@pnp/cli-microsoft365 5.9.0-beta.fd24b4e → 5.9.0

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

@@ -31,3 +31,90 @@ Get the health report for the service _Exchange Online_ including the issues of
 ```sh
 m365 tenant serviceannouncement health get --serviceName "Exchange Online" --issues
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ```json
+    {
+      "service": "Exchange Online",
+      "status": "serviceDegradation",
+      "id": "Exchange"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    id     : Exchange
+    service: Exchange Online
+    status : serviceDegradation
+    ```
+
+=== "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": "Exchange Online",
+      "status": "serviceDegradation",
+      "id": "Exchange",
+      "issues": [
+        {
+          "startDateTime": "2022-08-17T18:27:00Z",
+          "endDateTime": "2022-08-18T16:06:18Z",
+          "lastModifiedDateTime": "2022-08-18T16:46:04.133Z",
+          "title": "AdminsÔÇÖ downloaded CSV mailbox usage reports via Microsoft 365 admin center donÔÇÖt contain data prior to August 1, 2022",
+          "id": "EX415080",
+          "impactDescription": "AdminsÔÇÖ downloaded CSV mailbox usage reports via Microsoft 365 admin center didn't contain data prior to August 1, 2022.",
+          "classification": "advisory",
+          "origin": "microsoft",
+          "status": "serviceRestored",
+          "service": "Exchange Online",
+          "feature": "Windows Live sign-in issue",
+          "featureGroup": "Sign-in",
+          "isResolved": true,
+          "highImpact": null,
+          "details": [],
+          "posts": [
+            {
+              "createdDateTime": "2022-08-17T18:34:54.95Z",
+              "postType": "regular",
+              "description": {
+                "contentType": "html",
+                "content": "Title: AdminsÔÇÖ downloaded CSV mailbox usage reports via Microsoft 365 admin center donÔÇÖt contain data prior to August 1, 2022\\\n\nUser impact: AdminsÔÇÖ downloaded CSV mailbox usage reports via Microsoft 365 admin center donÔÇÖt contain data prior to August 1, 2022.\\\n\nCurrent status: We're investigating a potential issue and checking for impact to your organization. We'll provide an update within 30 minutes."
+              }
+            }
+          ]
+        }
+      ]
+    }
+    ```
+
+=== "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-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-add.md

@@ -11,26 +11,53 @@ m365 todo task add [options]
 ## Options
 
 `-t, --title <title>`
-: The title of the task
+: The title of the task.
 
 `--listName [listName]`
-: The name of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The name of the list in which to create the task. Specify either `listName` or `listId` but not both.
 
 `--listId [listId]`
-: The id of the list in which to create the task. Specify either `listName` or `listId` but not both
+: The id of the list in which to create the task. Specify either `listName` or `listId` but not both.
+
+`--bodyContent [bodyContent]`
+: The body content of the task. In the UI this is called 'notes'.
+
+`--bodyContentType [bodyContentType]`
+: The type of the body content. Possible values are `text` and `html`. Default is `text`.
+
+`--dueDateTime [dueDateTime]`
+: The date when the task is due. This should be defined as a valid ISO 8601 string in the UTC time zone. Only date value is needed, time value is always ignored.
+
+`--importance [importance]`
+: The importance of the task. Possible values are: `low`, `normal`, `high`. Default is `normal`.
+
+`--reminderDateTime [reminderDateTime]`
+: The date and time for a reminder alert of the task to occur. This should be defined as a valid ISO 8601 string in the UTC time zone.
 
 --8<-- "docs/cmd/_global.md"
 
 ## Examples
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the name _My task list_
+Add a task to Microsoft To Do tasks list with with a specific name
 
 ```sh
 m365 todo task add --title "New task" --listName "My task list"
 ```
 
-Add a task with title _New task_ to Microsoft To Do tasks list with the id `AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==`
+Add a task to a Microsoft To Do tasks list with a specific id
 
 ```sh
 m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA=="
 ```
+
+Create a new task with bodyContent and reminder and flag it as important
+
+```sh
+m365 todo task add --title "New task" --listName "My task list" --bodyContent "I should not forget this" --reminderDateTime 2023-01-01T12:00:00Z --importance high
+```
+
+Create a new task with a specific due date
+
+```sh
+m365 todo task add --title "New task" --listId "AQMkADlhMTRkOGEzLWQ1M2QtNGVkNS04NjdmLWU0NzJhMjZmZWNmMwAuAAADKvwNgAMNPE_zFNRJXVrU1wEAhHKQZHItDEOVCn8U3xuA2AABmQeVPwAAAA==" --dueDateTime 2023-01-01
+```