@pnp/cli-microsoft365 6.3.0-beta.861847a → 6.3.0-beta.98b4bc2

package/docs/docs/cmd/aad/user/user-remove.md

@@ -0,0 +1,51 @@
+# aad user remove
+
+Removes a specific user
+
+## Usage
+
+```sh
+m365 aad user remove [options]
+```
+
+## Options
+
+`--id [id]`
+: The ID of the user. Specify either `id` or `userName` but not both.
+
+`--userName [userName]`
+:	User principal name of the user. Specify either `id` or `userName` but not both.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! important
+    If the user with the specified id or user name doesn't exist, you will get a `Resource 'xyz' does not exist or one of its queried reference-property objects are not present.` error.
+
+!!! important
+    To use this command you must be a Global administrator, User administrator or Privileged Authentication administrator.
+
+!!! note
+    After running this command, it may take a minute before the user is effectively moved to the recycle bin.
+
+## Examples
+
+Removes a specific user by id
+
+```sh
+m365 aad user remove --id a33bd401-9117-4e0e-bb7b-3f61c1539e10
+```
+
+Removes a specific user by its UPN
+
+```sh
+m365 aad user remove --name john.doe@contoso.com
+```
+
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/context/option/option-list.md

@@ -0,0 +1,63 @@
+# context option list
+
+List all options added to the context
+
+## Usage
+
+```sh
+m365 context option list [options]
+```
+
+## Options
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List all options added to the context
+
+```sh
+m365 context option list
+```
+
+## Response
+
+The responses below are an example. The output may differ based on the contents of the context file
+
+=== "JSON"
+
+    ```json
+    {
+      "url": "https://contoso.sharepoint.com",
+      "list": "list name"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    list: list name
+    url : https://contoso.sharepoint.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    url,list
+    https://contoso.sharepoint.com,list name
+    ```
+
+=== "Markdown"
+
+    ```md
+    # context option list
+
+    Date: 7/2/2023
+
+    ## https://contoso.sharepoint.com
+
+    Property | Value
+    ---------|-------
+    url | https://contoso.sharepoint.com
+    list | list name
+    ```

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

@@ -10,8 +10,8 @@ m365 flow environment get [options]
 
 ## Options
 
-`-n, --name <name>`
-: The name of the environment to get information about
+`-n, --name [name]`
+: The name of the environment to get information about. When not specified, the default environment is retrieved.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -24,12 +24,17 @@ If the environment with the name you specified doesn't exist, you will get the `
 
 ## Examples
 
-Get information about the Microsoft Flow environment named _Default-d87a7535-dd31-4437-bfe1-95340acd55c5_
+Get information about a Microsoft Flow environment specified by name
 
 ```sh
 m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
 ```
 
+Get information about the default Microsoft Flow environment
+```sh
+m365 flow environment get
+```
+
 ## Response
 
 ### Standard response
