@pnp/cli-microsoft365 10.1.0-beta.f17d225 → 10.2.0-beta.1819fcc

package/docs/docs/cmd/entra/roledefinition/roledefinition-list.mdx

@@ -0,0 +1,148 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# entra roledefinition list
+
+Lists all Microsoft Entra ID role definitions.
+
+## Usage
+
+```sh
+m365 entra roledefinition list [options]
+```
+
+## Options
+
+```md definition-list
+`-p, --properties [properties]`
+: Comma-separated list of properties to retrieve.
+
+`-f, --filter [filter]`
+: OData filter to apply when retrieving the role definitions.
+```
+
+<Global />
+
+## Examples
+
+Retrieve all Microsoft Entra ID role definitions
+
+```sh
+m365 entra roledefinition list
+```
+
+Retrieve only the names of the role definitions
+
+```sh
+m365 entra roledefinition list --properties 'displayName'
+```
+
+Retrieve only custom role definitions
+
+```sh
+m365 entra roledefinition list --filter 'isBuiltIn eq false'
+```
+
+## Response
+
+### Standard response
+
+<Tabs>
+  <TabItem value="JSON">
+
+  ```json
+  [
+    {
+      "id": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
+      "description": "Can manage all aspects of the SharePoint service.",
+      "displayName": "SharePoint Administrator",
+      "isBuiltIn": true,
+      "isEnabled": true,
+      "resourceScopes": [
+        "/"
+      ],
+      "templateId": "f28a1f50-f6e7-4571-818b-6a12f2af6b6c",
+      "version": "1",
+      "rolePermissions": [
+        {
+          "allowedResourceActions": [
+            "microsoft.azure.serviceHealth/allEntities/allTasks",
+            "microsoft.azure.supportTickets/allEntities/allTasks",
+            "microsoft.backup/oneDriveForBusinessProtectionPolicies/allProperties/allTasks",
+            "microsoft.backup/oneDriveForBusinessRestoreSessions/allProperties/allTasks",
+            "microsoft.backup/restorePoints/sites/allProperties/allTasks",
+            "microsoft.backup/restorePoints/userDrives/allProperties/allTasks",
+            "microsoft.backup/sharePointProtectionPolicies/allProperties/allTasks",
+            "microsoft.backup/sharePointRestoreSessions/allProperties/allTasks",
+            "microsoft.backup/siteProtectionUnits/allProperties/allTasks",
+            "microsoft.backup/siteRestoreArtifacts/allProperties/allTasks",
+            "microsoft.backup/userDriveProtectionUnits/allProperties/allTasks",
+            "microsoft.backup/userDriveRestoreArtifacts/allProperties/allTasks",
+            "microsoft.directory/groups/hiddenMembers/read",
+            "microsoft.directory/groups.unified/basic/update",
+            "microsoft.directory/groups.unified/create",
+            "microsoft.directory/groups.unified/delete",
+            "microsoft.directory/groups.unified/members/update",
+            "microsoft.directory/groups.unified/owners/update",
+            "microsoft.directory/groups.unified/restore",
+            "microsoft.office365.migrations/allEntities/allProperties/allTasks",
+            "microsoft.office365.network/performance/allProperties/read",
+            "microsoft.office365.serviceHealth/allEntities/allTasks",
+            "microsoft.office365.sharePoint/allEntities/allTasks",
+            "microsoft.office365.supportTickets/allEntities/allTasks",
+            "microsoft.office365.usageReports/allEntities/allProperties/read",
+            "microsoft.office365.webPortal/allEntities/standard/read"
+          ],
+          "condition": null
+        }
+      ],
+      "inheritsPermissionsFrom": [
+        {
+          "id": "88d8e3e3-8f55-4a1e-953a-9b9898b8876b"
+        }
+      ]
+    }
+  ]
+  ```
+
+  </TabItem>
+  <TabItem value="Text">
+
+  ```text
+  id                                    displayName                                    isBuiltIn  isEnabled
+  ------------------------------------  ---------------------------------------------  ---------  ---------
+  f28a1f50-f6e7-4571-818b-6a12f2af6b6c  SharePoint Administrator                       true       true
+  ```
+
+  </TabItem>
+  <TabItem value="CSV">
+
+  ```csv
+  id,description,displayName,isBuiltIn,isEnabled,templateId,version
+  f28a1f50-f6e7-4571-818b-6a12f2af6b6c,Can manage all aspects of the SharePoint service.,SharePoint Administrator,1,1,f28a1f50-f6e7-4571-818b-6a12f2af6b6c,1
+  ```
+
+  </TabItem>
+  <TabItem value="Markdown">
+
+  ```md
+  # entra roledefinition list
+
+  Date: 11/7/2024
+
+  ## SharePoint Administrator (f28a1f50-f6e7-4571-818b-6a12f2af6b6c)
+
+  Property | Value
+  ---------|-------
+  id | f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  description | Can manage all aspects of the SharePoint service.
+  displayName | SharePoint Administrator
+  isBuiltIn | true
+  isEnabled | true
+  templateId | f28a1f50-f6e7-4571-818b-6a12f2af6b6c
+  version | 1
+  ```
+
+  </TabItem>
+</Tabs>

