@pnp/cli-microsoft365 6.1.0-beta.a927083 → 6.1.0-beta.d3a109a

package/docs/docs/cmd/cli/cli-doctor.md

@@ -23,3 +23,53 @@ Retrieve diagnostic information
 ```sh
 m365 cli doctor
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "os": {
+        "platform": "win32",
+        "version": "Windows 10 Pro",
+        "release": "10.0.19045"
+      },
+      "cliVersion": "6.1.0",
+      "nodeVersion": "v16.13.0",
+      "cliAadAppId": "31359c7f-bd7e-475c-86db-fdb8c937548e",
+      "cliAadAppTenant": "common",
+      "authMode": "DeviceCode",
+      "cliEnvironment": "",
+      "cliConfig": {
+        "output": "json",
+        "showHelpOnFailure": false
+      },
+      "roles": [],
+      "scopes": [
+        "AllSites.FullControl"
+      ]
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    authMode       : DeviceCode
+    cliAadAppId    : 31359c7f-bd7e-475c-86db-fdb8c937548e
+    cliAadAppTenant: common
+    cliConfig      : {"output":"json","showHelpOnFailure":false}
+    cliEnvironment :
+    cliVersion     : 6.1.0
+    nodeVersion    : v16.13.0
+    os             : {"platform":"win32","version":"Windows 10 Pro","release":"10.0.19045"}
+    roles          : []
+    scopes         : ["AllSites.FullControl"]
+    ```
+
+=== "CSV"
+
+    ```csv
+    os,cliVersion,nodeVersion,cliAadAppId,cliAadAppTenant,authMode,cliEnvironment,cliConfig,roles,scopes
+    "{""platform"":""win32"",""version"":""Windows 10 Pro"",""release"":""10.0.19045""}",6.1.0,v16.13.0,31359c7f-bd7e-475c-86db-fdb8c937548e,common,DeviceCode,,"{""output"":""json"",""showHelpOnFailure"":false}",[],"[""AllSites.FullControl""]"
+    ```

package/docs/docs/cmd/cli/cli-issue.md

@@ -32,3 +32,23 @@ Suggest a new command
 ```sh
 m365 cli issue --type command
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "https://aka.ms/cli-m365/new-command"
+    ```
+
+=== "Text"
+
+    ```text
+    https://aka.ms/cli-m365/new-command
+    ```
+
+=== "CSV"
+
+    ```csv
+    https://aka.ms/cli-m365/new-command
+    ```

package/docs/docs/cmd/cli/cli-reconsent.md

@@ -20,6 +20,26 @@ Get the URL to open in the browser to re-consent CLI for Microsoft 365 permissio
 m365 cli reconsent
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    "To re-consent the PnP Microsoft 365 Management Shell Azure AD application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent"
+    ```
+
+=== "Text"
+
+    ```text
+    To re-consent the PnP Microsoft 365 Management Shell Azure AD application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
+    ```
+
+=== "CSV"
+
+    ```csv
+    To re-consent the PnP Microsoft 365 Management Shell Azure AD application navigate in your web browser to https://login.microsoftonline.com/common/oauth2/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&prompt=admin_consent
+    ```
+
 ## More information
 
 - Re-consent the PnP Microsoft 365 Management Shell Azure AD application: [https://pnp.github.io/cli-microsoft365/user-guide/connecting-office-365/#re-consent-the-pnp-office-365-management-shell-azure-ad-application](https://pnp.github.io/cli-microsoft365/user-guide/connecting-office-365/#re-consent-the-pnp-office-365-management-shell-azure-ad-application)

package/docs/docs/cmd/cli/completion/completion-clink-update.md

@@ -24,9 +24,13 @@ This commands updates the list of commands and their options used by command com
 Write the list of commands for Clink (cmder) command completion to a file named `m365.lua` in the current directory
 
 ```powershell
-cli completion clink update > m365.lua
+m365 cli completion clink update > m365.lua
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

package/docs/docs/cmd/cli/completion/completion-pwsh-setup.md

@@ -26,9 +26,13 @@ If the specified profile path doesn't exist, the CLI will try to create it.
 Set up command completion for PowerShell using the profile from the profile variable
 
 ```powershell
-cli completion pwsh setup --profile $profile
+m365 cli completion pwsh setup --profile $profile
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

package/docs/docs/cmd/cli/completion/completion-pwsh-update.md

@@ -21,9 +21,13 @@ This commands updates the list of commands and their options used by command com
 Update list of commands for PowerShell command completion
 
 ```powershell
