@pnp/cli-microsoft365 6.8.0-beta.a10f6e4 → 6.8.0-beta.bb09db9

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

@@ -50,3 +50,9 @@ m365 cli consent --service yammer
     ```csv
     To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
     ```
+
+=== "Markdown"
+
+    ```md
+    To consent permissions for executing yammer commands, navigate in your web browser to https://login.microsoftonline.com/common/oauth2/v2.0/authorize?client_id=31359c7f-bd7e-475c-86db-fdb8c937548e&response_type=code&scope=https%3A%2F%2Fapi.yammer.com%2Fuser_impersonation
+    ```

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

@@ -73,3 +73,20 @@ m365 cli doctor
     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""]"
     ```
+
+=== "Markdown"
+
+    ```md
+    # cli doctor
+
+    Date: 2022-09-05
+
+    Property | Value
+    ---------|-------
+    cliVersion | 6.1.0
+    nodeVersion | v16.13.0
+    cliAadAppId | 31359c7f-bd7e-475c-86db-fdb8c937548e
+    cliAadAppTenant | common
+    authMode | DeviceCode
+    cliEnvironment |
+    ```

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

@@ -52,3 +52,9 @@ m365 cli issue --type command
     ```csv
     https://aka.ms/cli-m365/new-command
     ```
+
+=== "Markdown"
+
+    ```md
+    https://aka.ms/cli-m365/new-command
+    ```

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

@@ -40,6 +40,12 @@ m365 cli reconsent
     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
     ```
 
+=== "Markdown"
+
+    ```md
+    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-sh-setup.md

@@ -40,6 +40,12 @@ m365 cli completion sh setup
     Command completion successfully registered. Restart your shell to load the completion
     ```
 
+=== "Markdown"
+
+    ```md
+    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/config/config-get.md

@@ -51,6 +51,12 @@ When retrieving the `output` key, responses will look like this:
     json
     ```
 
+=== "Markdown"
+
+    ```md
+    json
+    ```
+
 ## More information
 
 - [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.md)

package/docs/docs/cmd/docs.md

@@ -0,0 +1,51 @@
+# docs
+
+Returns the CLI for Microsoft 365 docs webpage URL
+
+## Usage
+
+```sh
+m365 docs [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+Configure `autoOpenLinksInBrowser` using [cli config set](../cmd/cli/config/config-set.md) to automatically open the webpage in the default browser.
+
+## Examples
+
+Returns the CLI for Microsoft 365 docs webpage URL
+
+```sh
+m365 docs
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    "https://pnp.github.io/cli-microsoft365/"
+    ```
+
+=== "Text"
+
+    ```text
+    https://pnp.github.io/cli-microsoft365/
+    ```
+
+=== "CSV"
+
+    ```csv
+    https://pnp.github.io/cli-microsoft365/
+    ```
+
+=== "Markdown"
+
+    ```md
+    https://pnp.github.io/cli-microsoft365/
+    ```

package/docs/docs/cmd/flow/environment/environment-list.md

@@ -121,3 +121,21 @@ m365 flow environment list
     name,displayName
     d87a7535-dd31-4437-bfe1-95340acd55c5,Contoso Environment
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow environment list
+
+    Date: 2023-05-18
+
+    ## Contoso Environment (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4)
+
+    Property | Value
+    ---------|-------
+    name | Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+    location | europe
+    type | Microsoft.ProcessSimple/environments
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
+    displayName | Contoso Environment
+    ```

package/docs/docs/cmd/flow/flow-get.md