package/docs/docs/cmd/entra/roledefinition/roledefinition-remove.mdx

@@ -0,0 +1,52 @@
+import Global from '/docs/cmd/_global.mdx';
+
+# entra roledefinition remove
+
+Removes a custom Microsoft Entra role definition
+
+## Usage
+
+```sh
+m365 entra roledefinition remove [options]
+```
+
+## Options
+
+```md definition-list
+`-i, --id [id]`
+: The id of the role definition. Specify either `id` or `displayName`, but not both.
+
+`-n, --displayName [displayName]`
+: The name of the role definition. Specify either `id` or `displayName`, but not both.
+
+`-f, --force`
+: Don't prompt for confirmation.
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+When the role definition is removed, all the associated role assignments are deleted.
+
+:::
+
+## Examples
+
+Remove a role definition specified by id without prompting
+
+```sh
+m365 entra roledefinition remove --id 0bed8b86-5026-4a93-ac7d-56750cc099f1 --force
+```
+
+Remove a role definition specified by name and prompt for confirmation
+
+```sh
+m365 entra roledefinition remove --displayName 'Custom Role'
+```
+
+## Response
+
+The command won't return a response on success

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

@@ -29,6 +29,24 @@ m365 graph subscription add [options]
 
 `-s, --clientState [clientState]`
 : The value of the clientState property sent by the service in each notification. The maximum length is 128 characters.
+
+`--lifecycleNotificationUrl [lifecycleNotificationUrl]`
+: The URL of the endpoint that will receive the lifecycle notifications. This URL must use the HTTPS protocol.
+
+`--notificationUrlAppId [notificationUrlAppId]`
+: The app ID that the subscription service can use to generate the validation token. The value allows the client to validate the authenticity of the notification received.
+
+`--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`
+: When set, the change notifications will include the changed resource data.
+
+`--encryptionCertificate [encryptionCertificate]`
+: A base64-encoded representation of a certificate with a public key used to encrypt resource data in change notifications. Required when using `includeResourceData`.
+
+`--encryptionCertificateId [encryptionCertificateId]`
+: A custom app-provided identifier to help identify the certificate needed to decrypt resource data. Required when using `includeResourceData`.
 ```
 
 <Global />
@@ -47,6 +65,13 @@ To subscribe to change notifications of Outlook contacts, events, or messages in
 - Use the corresponding application permission to subscribe to changes of items in a folder or mailbox of any user in the tenant.
 - Do not use the Outlook sharing permissions (Contacts.Read.Shared, Calendars.Read.Shared, Mail.Read.Shared, and their read/write counterparts), as they do not support subscribing to change notifications on items in shared or delegated folders.
 
+:::info
+
+For subscribers whose notification endpoint supports a version lower than the currently recommended version (TLS 1.2), specifying this property by a set timeline allows them to temporarily use their deprecated version of TLS before completing their upgrade to TLS 1.2. 
+For these subscribers, not setting this property per the timeline would result in subscription operations failing.
+
+:::
+
 ## Examples
 
 Create a subscription
@@ -55,16 +80,16 @@ Create a subscription
 m365 graph subscription add --resource "me/mailFolders('Inbox')/messages" --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
