@pnp/cli-microsoft365 12.0.0-beta.8dff3ac → 12.0.0-beta.93e11fb

package/docs/docs/cmd/spo/page/page-unpublish.mdx

@@ -0,0 +1,63 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo page unpublish
+
+Unpublishes a modern page
+
+## Usage
+
+```sh
+m365 spo page unpublish [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: URL of the site where the page is located.
+
+`-n, --name <name>`
+: Name of the page.
+```
+
+<Global />
+
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource   | Permissions    |
+  |------------|----------------|
+  | SharePoint | AllSites.Write |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource   | Permissions         |
+  |------------|---------------------|
+  | SharePoint | Sites.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Unpublish a modern page
+
+```sh
+m365 spo page unpublish --webUrl https://contoso.sharepoint.com/sites/Marketing --name "Style guide.aspx"
+```
+
+Unpublish a modern page in a subfolder
+
+```sh
+m365 spo page unpublish --webUrl https://contoso.sharepoint.com/sites/Marketing --name "/Styles/Guide.aspx"
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/web/web-rule-get.mdx

@@ -0,0 +1,108 @@
+import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo web rule get
+
+Retrieves information about a specific alert from a SharePoint list
+
+## Usage
+
+```sh
+m365 spo web rule get [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --webUrl <webUrl>`
+: The URL of the SharePoint site.
+
+`--id <id>`
+: The ID of the rule.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | SharePoint      | AllSites.FullControl |
+  | Microsoft Graph | User.ReadBasic.All   |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | SharePoint      | Sites.FullControl.All |
+  | Microsoft Graph | User.ReadBasic.All    |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Retrieve a rule by ID
+
+```sh
+m365 spo web rule get --webUrl https://contoso.sharepoint.com/sites/Marketing --id 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "AlertFrequency": 0,
+    "AlertTemplateName": "SPAlertTemplateType.DocumentLibrary",
+    "AlertType": 0,
+    "AlwaysNotify": false,
+    "DeliveryChannels": 1,
+    "EventType": -1,
+    "Filter": "",
+    "ID": "7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e",
+    "Status": 0,
+    "Title": "Marketing documents",
+    "UserId": 8,
+    "List": {
+      "Id": "39d9e102-9e8f-4e74-8f17-84a92f972fcf",
+      "Title": "Documents",
+      "RootFolder": {
+        "ServerRelativeUrl": "/sites/Marketing/Shared Documents"
+      }
+    },
+    "User": {
+      "Id": 8,
+      "UserPrincipalName": "jane.doe@contoso.com"
+    }
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  AlertFrequency   : 0
+  AlertTemplateName: SPAlertTemplateType.DocumentLibrary
+  AlertType        : 0
+  AlwaysNotify     : false
+  DeliveryChannels : 1
+  EventType        : -1
+  Filter           : 
+  ID               : 7cbb4c8d-8e4d-4d2e-9c6f-3f1d8b2e6a0e
+  Status           : 0
+  Title            : Marketing documents
+  UserId           : 8
+  List             : {"Id":"39d9e102-9e8f-4e74-8f17-84a92f972fcf","Title":"Documents","RootFolder":{"ServerRelativeUrl":"/sites/Marketing/Shared Documents"}}
+  User             : {"Id":8,"UserPrincipalName":"jane.doe@contoso.com"}
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/spp/model/model-get.mdx

@@ -32,7 +32,7 @@ m365 spp model get [options]
 
 ## Examples
 
-Retrieve information about a SharePoint Premium document understanding model, using model UniqueId.
+Retrieve information about a SharePoint Premium document understanding model, using model unique ID.
 
 ```sh
 m365 spp model get --siteUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc"

package/docs/docs/cmd/spp/model/model-remove.mdx

@@ -40,7 +40,7 @@ The model must be removed from all libraries before it can be deleted.
 
 ## Examples
 
-Delete a SharePoint Premium document understanding model using the model’s UniqueId.
+Delete a SharePoint Premium document understanding model using the model’s unique ID.
 
 ```sh
 m365 spp model remove --siteUrl "https://contoso.sharepoint.com/sites/ContentCenter" --id "7645e69d-21fb-4a24-a17a-9bdfa7cb63dc"

package/docs/docs/cmd/teams/tab/tab-add.mdx

@@ -46,6 +46,25 @@ m365 teams tab add [options]
 
 The corresponding app must already be installed in the team.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | TeamsTab.Create |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | TeamsTab.Create |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
   
 Add teams tab for website.

package/docs/docs/cmd/teams/tab/tab-get.mdx

@@ -40,6 +40,25 @@ m365 teams tab get [options]
 
 You can only retrieve tabs for teams of which you are a member.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                  |
+  |-----------------|--------------------------------------------------------------|
+  | Microsoft Graph | Channel.ReadBasic.All, Team.ReadBasic.All, TeamsTab.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                                  |
+  |-----------------|--------------------------------------------------------------|
+  | Microsoft Graph | Channel.ReadBasic.All, Team.ReadBasic.All, TeamsTab.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get a Microsoft Teams Tab with the specified ID.

package/docs/docs/cmd/teams/tab/tab-list.mdx

@@ -30,6 +30,25 @@ You can only retrieve tabs for teams of which you are a member.
 
 Tabs _Conversations_ and _Files_ are present in every team and therefore not included in the list of available tabs.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | TeamsTab.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | TeamsTab.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
   
 List all tabs in a Microsoft Teams channel.

package/docs/docs/cmd/teams/tab/tab-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams tab remove
 
@@ -28,6 +30,25 @@ m365 teams tab remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions               |
+  |-----------------|---------------------------|
+  | Microsoft Graph | TeamsTab.ReadWriteForTeam |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | TeamsTab.ReadWriteForTeam.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a tab from the specified channel. Will prompt for confirmation

package/docs/docs/cmd/tenant/people/people-profilecardproperty-add.mdx

@@ -44,6 +44,25 @@ When adding an attribute to a profile card, it takes up to 24 hours for the addi
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add the UPN as a profile property to the profile cards properties

package/docs/docs/cmd/tenant/people/people-profilecardproperty-get.mdx

@@ -29,6 +29,25 @@ To use this command you must be either **Tenant Administrator** or **Global Admi
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve information about a specific profile card property

package/docs/docs/cmd/tenant/people/people-profilecardproperty-list.mdx

@@ -24,6 +24,25 @@ To use this command you must be either **Tenant Administrator** or **Global Admi
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | PeopleSettings.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists all profile card properties

package/docs/docs/cmd/tenant/people/people-profilecardproperty-remove.mdx

@@ -38,6 +38,25 @@ When removing an attribute from a profile card, it takes up to 24 hours for the
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes the UPN as a profile property from the profile cards

package/docs/docs/cmd/tenant/people/people-profilecardproperty-set.mdx

@@ -44,6 +44,25 @@ When updating an attribute to a profile card, it takes up to 24 hours for the ad
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                  |
+  |-----------------|------------------------------|
+  | Microsoft Graph | PeopleSettings.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Updates a custom extension attribute to Cost Center

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

@@ -24,6 +24,25 @@ m365 tenant serviceannouncement health get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get the health report for the service _Exchange Online_

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

@@ -21,6 +21,25 @@ m365 tenant serviceannouncement health list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get the health report of all subscribed services for a tenant

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

@@ -21,6 +21,25 @@ m365 tenant serviceannouncement healthissue get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets information about issue with ID _MO226784_

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

@@ -21,6 +21,25 @@ m365 tenant serviceannouncement healthissue list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions            |
+  |-----------------|------------------------|
+  | Microsoft Graph | ServiceHealth.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get service health issues of all services in Microsoft 365

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

@@ -21,6 +21,25 @@ m365 tenant serviceannouncement message get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | ServiceMessage.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | ServiceMessage.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get service update message with ID MC001337

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

@@ -21,6 +21,25 @@ m365 tenant serviceannouncement message list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | ServiceMessage.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions             |
+  |-----------------|-------------------------|
+  | Microsoft Graph | ServiceMessage.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Get service update messages of all services in Microsoft 365

package/docs/docs/cmd/viva/engage/engage-message-add.mdx

@@ -41,6 +41,23 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Replies to a message with the ID 1231231231.

package/docs/docs/cmd/viva/engage/engage-message-get.mdx

@@ -29,6 +29,23 @@ In order to use this command, you need to grant the Microsoft Entra application
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns the Viva Engage message with the id 1239871123.

package/docs/docs/cmd/viva/engage/engage-message-list.mdx

@@ -54,6 +54,23 @@ Feed types
 - Private: Private messages received by the user
 - Received: All messages received by the user
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource | Permissions        |
+  |----------|--------------------|
+  | Yammer   | user_impersonation |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns all Viva Engage network messages