@@ -417,3 +417,23 @@ m365 flow get --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --n
     name,displayName,description,triggers,actions
     ca76d7b8-3b76-4050-8c03-9fb310ad172f,My Flow,,OpenApiConnection,"OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem"
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow get --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4" --name "ca76d7b8-3b76-4050-8c03-9fb310ad172f"
+
+    Date: 2023-05-18
+
+    ## My Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f)
+
+    Property | Value
+    ---------|-------
+    name | ca76d7b8-3b76-4050-8c03-9fb310ad172f
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/ca76d7b8-3b76-4050-8c03-9fb310ad172f
+    type | Microsoft.ProcessSimple/environments/flows
+    displayName | My Flow
+    description | My Flow
+    triggers | OpenApiConnection
+    actions | OpenApiConnection-AnalyzeImageV2, Compose, InitializeVariable, OpenApiConnection-HttpRequest, ParseJson, OpenApiConnection-PatchFileItem
+    ```

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

@@ -147,3 +147,20 @@ m365 flow list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --
     name,displayName
     00afcb83-df7b-4fe0-ab9c-1542a1dc66a9,Contoso Invoicing Flow
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow list --environmentName "Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4"
+
+    Date: 2023-05-18
+
+    ## Contoso Invoicing Flow (/providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9)
+
+    Property | Value
+    ---------|-------
+    name | 00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+    id | /providers/Microsoft.ProcessSimple/environments/Default-1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4/flows/00afcb83-df7b-4fe0-ab9c-1542a1dc66a9
+    type | Microsoft.ProcessSimple/environments/flows
+    displayName | Contoso Invoicing Flow
+    ```

package/docs/docs/cmd/login.md

@@ -46,7 +46,7 @@ m365 login [options]
 
 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-office-365.md).
+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.md).
 
 When logging in to Microsoft 365 using the user name and password, next to the access and refresh token, the CLI for Microsoft 365 will store the user credentials so that it can automatically re-authenticate if necessary. Similarly to the tokens, the credentials are removed by re-authenticating using the device code or by calling the [logout](logout.md) command.
 

package/docs/docs/cmd/pa/app/app-consent-set.md

@@ -0,0 +1,47 @@
+# pa app consent set
+
+Configures if users can bypass the API Consent window for the selected canvas app
+
+## Usage
+
+```sh
+m365 pa app consent set [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-n, --name <name>`
+: The name of the Power App to update
+
+`-b, --bypass <bypass>`
+: Set to `true` to allow users to bypass the API Consent window. Set to `false` to disable the bypass.
+
+`--confirm`
+: Don't prompt for confirmation
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+This command only works for canvas apps.
+
+## Examples
+
+Enables the bypass for the specified canvas app
+
+```sh
+m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass true
+```
+
+Disables the bypass consent for the specified canvas app
+
+```sh
+m365 pa app consent set --environment 4be50206-9576-4237-8b17-38d8aadfaa36 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --bypass false --confirm
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -8,12 +8,6 @@ Retrieve the specified planner task
 m365 planner task get [options]
 ```
 
-## Alias
-
-```sh
-m365 planner task details get [options]
-```
-
 ## Options
 
 `-i, --id  [id]`

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-get.md

@@ -0,0 +1,118 @@
+# purview sensitivitylabel get
+
+Retrieve the specified sensitivity label
+
+## Usage
+
+```sh
+m365 purview sensitivitylabel get [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the sensitivity label.
+
+`--userId [userId]`
+: User's Azure AD ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    When operating in app-only mode, you have the option to use either the `userName` or `userId` parameters to retrieve the sensitivity policy settings for a specific user. Without specifying either of these parameters, the command will retrieve the sensitivity policy settings for the currently authenticated user when operating in delegated mode.
+
+
+## Examples
+
+Get a sensitivity label
+
+```sh
+m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+```
+
+Get a sensitivity label that a specific user has access to by its Id
+
+```sh
+m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Get a sensitivity label that a specific user has access to by its UPN
+
+```sh
+m365 purview sensitivitylabel get --id 6f4fb2db-ecf4-4279-94ba-23d059bf157e --userName john.doe@contoso.com
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "6f4fb2db-ecf4-4279-94ba-23d059bf157e",
+      "name": "Unrestricted",
+      "description": "",
+      "color": "",
+      "sensitivity": 0,
+      "tooltip": "Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.",
+      "isActive": true,
+      "isAppliable": true,
+      "contentFormats": [
+        "file",
+        "email"
+      ],
+      "hasProtection": false
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    color         :
+    contentFormats: ["file","email"]
+    description   :
+    hasProtection : false
+    id            : 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+    isActive      : true
+    isAppliable   : true
+    name          : Unrestricted
+    sensitivity   : 0
+    tooltip       : Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name,description,color,sensitivity,tooltip,isActive,isAppliable,contentFormats,hasProtection
+    6f4fb2db-ecf4-4279-94ba-23d059bf157e,Unrestricted,,,0,"Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.",1,1,"[""file"",""email""]",
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview sensitivitylabel get --id "6f4fb2db-ecf4-4279-94ba-23d059bf157e"
+
+    Date: 3/25/2023
+
+    ## Unrestricted (6f4fb2db-ecf4-4279-94ba-23d059bf157e)
+
+    Property | Value
+    ---------|-------
+    id | 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+    name | Unrestricted
+    description |
+    color |
+    sensitivity | 0
+    tooltip | Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
+    isActive | true
+    isAppliable | true
+    contentFormats | ["file","email"]
+    hasProtection | false
+    ```

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-list.md