-Create a subscription on multiple change types
+Create a subscription on multiple change types and include resource data
 
 ```sh
-m365 graph subscription add --resource groups --changeTypes "updated,deleted" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
+m365 graph subscription add --resource "me/messages" --changeTypes "updated,deleted" --includeResourceData --encryptionCertificate 'Q0xJIGZvciBNaWNyb3NvZnQgMzY1' --encryptionCertificateId 'myCert' --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --expirationDateTime "2016-11-20T18:23:45.935Z" --clientState "secretClientState"
 ```
 
 Create a subscription using the maximum allowed expiration for Group resources
 
 ```sh
-m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient"
+m365 graph subscription add --resource groups --changeTypes "updated" --notificationUrl "https://webhook.azurewebsites.net/api/send/myNotifyClient" --lifecycleNotificationUrl "https://webhook.azurewebsites.net/api/send/lifecycleNotifications"
 ```
 
 Create a subscription for Event Hub location if you are using Key Vault
@@ -79,10 +104,10 @@ Create a subscription for Event Hub location if you are using role-based access
 m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventHub:https://eventHubNamespace.servicebus.windows.net/eventhubname/eventHubName?tenantId=contoso.com"
 ```
 
-Create a subscription for Event Grid Partner Topic.
+Create a subscription for Event Grid Partner Topic and use TLS 1.3
 
 ```sh
-m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --notificationUrl "EventGrid:?azuresubscriptionid=8A8A8A8A-4B4B-4C4C-4D4D-12E12E12E12E&resourcegroup=resourceGroupName&partnertopic=partnerTopicName&location=partnerTopicAzureRegionName"
+m365 graph subscription add --resource user --changeTypes "created,updated,deleted" --latestTLSVersion 'v1_3' --notificationUrl "EventGrid:?azuresubscriptionid=8A8A8A8A-4B4B-4C4C-4D4D-12E12E12E12E&resourcegroup=resourceGroupName&partnertopic=partnerTopicName&location=partnerTopicAzureRegionName"
 ```
 
 ## Response

package/docs/docs/cmd/login.mdx

@@ -15,6 +15,12 @@ m365 login [options]
 ## Options
 
 ```md definition-list
+`--appId [appId]`
+: App ID of the Microsoft Entra application to use for authentication. This option is crucial and should be specified if it isn't defined elsewhere.
+
+`--tenant [tenant]`
+: ID of the tenant from which accounts should authenticate. Use `common` or `organization` for multitenant apps. Defaults to `common` if not specified and if the config value `tenantId` and the environment variable `CLIMICROSOFT365_TENANT` are also not set.
+
 `-t, --authType [authType]`
 : The type of authentication to use. Allowed values `certificate`, `deviceCode`, `password`, `identity`, `browser`, `secret`. Default `deviceCode`
 
@@ -36,12 +42,6 @@ m365 login [options]
 `-s, --secret [secret]`
 : Client Secret of the Microsoft Entra application to use for authentication. Required when `authType` is set to `secret`.
 
-`--appId [appId]`
-: App ID of the Microsoft Entra application to use for authentication. If not specified, use the app specified in the `CLIMICROSOFT365_ENTRAAPPID` environment variable. If the environment variable is not defined, use the multitenant PnP Management Shell app
-
-`--tenant [tenant]`
-: ID of the tenant from which accounts should be able to authenticate. Use `common` or `organization` if the app is multitenant. If not specified, use the tenant specified in the `CLIMICROSOFT365_TENANT` environment variable. If the environment variable is not defined, use `common` as the tenant identifier
-
 `--cloud [cloud]`
 : Cloud to connect to. Allowed values `Public`, `USGov`, `USGovHigh`, `USGovDoD` and `China`. Default `Public`
 
@@ -56,6 +56,20 @@ m365 login [options]
 
 ## Remarks
 
+:::tip
+
+The CLI determines the `appId` and `tenant` values in the following order of precedence:
+
+1. The `appId` or `tenant` option specified during login.
+2. The `clientId` or `tenantId` value set in the configuration.
+3. The `CLIMICROSOFT365_ENTRAAPPID` or `CLIMICROSOFT365_TENANT` environment variable.
+
+For `appId`, it is **required** that at least one of the options is specified during login.
+
+For `tenant`, if none are specified, the CLI will default to `common`.
+
+:::
+
 Using the `login` command you can log in to Microsoft 365.
 
 By default, the `login` command uses device code OAuth flow to log in to Microsoft 365. Alternatively, you can authenticate using a user name and password or certificate, which are convenient for CI/CD scenarios, but which come with their own [limitations](../user-guide/connecting-microsoft-365.mdx). The default `authType` can be configured using `m365 cli config set`. This means you'll be able to run `m365 login` without specifying the `--authType` option.
