@pnp/cli-microsoft365 10.9.0-beta.bc13e90 → 10.10.0-beta.1bb5ba0

package/docs/docs/cmd/planner/task/task-checklistitem-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # planner task checklistitem remove
 
@@ -25,6 +27,25 @@ m365 planner task checklistitem remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a checklist item with the id _40012_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_

package/docs/docs/cmd/planner/task/task-get.mdx

@@ -45,6 +45,33 @@ m365 planner task get [options]
 
 <Global />
 
+## Remarks
+
+:::warning
+
+When using `rosterId`, the command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+:::
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Returns the Microsoft Planner task by id.

package/docs/docs/cmd/planner/task/task-list.mdx

@@ -53,6 +53,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                      |
+  |-----------------|----------------------------------|
+  | Microsoft Graph | Tasks.Read, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                          |
+  |-----------------|--------------------------------------|
+  | Microsoft Graph | Tasks.Read.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List tasks for the currently logged in user.

package/docs/docs/cmd/planner/task/task-reference-add.mdx

@@ -30,6 +30,25 @@ m365 planner task reference add [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Add a new reference with the url _https://www.microsoft.com_ to a Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_

package/docs/docs/cmd/planner/task/task-reference-list.mdx

@@ -21,6 +21,25 @@ m365 planner task reference list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | Tasks.Read  |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions    |
+  |-----------------|----------------|
+  | Microsoft Graph | Tasks.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Retrieve the references of the specified planner task

package/docs/docs/cmd/planner/task/task-reference-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # planner task reference remove
 
@@ -28,6 +30,25 @@ m365 planner task reference remove [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions     |
+  |-----------------|-----------------|
+  | Microsoft Graph | Tasks.ReadWrite |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions         |
+  |-----------------|---------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes a reference with the url _https://www.microsoft.com_ from the Planner task with the id _2Vf8JHgsBUiIf-nuvBtv-ZgAAYw2_

package/docs/docs/cmd/planner/task/task-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # planner task remove
 
@@ -54,6 +56,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                           |
+  |-----------------|---------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                               |
+  |-----------------|-------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Removes the Microsoft Planner task by ID.

package/docs/docs/cmd/planner/task/task-set.mdx

@@ -100,6 +100,25 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 :::
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                                      |
+  |-----------------|--------------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite, GroupMember.Read.All, User.Read |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                                              |
+  |-----------------|----------------------------------------------------------|
+  | Microsoft Graph | Tasks.ReadWrite.All, GroupMember.Read.All, User.Read.All |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Updates a Microsoft Planner task name of the specified task by ID.

package/docs/docs/cmd/planner/tenant/tenant-settings-list.mdx

@@ -18,13 +18,30 @@ m365 planner tenant settings list [options]
 
 ## Remarks
 
-:::info
+After executing the command `planner tenant settings set`, it can take some time for all changes to propagate across the tenant. Because of this, executing this command right away can return some unexpected results.
 
-To use this command you must be a global administrator.
+## Permissions
 
-:::
+<Tabs>
+  <TabItem value="Delegated">
 
-After executing the command `planner tenant settings set`, it can take some time for all changes to propagate across the tenant. Because of this, executing this command right away can return some unexpected results.
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | email       |
+
+  :::info
+
+  To use this command you must be a **global administrator**.
+
+  :::
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
 
 ## Examples
 
@@ -47,7 +64,17 @@ m365 planner tenant settings list
     "allowTenantMoveWithDataLoss": false,
     "allowTenantMoveWithDataMigration": false,
     "allowRosterCreation": true,
-    "allowPlannerMobilePushNotifications": true
+    "allowPlannerMobilePushNotifications": true,
+    "allowFileRecommendations": true,
+    "enforceClientLicenseCheck": false,
+    "allowDataFlowToDataverse": true,
+    "allowPlannerCopilot": true,
+    "disallowedSharedWithContainerTypes": [
+      {
+        "hostContainerType": "group",
+        "sharedWithContainerType": "roster"
+      }
+    ]
   }
   ```
 
@@ -56,10 +83,16 @@ m365 planner tenant settings list
 
   ```txt
   allowCalendarSharing               : true
+  allowDataFlowToDataverse           : true
+  allowFileRecommendations           : true
+  allowPlannerCopilot                : true
   allowPlannerMobilePushNotifications: true
   allowRosterCreation                : true
   allowTenantMoveWithDataLoss        : false
   allowTenantMoveWithDataMigration   : false
+  disallowedSharedWithContainerTypes : [{"hostContainerType":"group","sharedWithContainerType":"roster"}]
+  enforceClientLicenseCheck          : false
+  id                                 : 1
   isPlannerAllowed                   : true
   ```
 
@@ -67,8 +100,8 @@ m365 planner tenant settings list
   <TabItem value="CSV">
 
   ```csv
-  isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications
-  1,1,,,1,1
+  id,isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications,allowFileRecommendations,enforceClientLicenseCheck,allowDataFlowToDataverse,allowPlannerCopilot
+  1,1,1,0,0,1,1,1,0,1,1
   ```
 
   </TabItem>
@@ -90,6 +123,10 @@ m365 planner tenant settings list
   allowTenantMoveWithDataMigration | false
   allowRosterCreation | true
   allowPlannerMobilePushNotifications | true
+  allowFileRecommendations | true
+  enforceClientLicenseCheck | false
+  allowDataFlowToDataverse | true
+  allowPlannerCopilot | true
   ```
 
   </TabItem>

package/docs/docs/cmd/planner/tenant/tenant-settings-set.mdx

@@ -36,13 +36,28 @@ m365 planner tenant settings set [options]
 
 <Global />
 
-## Remarks
+## Permissions
 
-:::info
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions |
+  |-----------------|-------------|
+  | Microsoft Graph | email       |
+
+  :::info
 
-To use this command you must be a global administrator.
+  To use this command you must be a **global administrator**.
 
-:::
+  :::
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command does not support application permissions.
+
+  </TabItem>
+</Tabs>
 
 ## Examples
 
@@ -77,7 +92,17 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
     "allowTenantMoveWithDataLoss": false,
     "allowTenantMoveWithDataMigration": false,
     "allowRosterCreation": true,
-    "allowPlannerMobilePushNotifications": true
+    "allowPlannerMobilePushNotifications": true,
+    "allowFileRecommendations": true,
+    "enforceClientLicenseCheck": false,
+    "allowDataFlowToDataverse": true,
+    "allowPlannerCopilot": true,
+    "disallowedSharedWithContainerTypes": [
+      {
+        "hostContainerType": "group",
+        "sharedWithContainerType": "roster"
+      }
+    ]
   }
   ```
 
@@ -86,10 +111,16 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
 
   ```txt
   allowCalendarSharing               : true
