@pnp/cli-microsoft365 12.0.0-beta.0be7d8d → 12.0.0-beta.10c5833

package/docs/docs/cmd/spo/site/site-list.mdx

@@ -16,7 +16,10 @@ m365 spo site list [options]
 
 ```md definition-list
 `-t, --type [type]`
-: convenience option for type of sites to list. Allowed values are `TeamSite,CommunicationSite`.
+: convenience option for type of sites to list. Allowed values are `TeamSite` and `CommunicationSite`.
+
+`--state [state]`
+: option to filter sites by their archived state. Allowed values are `active`, `fullyArchived`, `recentlyArchived` and `archived`.
 
 `--webTemplate [webTemplate]`
 : type of sites to list. To be used with values like `GROUP#0` and `SITEPAGEPUBLISHING#0`. Specify either `type` or `webTemplate`, but not both.  
@@ -31,6 +34,12 @@ m365 spo site list [options]
 <Global />
 
 ## Remarks
+When providing a value for option `state`, consider the following:
+
+- `active`: return sites that are not archived
+- `fullyArchived`: return sites that are fully archived (longer than 7 days)
+- `recentlyArchived`: return sites that are recently archived (within 7 days)
+- `archived`: return both recently archived and fully archived sites
 
 Using the `--filter` option you can specify which sites you want to retrieve. For example, to get sites with _project_ in their URL, use `Url -like 'project'` as the filter.
 
@@ -76,6 +85,18 @@ List all sites in the currently connected tenant including OneDrive sites.
 m365 spo site list --withOneDriveSites
 ```
 
+List all active (non-archived) sites in the currently connected tenant.
+
+```sh
+m365 spo site list --state active
+```
+
+List all archived sites in the currently connected tenant.
+
+```sh
+m365 spo site list --state archived
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/spo/site/site-remove.mdx

@@ -16,8 +16,8 @@ m365 spo site remove [options]
 `-u, --url <url>`
 : URL of the site.
 
-`--skipRecycleBin`
-: Set to directly remove the site without moving it to the recycle bin.
+`--permanent`
+: Permanently remove the site without leaving it in the recycle bin.
 
 `--fromRecycleBin`
 : Set to remove the site from the recycle bin.
@@ -49,7 +49,7 @@ m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite
 Remove the site without moving it to the recycle bin.
 
 ```sh
-m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --skipRecycleBin
+m365 spo site remove --url https://contoso.sharepoint.com/sites/demosite --permanent
 ```
 
 Remove the previously deleted site from the recycle bin.

package/docs/docs/cmd/spo/storageentity/storageentity-get.mdx

@@ -17,22 +17,31 @@ m365 spo storageentity get [options]
 ```md definition-list
 `-k, --key <key>`
 : Name of the tenant property to retrieve
+
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the app catalog site. If not specified, the tenant app catalog URL will be used.
 ```
 
 <Global />
 
 ## Remarks
 
-Tenant properties are stored in the app catalog site associated with the site to which you are currently connected. When retrieving the specified tenant property, SharePoint will automatically find the associated app catalog and try to retrieve the property from it.
+Tenant properties are stored in the app catalog site associated with the site to which you are currently connected. When retrieving the specified tenant property, SharePoint will use the specified app catalog URL or automatically resolve the tenant app catalog URL.
 
 ## Examples
 
-Show the value, description and comment of the _AnalyticsId_ tenant property
+Show the value, description and comment of the _AnalyticsId_ tenant property using the tenant app catalog
 
 ```sh
 m365 spo storageentity get -k AnalyticsId
 ```
 
+Show the value, description and comment of the _AnalyticsId_ tenant property from a specific app catalog site
+
+```sh
+m365 spo storageentity get -k AnalyticsId -u https://contoso.sharepoint.com/sites/appcatalog
+```
+
 ## Response
 
 <Tabs>

package/docs/docs/cmd/spo/storageentity/storageentity-list.mdx

@@ -15,18 +15,24 @@ m365 spo storageentity list [options]
 ## Options
 
 ```md definition-list
-`-u, --appCatalogUrl <appCatalogUrl>`
-: URL of the app catalog site
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the app catalog site. If not specified, the tenant app catalog URL will be used.
 ```
 
 <Global />
 
 ## Remarks
 