@@ -0,0 +1,111 @@
+# purview sensitivitylabel list
+
+Get a list of sensitivity labels
+
+## Usage
+
+```sh
+m365 purview sensitivitylabel list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: User's Azure AD ID. Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of sensitivity labels that the user has access to. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    When operating in app-only mode, you have the option to use either the `userName` or `userId` parameters to retrieve the sensitivity label for a specific user. Without specifying either of these parameters, the command will retrieve the sensitivity label for the currently authenticated user when operating in delegated mode.
+
+## Examples
+
+Get a list of sensitivity labels
+
+```sh
+m365 purview sensitivitylabel list
+```
+
+Get a list of sensitivity labels that a specific user has access to by its Id
+
+```sh
+m365 purview sensitivitylabel list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Get a list of sensitivity labels that a specific user has access to by its UPN
+
+```sh
+m365 purview sensitivitylabel list --userName john.doe@contoso.com
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "id": "6f4fb2db-ecf4-4279-94ba-23d059bf157e",
+        "name": "Unrestricted",
+        "description": "",
+        "color": "",
+        "sensitivity": 0,
+        "tooltip": "Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.",
+        "isActive": true,
+        "isAppliable": true,
+        "contentFormats": [
+          "file",
+          "email"
+        ],
+        "hasProtection": false,
+        "parent": null
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                                    name                   isActive
+    ------------------------------------  ---------------------  --------
+    6f4fb2db-ecf4-4279-94ba-23d059bf157e  Unrestricted           true
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,name,isActive
+    6f4fb2db-ecf4-4279-94ba-23d059bf157e,Unrestricted,1
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview sensitivitylabel list
+
+    Date: 3/26/2023
+
+    ## Unrestricted (6f4fb2db-ecf4-4279-94ba-23d059bf157e)
+
+    Property | Value
+    ---------|-------
+    id | 6f4fb2db-ecf4-4279-94ba-23d059bf157e
+    name | Unrestricted
+    description |
+    color |
+    sensitivity | 0
+    tooltip | Information either intended for general distribution, or which would not have any impact on the organization if it were to be distributed.
+    isActive | true
+    isAppliable | true
+    contentFormats | ["file","email"]
+    hasProtection | false
+    parent | null
+    ```

package/docs/docs/cmd/purview/sensitivitylabel/sensitivitylabel-policysettings-list.md

