@pnp/cli-microsoft365 5.9.0-beta.1e08e6c → 5.9.0-beta.1f313f7

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-health-list.md

@@ -28,3 +28,94 @@ Get the health report of all subscribed services for a tenant including the issu
 ```sh
 m365 tenant serviceannouncement health list --issues
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "service": "Exchange Online",
+        "status": "serviceDegradation",
+        "id": "Exchange"
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id          status              service
+    ----------  ------------------  -----------------
+    Exchange    serviceDegradation  Exchange Online
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,status,service
+    Exchange,serviceDegradation,Exchange Online
+    ```
+
+### `issues` response
+
+When we make use of the option `issues` the response will differ.
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "service": "Microsoft Defender for Cloud Apps",
+        "status": "serviceOperational",
+        "id": "cloudappsecurity",
+        "issues": [
+          {
+            "startDateTime": "2022-05-13T00:00:00Z",
+            "endDateTime": "2022-05-16T13:10:00Z",
+            "lastModifiedDateTime": "2022-05-17T11:00:42.2Z",
+            "title": "Microsoft Defender for Cloud Apps admin panel changes not propagating to Microsoft Defender for Endpoint",
+            "id": "CS381143",
+            "impactDescription": "Admins may notice that Microsoft Defender for Cloud Apps admin panel changes did not propagate to Microsoft Defender for",
+            "classification": "advisory",
+            "origin": "microsoft",
+            "status": "serviceRestored",
+            "service": "Microsoft Defender for Cloud Apps",
+            "feature": "Cloud App Security",
+            "featureGroup": "Cloud App Security",
+            "isResolved": true,
+            "highImpact": null,
+            "details": [],
+            "posts": [
+              {
+                "createdDateTime": "2022-05-17T08:31:31.113Z",
+                "postType": "regular",
+                "description": {
+                  "contentType": "html",
+                  "content": "Title: Microsoft Defender for Cloud Apps admin panel changes not propagating to Microsoft Defender for Endpoint\\\n\nUser Impact: Admins may notice that Microsoft Defender for Cloud Apps admin panel changes do not propagate to Microsoft Defender for Endpoint.\\\n\nCurrent status: We're analyzing system logs to determine the source of the issue.\\\n\nScope of impact: Impact is specific to users who are served through the affected infrastructure.\\\n\nNext update by: Tuesday, May 17, 2022, at 10:30 AM UTC"
+                }
+              }
+            ]
+          }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id          status              service
+    ----------  ------------------  -----------------
+    Exchange    serviceDegradation  Exchange Online
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,status,service
+    Exchange,serviceDegradation,Exchange Online
+    ```

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-get.md

@@ -22,3 +22,65 @@ Gets information about issue with ID _MO226784_
 ```sh
 m365 tenant serviceannouncement healthissue get --id MO226784
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "startDateTime": "2022-05-24T16:00:00Z",
+      "endDateTime": "2022-05-24T22:20:00Z",
+      "lastModifiedDateTime": "2022-05-24T22:27:18.63Z",
+      "title": "Installation delays within the Power Platform admin center",
+      "id": "CR384241",
+      "impactDescription": "Users may have experienced delays when installing applications within the Power Platform admin center.",
+      "classification": "advisory",
+      "origin": "microsoft",
+      "status": "serviceRestored",
+      "service": "Dynamics 365 Apps",
+      "feature": "Other",
+      "featureGroup": "Other",
+      "isResolved": true,
+      "highImpact": null,
+      "details": [],
+      "posts": [
+        {
+          "createdDateTime": "2022-05-24T21:22:56.817Z",
+          "postType": "regular",
+          "description": {
+            "contentType": "html",
+            "content": "Title: Installation delays within the Power Platform admin center\\\n\nUser Impact: Users may experience delays when installing applications within the Power Platform admin center.\\\n\nWe are aware of an emerging issue where users are experiencing delays when installing applications through the Power Platform admin center. We are investigating the issue and will provide another update within the next 30 minutes.\\\n\nThis information is preliminary and may be subject to changes, corrections, and updates."
+          }
+        }
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    classification      : advisory
+    details             : []
+    endDateTime         : 2022-05-24T22:20:00Z
+    feature             : Other
+    featureGroup        : Other
+    highImpact          : null
+    id                  : CR384241
+    impactDescription   : Users may have experienced delays when installing applications within the Power Platform admin center.
+    isResolved          : true
+    lastModifiedDateTime: 2022-05-24T22:27:18.63Z
+    origin              : microsoft
+    posts               : [{"createdDateTime":"2022-05-24T21:22:56.817Z","postType":"regular","description":{"contentType":"html","content":"Title: Installation delays within the Power Platform admin center\n\nUser Impact: Users may experience delays when installing applications within the Power Platform admin center.\n\nWe are aware of an emerging issue where users are experiencing delays when installing applications through the Power Platform admin center. We are investigating the issue and will provide another update within the next 30 minutes.\n\nThis information is preliminary and may be subject to changes, corrections, and updates."}}]
+    service             : Dynamics 365 Apps
+    startDateTime       : 2022-05-24T16:00:00Z
+    status              : serviceRestored
+    title               : Installation delays within the Power Platform admin center
+    ```
+
+=== "CSV"
+
+    ```csv
+    startDateTime,endDateTime,lastModifiedDateTime,title,id,impactDescription,classification,origin,status,service,feature,featureGroup,isResolved,highImpact,details,posts
+    2022-05-24T16:00:00Z,2022-05-24T22:20:00Z,2022-05-24T22:27:18.63Z,Installation delays within the Power Platform admin center,CR384241,Users may have experienced delays when installing applications within the Power Platform admin center.,advisory,microsoft,serviceRestored,Dynamics 365 Apps,Other,Other,1,,[],"[{""createdDateTime"":""2022-05-24T21:22:56.817Z"",""postType"":""regular"",""description"":{""contentType"":""html"",""content"":""Title: Installation delays within the Power Platform admin center\n\nUser Impact: Users may experience delays when installing applications within the Power Platform admin center.\n\nWe are aware of an emerging issue where users are experiencing delays when installing applications through the Power Platform admin center. We are investigating the issue and will provide another update within the next 30 minutes.\n\nThis information is preliminary and may be subject to changes, corrections, and updates.""}}]"
+    ```

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-healthissue-list.md

@@ -29,6 +29,57 @@ Get service health issues for Microsoft Forms
 m365 tenant serviceannouncement healthissue list --service "Microsoft Forms"
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "startDateTime": "2022-05-24T16:00:00Z",
+        "endDateTime": "2022-05-24T22:20:00Z",
+        "lastModifiedDateTime": "2022-05-24T22:27:18.63Z",
+        "title": "Installation delays within the Power Platform admin center",
+        "id": "CR384241",
+        "impactDescription": "Users may have experienced delays when installing applications within the Power Platform admin center.",
+        "classification": "advisory",
+        "origin": "microsoft",
+        "status": "serviceRestored",
+        "service": "Dynamics 365 Apps",
+        "feature": "Other",
+        "featureGroup": "Other",
+        "isResolved": true,
+        "highImpact": null,
+        "details": [],
+        "posts": [
+          {
+            "createdDateTime": "2022-05-24T21:22:56.817Z",
+            "postType": "regular",
+            "description": {
+              "contentType": "html",
+              "content": "Title: Installation delays within the Power Platform admin center\\\n\nUser Impact: Users may experience delays when installing applications within the Power Platform admin center.\\\n\nWe are aware of an emerging issue where users are experiencing delays when installing applications through the Power Platform admin center. We are investigating the issue and will provide another update within the next 30 minutes.\\\n\nThis information is preliminary and may be subject to changes, corrections, and updates."
+            }
+          }
+        ]
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id        title
+    --------  ----------------------------------------------------------
+    CR384241  Installation delays within the Power Platform admin center
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title
+    CR384241,Installation delays within the Power Platform admin center
+    ```
+
 ## More information
 
 - List serviceAnnouncement issues: [https://docs.microsoft.com/en-us/graph/api/serviceannouncement-list-issues](https://docs.microsoft.com/en-us/graph/api/serviceannouncement-list-issues)

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-get.md

@@ -23,6 +23,70 @@ Get service update message with ID MC001337
 m365 tenant serviceannouncement message get --id MC001337
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "startDateTime": "2021-07-08T00:37:37Z",
+      "endDateTime": "2022-12-09T07:00:00Z",
+      "lastModifiedDateTime": "2022-06-07T20:21:06.713Z",
+      "title": "(Updated) Microsoft Lists: Custom list templates",
+      "id": "MC267581",
+      "category": "planForChange",
+      "severity": "normal",
+      "tags": [
+        "Updated message",
+        "New feature",
+        "User impact",
+        "Admin impact"
+      ],
+      "isMajorChange": false,
+      "actionRequiredByDateTime": null,
+      "services": [
+        "SharePoint Online"
+      ],
+      "expiryDateTime": null,
+      "hasAttachments": false,
+      "viewPoint": null,
+      "details": [],
+      "body": {
+        "contentType": "html",
+        "content": "<p>Updated June 7, 2022: We have updated the rollout timeline below. Thank you for your patience.</p><p>This new feature will support the addition of custom list templates from your organization alongside the ready-made templates Microsoft provides to make it easy to get started tracking and managing information.</p> \\\n<p>[Key points]</p> \\\n<ul> \\\n<li>Microsoft 365 <a href=\"https://www.microsoft.com/microsoft-365/roadmap?filters=&amp;searchterms=70753\" target=\"_blank\">Roadmap ID: 70753</a></li> \\\n<li>Timing:<ul><li>Targeted release (entire org): Complete</li><li>Standard release: will roll out in mid-September (previously mid-May) and be complete by early November (previously mid-June)</li></ul></li> \\\n<li>Roll-out: tenant level </li> \\\n<li>Control type: user control / admin control</li> \\\n<li>Action: review, assess and educate</li></ul><p>[How this will affect your organization]</p><p>This feature will give organizations the ability to create their own custom list templates with custom formatting and schema. It will also empower organizations to create repeatable solutions within the same Microsoft Lists infrastructure (including list creation in SharePoint, Teams, and within the Lists app itself).</p><p>End-user impact:</p>\\\n<p>Visual updates to the list creation dialog and the addition of a<i> From your organization</i> tab when creating a new list. This new tab is where your custom list templates appear alongside the ready-made templates from Microsoft.</p>\\\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81n?ver=c93f\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"><br>\\\nAdmin impact:</p>\\\n<p>Custom list templates can only be uploaded by a SharePoint administrator for Microsoft 365 by using PowerShell cmdlets. For consistency, the process of defining and uploading custom list templates is like the custom site templates experience.</p><p>To define and upload custom list templates, admins will use the following site template PowerShell cmdlets:</p><ul><li>Use the <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/get-spositescriptfromlist?view=sharepoint-ps\" target=\"_blank\">Get-SPOSiteScriptFromList</a> cmdlet to extract the site script from any list</li><li>Run <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/add-spositescript?view=sharepoint-ps\" target=\"_blank\">Add-SPOSiteScript</a> and <b style=\"\">Add-SPOListDesign</b> to add the custom list template to your organization.</li><li>Scope who sees the template by using <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/grant-spositedesignrights?view=sharepoint-ps\" target=\"_blank\">Grant-SPOSiteDesignRights</a>  (Optional).</li></ul><p>The visual updates for this feature will be seen by end-users in the updated user interface (UI) when creating a list.</p><p>The <i>From your organization</i> tab will be empty until your organization defines and publishes custom list templates.</p>\\\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81t?ver=70be\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"></p><p>[What you need to do to prepare]</p><p>You might want to notify your users about this new capability and update your training and documentation as appropriate.</p>\\\n<p>Learn more:</p><ul><li><a href=\"https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-design-overview\" target=\"_blank\">PowerShell Cmdlets documentation for custom list templates</a></li><li> <a href=\"https://docs.microsoft.com/sharepoint/lists-custom-template\" target=\"_blank\">Creating custom list templates</a></li></ul>"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    actionRequiredByDateTime: null
+    body                    : {"contentType":"html","content":"<p>Updated June 7, 2022: We have updated the rollout timeline below. Thank you for your patience.</p><p>This new feature will support the addition of custom list templates from your organization alongside the ready-made templates Microsoft provides to make it easy to get started tracking and managing information.</p> \n<p>[Key points]</p> \n<ul> \n<li>Microsoft 365 <a href=\"https://www.microsoft.com/microsoft-365/roadmap?filters=&amp;searchterms=70753\" target=\"_blank\">Roadmap ID: 70753</a></li> \n<li>Timing:<ul><li>Targeted release (entire org): Complete</li><li>Standard release: will roll out in mid-September (previously mid-May) and be complete by early November (previously mid-June)</li></ul></li> \n<li>Roll-out: tenant level </li> \n<li>Control type: user control / admin control</li> \n<li>Action: review, assess and educate</li></ul><p>[How this will affect your organization]</p><p>This feature will give organizations the ability to create their own custom list templates with custom formatting and schema. It will also empower organizations to create repeatable solutions within the same Microsoft Lists infrastructure (including list creation in SharePoint, Teams, and within the Lists app itself).</p><p>End-user impact:</p>\n<p>Visual updates to the list creation dialog and the addition of a<i> From your organization</i> tab when creating a new list. This new tab is where your custom list templates appear alongside the ready-made templates from Microsoft.</p>\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81n?ver=c93f\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"><br>\nAdmin impact:</p>\n<p>Custom list templates can only be uploaded by a SharePoint administrator for Microsoft 365 by using PowerShell cmdlets. For consistency, the process of defining and uploading custom list templates is like the custom site templates experience.</p><p>To define and upload custom list templates, admins will use the following site template PowerShell cmdlets:</p><ul><li>Use the <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/get-spositescriptfromlist?view=sharepoint-ps\" target=\"_blank\">Get-SPOSiteScriptFromList</a> cmdlet to extract the site script from any list</li><li>Run <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/add-spositescript?view=sharepoint-ps\" target=\"_blank\">Add-SPOSiteScript</a> and <b style=\"\">Add-SPOListDesign</b> to add the custom list template to your organization.</li><li>Scope who sees the template by using <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/grant-spositedesignrights?view=sharepoint-ps\" target=\"_blank\">Grant-SPOSiteDesignRights</a>  (Optional).</li></ul><p>The visual updates for this feature will be seen by end-users in the updated user interface (UI) when creating a list.</p><p>The <i>From your organization</i> tab will be empty until your organization defines and publishes custom list templates.</p>\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81t?ver=70be\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"></p><p>[What you need to do to prepare]</p><p>You might want to notify your users about this new capability and update your training and documentation as appropriate.</p>\n<p>Learn more:</p><ul><li><a href=\"https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-design-overview\" target=\"_blank\">PowerShell Cmdlets documentation for custom list templates</a></li><li> <a href=\"https://docs.microsoft.com/sharepoint/lists-custom-template\" target=\"_blank\">Creating custom list templates</a></li></ul>"}
+    category                : planForChange
+    details                 : []
+    endDateTime             : 2022-12-09T07:00:00Z
+    expiryDateTime          : null
+    hasAttachments          : false
+    id                      : MC267581
+    isMajorChange           : false
+    lastModifiedDateTime    : 2022-06-07T20:21:06.713Z
+    services                : ["SharePoint Online"]
+    severity                : normal
+    startDateTime           : 2021-07-08T00:37:37Z
+    tags                    : ["Updated message","New feature","User impact","Admin impact"]
+    title                   : (Updated) Microsoft Lists: Custom list templates
+    viewPoint               : null
+    ```
+
+=== "CSV"
+
+    ```csv
+    startDateTime,endDateTime,lastModifiedDateTime,title,id,category,severity,tags,isMajorChange,actionRequiredByDateTime,services,expiryDateTime,hasAttachments,viewPoint,details,body
+    2021-07-08T00:37:37Z,2022-12-09T07:00:00Z,2022-06-07T20:21:06.713Z,(Updated) Microsoft Lists: Custom list templates,MC267581,planForChange,normal,"[""Updated message"",""New feature"",""User impact"",""Admin impact""]",,,"[""SharePoint Online""]",,,,[],"{""contentType"":""html"",""content"":""<p>Updated June 7, 2022: We have updated the rollout timeline below. Thank you for your patience.</p><p>This new feature will support the addition of custom list templates from your organization alongside the ready-made templates Microsoft provides to make it easy to get started tracking and managing information.</p> \n<p>[Key points]</p> \n<ul> \n<li>Microsoft 365 <a href=\""https://www.microsoft.com/microsoft-365/roadmap?filters=&amp;searchterms=70753\"" target=\""_blank\"">Roadmap ID: 70753</a></li> \n<li>Timing:<ul><li>Targeted release (entire org): Complete</li><li>Standard release: will roll out in mid-September (previously mid-May) and be complete by early November (previously mid-June)</li></ul></li> \n<li>Roll-out: tenant level </li> \n<li>Control type: user control / admin control</li> \n<li>Action: review, assess and educate</li></ul><p>[How this will affect your organization]</p><p>This feature will give organizations the ability to create their own custom list templates with custom formatting and schema. It will also empower organizations to create repeatable solutions within the same Microsoft Lists infrastructure (including list creation in SharePoint, Teams, and within the Lists app itself).</p><p>End-user impact:</p>\n<p>Visual updates to the list creation dialog and the addition of a<i> From your organization</i> tab when creating a new list. This new tab is where your custom list templates appear alongside the ready-made templates from Microsoft.</p>\n<p><img src=\""https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81n?ver=c93f\"" alt=\""Your custom list templates along with Microsoft ready-made templates\"" width=\""550\""><br>\nAdmin impact:</p>\n<p>Custom list templates can only be uploaded by a SharePoint administrator for Microsoft 365 by using PowerShell cmdlets. For consistency, the process of defining and uploading custom list templates is like the custom site templates experience.</p><p>To define and upload custom list templates, admins will use the following site template PowerShell cmdlets:</p><ul><li>Use the <a href=\""https://docs.microsoft.com/powershell/module/sharepoint-online/get-spositescriptfromlist?view=sharepoint-ps\"" target=\""_blank\"">Get-SPOSiteScriptFromList</a> cmdlet to extract the site script from any list</li><li>Run <a href=\""https://docs.microsoft.com/powershell/module/sharepoint-online/add-spositescript?view=sharepoint-ps\"" target=\""_blank\"">Add-SPOSiteScript</a> and <b style=\""\"">Add-SPOListDesign</b> to add the custom list template to your organization.</li><li>Scope who sees the template by using <a href=\""https://docs.microsoft.com/powershell/module/sharepoint-online/grant-spositedesignrights?view=sharepoint-ps\"" target=\""_blank\"">Grant-SPOSiteDesignRights</a>  (Optional).</li></ul><p>The visual updates for this feature will be seen by end-users in the updated user interface (UI) when creating a list.</p><p>The <i>From your organization</i> tab will be empty until your organization defines and publishes custom list templates.</p>\n<p><img src=\""https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81t?ver=70be\"" alt=\""Your custom list templates along with Microsoft ready-made templates\"" width=\""550\""></p><p>[What you need to do to prepare]</p><p>You might want to notify your users about this new capability and update your training and documentation as appropriate.</p>\n<p>Learn more:</p><ul><li><a href=\""https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-design-overview\"" target=\""_blank\"">PowerShell Cmdlets documentation for custom list templates</a></li><li> <a href=\""https://docs.microsoft.com/sharepoint/lists-custom-template\"" target=\""_blank\"">Creating custom list templates</a></li></ul>""}"
+    ```
+
 ## More information
 
 - Microsoft Graph REST API reference: [https://docs.microsoft.com/en-us/graph/api/serviceupdatemessage-get](https://docs.microsoft.com/en-us/graph/api/serviceupdatemessage-get)
+

package/docs/docs/cmd/tenant/serviceannouncement/serviceannouncement-message-list.md

@@ -29,6 +29,58 @@ Get service update messages for Microsoft Teams
 m365 tenant serviceannouncement message list --service "Microsoft Teams"
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "startDateTime": "2021-07-08T00:37:37Z",
+        "endDateTime": "2022-12-09T07:00:00Z",
+        "lastModifiedDateTime": "2022-06-07T20:21:06.713Z",
+        "title": "(Updated) Microsoft Lists: Custom list templates",
+        "id": "MC267581",
+        "category": "planForChange",
+        "severity": "normal",
+        "tags": [
+          "Updated message",
+          "New feature",
+          "User impact",
+          "Admin impact"
+        ],
+        "isMajorChange": false,
+        "actionRequiredByDateTime": null,
+        "services": [
+          "SharePoint Online"
+        ],
+        "expiryDateTime": null,
+        "hasAttachments": false,
+        "viewPoint": null,
+        "details": [],
+        "body": {
+          "contentType": "html",
+          "content": "<p>Updated June 7, 2022: We have updated the rollout timeline below. Thank you for your patience.</p><p>This new feature will support the addition of custom list templates from your organization alongside the ready-made templates Microsoft provides to make it easy to get started tracking and managing information.</p> \\\n<p>[Key points]</p> \\\n<ul> \\\n<li>Microsoft 365 <a href=\"https://www.microsoft.com/microsoft-365/roadmap?filters=&amp;searchterms=70753\" target=\"_blank\">Roadmap ID: 70753</a></li> \\\n<li>Timing:<ul><li>Targeted release (entire org): Complete</li><li>Standard release: will roll out in mid-September (previously mid-May) and be complete by early November (previously mid-June)</li></ul></li> \\\n<li>Roll-out: tenant level </li> \\\n<li>Control type: user control / admin control</li> \\\n<li>Action: review, assess and educate</li></ul><p>[How this will affect your organization]</p><p>This feature will give organizations the ability to create their own custom list templates with custom formatting and schema. It will also empower organizations to create repeatable solutions within the same Microsoft Lists infrastructure (including list creation in SharePoint, Teams, and within the Lists app itself).</p><p>End-user impact:</p>\\\n<p>Visual updates to the list creation dialog and the addition of a<i> From your organization</i> tab when creating a new list. This new tab is where your custom list templates appear alongside the ready-made templates from Microsoft.</p>\\\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81n?ver=c93f\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"><br>\\\nAdmin impact:</p>\\\n<p>Custom list templates can only be uploaded by a SharePoint administrator for Microsoft 365 by using PowerShell cmdlets. For consistency, the process of defining and uploading custom list templates is like the custom site templates experience.</p><p>To define and upload custom list templates, admins will use the following site template PowerShell cmdlets:</p><ul><li>Use the <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/get-spositescriptfromlist?view=sharepoint-ps\" target=\"_blank\">Get-SPOSiteScriptFromList</a> cmdlet to extract the site script from any list</li><li>Run <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/add-spositescript?view=sharepoint-ps\" target=\"_blank\">Add-SPOSiteScript</a> and <b style=\"\">Add-SPOListDesign</b> to add the custom list template to your organization.</li><li>Scope who sees the template by using <a href=\"https://docs.microsoft.com/powershell/module/sharepoint-online/grant-spositedesignrights?view=sharepoint-ps\" target=\"_blank\">Grant-SPOSiteDesignRights</a>  (Optional).</li></ul><p>The visual updates for this feature will be seen by end-users in the updated user interface (UI) when creating a list.</p><p>The <i>From your organization</i> tab will be empty until your organization defines and publishes custom list templates.</p>\\\n<p><img src=\"https://img-prod-cms-rt-microsoft-com.akamaized.net/cms/api/am/imageFileData/RE4P81t?ver=70be\" alt=\"Your custom list templates along with Microsoft ready-made templates\" width=\"550\"></p><p>[What you need to do to prepare]</p><p>You might want to notify your users about this new capability and update your training and documentation as appropriate.</p>\\\n<p>Learn more:</p><ul><li><a href=\"https://docs.microsoft.com/sharepoint/dev/declarative-customization/site-design-overview\" target=\"_blank\">PowerShell Cmdlets documentation for custom list templates</a></li><li> <a href=\"https://docs.microsoft.com/sharepoint/lists-custom-template\" target=\"_blank\">Creating custom list templates</a></li></ul>"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id        title
+    --------  ------------------------------------------------
+    MC267581  (Updated) Microsoft Lists: Custom list templates
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title
+    MC267581,(Updated) Microsoft Lists: Custom list templates
+    ```
+ 
 ## More information
 
 - List serviceAnnouncement messages: [https://docs.microsoft.com/en-us/graph/api/serviceannouncement-list-messages](https://docs.microsoft.com/en-us/graph/api/serviceannouncement-list-messages)

package/docs/docs/cmd/todo/list/list-get.md

@@ -0,0 +1,61 @@
+# todo list get
+
+Returns a specific Microsoft To Do task list
+
+## Usage
+
+```sh
+m365 todo list get [options]
+```
+
+## Options
+
+`-i, --id [id]`
+: The id of the list. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the list. Specify either `id` or `name` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a specific Microsoft To Do task list based on id
+
+```sh
+m365 todo list get --id "AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA="
+```
+
+Get a specific Microsoft To Do task list based on name
+
+```sh
+m365 todo list get --name "Task list"
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "displayName": "Task list",
+      "isOwner": true,
+      "isShared": false,
+      "wellknownListName": "defaultList",
+      "id": "AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA="
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    displayName    : Task list
+    id             : AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA=
+    ```
+
+=== "CSV"
+
+    ```csv
+    displayName,id
+    Task list,AAMkADY3NmM5ZjhiLTc3M2ItNDg5ZC1iNGRiLTAyM2FmMjVjZmUzOQAuAAAAAAAZ1T9YqZrvS66KkevskFAXAQBEMhhN5VK7RaaKpIc1KhMKAAAZ3e1AAAA=
+    ```

package/docs/docs/cmd/todo/task/task-get.md

@@ -0,0 +1,75 @@
+# todo task get
+
+Gets a specific task from a Microsoft To Do task list
+
+## Usage
+
+```sh
+m365 todo task get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The ID of the task in de list.
+
+`--listName [listName]`
+: The name of the task list to return tasks from. Specify either `listName` or `listId`, not both
+
+`--listId [listId]`
+: The id of the task list to return tasks from. Specify either `listName` or `listId`, not both
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Gets a specific task from a Microsoft To Do tasks list based on the name of the list and the task id
+
+```sh
+m365 todo task get --listName "My task list" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
+```
+
+Gets a specific task from a Microsoft To Do tasks list based on the id of the list and the task id
+
+```sh
+m365 todo task get --listId "AQMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MAAuAAADMN-7V4K8g0q_adetip1DygEAxMBBaLl1lk_dAn8KkjfXKQABF-BAgwAAAA==" --id "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA="
+```
+
+## Response
+
+=== "JSON"
+
+    ``` json
+    {
+      "importance": "normal",
+      "isReminderOn": false,
+      "status": "notStarted",
+      "title": "Stay healthy",
+      "createdDateTime": "2022-10-23T14:05:09.2673009Z",
+      "lastModifiedDateTime": "2022-10-23T14:15:11.3180312Z",
+      "hasAttachments": false,
+      "categories": [],
+      "id": "AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=",
+      "body": {
+        "content": "",
+        "contentType": "text"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ``` text
+    createdDateTime     : 2022-10-23T14:05:09.2673009Z
+    id                  : AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=
+    lastModifiedDateTime: 2022-10-23T14:15:11.3180312Z
+    status              : notStarted
+    title               : Stay healthy
+    ```
+
+=== "CSV"
+
+    ``` text
+    id,title,status,createdDateTime,lastModifiedDateTime
+    AAMkAGYzNjMxYTU4LTJjZjYtNDlhMi1iMzQ2LWVmMTU3YmUzOGM5MABGAAAAAAAw3-tXgryDSr5p162KnUPKBwDEwEFouXWWT50CfwqSN9cpAAEX8ECDAADEwEFouXWWT50CfwqSN9cpAAEX8GuPAAA=,Stay healthy,notStarted,2022-10-23T14:05:09.2673009Z,2022-10-23T14:15:11.3180312Z
+    ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pnp/cli-microsoft365",
-  "version": "5.9.0-beta.1e08e6c",
+  "version": "5.9.0-beta.1f313f7",
   "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
   "license": "MIT",
   "main": "./dist/api.js",
@@ -101,7 +101,7 @@
   "contributors": [
     "Abhishek K M <67158080+Sync271@users.noreply.github.com>",
     "Ågren, Simon <simon.agren@sogeti.com>",
-    "Akash Karda <akashkarda@gmail.com>",
+    "Ahlawat, Priyanshu <priyanshuahlawat009@gmail.com>",
     "Albany, Bruce <bruce.albany@gmail.com>",
     "Auckloo, Reshmee <reshmee011@gmail.com>",
     "Balasubramaniam, Jayakumar <jayakumar@live.in>",
@@ -116,14 +116,13 @@
     "Calabro, David <davej.calabro@gmail.com>",
     "Choudhary, Karnail Singh <pradhankarnail@gmail.com>",
     "Connell, Andrew <me@andrewconnell.com>",
-    "Conor O'Callaghan <brioscaibriste@gmail.com>",
     "De Cleyre, Nico <nico.de.cleyre@gmail.com>",
     "Deshpande, Vardhaman <vardhaman.rd@gmail.com>",
     "Dyjas, Robert <15113729+robdy@users.noreply.github.com>",
     "Faleel, Mohamed Ashiq <ashiqf@gmail.com>",
+    "Flores, Gaston <gaston.flrs@gmail.com>",
     "Ford, Lee <fordyman@gmail.com>",
     "Freese, Luise <49960482+LuiseFreese@users.noreply.github.com>",
-    "Gaston Flores <gaston.flrs@gmail.com>",
     "Georgiev, Velin <velin.georgiev@gmail.com>",
     "Ghuge, Pramod <pramod7@gmail.com>",
     "Gölles, Thomas <thomy@outlook.at>",
@@ -131,13 +130,12 @@
     "Harding, Phil <pil.harding@platinumdogs.co.uk>",
     "Hawrylak, Paweł <phawrylak@outlook.com>",
     "Holemans, Milan <Milan.Holemans@vanroey.be>",
-    "Hüseyin Saatçi <huseyins@comodo.net>",
     "Honen, Nicholas <nickhonen@gmail.com>",
     "Högberg, Joakim <joakim.hogberg@bravero.se>",
     "Hvam, Allan <ahp@delegate.dk>",
     "Jaakke, Robert <robert.jaakke@mavention.nl>",
-    "John Rafael <dragonwood0@protonmail.com>",
     "Kailasam, Balamurugan <kshsbala@engineer.com>",
+    "Karda, Akash <akashkarda@gmail.com>",
     "Kasireddy, Prasad <prasad.gietcse@gmail.com>",
     "Keijzers, Paul <KbWorks@users.noreply.github.com>",
     "Kelkar, Vipul <vipul.kelkar@outlook.com>",
@@ -161,6 +159,7 @@
     "Nachan, Smita <smita.nachan@gmail.com>",
     "Nadir, Daniaal <daniaal1030@gmail.com>",
     "Nikolić, Aleksandar <alexandair@live.com>",
+    "O'Callaghan, Conor <brioscaibriste@gmail.com>",
     "Otto <berot3@gmail.com>",
     "Pandey, Vividh <vividh.pandey.13@gmail.com>",
     "Patil, Atharva <atharvapatil19202@gmail.com>",
@@ -168,13 +167,16 @@
     "Powney, Mark <powney.mark@outlook.com>",
     "pramod74 <pramod.lumb@gmail.com>",
     "Priem, Mark <mark.priem@outlook.com>",
+    "Rafael, John <dragonwood0@protonmail.com>",
     "Raju, Arnie <arnie.raju@thesolutioncollective.com.au>",
     "Ramalho, David <dramalho@storm.ie>",
     "Rathi, Tanmay <tanmay_rathi@intuit.com>",
     "Reekmans, Yannick <reekmans.yannick@gmail.com>",
+    "Raghwendra Rishabh <rishabhraghwendra2002@gmail.com>",
     "Romano, Rodrigo <rodrigo@rodrigoromano.net>",
     "Romão, Douglas <douglas.romao@trentim.com>",
     "Rozinov, Roman <roman.rozinov@sogeti.com>",
+    "Saatçi, Hüseyin <huseyins@comodo.net>",
     "Schaeflein, Paul <paul@schaeflein.net>",
     "Schot, Albert-Jan <appie@digiwijs.nl>",
     "Schouten, Robert <robert.schouten@wortell.nl>",
@@ -187,6 +189,7 @@
     "Sitaraman, Rajesh <rajesh.sitaraman@outlook.com>",
     "Sittler, Laurent <laurent.sittler@lsonline.fr>",
     "Skelly, Pete <peteskelly@gmail.com>",
+    "Solazzi, Riccardo <rick.zal239@gmail.com>",
     "Sotelo, Aaron <soteloaaron16@gmail.com>",
     "strafe <strafe@users.noreply.github.com>",
     "Struyf, Elio <info@estruyf.be>",