-Tenant properties are stored in the app catalog site. To list all tenant properties, you have to specify the absolute URL of the app catalog site. If you specify an incorrect URL, or the site at the given URL is not an app catalog site, no properties will be retrieved.
+Tenant properties are stored in the app catalog site. To list all tenant properties, you can specify the absolute URL of the app catalog site. If not specified, the command will automatically resolve the tenant app catalog URL. If you specify an incorrect URL, or the site at the given URL is not an app catalog site, no properties will be retrieved.
 
 ## Examples
 
+List all tenant properties using the tenant app catalog
+
+```sh
+m365 spo storageentity list
+```
+
 List all tenant properties stored in the _https://contoso.sharepoint.com/sites/appcatalog_ app catalog site
 
 ```sh

package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx

@@ -13,8 +13,8 @@ m365 spo storageentity remove [options]
 ## Options
 
 ```md definition-list
-`-u, --appCatalogUrl <appCatalogUrl>`
-: URL of the app catalog site
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the app catalog site. If not specified, the tenant app catalog URL will be used.
 
 `-k, --key <key>`
 : Name of the tenant property to retrieve
@@ -27,7 +27,7 @@ m365 spo storageentity remove [options]
 
 ## Remarks
 
-Tenant properties are stored in the app catalog site associated with that tenant. To remove a property, you have to specify the absolute URL of the app catalog site. If you specify the URL of a site different than the app catalog, you will get an access denied error.
+Tenant properties are stored in the app catalog site associated with that tenant. To remove a property, you can specify the absolute URL of the app catalog site. If not specified, the command will automatically resolve the tenant app catalog URL. If you specify the URL of a site different than the app catalog, you will get an access denied error.
 
 :::info
 
@@ -37,13 +37,13 @@ To use this command you must be either **SharePoint Administrator** or **Global
     
 ## Examples
 
-Remove the _AnalyticsId_ tenant property. Yields a confirmation prompt before actually removing the property
+Remove the _AnalyticsId_ tenant property using the tenant app catalog. Yields a confirmation prompt before actually removing the property
 
 ```sh
-m365 spo storageentity remove -k AnalyticsId -u https://contoso.sharepoint.com/sites/appcatalog
+m365 spo storageentity remove -k AnalyticsId
 ```
 
-Remove the _AnalyticsId_ tenant property. Suppresses the confirmation prompt
+Remove the _AnalyticsId_ tenant property from a specific app catalog. Suppresses the confirmation prompt
 
 ```sh
 m365 spo storageentity remove -k AnalyticsId --force -u https://contoso.sharepoint.com/sites/appcatalog

package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx

@@ -13,8 +13,8 @@ m365 spo storageentity set [options]
 ## Options
 
 ```md definition-list
-`-u, --appCatalogUrl <appCatalogUrl>`
-: URL of the app catalog site
+`-u, --appCatalogUrl [appCatalogUrl]`
+: URL of the app catalog site. If not specified, the tenant app catalog URL will be used.
 
 `-k, --key <key>`
 : Name of the tenant property to retrieve
@@ -33,7 +33,7 @@ m365 spo storageentity set [options]
 
 ## Remarks
 
-Tenant properties are stored in the app catalog site associated with that tenant. To set a property, you have to specify the absolute URL of the app catalog site without a trailing slash. If you specify the URL with trailing slash you get the error `The managed path sites/apps is not a managed path in this tenant.`
+Tenant properties are stored in the app catalog site associated with that tenant. To set a property, you can specify the absolute URL of the app catalog site without a trailing slash. If not specified, the command will automatically resolve the tenant app catalog URL. If you specify the URL with trailing slash you get the error `The managed path sites/apps is not a managed path in this tenant.`
 
 If you specify the URL of a site different than the app catalog, you will get an access denied error.
 
@@ -45,7 +45,13 @@ To use this command you must be either **SharePoint Administrator** or **Global
 
 ## Examples
 
-Set _123_ as the value of the _AnalyticsId_ tenant property. Also include a description and a comment for additional clarification of the usage of the property.
+Set _123_ as the value of the _AnalyticsId_ tenant property using the tenant app catalog
+
+```sh
+m365 spo storageentity set -k AnalyticsId -v 123 -d 'Web analytics ID' -c 'Use on all sites'
+```
+
+Set _123_ as the value of the _AnalyticsId_ tenant property on a specific app catalog site
 
 ```sh
 m365 spo storageentity set -k AnalyticsId -v 123 -d 'Web analytics ID' -c 'Use on all sites' -u https://contoso.sharepoint.com/sites/appcatalog

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/spo/web/web-rule-list.mdx

@@ -12,12 +12,6 @@ Lists all SharePoint list alerts
 m365 spo web rule list [options]
 ```
 
