@pnp/cli-microsoft365 6.0.0-beta.c5b75e1 → 6.0.0-beta.c63e3b2

package/docs/docs/cmd/planner/bucket/bucket-remove.md

@@ -58,3 +58,7 @@ Removes the Microsoft Planner bucket with name _My Bucket_ in the Plan _My Plan_
 ```sh
 m365 planner bucket remove --name "My Bucket" --planTitle "My Plan" --ownerGroupName "My Group"
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -55,3 +55,7 @@ Updates the Microsoft Planner bucket named _My Bucket_ in the Plan _My Plan_ own
 ```sh
 m365 planner bucket set --name "My Bucket" --planTitle "My Plan" --ownerGroupId 00000000-0000-0000-0000-000000000000 --newName "New bucket name"
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -50,3 +50,126 @@ Adds a Microsoft Planner plan with the name _My Planner Plan_ for Group _My Plan
 ```sh
 m365 planner plan add --title 'My Planner Plan' --ownerGroupName 'My Planner Group' --shareWithUserNames 'Allan.Carroll@contoso.com,Ida.Stevens@contoso.com'
 ```
+
+## Response
+
+### Standard response
+
+=== "JSON"
+
+    ``` json
+    {
+      "createdDateTime": "2015-03-30T18:36:49.2407981Z",
+      "owner": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+      "title": "My Planner Plan",
+      "id": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
+      "createdBy": {
+        "user": {
+          "displayName": null,
+          "id": "95e27074-6c4a-447a-aa24-9d718a0b86fa"
+        },
+        "application": {
+          "displayName": null,
+          "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
+        }
+      },
+      "container": {
+        "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+        "type": "group",
+        "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ``` text
+    createdDateTime: 2015-03-30T18:36:49.2407981Z
+    id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
+    owner          : ebf3b108-5234-4e22-b93d-656d7dae5874
+    title          : My Planner Plan
+    ```
+
+=== "CSV"
+
+    ``` text
+    id,title,createdDateTime,owner
+    xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
+    ```
+
+### `shareWithUserIds`, `shareWithUserNames` response
+
+When we make use of the option `shareWithUserIds` or `shareWithUserNames` the response will differ. 
+
+=== "JSON"
+
+    ```json
+    {
+      "createdDateTime": "2015-03-30T18:36:49.2407981Z",
+      "owner": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+      "title": "My Planner Plan",
+      "id": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
+      "createdBy": {
+        "user": {
+          "displayName": null,
+          "id": "95e27074-6c4a-447a-aa24-9d718a0b86fa"
+        },
+        "application": {
+          "displayName": null,
+          "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
+        }
+      },
+      "container": {
+        "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+        "type": "group",
+        "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"
+      },
+      "sharedWith": {
+        "ebf3b108-5234-4e22-b93d-656d7dae5874": true,
+        "6463a5ce-2119-4198-9f2a-628761df4a62": true
+      },
+      "categoryDescriptions": {
+        "category1": null,
+        "category2": null,
+        "category3": null,
+        "category4": null,
+        "category5": null,
+        "category6": null,
+        "category7": null,
+        "category8": null,
+        "category9": null,
+        "category10": null,
+        "category11": null,
+        "category12": null,
+        "category13": null,
+        "category14": null,
+        "category15": null,
+        "category16": null,
+        "category17": null,
+        "category18": null,
+        "category19": null,
+        "category20": null,
+        "category21": null,
+        "category22": null,
+        "category23": null,
+        "category24": null,
+        "category25": null
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    createdDateTime: 2015-03-30T18:36:49.2407981Z
+    id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
+    owner          : ebf3b108-5234-4e22-b93d-656d7dae5874
+    title          : My Planner Plan
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title,createdDateTime,owner
+    xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
+    ```

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

@@ -16,17 +16,11 @@ m365 planner plan get [options]
 `-t, --title [title]`
 : Title of the plan. Specify either `id` or `title` but not both.
 
-`--planId [planId]`
-: (deprecated. Use `id` instead) ID of the plan. Specify either `planId` or `planTitle` but not both.
-
-`---planTitle [planTitle]`
-: (deprecated. Use `title` instead) Title of the plan. Specify either `planId` or `planTitle` but not both.
-
 `--ownerGroupId [ownerGroupId]`
-: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` or the deprecated `planTitle`.
+: ID of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
 
 `--ownerGroupName [ownerGroupName]`
-: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title` or the deprecated `planTitle`.
+: Name of the Group that owns the plan. Specify either `ownerGroupId` or `ownerGroupName` when using `title`.
 
 --8<-- "docs/cmd/_global.md"
 
@@ -49,3 +43,78 @@ Returns the Microsoft Planner plan with title _MyPlan_ for Group _My Planner Gro
 ```sh
 m365 planner plan get --title "MyPlan" --ownerGroupName "My Planner Group"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "createdDateTime": "2015-03-30T18:36:49.2407981Z",
+      "owner": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+      "title": "My Planner Plan",
+      "id": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
+      "createdBy": {
+        "user": {
+          "displayName": null,
+          "id": "95e27074-6c4a-447a-aa24-9d718a0b86fa"
+        },
+        "application": {
+          "displayName": null,
+          "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
+        }
+      },
+      "container": {
+        "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+        "type": "group",
+        "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"
+      },
+      "sharedWith": {
+        "ebf3b108-5234-4e22-b93d-656d7dae5874": true,
+        "6463a5ce-2119-4198-9f2a-628761df4a62": true
+      },
+      "categoryDescriptions": {
+        "category1": null,
+        "category2": null,
+        "category3": null,
+        "category4": null,
+        "category5": null,
+        "category6": null,
+        "category7": null,
+        "category8": null,
+        "category9": null,
+        "category10": null,
+        "category11": null,
+        "category12": null,
+        "category13": null,
+        "category14": null,
+        "category15": null,
+        "category16": null,
+        "category17": null,
+        "category18": null,
+        "category19": null,
+        "category20": null,
+        "category21": null,
+        "category22": null,
+        "category23": null,
+        "category24": null,
+        "category25": null
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    createdDateTime: 2015-03-30T18:36:49.2407981Z
+    id             : xqQg5FS2LkCp935s-FIFm2QAFkHM
+    owner          : ebf3b108-5234-4e22-b93d-656d7dae5874
+    title          : My Planner Plan
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title,createdDateTime,owner
+    xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
+    ```

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

@@ -31,3 +31,48 @@ Returns a list of Microsoft Planner plans for Group _My Planner Group_
 ```sh
 m365 planner plan list --ownerGroupName "My Planner Group"
 ```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "createdDateTime": "2015-03-30T18:36:49.2407981Z",
+        "owner": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+        "title": "My Planner Plan",
+        "id": "xqQg5FS2LkCp935s-FIFm2QAFkHM",
+        "createdBy": {
+          "user": {
+            "displayName": null,
+            "id": "95e27074-6c4a-447a-aa24-9d718a0b86fa"
+          },
+          "application": {
+            "displayName": null,
+            "id": "ebf3b108-5234-4e22-b93d-656d7dae5874"
+          }
+        },
+        "container": {
+          "containerId": "ebf3b108-5234-4e22-b93d-656d7dae5874",
+          "type": "group",
+          "url": "https://graph.microsoft.com/v1.0/groups/ebf3b108-5234-4e22-b93d-656d7dae5874"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    id                            title            createdDateTime               owner
+    ----------------------------  ---------------  ----------------------------  ------------------------------------
+    xqQg5FS2LkCp935s-FIFm2QAFkHM  My Planner Plan  2015-03-30T18:36:49.2407981Z  ebf3b108-5234-4e22-b93d-656d7dae5874
+    ```
+
+=== "CSV"
+
+    ```csv
+    id,title,createdDateTime,owner
+    xqQg5FS2LkCp935s-FIFm2QAFkHM,My Planner Plan,2015-03-30T18:36:49.2407981Z,ebf3b108-5234-4e22-b93d-656d7dae5874
+    ```

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

@@ -46,3 +46,7 @@ Removes the Microsoft Planner plan with title _My Plan_ in group with name _My P
 ```sh
 m365 planner plan remove --title "My Plan" --ownerGroupName "My Planner Group" --confirm
 ```
+
+## Response
+
+The command won't return a response on success.

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

@@ -22,9 +22,6 @@ m365 planner task details get [options]
 `-t, --title [title]`
 : Title of the task. Specify either `id` or `title` but not both.
 
-`--taskId [taskId]`
-: (deprecated. Use `id` instead) ID of the task.
-
 `--bucketId [bucketId]`
 : ID of the bucket to which the task belongs. Specify `bucketId` or `bucketName` when using `title`.
 

package/docs/docs/cmd/pp/card/card-clone.md

@@ -0,0 +1,77 @@
+# pp card clone
+
+Clones a specific Microsoft Power Platform card in the specified Power Platform environment
+
+## Usage
+
+```sh
+pp card clone [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`--newName <newName>`
+: The name of the new card.
+
+`-i, --id [id]`
+: The id of the card. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the card. Specify either `id` or `name` but not both.
+
+`-a, --asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+Clones a specific card in a specific environment based on name.
+
+```sh
+m365 pp card clone --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Card" --newName "CLI 365 new Card"
+```
+
+Clones a specific card in a specific environment based on name as admin.
+
+```sh
+m365 pp card clone --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Card" --newName "CLI 365 new Card" --asAdmin 
+```
+
+Clones a specific card in a specific environment based on id.
+
+```sh
+m365 pp card clone --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "408e3f42-4c9e-4c93-8aaf-3cbdea9179aa" --newName "CLI 365 new Card"
+```
+
+Clones a specific card in a specific environment based on id as admin.
+
+```sh
+m365 pp card clone --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "408e3f42-4c9e-4c93-8aaf-3cbdea9179aa" --newName "CLI 365 new Card" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "CardIdClone": "80cff342-ddf1-4633-aec1-6d3d131b29e0"
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    CardIdClone: 80cff342-ddf1-4633-aec1-6d3d131b29e0
+    ```
+
+=== "CSV"
+
+    ```csv
+    CardIdClone
+    80cff342-ddf1-4633-aec1-6d3d131b29e0
+    ```

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

@@ -0,0 +1,122 @@
+# pp card get
+
+Gets a specific Microsoft Power Platform card in the specified Power Platform environment
+
+## Usage
+
+```sh
+pp card get [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-i, --id [id]`
+: The id of the card. Specify either `id` or `name` but not both.
+
+`-n, --name [name]`
+: The name of the card. Specify either `id` or `name` but not both.
+
+`-a, --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 card in a specific environment based on name
+
+```sh
+m365 pp card get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Card"
+```
+
+Get a specific card in a specific environment based on name as admin
+
+```sh
+m365 pp card get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --name "CLI 365 Card" --asAdmin
+```
+
+Get a specific card in a specific environment based on id
+
+```sh
+m365 pp card get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "408e3f42-4c9e-4c93-8aaf-3cbdea9179aa"
+```
+
+Get a specific card in a specific environment based on id as admin
+
+```sh
+m365 pp card get --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --id "408e3f42-4c9e-4c93-8aaf-3cbdea9179aa" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    {
+      "solutionid":"fd140aae-4df4-11dd-bd17-0019b9312238",
+      "modifiedon":"2022-10-25T14:44:48Z",
+      "_owninguser_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+      "overriddencreatedon":null,
+      "ismanaged":false,
+      "schemaversion":null,
+      "importsequencenumber":null,
+      "tags":null,
+      "componentidunique":"24205370-bc43-4c5e-b095-16da18f0b1a3",
+      "_modifiedonbehalfby_value":null,
+      "componentstate":0,
+      "statecode":0,
+      "name":"Tasks List",
+      "versionnumber":4451230,
+      "utcconversiontimezonecode":null,
+      "cardid":"0eab9392-7354-ed11-bba2-000d3adf774e",
+      "publishdate":null,
+      "_createdonbehalfby_value":null,
+      "_modifiedby_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+      "createdon":"2022-10-25T14:44:48Z",
+      "overwritetime":"1900-01-01T00:00:00Z",
+      "_owningbusinessunit_value":"b419f090-fe22-ec11-b6e5-000d3ab596a1",
+      "hiddentags":null,
+      "description":" ",
+      "appdefinition":"{\"screens\":{\"main\":{\"template\":{\"type\":\"AdaptiveCard\",\"body\":[{\"type\":\"TextBlock\",\"size\":\"Medium\",\"weight\":\"bolder\",\"text\":\"Your card title goes here\"},{\"type\":\"TextBlock\",\"text\":\"Add and remove element to customize your new card.\",\"wrap\":true}],\"actions\":[],\"$schema\":\"http://adaptivecards.io/schemas/1.4.0/adaptive-card.json\",\"version\":\"1.4\"},\"verbs\":{\"submit\":\"echo\"}}},\"sampleData\":{\"main\":{}},\"connections\":{},\"variables\":{},\"flows\":{}}",
+      "statuscode":1,
+      "remixsourceid":null,
+      "sizes":null,
+      "coowners":null,
+      "_owningteam_value":null,
+      "_createdby_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+      "_ownerid_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+      "publishsourceid":null,
+      "timezoneruleversionnumber":null,
+      "iscustomizable":{
+        "Value":true,
+        "CanBeChanged":true,
+        "ManagedPropertyLogicalName":"iscustomizableanddeletable"
+      },
+      "owninguser":{
+        "azureactivedirectoryobjectid":"78637d62-e872-4dc9-b7c1-bd161e631682",
+        "fullname":"# Nico",
+        "systemuserid":"4f175d04-b952-ed11-bba2-000d3adf774e",
+        "ownerid":"4f175d04-b952-ed11-bba2-000d3adf774e"
+      }
+    }
+    ```
+
+=== "Text"
+
+    ```text
+    cardid     : 0eab9392-7354-ed11-bba2-000d3adf774e
+    createdon  : 2022-10-25T14:44:48Z
+    modifiedon : 2022-10-25T14:44:48Z
+    name       : Tasks List
+    publishdate: 2022-10-30T16:00:00Z
+    ```
+
+=== "CSV"
+
+    ```csv
+    name,cardid,publishdate,createdon,modifiedon
+    Tasks List,0eab9392-7354-ed11-bba2-000d3adf774e,2022-10-30T16:00:00Z,2022-10-25T14:44:48Z,2022-10-25T14:44:48Z
+    ```

package/docs/docs/cmd/pp/card/card-list.md

@@ -0,0 +1,104 @@
+# pp card list
+
+Lists Microsoft Power Platform cards in the specified Power Platform environment.
+
+## Usage
+
+```sh
+pp card list [options]
+```
+
+## Options
+
+`-e, --environment <environment>`
+: The name of the environment.
+
+`-a, --asAdmin`
+: Run the command as admin for environments you do not have explicitly assigned permissions to.
+
+--8<-- "docs/cmd/_global.md"
+
+## Examples
+
+List cards in a specific environment.
+
+```sh
+m365 pp card list --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
+```
+
+List cards in a specific environment as admin.
+
+```sh
+m365 pp card list --environment "Default-d87a7535-dd31-4437-bfe1-95340acd55c5" --asAdmin
+```
+
+## Response
+
+=== "JSON"
+
+    ```json
+    [
+      {
+        "solutionid":"fd140aae-4df4-11dd-bd17-0019b9312238",
+        "modifiedon":"2022-10-25T14:44:48Z",
+        "_owninguser_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+        "overriddencreatedon":null,
+        "ismanaged":false,
+        "schemaversion":null,
+        "importsequencenumber":null,
+        "tags":null,
+        "componentidunique":"24205370-bc43-4c5e-b095-16da18f0b1a3",
+        "_modifiedonbehalfby_value":null,
+        "componentstate":0,
+        "statecode":0,
+        "name":"Tasks List",
+        "versionnumber":4451230,
+        "utcconversiontimezonecode":null,
+        "cardid":"0eab9392-7354-ed11-bba2-000d3adf774e",
+        "publishdate":null,
+        "_createdonbehalfby_value":null,
+        "_modifiedby_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+        "createdon":"2022-10-25T14:44:48Z",
+        "overwritetime":"1900-01-01T00:00:00Z",
+        "_owningbusinessunit_value":"b419f090-fe22-ec11-b6e5-000d3ab596a1",
+        "hiddentags":null,
+        "description":" ",
+        "appdefinition":"{\"screens\":{\"main\":{\"template\":{\"type\":\"AdaptiveCard\",\"body\":[{\"type\":\"TextBlock\",\"size\":\"Medium\",\"weight\":\"bolder\",\"text\":\"Your card title goes here\"},{\"type\":\"TextBlock\",\"text\":\"Add and remove element to customize your new card.\",\"wrap\":true}],\"actions\":[],\"$schema\":\"http://adaptivecards.io/schemas/1.4.0/adaptive-card.json\",\"version\":\"1.4\"},\"verbs\":{\"submit\":\"echo\"}}},\"sampleData\":{\"main\":{}},\"connections\":{},\"variables\":{},\"flows\":{}}",
+        "statuscode":1,
+        "remixsourceid":null,
+        "sizes":null,
+        "coowners":null,
+        "_owningteam_value":null,
+        "_createdby_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+        "_ownerid_value":"4f175d04-b952-ed11-bba2-000d3adf774e",
+        "publishsourceid":null,
+        "timezoneruleversionnumber":null,
+        "iscustomizable":{
+          "Value":true,
+          "CanBeChanged":true,
+          "ManagedPropertyLogicalName":"iscustomizableanddeletable"
+        },
+        "owninguser":{
+          "azureactivedirectoryobjectid":"78637d62-e872-4dc9-b7c1-bd161e631682",
+          "fullname":"# Nico",
+          "systemuserid":"4f175d04-b952-ed11-bba2-000d3adf774e",
+          "ownerid":"4f175d04-b952-ed11-bba2-000d3adf774e"
+        }
+      }
+    ]
+    ```
+
+=== "Text"
+
+    ```text
+    name        cardid                                publishdate          createdon             modifiedon
+    ----------  ------------------------------------  -----------          --------------------  --------------------
+    Tasks List  0eab9392-7354-ed11-bba2-000d3adf774e  2022-10-30T16:00:00Z 2022-10-25T14:44:48Z  2022-10-25T14:44:48Z
+    ```
+
+=== "CSV"
+
+    ```csv
+    name,cardid,publishdate,createdon,modifiedon
+    Tasks List,0eab9392-7354-ed11-bba2-000d3adf774e,2022-10-30T16:00:00Z,2022-10-25T14:44:48Z,2022-10-25T14:44:48Z
+    ```