@@ -129,3 +134,26 @@ m365 flow environment get --name Default-d87a7535-dd31-4437-bfe1-95340acd55c5
     name,id,location,displayName,provisioningState,environmentSku,azureRegionHint,isDefault
     Default-d87a7535-dd31-4437-bfe1-95340acd55c5,/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5,india,contoso (default),Succeeded,Default,centralindia,1  
     ```
+
+=== "Markdown"
+
+    ```md
+    # flow environment get
+
+    Date: 8/2/2023
+
+    ## contoso (default) (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5)
+
+    Property | Value
+    ---------|-------
+    name | Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+    location | india
+    type | Microsoft.ProcessSimple/environments
+    id | /providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5
+    properties | {"displayName":"contoso (default)","createdTime":"2019-12-21T18:32:11.8708704Z","createdBy":{"id":"SYSTEM","displayName": "SYSTEM","type": "NotSpecified"},"provisioningState":"Succeeded","creationType":"DefaultTenant","environmentSku":"Default","environmentType":"NotSpecified","states":{"management":{"id":"NotSpecified"},"runtime":{"runtimeReasonCode":"NotSpecified","requestedBy":{"displayName":"SYSTEM","type":"NotSpecified"},"id":"Enabled"}},"isDefault":true,"isPayAsYouGoEnabled":false,"azureRegionHint":"centralindia","runtimeEndpoints":{"microsoft.BusinessAppPlatform":"https://india.api.bap.microsoft.com","microsoft.CommonDataModel":"https://india.api.cds.microsoft.com","microsoft.PowerApps":"https://india.api.powerapps.com",microsoft.PowerAppsAdvisor":"https://india.api.advisor.powerapps.com","microsoft.PowerVirtualAgents":"https://powervamg.in-il101.gateway.prod.island.powerapps.com","microsoft.ApiManagement":"https://management.INDIA.azure-apihub.net","microsoft.Flow":"https://india.api.flow.microsoft.com"},"linkedEnvironmentMetadata":{"type":"NotSpecified","resourceId":"3aa550bf-52ac-42fc-98f7-5d1833c1501c","friendlyName":"contoso (default)","uniqueName":"orgfc80770f","domainName":"orgfc80770f","version":"9.2.22105.00154","instanceUrl":"https://orgfc80770f.crm8.dynamics.com/","instanceApiUrl":"https://orgfc80770f.api.crm8.dynamics.com","baseLanguage":1033,"instanceState":"Ready","createdTime":"2019-12-25T15:46:14.433Z"},"environmentFeatures":{"isOpenApiEnabled":false},"cluster":{"category":"Prod","number":"101","uriSuffix":"in-il101.gateway.prod.island","geoShortName":"IN","environment":"Prod"},"governanceConfiguration":{"protectionLevel":"Basic"}}
+    displayName | contoso (default)
+    provisioningState | Succeeded
+    environmentSku | Default
+    azureRegionHint | centralindia
+    isDefault | true
+    ```

package/docs/docs/cmd/login.md

@@ -159,3 +159,29 @@ Log in to Microsoft 365 using a client secret.
 ```sh
 m365 login --authType secret --secret topSeCr3t@007
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```
+
+=== "Text"
+
+    ```text
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```
+
+=== "CSV"
+
+    ```csv
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```
+
+=== "Markdown"
+
+    ```md
+    To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code CQBMTLEFC to authenticate.
+    ```

package/docs/docs/cmd/logout.md

@@ -29,3 +29,7 @@ Log out from Microsoft 365 in debug mode including detailed debug information in
 ```sh
 m365 logout --debug
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -10,8 +10,8 @@ m365 pa 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.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -24,6 +24,12 @@ If the environment with the name you specified doesn't exist, you will get the `
 
 ## Examples
 
+Get information about the default Power Apps environment
+
+```sh
+m365 pa environment get
+```
+
 Get information about the Power Apps environment named _Default-d87a7535-dd31-4437-bfe1-95340acd55c5_
 
 ```sh

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

@@ -11,19 +11,19 @@ m365 planner plan get [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the plan. Specify either `id` or `title` but not both.
+: ID of the plan. Specify either `id`, `title` or `rosterId` but not multiple.
 
 `-t, --title [title]`
-: Title of the plan. Specify either `id` or `title` but not both.
+: Title of the plan. Specify either `id`, `title` or `rosterId` but not multiple.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `id`, `title` or `rosterId` but not multiple.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId` when using `title`.
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` but not both.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId` when using `title`.
-
-`--rosterId [rosterId]`
-: ID of the Planner Roster. Specify either `ownerGroupId`, `ownerGroupName` or `rosterId` when using `title`.
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` but not both.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -34,28 +34,28 @@ When using `rosterId`, the command is based on an API that is currently in previ
 
 ## Examples
 
-Returns the Microsoft Planner plan with id _gndWOTSK60GfPQfiDDj43JgACDCb_
+Returns the Microsoft Planner plan by id
 
 ```sh
 m365 planner plan get --id "gndWOTSK60GfPQfiDDj43JgACDCb"
 ```
 
-Returns the Microsoft Planner plan with title _MyPlan_ for Group _233e43d0-dc6a-482e-9b4e-0de7a7bce9b4_
+Returns the Microsoft Planner plan by title and owner group id 
 
 ```sh
 m365 planner plan get --title "MyPlan" --ownerGroupId "233e43d0-dc6a-482e-9b4e-0de7a7bce9b4"
 ```
 
-Returns the Microsoft Planner plan with title _MyPlan_ for Group _My Planner Group_
+Returns the Microsoft Planner plan by title and owner group name
 
 ```sh
 m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"
 ```
 
-Returns the Microsoft Planner plan with title _MyPlan_ for Roster _FeMZFDoK8k2oWmuGE-XFHZcAEwtn_
+Returns the Microsoft Planner plan by roster id
 
 ```sh
-m365 planner plan get --title "MyPlan" --rosterId "FeMZFDoK8k2oWmuGE-XFHZcAEwtn"
+m365 planner plan get --rosterId "FeMZFDoK8k2oWmuGE-XFHZcAEwtn"
 ```
 
 ## Response

package/docs/docs/cmd/planner/plan/plan-set.md

@@ -11,16 +11,19 @@ m365 planner plan set [options]
 ## Options
 
 `-i, --id [id]`
-: ID of the plan. Specify either `id` or `title` but not both.
+: ID of the plan. Specify either `id`, `title` or `rosterId` but not multiple.
 
 `-t, --title [title]`
-: Title of the plan. Specify either `id` or `title` but not both.
+: Title of the plan. Specify either `id`, `title` or `rosterId` but not multiple.
+
+`--rosterId [rosterId]`
+: ID of the Planner Roster. Specify either `id`, `title` or `rosterId` but not multiple.
 
 `--ownerGroupId [ownerGroupId]`
-: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+: ID of the group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `title` but not both.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
+: Name of the Group to which the plan belongs. Specify either `ownerGroupId` or `ownerGroupName` when using `title` but not both.
 
 `--newTitle [newTitle]`
 : New title of the plan.
@@ -40,6 +43,9 @@ This command allows using unknown options.
 `--category1 [category1]`
 : New label for a category. Define the category key within your option to update the related label. Category 1 to 25 are available. E.g., `--category4`, `--category12`.
 
+!!! attention
+    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.
+
 ## Examples
 
 Updates a Microsoft Planner plan title to New Title

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

@@ -0,0 +1,73 @@
+# planner roster get
+
+Gets information about the specific Microsoft Planner Roster.
+
+## Usage
+
+```sh
+m365 planner roster get [options]
+```
+
+## Options
+
+`--id <id>`
+: ID of the Planner Roster.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+## Examples
+
+Gets information about a specific Planner Roster.
+
+```sh
+m365 planner roster get --id tYqYlNd6eECmsNhN_fcq85cAGAnd
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "id": "tYqYlNd6eECmsNhN_fcq85cAGAnd",
+      "assignedSensitivityLabel": null
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    assignedSensitivityLabel: null
+    id                      : tYqYlNd6eECmsNhN_fcq85cAGAnd
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,assignedSensitivityLabel
+    tYqYlNd6eECmsNhN_fcq85cAGAnd,
+    ```
+
+=== "Markdown"
+
+    ```md
+    # planner roster get --id "tYqYlNd6eECmsNhN_fcq85cAGAnd"
+
+    Date: 1/30/2023
+
+    ## undefined (tYqYlNd6eECmsNhN_fcq85cAGAnd)
+
+    Property | Value
+    ---------|-------
+    id | tYqYlNd6eECmsNhN_fcq85cAGAnd
+    assignedSensitivityLabel | null
+    ```
+
+## Additional information
+
+Rosters are a new type of container for Microsoft Planner plans. This enables users to create a Planner plan without the need to create a new Microsoft 365 group (with a mailbox, SharePoint site, ...). Access to Roster-contained plans is controlled by the members on the Roster. A Planner Roster can contain only 1 plan.

package/docs/docs/cmd/planner/roster/roster-member-remove.md

@@ -0,0 +1,51 @@
+# planner roster member remove
+
+Removes a member from a Microsoft Planner Roster
+
+## Usage
+
+```sh
+m365 planner roster member remove [options]
+```
+
+## Options
+
+`--rosterId <rosterId>`
+: ID of the Planner Roster.
+
+`--userId [userId]`
+: User's Azure AD ID. Specify either `userId` or `userName` but not both.
+
+`--userName [userName]`
+: User's UPN (user principal name, e.g. johndoe@example.com). Specify either `userId` or `userName` but not both.
+
+`--confirm`
+: Don't prompt for confirmation.
+
+--8<-- "docs/cmd/_global.md"
+
+## Remarks
+
+!!! attention
+    This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
+
+!!! attention
+    The Planner Roster will be deleted when it doesn't have any users remaining in the membership list because the last user removed themselves. Roster, its plan and all contained tasks will be deleted within 30 days of this operation. We will show an extra prompt when this happens. This prompt is also suppressed when specifying `--confirm`.
+
+## Examples
+
+Remove a Roster member by its Azure AD ID
+
+```sh
+m365 planner roster member remove --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userId 126878e5-d8f9-4db2-951d-d25486488d38
+```
+
+Remove a Roster member by its UPN
+
+```sh
+m365 planner roster member remove --rosterId tYqYlNd6eECmsNhN_fcq85cAGAnd --userName john.doe@contoso.com
+```
+
+## Response
+
+The command won't return a response on success.

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

@@ -26,7 +26,7 @@ m365 purview retentionevent list
     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
-    This command currently does not support app only permissions.
+    This command currently only supports delegated permissions.
 
 ## More information
 

package/docs/docs/cmd/purview/retentionevent/retentionevent-remove.md

@@ -0,0 +1,45 @@
+# purview retentionevent remove
+
+Delete a retention event
+
+## Usage
+
+```sh
+m365 purview retentionevent remove [options]
+```
+
+## Options
+
+`-i, --id <id>`
+: The Id of the retention event.
+
+`--confirm`
+: Don't prompt for confirmation to remove the retention event.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Delete a retention event by id
+
+```sh
+m365 purview retentionevent remove --id c37d695e-d581-4ae9-82a0-9364eba4291e
+```
+
+## 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
+    This command currently only supports delegated permissions.
+
+## More information
+
+This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.
+
+[Read more on event-based retention here](https://learn.microsoft.com/microsoft-365/compliance/event-driven-retention?view=o365-worldwide)
+
+## Response
+
+The command won't return a response on success.

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

@@ -28,6 +28,9 @@ m365 purview retentioneventtype get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! attention
     This command is based on an API that is currently in preview and is subject to change once the API reached general availability.
 
+!!! attention
+    This command currently only supports delegated permissions.
+
 ## More information
 
 This command is part of a series of commands that have to do with event-based retention. Event-based retention is about starting a retention period when a specific event occurs, instead of the moment a document was labeled or created.

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

@@ -26,7 +26,7 @@ m365 purview retentioneventtype list
     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
-    This command currently does not support app only permissions.
+    This command currently only supports delegated permissions.
 
 ## More information
 

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-add.md

@@ -58,6 +58,9 @@ m365 purview retentionlabel add --displayName 'some label' --behaviorDuringReten
 !!! 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
+    This command currently only supports delegated permissions.
+
 ## More information
 
 - Create retentionLabel: [https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http](https://learn.microsoft.com/en-us/graph/api/security-retentionlabel-post?view=graph-rest-beta&tabs=http)

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

@@ -28,6 +28,9 @@ m365 purview retentionlabel get --id c37d695e-d581-4ae9-82a0-9364eba4291e
 !!! 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
+    This command currently only supports delegated permissions.
+
 ## Response
 
 

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

@@ -25,6 +25,9 @@ m365 purview retentionlabel list
 !!! 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
+    This command currently only supports delegated permissions.
+
 ## Response
 
 

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-remove.md

@@ -31,6 +31,9 @@ m365 purview retentionlabel remove --id 'e554d69c-0992-4f9b-8a66-fca3c4d9c531'
 !!! 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
+    This command currently only supports delegated permissions.
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/purview/retentionlabel/retentionlabel-set.md

@@ -58,6 +58,9 @@ m365 purview retentionlabel set --id c37d695e-d581-4ae9-82a0-9364eba4291e --beha
 !!! 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
+    This command currently only supports delegated permissions.
+
 ## Response
 
 The command won't return a response on success.

package/docs/docs/cmd/request.md

@@ -74,3 +74,77 @@ Call the Microsoft Graph to get a profile photo.
 ```sh
 m365 request --url "https://graph.microsoft.com/beta/me/photo/\$value" --filePath ./profile-pic.jpg
 ```
+
+## Response
+
+The responses below are an example based on the `url` option with the value 'https://graph.microsoft.com/v1.0/me'. The output may differ based on the `url` options
+
+=== "JSON"
+
+    ```json
+    {
+      "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users/$entity",
+      "businessPhones": [
+        "123456789"
+      ],
+      "displayName": "John Doe",
+      "givenName": "John",
+      "jobTitle": null,
+      "mail": "john.doe@contoso.onmicrosoft.com",
+      "mobilePhone": null,
+      "officeLocation": null,
+      "preferredLanguage": "en-US",
+      "surname": "Doe",
+      "userPrincipalName": "john.doe@contoso.onmicrosoft.com",
+      "id": "1df1fffa-62b8-44a9-9c7c-49853f5b4ac6"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    @odata.context   : https://graph.microsoft.com/v1.0/$metadata#users/$entity
+    businessPhones   : ["123456789"]
+    displayName      : John Doe
+    givenName        : John
+    id               : 1df1fffa-62b8-44a9-9c7c-49853f5b4ac6
+    jobTitle         : null
+    mail             : john.doe@contoso.onmicrosoft.com
+    mobilePhone      : null
+    officeLocation   : null
+    preferredLanguage: en-US
+    surname          : Doe
+    userPrincipalName: john.doe@contoso.onmicrosoft.com
+    ```
+
+=== "CSV"
+
+    ```csv
+    @odata.context,businessPhones,displayName,givenName,jobTitle,mail,mobilePhone,officeLocation,preferredLanguage,surname,userPrincipalName,id
+    https://graph.microsoft.com/v1.0/$metadata#users/$entity,"[""123456789""]",John Doe,John,,john.doe@contoso.onmicrosoft.com,,,en-US,Doe,john.doe@contoso.onmicrosoft.com,1df1fffa-62b8-44a9-9c7c-49853f5b4ac6
+    ```
+
+=== "Markdown"
+
+    ```md
+    # request --url "https://graph.microsoft.com/v1.0/me" --method "get"
+
+    Date: 7/2/2023
+
+    ## John Doe (1df1fffa-62b8-44a9-9c7c-49853f5b4ac6)
+
+    Property | Value
+    ---------|-------
+    @odata.context | https://graph.microsoft.com/v1.0/$metadata#users/$entity
+    businessPhones | ["494594133"]
+    displayName | John Doe
+    givenName | John
+    jobTitle | null
+    mail | john.doe@contoso.onmicrosoft.com
+    mobilePhone | null
+    officeLocation | null
+    preferredLanguage | en-US
+    surname | Doe
+    userPrincipalName | john.doe@contoso.onmicrosoft.com
+    id | 1df1fffa-62b8-44a9-9c7c-49853f5b4ac6
+    ```