-## Alias
-
-```sh
-m365 spo web alert list
-```
-
 ## Options
 
 ```md definition-list
@@ -47,16 +41,18 @@ m365 spo web alert list
 <Tabs>
   <TabItem value="Delegated">
 
-  | Resource   | Permissions          |
-  |------------|----------------------|
-  | SharePoint | AllSites.FullControl |
+  | Resource        | Permissions          |
+  |-----------------|----------------------|
+  | SharePoint      | AllSites.FullControl |
+  | Microsoft Graph | User.ReadBasic.All   |
 
   </TabItem>
   <TabItem value="Application">
 
-  | Resource   | Permissions           |
-  |------------|-----------------------|
-  | SharePoint | Sites.FullControl.All |
+  | Resource        | Permissions           |
+  |-----------------|-----------------------|
+  | SharePoint      | Sites.FullControl.All |
+  | Microsoft Graph | User.ReadBasic.All    |
 
   </TabItem>
 </Tabs>

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

@@ -12,12 +12,6 @@ Removes an alert from a SharePoint list
 m365 spo web rule remove [options]
 ```
 
-## Alias
-
-```sh
-m365 spo web alert remove
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/teams/app/app-install.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams app install
 
@@ -35,6 +37,25 @@ m365 teams app install [options]
 
 The `id` has to be the ID of the app from the Microsoft Teams App Catalog. Do not use the ID from the manifest of the zip app package. Use the [teams app list](./app-list.mdx) command to get this ID instead.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                                                                                         |
+  |-----------------|---------------------------------------------------------------------------------------------------------------------|
+  | Microsoft Graph | AppCatalog.Submit, TeamsAppInstallation.ReadWriteForTeam, TeamsAppInstallation.ReadWriteForUser, User.ReadBasic.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                                                                                              |
+  |-----------------|--------------------------------------------------------------------------------------------------------------------------|
+  | Microsoft Graph | AppCatalog.Read.All, TeamsAppInstallation.ReadWriteForTeam.All, TeamsAppInstallation.ReadWriteForUser.All, User.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Install an app from the catalog in a Microsoft Teams team

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

@@ -21,6 +21,25 @@ m365 teams app list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions       |
+  |-----------------|-------------------|
+  | Microsoft Graph | AppCatalog.Submit |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | AppCatalog.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List all apps from the Microsoft Teams app catalog

package/docs/docs/cmd/teams/app/app-publish.mdx

@@ -29,6 +29,23 @@ To use this command you must be a Global administrator.
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions              |
+  |-----------------|--------------------------|
+  | Microsoft Graph | AppCatalog.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add the _teams-manifest.zip_ file to the organization's app catalog

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

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams app remove
 
@@ -29,6 +31,23 @@ m365 teams app remove [options]
 
 You can only remove a Teams app as a global administrator.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions              |
+  |-----------------|--------------------------|
+  | Microsoft Graph | AppCatalog.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove the Teams app by ID from the organization's app catalog. Will prompt for confirmation before actually removing the app.

package/docs/docs/cmd/teams/app/app-uninstall.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams app uninstall
 
@@ -30,6 +32,25 @@ m365 teams app uninstall [options]
 The `id` has to be the id the app instance installed in the Microsoft Teams team.
 Do not use the ID from the manifest of the zip app package or the id from the Microsoft Teams App Catalog.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | TeamsAppInstallation.ReadWriteForTeam |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | TeamsAppInstallation.ReadWriteForTeam.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Uninstall an app from a Microsoft Teams team

package/docs/docs/cmd/teams/app/app-update.mdx

@@ -1,4 +1,6 @@
 import Global from '../../_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # teams app update
 
@@ -29,6 +31,23 @@ m365 teams app update [options]
 
 You can only update a Teams app as a global administrator.
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions              |
+  |-----------------|--------------------------|
+  | Microsoft Graph | AppCatalog.ReadWrite.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Update the Teams app with ID _83cece1e-938d-44a1-8b86-918cf6151957_ from file _teams-manifest.zip_

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