@@ -78,116 +92,103 @@ When signing in with multiple identities, every signin will be saved as a connec
 
 ## Examples
 
-Log in to Microsoft 365 using the device code
+Log in to Microsoft 365 using the device code.
+
+```sh
+m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548e
+```
+
+Log in to Microsoft 365 using the device code and set the connection name.
 
 ```sh
-m365 login
+m365 login --connectionName 'myworkaccount' --appId 31359c7f-bd7e-475c-86db-fdb8c937548e
 ```
 
-Log in to Microsoft 365 using the device code and set the connection name
+Log in to Microsoft 365 using your own Microsoft Entra application that's restricted only to allow accounts from the specific tenant.
 
 ```sh
-m365 login --connectionName 'myworkaccount'
+m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a
 ```
 
-Log in to Microsoft 365 using the device code in debug mode including detailed debug information in the console output
+Log in to Microsoft 365 using your own Microsoft Entra application and a personal information exchange (.pfx) file.
 
 ```sh
-m365 login --debug
+m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
 ```
 
-Log in to Microsoft 365 using a user name and password
+Log in to Microsoft 365 using a user name and password with `clientId` set in the configuration.
 
 ```sh
 m365 login --authType password --userName user@contoso.com --password pass@word1
 ```
 
-Log in to Microsoft 365 using a PEM certificate
+Log in to Microsoft 365 using a PEM certificate with `clientId` set in the configuration.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pem
 ```
 
-Log in to Microsoft 365 using a PEM certificate. Use the specified thumbprint
+Log in to Microsoft 365 using a PEM certificate with `clientId` set in the configuration. Use the specified thumbprint.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pem  --thumbprint 47C4885736C624E90491F32B98855AA8A7562AF1
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file
+Log in to Microsoft 365 using a personal information exchange (.pfx) file with `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file protected with an empty password
+Log in to Microsoft 365 using a personal information exchange (.pfx) file protected with an empty password and `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx --password
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file not protected with a password
+Log in to Microsoft 365 using a personal information exchange (.pfx) file not protected with a password and `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx
 ```
 
-Log in to Microsoft 365 using a personal information exchange (.pfx) file. Use the specified thumbprint
+Log in to Microsoft 365 using a personal information exchange (.pfx) file. Use the specified thumbprint and `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
 
 ```sh
 m365 login --authType certificate --certificateFile /Users/user/dev/localhost.pfx --thumbprint 47C4885736C624E90491F32B98855AA8A7562AF1 --password 'pass@word1'
 ```
 
-Log in to Microsoft 365 using a certificate from a base64-encoded string
+Log in to Microsoft 365 using a certificate from a base64-encoded string with `CLIMICROSOFT365_ENTRAAPPID` environment variable set.
 
 ```sh
 m365 login --authType certificate --certificateBase64Encoded MIII2QIBAzCCCJ8GCSqGSIb3DQEHAaCCCJAEg...eX1N5AgIIAA== --thumbprint D0C9B442DE249F55D10CDA1A2418952DC7D407A3
 ```
 
-Log in to Microsoft 365 using a system assigned managed identity. Applies to Azure resources with managed identity enabled,
-such as Azure Virtual Machines, Azure App Service or Azure Functions
+Log in to Microsoft 365 using a system assigned managed identity with `clientId` set in the configuration. Applies to Azure resources with managed identity enabled, such as Azure Virtual Machines, Azure App Service or Azure Functions.
 
 ```sh
 m365 login --authType identity
 ```
 
-Log in to Microsoft 365 using managed identity in Azure Cloud Shell. Uses the identity of the current user.
+Log in to Microsoft 365 using managed identity in Azure Cloud Shell with `clientId` set in the configuration. Uses the identity of the current user.
 
 ```sh
 m365 login --authType identity
 ```
 
-Log in to Microsoft 365 using a user-assigned managed identity. Client id or principal id also known as object id value can be specified in the `userName` option. Applies to Azure resources with managed identity enabled, such as Azure Virtual Machines, Azure App Service or Azure Functions
+Log in to Microsoft 365 using a user-assigned managed identity with `clientId` set in the configuration. Client id or principal id also known as object id value can be specified in the `userName` option. Applies to Azure resources with managed identity enabled, such as Azure Virtual Machines, Azure App Service or Azure Functions.
 
 ```sh
 m365 login --authType identity --userName ac9fbed5-804c-4362-a369-21a4ec51109e
 ```
 
