@pnp/cli-microsoft365 11.0.0-beta.88d51e6 → 11.0.0

package/docs/docs/cmd/entra/roleassignment/roleassignment-add.mdx

@@ -0,0 +1,163 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra roleassignment add
+
+Assign a Entra ID role to a user and specify the scope for which the user has been granted access
+
+## Usage
+
+```sh
+m365 entra roleassignment add [options]
+```
+
+## Options
+
+```md definition-list
+`--roleDefinitionId [roleDefinitionId]`
+: Id of a role to be assigned. Specify either `roleDefinitionId` or `roleDefinitionName`, but not both.
+
+`--roleDefinitionName [roleDefinitionName]`
+: Name of a role to be assigned. Specify either `roleDefinitionId` or `roleDefinitionName`, but not both.
+
+`--principal <principal>`
+: Id of a user, group or service principal or user principal name or group mail nickname to which the assignment is granted.
+
+`--userId [userId]`
+: Id of a user to which the assignment is scoped.
+
+`--userName [userName]`
+: User principal name of a user to which the assignment is scoped.
+
+`--administrativeUnitId [administrativeUnitId]`
+: Id of an administrative unit to which the assignment is scoped.
+
+`--administrativeUnitName [administrativeUnitName]`
+: Name of an administrative unit to which the assignment is scoped.
+
+`--applicationId [applicationId]`
+: Id of an application to which the assignment is scoped.
+
+`applicationObjectId [applicationObjectId]`
+: Object Id of an application to which the assignment is scoped.
+
+`--applicationName [applicationName]`
+: Name of an application to which the assignment is scoped.
+
+`--servicePrincipalId [servicePrincipalId]`
+: Id of a service principal to which the assignment is scoped.
+
+`--servicePrincipalName [servicePrincipalName]`
+: Name of a service principal to which the assignment is scoped.
+
+`--groupId [groupId]`
+: Id of a group to which the assignment is scoped.
+
+`--groupName [groupName]`
+: Name of a group to which the assignment is scoped.
+```
+
+<Global />
+
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                        |
+  |-----------------|------------------------------------|
+  | Microsoft Graph | RoleManagement.ReadWrite.Directory |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                        |
+  |-----------------|------------------------------------|
+  | Microsoft Graph | RoleManagement.ReadWrite.Directory |
+
+  </TabItem>
+</Tabs>
+
+## Examples
+
+Assign a role specified by name to a user specified by id and scope the assignment to the whole tenant
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'SharePoint Administrator' --principal 7a2ca997-9461-402e-9882-58088a370889
+```
+
+Assign a role specified by id to a user specified by UPN and scope the assignment to a service principal specified by id
+
+```sh
+m365 entra roleassignment add --roleDefinitionId 777b752-f9b7-4205-a2b1-5db0d6a0ccfc --principal john.doe@contoso.com --servicePrincipalId a4738dd8-fc0f-4646-87fb-47539f5c651b
+```
+
+Assign a role specified by name to a group specified by mail nickname and scope the assignment to an administrative unit specified by name
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'User Administrator' --principal 'contoso-group' --administrativeUnitName 'Marketing'
+```
+
+Assign a role specified by name to a service principal specified by id and scope the assignment to an application specified by id
+
+```sh
+m365 entra roleassignment add --roleDefinitionName 'Application Administrator' --principal ab2ca997-9461-402e-9882-58088a370889 --applicationId 47539fd8-fc0f-4646-87fb-a4738d5c651b
+```
+
+## Response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  {
+    "id": "s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1",
+    "principalId": "3844129d-f748-4c03-8165-4412ee9b4ceb",
+    "directoryScopeId": "/",
+    "roleDefinitionId": "92b086b3-e367-4ef2-b869-1de128fb986e"
+  }
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  directoryScopeId: /
+  id              : s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+  principalId     : 3844129d-f748-4c03-8165-4412ee9b4ceb
+  roleDefinitionId: 92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,principalId,directoryScopeId,roleDefinitionId
+  s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1,3844129d-f748-4c03-8165-4412ee9b4ceb,/,92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra roleassignment add --roleDefinitionId "92b086b3-e367-4ef2-b869-1de128fb986e" --principal "3844129d-f748-4c03-8165-4412ee9b4ceb"
+
+  Date: 7/3/2025
+
+  ## s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+
+  Property | Value
+  ---------|-------
+  id | s4awkmfj8k64aR3hKPuYbhaRP4kk4MZLjphUwkUSlIU-1
+  principalId | 3844129d-f748-4c03-8165-4412ee9b4ceb
+  directoryScopeId | /
+  roleDefinitionId | 92b086b3-e367-4ef2-b869-1de128fb986e
+  ```
+
+  </TabItem>
+</Tabs>
+
+## More information
+
+- https://learn.microsoft.com/graph/api/rbacapplication-post-roleassignments

package/docs/docs/cmd/flow/flow-list.mdx

@@ -21,9 +21,6 @@ m365 flow list [options]
 `--sharingStatus [sharingStatus]`
 : List a specific type of flows. Valid values: `ownedByMe`, `personal`, `sharedWithMe`, `all`. Defaults to `ownedByMe`. Don't specify this option when using asAdmin.
 
-`--includeSolutions`
-: (deprecated. Use option `withSolutions` instead) Include flows from solutions.
-
 `--withSolutions`
 : Include flows from solutions.
 

package/docs/docs/cmd/flow/run/run-get.mdx

@@ -24,9 +24,6 @@ m365 flow run get [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment where the flow is located.
 
-`--includeTriggerInformation`
-: (deprecated. Use option `withTrigger` instead) If specified, include information about the trigger details.
-
 `--withTrigger`
 : If specified, include information about the trigger details.
 

package/docs/docs/cmd/graph/subscription/subscription-add.mdx

@@ -39,9 +39,6 @@ m365 graph subscription add [options]
 `--latestTLSVersion [latestTLSVersion]`
 : The latest version of TLS that the notification endpoint supports. Allowed values are `v1_0`, `v1_1`, `v1_2`, `v1_3`. Default is `v1_2`.
 
-`--includeResourceData`
-: (deprecated. Use option `withResourceData` instead) When set, the change notifications will include the changed resource data.
-
 `--withResourceData`
 : When set, the change notifications will include the changed resource data.
 

package/docs/docs/cmd/pp/copilot/copilot-get.mdx

@@ -12,12 +12,6 @@ Get information about the specified copilot
 m365 pp copilot get [options]
 ```
 