-cli completion pwsh update
+m365 cli completion pwsh update
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

package/docs/docs/cmd/cli/completion/completion-sh-setup.md

@@ -17,9 +17,29 @@ m365 cli completion sh setup [options]
 Set up command completion for Zsh, Bash or Fish
 
 ```powershell
-cli completion sh setup
+m365 cli completion sh setup
 ```
 
+## Response
+
+=== "JSON"
+
+    ```json
+    "Command completion successfully registered. Restart your shell to load the completion"
+    ```
+
+=== "Text"
+
+    ```text
+    Command completion successfully registered. Restart your shell to load the completion
+    ```
+
+=== "CSV"
+
+    ```csv
+    Command completion successfully registered. Restart your shell to load the completion
+    ```
+
 ## More information
 
 - Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

package/docs/docs/cmd/cli/completion/completion-sh-update.md

@@ -24,6 +24,10 @@ Update list of commands for Zsh, Bash and Fish command completion
 m365 cli completion sh update
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - Command completion: [https://pnp.github.io/cli-microsoft365/user-guide/completion/](https://pnp.github.io/cli-microsoft365/user-guide/completion/)

package/docs/docs/cmd/cli/config/config-get.md

@@ -29,6 +29,28 @@ Get the output configured for CLI for Microsoft 365
 m365 cli config get --key output
 ```
 
+## Response
+
+When retrieving the `output` key, responses will look like this:
+
+=== "JSON"
+
+    ```json
+    "json"
+    ```
+
+=== "Text"
+
+    ```text
+    json
+    ```
+
+=== "CSV"
+
+    ```csv
+    json
+    ```
+
 ## More information
 
 - [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.md)

package/docs/docs/cmd/cli/config/config-reset.md

@@ -31,6 +31,10 @@ Reset all configuration settings to default
 m365 cli config reset
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.md)

package/docs/docs/cmd/cli/config/config-set.md

@@ -34,6 +34,10 @@ Configure the default CLI output to JSON
 m365 cli config set --key output --value json
 ```
 
+## Response
+
+The command won't return a response on success.
+
 ## More information
 
 - [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.md)

package/docs/docs/cmd/context/context-init.md

@@ -0,0 +1,25 @@
+# context init
+
+Initiates CLI for Microsoft 365 context in the current working folder
+
+## Usage
+
+```sh
+m365 context init [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Initiates CLI for Microsoft 365 context in the current working folder
+
+```sh
+m365 context init
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/context/context-remove.md

@@ -0,0 +1,34 @@
+# context remove
+
+Removes the CLI for Microsoft 365 context in the current working folder
+
+## Usage
+
+```sh
+m365 context remove [options]
+```
+
+## Options
+
+`--confirm`
+: Don't prompt for confirmation to remove the context
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the CLI for Microsoft 365 context in the current working folder
+
+```sh
+m365 context remove
+```
+
+Removes the CLI for Microsoft 365 context in the current working folder and does not prompt for confirmation before deleting.
+
+```sh
+m365 context remove --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/chatbot/chatbot-get.md

@@ -0,0 +1,123 @@
+# pp chatbot get
+
+Get information about the specified chatbot
+
+## Usage
+
+```sh
+pp chatbot get [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i, --id [id]`
+: The id of the chatbot. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the chatbot. Specify either `id` or `name` but not both.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Get a specific chatbot in a specific environment based on name
+
+```sh
+m365 pp chatbot get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Chatbot"
+```
+
+Get a specific chatbot in a specific environment based on name as admin
+
+```sh
+m365 pp chatbot get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Chatbot" --asAdmin
+```
+
+Get a specific chatbot in a specific environment based on id
+
+```sh
+m365 pp chatbot get --environment "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
+
+```sh
+m365 pp chatbot get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "authenticationtrigger": 0,
+      "_owningbusinessunit_value": "6da087c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "statuscode": 1,
+      "createdon": "2022-11-19T10:42:22Z",
+      "statecode": 0,
+      "schemaname": "new_bot_23f5f58697fd43d595eb451c9797a53d",
+      "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "overwritetime": "1900-01-01T00:00:00Z",
+      "name": "CLI 365 Chatbot",
+      "solutionid": "fd140aae-4df4-11dd-bd17-0019b9312238",
+      "ismanaged": false,
+      "versionnumber": 1421457,
+      "language": 1033,
+      "_modifiedby_value": "5f91d7a7-5f46-494a-80fa-5c18b0221351",
+      "_modifiedonbehalfby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "modifiedon": "2022-11-19T10:42:24Z",
+      "componentstate": 0,
+      "botid": "3a081d91-5ea8-40a7-8ac9-abbaa3fcb893",
+      "_createdby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "componentidunique": "cdcd6496-e25d-4ad1-91cf-3f4d547fdd23",
+      "authenticationmode": 1,
+      "_owninguser_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+      "accesscontrolpolicy": 0,
+      "runtimeprovider": 0,
+      "_publishedby_value": "John Doe",
+      "authenticationconfiguration": null,
+      "authorizedsecuritygroupids": null,
+      "overriddencreatedon": null,
+      "applicationmanifestinformation": null,
+      "importsequencenumber": null,
+      "synchronizationstatus": null,
+      "template": null,
+      "_providerconnectionreferenceid_value": null,
+      "configuration": null,
+      "utcconversiontimezonecode": null,
+      "publishedon": "2022-11-19T10:43:24Z",
+      "_createdonbehalfby_value": null,
+      "iconbase64": null,
+      "supportedlanguages": null,
+      "_owningteam_value": null,
+      "timezoneruleversionnumber": null,
+      "iscustomizable": {
+        "Value": true,
+        "CanBeChanged": true,
+        "ManagedPropertyLogicalName": "iscustomizableanddeletable"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    botid      : 3a081d91-5ea8-40a7-8ac9-abbaa3fcb893
+    createdon  : 2022-11-19T10:42:22Z
+    modifiedon : 2022-11-19T10:42:24Z
+    name       : CLI 365 Chatbot
+    publishedon: 2022-11-19T10:43:24Z
+    ```
+
+=== "CSV"
+
+    ```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
+    ```

package/docs/docs/cmd/pp/chatbot/chatbot-remove.md

@@ -0,0 +1,52 @@
+# pp chatbot remove
+
+Removes the specified chatbot
+
+## Usage
+
+```sh
+m365 pp chatbot remove [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i, --id [id]`
+: The id of the chatbot. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the chatbot. Specify either `id` or `name` but not both.
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes the specified Microsoft Power Platform chatbot owned by the currently signed-in user based on name
+
+```sh
+m365 pp chatbot remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Chatbot Name"
+```
+
+Removes the specified Microsoft Power Platform chatbot owned by the currently signed-in user based on id without confirmation
+
+```sh
+m365 pp chatbot remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 9d9a13d0-6255-ed11-bba2-000d3adf774e --confirm
+```
+
+Removes the specified Microsoft Power Platform chatbot owned by another user based on name
+
+```sh
+m365 pp chatbot remove --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name "Chatbot Name" --asAdmin
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-list.md

@@ -0,0 +1,90 @@
+# pp dataverse table row list
+
+Lists table rows for the given Dataverse table
+
+## Usage
+
+```sh
+pp dataverse table row list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment
+
+`--entitySetName [entitySetName]`
+: The entity set name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--tableName [tableName]`
+: The name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all table rows for the given environment based on the entity set name
+
+```sh
+m365 pp dataverse table row list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts"
+```
+
+List all table rows for the given environment based on the table name
+
+```sh
+m365 pp dataverse table row list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "cr6c3_account"
+```
+
+List all table rows for the given environment based on the entity set name as Admin
+
+```sh
+m365 pp dataverse table row list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "cr6c3_accountsid": "95c80273-3764-ed11-9561-000d3a4bbea4",
+        "_owningbusinessunit_value": "6da087c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "statecode": 0,
+        "statuscode": 1,
+        "_createdby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_ownerid_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "modifiedon": "2022-11-14T16:14:45Z",
+        "_owninguser_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "_modifiedby_value": "5fa787c1-1c4d-ed11-bba1-000d3a2caf7f",
+        "versionnumber": 1413873,
+        "createdon": "2022-11-14T16:14:45Z",
+        "cr6c3_name": "Column1 value",
+        "overriddencreatedon": null,
+        "importsequencenumber": null,
+        "_modifiedonbehalfby_value": null,
+        "utcconversiontimezonecode": null,
+        "_createdonbehalfby_value": null,
+        "_owningteam_value": null,
+        "timezoneruleversionnumber": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    cr6c3_accountsid                       _owningbusinessunit_value             statecode  statuscode  _createdby_value                      _ownerid_value                        modifiedon            _owninguser_value                     _modifiedby_value                     versionnumber  createdon             cr6c3_name      overriddencreatedon  importsequencenumber  _modifiedonbehalfby_value  utcconversiontimezonecode  _createdonbehalfby_value  _owningteam_value  timezoneruleversionnumber
+    ------------------------------------  ------------------------------------  ---------  ----------  ------------------------------------  ------------------------------------  --------------------  ------------------------------------  ------------------------------------  -------------  --------------------  ----------      -------------------  --------------------  -------------------------  -------------------------  ------------------------  -----------------  -------------------------
+    95c80273-3764-ed11-9561-000d3a4bbea4  6da087c1-1c4d-ed11-bba1-000d3a2caf7f  0          1           5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  2022-11-14T16:14:45Z  5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  5fa787c1-1c4d-ed11-bba1-000d3a2caf7f  1413873        2022-11-14T16:14:45Z  Column1 value   null                 null                  null                       null                       null                      null               null
+    ```
+
+=== "CSV"
+
+    ```csv
+    cr6c3_accountsid,_owningbusinessunit_value,statecode,statuscode,_createdby_value,_ownerid_value,modifiedon,_owninguser_value,_modifiedby_value,versionnumber,createdon,cr6c3_name,overriddencreatedon,importsequencenumber,_modifiedonbehalfby_value,utcconversiontimezonecode,_createdonbehalfby_value,_owningteam_value,timezoneruleversionnumber
+    95c80273-3764-ed11-9561-000d3a4bbea4,6da087c1-1c4d-ed11-bba1-000d3a2caf7f,0,1,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,2022-11-14T16:14:45Z,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,5fa787c1-1c4d-ed11-bba1-000d3a2caf7f,1413873,2022-11-14T16:14:45Z,Column1 value,,,,,,,
+    ```

package/docs/docs/cmd/pp/dataverse/dataverse-table-row-remove.md

@@ -0,0 +1,61 @@
+# pp dataverse table row remove
+
+Removes a row from a dataverse table in a given environment.
+
+## Usage
+
+```sh
+pp dataverse table row remove [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment to remove a row from a table from.
+
+`-i, --id <id>`
+: The id of the row to remove.
+
+`--entitySetName [entitySetName]`
+: The entity set name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--tableName [tableName]`
+: The name of the table. Specify either `entitySetName` or `tableName` but not both
+
+`--confirm`
+: Don't prompt for confirmation
+
+`--asAdmin`
+: Set, to remove the row from the dataverse table as admin for environments you are not a member of.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Removes a row from a dataverse table in a given environment
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4"
+```
+
+Removes a row from a dataverse table in a given environment as Admin
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --asAdmin
+```
+
+Removes a row from a dataverse table in a given environment without prompting for confirmation
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --tableName "aadusers" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --confirm
+```
+
+Removes a row from a dataverse table in a given environment based on the entity set name without prompting for confirmation
+
+```sh
+m365 pp dataverse table row remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --entitySetName "cr6c3_accounts" --id "21d01cf4-356c-ed11-9561-000d3a4bbea4" --confirm
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/pp/environment/environment-get.md

@@ -10,11 +10,13 @@ m365 pp environment get [options]
 
 ## Options
 
-`-n, --name <name>`
-: The name of the environment to get information about
+`-n, --name [name]`
+: The name of the environment. When not specified, the default environment is retrieved.
 
 `--asAdmin`
-: Run the command as admin and retrieve details of environments you do not have explicitly assigned permissions to
+: Run the command as admin and retrieve details of environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
 
 ## Remarks
 
@@ -37,6 +39,12 @@ Get information as admin about the Power Platform environment by name
 m365 pp environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --asAdmin
 ```
 
+Get information about the default Power Platform environment
+
+```sh
+m365 pp environment get
+```
+
 ## Response
 
 === "JSON"