-Log in to Microsoft 365 using your own multitenant Microsoft Entra application
-
-```sh
-m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548c
-```
-
-Log in to Microsoft 365 using your own Microsoft Entra application that's restricted only to allow accounts from the specific tenant
-
-```sh
-m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a
-```
-
-Log in to Microsoft 365 using your own Microsoft Entra application and a personal information exchange (.pfx) file
-
-```sh
-m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
-```
-
-Log in to Microsoft 365 using the interactive browser authentication. Uses the identity of the current user.
+Log in to Microsoft 365 using the interactive browser authentication with `clientId` set in the configuration. Uses the identity of the current user.
 
 ```sh
 m365 login --authType browser
 ```
 
-Log in to Microsoft 365 using a client secret.
+Log in to Microsoft 365 using a client secret with `clientId` set in the configuration.
 
 ```sh
 m365 login --authType secret --secret topSeCr3t@007

package/docs/docs/cmd/pp/{chatbot/chatbot-get.mdx → copilot/copilot-get.mdx}

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# pp chatbot get
+# pp copilot get
 
-Get information about the specified chatbot
+Get information about the specified copilot
 
 ## Usage
 
+```sh
+m365 pp copilot get [options]
+```
+
+## Alias
+
 ```sh
 m365 pp chatbot get [options]
 ```
@@ -19,10 +25,10 @@ m365 pp chatbot get [options]
 : The name of the environment.
 
 `-i, --id [id]`
-: The id of the chatbot. Specify either `id` or `name` but not both.
+: The id of the copilot. Specify either `id` or `name` but not both.
 
 `-n, --name [name]`
-: The name of the chatbot. Specify either `id` or `name` but not both.
+: The name of the copilot. Specify either `id` or `name` but not both.
 
 `--asAdmin`
 : Run the command as admin for environments you do not have explicitly assigned permissions to.
@@ -32,28 +38,28 @@ m365 pp chatbot get [options]
 
 ## Examples
 
-Get a specific chatbot in a specific environment based on name.
+Get a specific copilot in a specific environment based on name.
 
 ```sh
-m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Chatbot"
+m365 pp copilot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Copilot"
 ```
 
-Get a specific chatbot in a specific environment based on name as admin.
+Get a specific copilot in a specific environment based on name as admin.
 
 ```sh
-m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Chatbot" --asAdmin
+m365 pp copilot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Copilot" --asAdmin
 ```
 
-Get a specific chatbot in a specific environment based on id.
+Get a specific copilot in a specific environment based on id.
 
 ```sh
-m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893"
+m365 pp copilot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893"
 ```
 
-Get a specific chatbot in a specific environment based on id as admin.
+Get a specific copilot in a specific environment based on id as admin.
 
 ```sh
-m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893" --asAdmin
+m365 pp copilot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893" --asAdmin
 ```
 
 ## Response
@@ -71,7 +77,7 @@ m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd5
     "schemaname": "new_bot_23f5f58697fd43d595eb451c9797a53d",
     "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
     "overwritetime": "1900-01-01T00:00:00Z",
-    "name": "CLI 365 Chatbot",
+    "name": "CLI 365 Copilot",
     "solutionid": "fd140aae-4df4-11dd-bd17-0019b9312238",
     "ismanaged": false,
     "versionnumber": 1421457,
@@ -119,7 +125,7 @@ m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd5
   botid      : 3a081d91-5ea8-40a7-8ac9-abbaa3fcb893
   createdon  : 2022-11-19T10:42:22Z
   modifiedon : 2022-11-19T10:42:24Z
-  name       : CLI 365 Chatbot
+  name       : CLI 365 Copilot
   publishedon: 2022-11-19T10:43:24Z
   ```
 