-## Alias
-
-```sh
-m365 pp chatbot get [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/pp/copilot/copilot-list.mdx

@@ -12,12 +12,6 @@ Lists Microsoft Power Platform copilots in the specified Power Platform environm
 m365 pp copilot list [options]
 ```
 
-## Alias
-
-```sh
-m365 pp chatbot list [options]
-```
-
 ## Options
 
 ```md definition-list

package/docs/docs/cmd/pp/copilot/copilot-remove.mdx

@@ -10,12 +10,6 @@ Removes the specified copilot
 m365 pp copilot remove [options]
 ```
 
-## Alias
-
-```sh
-m365 pp chatbot remove [options]
-```
-
 ## Options
 
 ```md definition-list

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

@@ -18,9 +18,6 @@ m365 pp solution publisher list [options]
 `-e, --environmentName <environmentName>`
 : The name of the environment.
 
-`--includeMicrosoftPublishers`
-: (deprecated. Use option `withMicrosoftPublishers` instead) Include the Microsoft Publishers.
-
 `--withMicrosoftPublishers`
 : Include the Microsoft Publishers.
 

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

@@ -18,9 +18,6 @@ m365 purview threatassessment get [options]
 `-i, --id <id>`
 : The Id of the threat assessment.
 
-`--includeResults`
-: (deprecated. Use option `withResults` instead) Include the threat assessment results.
-
 `--withResults`
 : Include the threat assessment results.
 ```

package/docs/docs/cmd/spe/container/container-activate.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spe container activate
 
@@ -19,6 +21,25 @@ m365 spe container activate [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Activates a container.

package/docs/docs/cmd/spe/container/container-add.mdx

@@ -39,6 +39,35 @@ m365 spe container add [options]
 
 <Global />
 
+## Remarks
+
+:::warning
+
+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 | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command only supports application permissions when using the `containerTypeId` option.
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Creates a new container by specifying the container type ID

package/docs/docs/cmd/spe/container/container-get.mdx

@@ -21,6 +21,25 @@ m365 spe container get [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Gets a container of a specific type.
@@ -89,4 +108,4 @@ m365 spe container get --id "b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDE
   ```
 
   </TabItem>
-</Tabs>
+</Tabs>

package/docs/docs/cmd/spe/container/container-list.mdx

@@ -24,6 +24,35 @@ m365 spe container list [options]
 
 <Global />
 
+## Remarks
+
+:::warning
+
+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 | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command only supports application permissions when using the `containerTypeId` option.
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List containers of a specific type by id.

package/docs/docs/cmd/spe/container/container-permission-list.mdx

@@ -21,6 +21,25 @@ m365 spe container permission list [options]
 
 <Global />
 
+## Permissions
+
+<Tabs>
+  <TabItem value="Delegated">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Lists Container permissions.

package/docs/docs/cmd/spe/container/container-recyclebinitem-list.mdx

@@ -24,6 +24,35 @@ m365 spe container recyclebinitem list [options]
 
 <Global />
 
+## Remarks
+
+:::warning
+
+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 | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command only supports application permissions when using the `containerTypeId` option.
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 List deleted containers of a specific container type specified by id.

package/docs/docs/cmd/spe/container/container-recyclebinitem-restore.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spe container recyclebinitem restore
 
@@ -28,6 +30,35 @@ m365 spe container recyclebinitem restore [options]
 
 <Global />
 
+## Remarks
+
+:::warning
+
+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 | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command only supports application permissions when using the `containerTypeId` option.
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Restore a deleted container by ID.

package/docs/docs/cmd/spe/container/container-remove.mdx

@@ -1,4 +1,6 @@
 import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
 
 # spe container remove
 
@@ -34,6 +36,35 @@ m365 spe container remove [options]
 
 <Global />
 
+## Remarks
+
+:::warning
+
+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 | FileStorageContainer.Selected, FileStorageContainerType.Manage.All |
+
+  </TabItem>
+  <TabItem value="Application">
+
+  This command only supports application permissions when **not** using the `containerTypeName` option.
+
+  | Resource        | Permissions                   |
+  |-----------------|-------------------------------|
+  | Microsoft Graph | FileStorageContainer.Selected |
+
+  </TabItem>
+</Tabs>
+
 ## Examples
 
 Remove a container by ID.