+  allowDataFlowToDataverse           : true
+  allowFileRecommendations           : true
+  allowPlannerCopilot                : true
   allowPlannerMobilePushNotifications: true
   allowRosterCreation                : true
   allowTenantMoveWithDataLoss        : false
   allowTenantMoveWithDataMigration   : false
+  disallowedSharedWithContainerTypes : [{"hostContainerType":"group","sharedWithContainerType":"roster"}]
+  enforceClientLicenseCheck          : false
+  id                                 : 1
   isPlannerAllowed                   : true
   ```
 
@@ -97,15 +128,15 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
   <TabItem value="CSV">
 
   ```csv
-  isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications
-  1,1,,,1,1
+  id,isPlannerAllowed,allowCalendarSharing,allowTenantMoveWithDataLoss,allowTenantMoveWithDataMigration,allowRosterCreation,allowPlannerMobilePushNotifications,allowFileRecommendations,enforceClientLicenseCheck,allowDataFlowToDataverse,allowPlannerCopilot
+  1,1,1,0,0,1,1,1,0,1,1
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # planner tenant settings list
+  # planner tenant settings set --isPlannerAllowed true
 
   Date: 4/2/2023
 
@@ -120,6 +151,10 @@ m365 planner tenant settings set --isPlannerAllowed true --allowRosterCreation f
   allowTenantMoveWithDataMigration | false
   allowRosterCreation | true
   allowPlannerMobilePushNotifications | true
+  allowFileRecommendations | true
+  enforceClientLicenseCheck | false
+  allowDataFlowToDataverse | true
+  allowPlannerCopilot | true
   ```
 
   </TabItem>

package/docs/docs/cmd/pp/solution/solution-publisher-list.mdx

@@ -16,10 +16,13 @@ m365 pp solution publisher list [options]
 
 ```md definition-list
 `-e, --environmentName <environmentName>`
-: The name of the environment
+: The name of the environment.
 
 `--includeMicrosoftPublishers`
-: Include the Microsoft Publishers
+: (deprecated. Use option `withMicrosoftPublishers` instead) Include the Microsoft Publishers.
+
+`--withMicrosoftPublishers`
+: Include the Microsoft Publishers.
 
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -29,13 +32,13 @@ m365 pp solution publisher list [options]
 
 ## Examples
 
-List all publishers in a specific environment
+List all publishers in a specific environment.
 
 ```sh
 m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
 ```
 
-List all publishers in a specific environment as Admin
+List all publishers in a specific environment as Admin.
 
 ```sh
 m365 pp solution publisher list --environmentName "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin

package/docs/docs/cmd/purview/threatassessment/threatassessment-get.mdx

@@ -19,6 +19,9 @@ m365 purview threatassessment get [options]
 : The Id of the threat assessment.
 
 `--includeResults`
+: (deprecated. Use option `withResults` instead) Include the threat assessment results.
+
+`--withResults`
 : Include the threat assessment results.
 ```
 
@@ -35,7 +38,7 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 Get a threat assessment including results.
 
 ```sh
-m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults
+m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --withResults
 ```
 
 ## Response