@@ -128,18 +134,18 @@ m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd5
 
   ```csv
   name,botid,publishedon,createdon,modifiedon
-  CLI 365 Chatbot,3a081d91-5ea8-40a7-8ac9-abbaa3fcb893,2022-11-19T10:43:24Z,2022-11-19T10:42:22Z,2022-11-19T10:42:24Z
+  CLI 365 Copilot,3a081d91-5ea8-40a7-8ac9-abbaa3fcb893,2022-11-19T10:43:24Z,2022-11-19T10:42:22Z,2022-11-19T10:42:24Z
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893"
+  # pp copilot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893"
 
   Date: 9/1/2023
 
-  ## CLI 365 Chatbot
+  ## CLI 365 Copilot
 
   Property | Value
   ---------|-------
@@ -151,7 +157,7 @@ m365 pp chatbot get --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd5
   schemaname | new\_bot\_23f5f58697fd43d595eb451c9797a53d
   \_ownerid\_value | 5fa787c1-1c4d-ed11-bba1-000d3a2caf7f
   overwritetime | 1900-01-01T00:00:00Z
-  name | CLI 365 Chatbot
+  name | CLI 365 Copilot
   solutionid | fd140aae-4df4-11dd-bd17-0019b9312238
   ismanaged | false
   versionnumber | 1445843

package/docs/docs/cmd/pp/{chatbot/chatbot-list.mdx → copilot/copilot-list.mdx}

@@ -2,12 +2,18 @@ import Global from '/docs/cmd/_global.mdx';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-# pp chatbot list
+# pp copilot list
 
-Lists Microsoft Power Platform chatbot in the specified Power Platform environment
+Lists Microsoft Power Platform copilots in the specified Power Platform environment
 
 ## Usage
 
+```sh
+m365 pp copilot list [options]
+```
+
+## Alias
+
 ```sh
 m365 pp chatbot list [options]
 ```
@@ -26,16 +32,16 @@ m365 pp chatbot list [options]
 
 ## Examples
 
-List chatbots in a specific environment.
+List copilots in a specific environment.
 
 ```sh
-m365 pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+m365 pp copilot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
 ```
 
-List chatbots in a specific environment as admin.
+List copilots in a specific environment as admin.
 
 ```sh
-m365 pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --asAdmin
+m365 pp copilot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --asAdmin
 ```
 
 ## Response
@@ -59,7 +65,7 @@ m365 pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd
       "isManaged": false,
       "versionNumber": 1429641,
       "timezoneRuleVersionNumber": 0,
-      "name": "CLI Chatbot",
+      "name": "CLI Copilot",
       "statusCode": 1,
       "owner": "Doe, John",
       "overwriteTime": "1900-01-01T00:00:00Z",
@@ -77,9 +83,9 @@ m365 pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd
   <TabItem value="Text">
 
   ```text
-  name   botid                                 publishedOn           createdOn             botModifiedOn
-  ------------  ------------------------------------  --------------------  --------------------  --------------------
-  CLI Chatbot   23f5f586-97fd-43d5-95eb-451c9797a53d  2022-11-19T19:19:53Z  2022-11-19T10:42:22Z  2022-11-19T20:19:57Z
+   name         botid                                  publishedOn            createdOn              botModifiedOn
+  -----------   ------------------------------------   --------------------   --------------------   --------------------
+  CLI Copilot   23f5f586-97fd-43d5-95eb-451c9797a53d   2022-11-19T19:19:53Z   2022-11-19T10:42:22Z   2022-11-19T20:19:57Z
   ```
 
   </TabItem>
@@ -87,18 +93,18 @@ m365 pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd
 
   ```csv
   name,botid,publishedOn,createdOn,botModifiedOn
-  CLI Chatbot,23f5f586-97fd-43d5-95eb-451c9797a53d,2022-11-19T19:19:53Z,2022-11-19T10:42:22Z,2022-11-19T20:19:57Z
+  CLI Copilot,23f5f586-97fd-43d5-95eb-451c9797a53d,2022-11-19T19:19:53Z,2022-11-19T10:42:22Z,2022-11-19T20:19:57Z
   ```
 
   </TabItem>
   <TabItem value="Markdown">
 
   ```md
-  # pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+  # pp copilot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
 
   Date: 9/1/2023
 
-  ## CLI Chatbot
+  ## CLI Copilot
 
   Property | Value
   ---------|-------
@@ -115,7 +121,7 @@ m365 pp chatbot list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd
   isManaged | false
   versionNumber | 1429641
   timezoneRuleVersionNumber | 0
-  name | CLI Chatbot
+  name | CLI Copilot
   statusCode | 1
   owner | Doe, John
   overwriteTime | 1900-01-01T00:00:00Z