@@ -0,0 +1,97 @@
+# purview sensitivitylabel policysettings list
+
+Get a list of policy settings for a sensitivity label.
+
+## Usage
+
+```sh
+m365 purview sensitivitylabel policysettings list [options]
+```
+
+## Options
+
+`--userId [userId]`
+: User's Azure AD ID. Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Optionally specify this if you want to get a list of policy settings for a sensitivity label that the user has access to. Specify either `userId` or `userName` but not both.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on a Microsoft Graph API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    When operating in app-only mode, you have the option to use either the `userName` or `userId` parameters to retrieve the sensitivity policy settings for a specific user. Without specifying either of these parameters, the command will retrieve the sensitivity policy settings for the currently authenticated user when operating in delegated mode.
+
+## Examples
+
+Get a list of policy settings for a sensitivity label.
+
+```sh
+m365 purview sensitivitylabel policysettings list
+```
+
+Get a list of policy settings for a sensitivity label that a specific user has access to by its Id.
+
+```sh
+m365 purview sensitivitylabel policysettings list --userId 59f80e08-24b1-41f8-8586-16765fd830d3
+```
+
+Get a list of policy settings for a sensitivity label that a specific user has access to by its UPN.
+
+```sh
+m365 purview sensitivitylabel policysettings list --userName john.doe@contoso.com
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "71F139249895C2F6DC861031DAC47E0C2C37C6595582D4248CC77FD7293681B5DE348BC71AEB44068CB397DB021CADB4",
+      "moreInfoUrl": "https://docs.microsoft.com/en-us/microsoft-365/compliance/get-started-with-sensitivity-labels?view=o365-worldwide#end-user-documentation-for-sensitivity-labels",
+      "isMandatory": true,
+      "isDowngradeJustificationRequired": true,
+      "defaultLabelId": "022bb90d-0cda-491d-b861-d195b14532dc"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    defaultLabelId                  : 022bb90d-0cda-491d-b861-d195b14532dc
+    id                              : 71F139249895C2F6DC861031DAC47E0C2C37C6595582D4248CC77FD7293681B5DE348BC71AEB44068CB397
+    DB021CADB4
+    isDowngradeJustificationRequired: true
+    isMandatory                     : true
+    moreInfoUrl                     : https://docs.microsoft.com/en-us/microsoft-365/compliance/get-started-with-sensitivity-labels?view=o365-worldwide#end-user-documentation-for-sensitivity-labels
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,moreInfoUrl,isMandatory,isDowngradeJustificationRequired,defaultLabelId
+    71F139249895C2F6DC861031DAC47E0C2C37C6595582D4248CC77FD7293681B5DE348BC71AEB44068CB397DB021CADB4,https://docs.microsoft.com/en-us/microsoft-365/compliance/get-started-with-sensitivity-labels?view=o365-worldwide#end-user-documentation-for-sensitivity-labels,1,1,022bb90d-0cda-491d-b861-d195b14532dc
+    ```
+
+=== "Markdown"
+
+    ```md
+    # purview sensitivitylabel policysettings list
+
+    Date: 4/11/2023
+
+    ## 71F139249895C2F6DC861031DAC47E0C2C37C6595582D4248CC77FD7293681B5DE348BC71AEB44068CB397DB021CADB4
+
+    Property | Value
+    ---------|-------
+    id | 71F139249895C2F6DC861031DAC47E0C2C37C6595582D4248CC77FD7293681B5DE348BC71AEB44068CB397DB021CADB4
+    moreInfoUrl | https://docs.microsoft.com/en-us/microsoft-365/compliance/get-started-with-sensitivity-labels?view=o365-worldwide#end-user-documentation-for-sensitivity-labels
+    isMandatory | true
+    isDowngradeJustificationRequired | true
+    defaultLabelId | 022bb90d-0cda-491d-b861-d195b14532dc
+    ```

package/docs/docs/cmd/search/externalconnection/externalconnection-get.md

@@ -69,3 +69,20 @@ m365 search externalconnection get --name "Test"
     id,name,description,state,configuration
     CLITest,CLI-Test,CLI Test,draft,"{""authorizedApps"":[""31359c7f-bd7e-475c-86db-fdb8c937548e""],""authorizedAppIds"":[""31359c7f-bd7e-475c-86db-fdb8c937548e""]}"
     ```
+
+=== "Markdown"
+
+    ```md
+    # search externalconnection get --id "CLITest"
+
+    Date: 2022-11-05
+
+    ## CLI-Test (CLITest)
+
+    Property | Value
+    ---------|-------
+    id | CLITest
+    name | CLI-Test
+    description | CLI Test
+    state | draft
+    ```

package/docs/docs/cmd/search/externalconnection/externalconnection-list.md

@@ -57,3 +57,20 @@ m365 search externalconnection list
     id,name,state
     CLITest,CLI-Test,draft
     ```
+
+=== "Markdown"
+
+    ```md
+    # search externalconnection list
+
+    Date: 2022-09-05
+
+    ## CLI-Test (CLITest)
+
+    Property | Value
+    ---------|-------
+    id | CLITest
+    name | CLI-Test
+    description | CLI Test
+    state | draft
+    ```