@@ -118,9 +121,9 @@ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --in
   </TabItem>
 </Tabs>
 
-### `includeResults` response
+### `withResults` response
 
-When we make use of the option `includeResults` the response will differ. 
+When we make use of the option `withResults` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -184,7 +187,7 @@ When we make use of the option `includeResults` the response will differ.
   <TabItem value="Markdown">
 
   ```md
-  # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --includeResults "true"
+  # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --withResults "true"
 
   Date: 25/02/2023
 

package/docs/docs/cmd/spo/file/file-move.mdx

@@ -34,6 +34,9 @@ m365 spo file move [options]
 : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
 
 `--includeItemPermissions`
+: (deprecated. Use option `withItemPermissions` instead) Ensure that item-level permissions are preserved during the move.
+
+`--withItemPermissions`
 : Ensure that item-level permissions are preserved during the move.
 
 `--bypassSharedLock`
@@ -75,7 +78,7 @@ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sou
 Move a file referenced by its ID to another document library and retain item-level permissions.
 
 ```sh
-m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
+m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --withItemPermissions
 ```
 
 ## Response

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

@@ -25,6 +25,9 @@ m365 spo hubsite get [options]
 : URL of the hub site. Specify either `id`, `title`, or `url` but not multiple.
 
 `--includeAssociatedSites`
+: (deprecated. Use option `withAssociatedSites` instead) Include the associated sites in the result (only in JSON output).
+
+`--withAssociatedSites`
 : Include the associated sites in the result (only in JSON output)
 ```
 
@@ -53,7 +56,7 @@ m365 spo hubsite get --url 'https://contoso.sharepoint.com/sites/HubSite'
 Get information about the hub site with specific ID, including its associated sites. Associated site info is only shown in JSON output.
 
 ```sh
-m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociatedSites --output json
+m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --withAssociatedSites --output json
 ```
 
 ## Response
@@ -147,9 +150,9 @@ m365 spo hubsite get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --includeAssociat
   </TabItem>
 </Tabs>
 
-### `includeAssociatedSites` response
+### `withAssociatedSites` response
 
-When we make use of the option `includeAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
+When we make use of the option `withAssociatedSites` the response will differ. This command can only be executed using --output json or an error will be thrown.
 
 <Tabs>
   <TabItem value="JSON">

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

@@ -16,6 +16,9 @@ m365 spo hubsite list [options]
 
 ```md definition-list
 `-i, --includeAssociatedSites`
+: (deprecated. Use option `withAssociatedSites` instead) Include the associated sites in the result (only in JSON output).
+
+`--withAssociatedSites`
 : Include the associated sites in the result (only in JSON output).
 ```
 
@@ -36,7 +39,7 @@ m365 spo hubsite list
 List hub sites, including their associated sites, in the current tenant. Associated site info is only shown in JSON output.
 
 ```sh
-m365 spo hubsite list --includeAssociatedSites --output json
+m365 spo hubsite list --withAssociatedSites --output json
 ```
 
 ## Response
@@ -119,9 +122,9 @@ m365 spo hubsite list --includeAssociatedSites --output json
   </TabItem>
 </Tabs>
 
-### `includeAssociatedSites` response
+### `withAssociatedSites` response
 
-When we make use of the option `includeAssociatedSites` the response will differ. 
+When we make use of the option `withAssociatedSites` the response will differ. 
 
 <Tabs>
   <TabItem value="JSON">
@@ -176,7 +179,7 @@ When we make use of the option `includeAssociatedSites` the response will differ
   <TabItem value="Markdown">
 
   ```md
-  # spo hubsite list --includeAssociatedSites "true"
+  # spo hubsite list --withAssociatedSites "true"
 
   Date: 2/20/2023
 

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

@@ -127,7 +127,7 @@ m365 spo list add [options]
 : Boolean value that specifies whether the list is hidden. Valid values are `true`, `false`.
 
 `--includedInMyFilesScope [includedInMyFilesScope]`
-: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string “myfiles” by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
+: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string "myfiles" by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
 
 `--irmEnabled [irmEnabled]`
 : Gets or sets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list.

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

@@ -14,7 +14,7 @@ m365 spo list set [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the site
+: URL of the site.
 
 `--id [id]`
 : ID of the list. Specify either `id`, `title`, or `url` but not multiple.
@@ -128,7 +128,7 @@ m365 spo list set [options]
 : Boolean value that specifies whether the list is hidden. Valid values are `true`, `false`.
 
 `--includedInMyFilesScope [includedInMyFilesScope]`
-: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string “myfiles” by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
+: Specifies whether this list is accessible to an app principal that has been granted an OAuth scope that contains the string "myfiles" by a case-insensitive comparison when the current user is a site collection administrator of the personal site that contains the list.
 
 `--irmEnabled [irmEnabled]`
 : Gets or sets a Boolean value that specifies whether Information Rights Management (IRM) is enabled for the list.