@pnp/cli-microsoft365 6.5.0-beta.b69bf55 → 6.5.0-beta.ccd8e85

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (41) hide show
  1. package/.eslintrc.js +2 -0
  2. package/README.md +3 -3
  3. package/dist/Command.js +17 -7
  4. package/dist/cli/Cli.js +15 -11
  5. package/dist/m365/cli/commands/config/config-set.js +1 -0
  6. package/dist/m365/flow/commands/flow-export.js +6 -6
  7. package/dist/m365/pa/commands/app/app-export.js +197 -0
  8. package/dist/m365/pa/commands.js +1 -0
  9. package/dist/m365/purview/commands/threatassessment/threatassessment-get.js +79 -0
  10. package/dist/m365/purview/commands.js +2 -1
  11. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.17.0-beta.3.js → upgrade-1.17.0.js} +26 -26
  12. package/dist/m365/spfx/commands/project/project-upgrade.js +13 -15
  13. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-add.js +27 -13
  14. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-list.js +72 -0
  15. package/dist/m365/spo/commands/commandset/commandset-add.js +2 -1
  16. package/dist/m365/spo/commands/commandset/commandset-remove.js +12 -9
  17. package/dist/m365/spo/commands/commandset/commandset-set.js +12 -9
  18. package/dist/m365/spo/commands/file/file-move.js +1 -1
  19. package/dist/m365/spo/commands/file/file-retentionlabel-ensure.js +22 -1
  20. package/dist/m365/spo/commands/listitem/listitem-get.js +21 -6
  21. package/dist/m365/spo/commands/listitem/listitem-retentionlabel-ensure.js +35 -1
  22. package/dist/m365/spo/commands/web/web-set.js +33 -13
  23. package/dist/m365/spo/commands.js +1 -0
  24. package/dist/m365/teams/commands/team/team-list.js +4 -6
  25. package/dist/m365/todo/commands/task/task-set.js +25 -1
  26. package/dist/settingsNames.js +2 -1
  27. package/dist/utils/md.js +4 -3
  28. package/docs/docs/_clisettings.md +1 -0
  29. package/docs/docs/cmd/pa/app/app-export.md +52 -0
  30. package/docs/docs/cmd/purview/threatassessment/threatassessment-get.md +191 -0
  31. package/docs/docs/cmd/spfx/project/project-upgrade.md +2 -2
  32. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-add.md +4 -1
  33. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.md +109 -0
  34. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.md +12 -1
  35. package/docs/docs/cmd/spo/list/list-view-remove.md +1 -1
  36. package/docs/docs/cmd/spo/list/list-view-set.md +2 -2
  37. package/docs/docs/cmd/spo/listitem/listitem-get.md +14 -5
  38. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.md +15 -2
  39. package/docs/docs/cmd/teams/team/team-list.md +44 -4
  40. package/docs/docs/cmd/todo/task/task-set.md +50 -0
  41. package/package.json +2 -1
package/dist/utils/md.js CHANGED
@@ -1,17 +1,18 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.md = void 0;
4
+ const chalk = require("chalk");
4
5
  const fs = require("fs");
5
6
  const os_1 = require("os");
6
7
  const path = require("path");
7
8
  function convertTitle(md) {
8
9
  return md.replace(/^#\s+(.*)/gm, (match, title) => {
9
- return title.toLocaleUpperCase() + os_1.EOL + Array(title.length + 1).join('=');
10
+ return chalk.bold(title.toLocaleUpperCase()) + os_1.EOL + Array(title.length + 1).join('=');
10
11
  });
11
12
  }
12
13
  function convertHeadings(md) {
13
14
  return md.replace(/^(#+)\s+(.*)/gm, (match, level, content) => {
14
- return `${os_1.EOL}${content.toLocaleUpperCase()}`;
15
+ return `${os_1.EOL}${chalk.bold(content.toLocaleUpperCase())}`;
15
16
  });
16
17
  }
17
18
  function convertAdmonitions(md) {
@@ -31,7 +32,7 @@ function convertDd(md) {
31
32
  });
32
33
  }
33
34
  function convertHyperlinks(md) {
34
- return md.replace(/\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
35
+ return md.replace(/(?!\[1m)(?!\[22m)\[([^\]]+)\]\(([^\)]+)\)/gm, (match, label, url) => {
35
36
  // if the link is the same as the content, return just the link
36
37
  if (label === url) {
37
38
  return url;
@@ -18,3 +18,4 @@ Setting name|Definition|Default value
18
18
  `printErrorsAsPlainText`|When output mode is set to `json`, print error messages as plain-text rather than JSON|`true`
19
19
  `prompt`|Prompts for missing values in required options|`false`
20
20
  `showHelpOnFailure`|Automatically display help when executing a command failed|`true`
21
+ `showSpinner`|Display spinner when executing commands|`true`
@@ -0,0 +1,52 @@
1
+ # pa app export
2
+
3
+ Exports the specified Power App
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 pa app export [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-i, --id <id>`
14
+ : The id of the Power App to export
15
+
16
+ `-e, --environment <environment>`
17
+ : The name of the environment for which to export the app
18
+
19
+ `-n, --packageDisplayName [packageDisplayName]`
20
+ : The display name to use in the exported package
21
+
22
+ `-d, --packageDescription [packageDescription]`
23
+ : The description to use in the exported package
24
+
25
+ `-c, --packageCreatedBy [packageCreatedBy]`
26
+ : The name of the person to be used as the creator of the exported package
27
+
28
+ `-s, --packageSourceEnvironment [packageSourceEnvironment]`
29
+ : The name of the source environment from which the exported package was taken
30
+
31
+ `-p, --path [path]`
32
+ : The path to save the exported package to. If not specified the app will be exported in the current working directory
33
+
34
+ --8<-- "docs/cmd/_global.md"
35
+
36
+ ## Examples
37
+
38
+ Export the specified Power App as a ZIP file
39
+
40
+ ```sh
41
+ m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d
42
+ ```
43
+
44
+ Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
45
+
46
+ ```sh
47
+ m365 pa app export --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --id 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
48
+ ```
49
+
50
+ ## Response
51
+
52
+ The command won't return a response on success.
@@ -0,0 +1,191 @@
1
+ # purview threatassessment get
2
+
3
+ Get a threat assessment
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 purview threatassessment get [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-i, --id <id>`
14
+ : The Id of the threat assessment
15
+
16
+ `--includeResults`
17
+ : Include the threat assessment results
18
+
19
+ --8<-- "docs/cmd/_global.md"
20
+
21
+ ## Examples
22
+
23
+ Get a threat assessment
24
+
25
+ ```sh
26
+ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e
27
+ ```
28
+
29
+ Get a threat assessment including results
30
+
31
+ ```sh
32
+ m365 purview threatassessment get --id c37d695e-d581-4ae9-82a0-9364eba4291e --includeResults
33
+ ```
34
+
35
+ ## Response
36
+
37
+ ### Standard Response
38
+
39
+ === "JSON"
40
+
41
+ ```json
42
+ {
43
+ "id": "8aaba0ac-ec4d-4e62-5774-08db16c68731",
44
+ "createdDateTime": "2023-02-25T00:23:33.0550644Z",
45
+ "contentType": "mail",
46
+ "expectedAssessment": "block",
47
+ "category": "spam",
48
+ "status": "pending",
49
+ "requestSource": "administrator",
50
+ "recipientEmail": "john@contoso.com",
51
+ "destinationRoutingReason": "notJunk",
52
+ "messageUri": "https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=",
53
+ "createdBy": {
54
+ "user": {
55
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
56
+ "displayName": "John Doe"
57
+ }
58
+ }
59
+ }
60
+ ```
61
+
62
+ === "Text"
63
+
64
+ ```text
65
+ category : spam
66
+ contentType : mail
67
+ createdBy : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
68
+ createdDateTime : 2023-02-25T00:23:33.0550644Z
69
+ destinationRoutingReason: notJunk
70
+ expectedAssessment : block
71
+ id : 8aaba0ac-ec4d-4e62-5774-08db16c68731
72
+ messageUri : https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=
73
+ recipientEmail : john@contoso.com
74
+ requestSource : administrator
75
+ status : pending
76
+ ```
77
+
78
+ === "CSV"
79
+
80
+ ```csv
81
+ id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,recipientEmail,destinationRoutingReason,messageUri,createdBy
82
+ 8aaba0ac-ec4d-4e62-5774-08db16c68731,2023-02-25T00:23:33.0550644Z,mail,block,spam,pending,administrator,john@contoso.com,notJunk,https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=,"{""user"":{""id"":""fe36f75e-c103-410b-a18a-2bf6df06ac3a"",""displayName"":""John Doe""}}"
83
+ ```
84
+
85
+ === "Markdown"
86
+
87
+ ```md
88
+ # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731"
89
+
90
+ Date: 25/02/2023
91
+
92
+ ## 8aaba0ac-ec4d-4e62-5774-08db16c68731
93
+
94
+ Property | Value
95
+ ---------|-------
96
+ id | 8aaba0ac-ec4d-4e62-5774-08db16c68731
97
+ createdDateTime | 2023-02-25T00:23:33.0550644Z
98
+ contentType | mail
99
+ expectedAssessment | block
100
+ category | spam
101
+ status | pending
102
+ requestSource | administrator
103
+ recipientEmail | john@contoso.com
104
+ destinationRoutingReason | notJunk
105
+ messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
106
+ createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
107
+ ```
108
+
109
+ ### `includeResults` response
110
+
111
+ When we make use of the option `includeResults` the response will differ.
112
+
113
+ === "JSON"
114
+
115
+ ```json
116
+ {
117
+ "id": "8aaba0ac-ec4d-4e62-5774-08db16c68731",
118
+ "createdDateTime": "2023-02-25T00:23:33.0550644Z",
119
+ "contentType": "mail",
120
+ "expectedAssessment": "block",
121
+ "category": "spam",
122
+ "status": "pending",
123
+ "requestSource": "administrator",
124
+ "recipientEmail": "john@contoso.com",
125
+ "destinationRoutingReason": "notJunk",
126
+ "messageUri": "https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=",
127
+ "createdBy": {
128
+ "user": {
129
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
130
+ "displayName": "John Doe"
131
+ }
132
+ },
133
+ "results": [
134
+ {
135
+ "id": "a5455871-18d1-44d8-0866-08db16c68b85",
136
+ "createdDateTime": "2023-02-25T00:23:40.28Z",
137
+ "resultType": "checkPolicy",
138
+ "message": "No policy was hit."
139
+ }
140
+ ]
141
+ }
142
+ ```
143
+
144
+ === "Text"
145
+
146
+ ```text
147
+ category : spam
148
+ contentType : mail
149
+ createdBy : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
150
+ createdDateTime : 2023-02-25T00:23:33.0550644Z
151
+ destinationRoutingReason: notJunk
152
+ expectedAssessment : block
153
+ id : 8aaba0ac-ec4d-4e62-5774-08db16c68731
154
+ messageUri : https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=
155
+ recipientEmail : john@contoso.com
156
+ requestSource : administrator
157
+ results : [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
158
+ status : pending
159
+ ```
160
+
161
+ === "CSV"
162
+
163
+ ```csv
164
+ id,createdDateTime,contentType,expectedAssessment,category,status,requestSource,recipientEmail,destinationRoutingReason,messageUri,createdBy,results
165
+ 8aaba0ac-ec4d-4e62-5774-08db16c68731,2023-02-25T00:23:33.0550644Z,mail,block,spam,pending,administrator,john@contoso.com,notJunk,https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E_hLMK5kAALHNaMuAAA=,"{""user"":{""id"":""fe36f75e-c103-410b-a18a-2bf6df06ac3a"",""displayName"":""John Doe""}}","[{""id"":""a5455871-18d1-44d8-0866-08db16c68b85"",""createdDateTime"":""2023-02-25T00:23:40.28Z"",""resultType"":""checkPolicy"",""message"":""No policy was hit.""}]"
166
+ ```
167
+
168
+ === "Markdown"
169
+
170
+ ```md
171
+ # purview threatassessment get --id "8aaba0ac-ec4d-4e62-5774-08db16c68731" --includeResults "true"
172
+
173
+ Date: 25/02/2023
174
+
175
+ ## 8aaba0ac-ec4d-4e62-5774-08db16c68731
176
+
177
+ Property | Value
178
+ ---------|-------
179
+ id | 8aaba0ac-ec4d-4e62-5774-08db16c68731
180
+ createdDateTime | 2023-02-25T00:23:33.0550644Z
181
+ contentType | mail
182
+ expectedAssessment | block
183
+ category | spam
184
+ status | pending
185
+ requestSource | administrator
186
+ recipientEmail | john@contoso.com
187
+ destinationRoutingReason | notJunk
188
+ messageUri | https://graph.microsoft.com/v1.0/users/john@contoso.com/messages/AAMkADgzN2Q1NThiLTI0NjYtNGIxYS05MDdjLTg1OWQxNzgwZGM2ZgBGAAAAAAC6jQfUzacTSIHqMw2yacnUBwBiOC8xvYmdT6G2E\_hLMK5kAAAAAAEMAABiOC8xvYmdT6G2E\_hLMK5kAALHNaMuAAA=
189
+ createdBy | {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
190
+ results | [{"id":"a5455871-18d1-44d8-0866-08db16c68b85","createdDateTime":"2023-02-25T00:23:40.28Z","resultType":"checkPolicy","message":"No policy was hit."}]
191
+ ```
@@ -29,13 +29,13 @@ m365 spfx project upgrade [options]
29
29
 
30
30
  ## Remarks
31
31
 
32
- The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.16.1).
32
+ The `spfx project upgrade` command helps you upgrade your SharePoint Framework project to the specified version. If no version is specified, the command will upgrade to the latest version of the SharePoint Framework it supports (v1.17.0).
33
33
 
34
34
  This command doesn't change your project files. Instead, it gives you a report with all steps necessary to upgrade your project to the specified version of the SharePoint Framework. Changing project files is error-prone, especially when it comes to updating your solution's code. This is why at this moment, this command produces a report that you can use yourself to perform the necessary updates and verify that everything is working as expected.
35
35
 
36
36
  !!! important
37
37
  Run this command in the folder where the project that you want to upgrade is located. This command doesn't change your project files.
38
-
38
+
39
39
  ## Examples
40
40
 
41
41
  Get instructions to upgrade the current SharePoint Framework project to SharePoint Framework version 1.5.0 and save the findings in a Markdown file
@@ -22,6 +22,9 @@ m365 spo applicationcustomizer add [options]
22
22
  `--clientSideComponentProperties [clientSideComponentProperties]`
23
23
  : JSON string with application customizer properties
24
24
 
25
+ `-s, --scope [scope]`
26
+ : Scope of the application customizer. Allowed values: `Site`, `Web`. Defaults to `Site`.
27
+
25
28
  --8<-- "docs/cmd/_global.md"
26
29
 
27
30
  ## Remarks
@@ -48,7 +51,7 @@ m365 spo applicationcustomizer add --title 'Some customizer' --clientSideCompone
48
51
  Adds an application customizer to the sales site with some properties.
49
52
 
50
53
  ```sh
51
- m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales
54
+ m365 spo applicationcustomizer add --title 'Some customizer' --clientSideComponentId 799883f5-7962-4384-a10a-105adaec6ffc --clientSideComponentProperties '{ "someProperty": "Some value" }' --webUrl https://contoso.sharepoint.com/sites/sales --scope 'Site'
52
55
  ```
53
56
 
54
57
  ## Response
@@ -0,0 +1,109 @@
1
+ # spo applicationcustomizer list
2
+
3
+ Get a list of application customizers that are added to a site.
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo applicationcustomizer list [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : The url of the site.
15
+
16
+ `-s, --scope [scope]`
17
+ : Scope of the application customizers. Allowed values `Site`, `Web`, `All`. Defaults to `All`
18
+
19
+ --8<-- "docs/cmd/_global.md"
20
+
21
+ ## Examples
22
+
23
+ Retrieves a list of application customizers.
24
+
25
+ ```sh
26
+ m365 spo applicationcustomizer list --webUrl https://contoso.sharepoint.com/sites/sales
27
+ ```
28
+
29
+ ## Response
30
+
31
+ === "JSON"
32
+
33
+ ```json
34
+ [
35
+ {
36
+ "ClientSideComponentId": "4358e70e-ec3c-4713-beb6-39c88f7621d1",
37
+ "ClientSideComponentProperties": "{\"listTitle\":\"News\",\"listViewTitle\":\"Published News\"}",
38
+ "CommandUIExtension": null,
39
+ "Description": null,
40
+ "Group": null,
41
+ "HostProperties": "",
42
+ "Id": "f405303c-6048-4636-9660-1b7b2cadaef9",
43
+ "ImageUrl": null,
44
+ "Location": "ClientSideExtension.ApplicationCustomizer",
45
+ "Name": "{f405303c-6048-4636-9660-1b7b2cadaef9}",
46
+ "RegistrationId": null,
47
+ "RegistrationType": 0,
48
+ "Rights": {
49
+ "High": 0,
50
+ "Low": 0
51
+ },
52
+ "Scope": 3,
53
+ "ScriptBlock": null,
54
+ "ScriptSrc": null,
55
+ "Sequence": 65536,
56
+ "Title": "NewsTicker",
57
+ "Url": null,
58
+ "VersionOfUserCustomAction": "1.0.1.0"
59
+ }
60
+ ]
61
+ ```
62
+
63
+ === "Text"
64
+
65
+ ```text
66
+ Name Location Scope Id
67
+ -------------------------------------- ----------------------------------------- ----- ------------------------------------
68
+ {f405303c-6048-4636-9660-1b7b2cadaef9} ClientSideExtension.ApplicationCustomizer 3 f405303c-6048-4636-9660-1b7b2cadaef9
69
+ ```
70
+
71
+ === "CSV"
72
+
73
+ ```csv
74
+ Name,Location,Scope,Id
75
+ {f405303c-6048-4636-9660-1b7b2cadaef9},ClientSideExtension.ApplicationCustomizer,3,f405303c-6048-4636-9660-1b7b2cadaef9
76
+ ```
77
+
78
+ === "Markdown"
79
+
80
+ ```md
81
+ # spo applicationcustomizer list --webUrl "https://contoso.sharepoint.com"
82
+
83
+ Date: 28/2/2023
84
+
85
+ ## NewsTicker (f405303c-6048-4636-9660-1b7b2cadaef9)
86
+
87
+ Property | Value
88
+ ---------|-------
89
+ ClientSideComponentId | 4358e70e-ec3c-4713-beb6-39c88f7621d1
90
+ ClientSideComponentProperties | {"listTitle":"News","listViewTitle":"Published News"}
91
+ CommandUIExtension | null
92
+ Description | null
93
+ Group | null
94
+ HostProperties |
95
+ Id | f405303c-6048-4636-9660-1b7b2cadaef9
96
+ ImageUrl | null
97
+ Location | ClientSideExtension.ApplicationCustomizer
98
+ Name | {f405303c-6048-4636-9660-1b7b2cadaef9}
99
+ RegistrationId | null
100
+ RegistrationType | 0
101
+ Rights | {"High":0,"Low":0}
102
+ Scope | 3
103
+ ScriptBlock | null
104
+ ScriptSrc | null
105
+ Sequence | 65536
106
+ Title | NewsTicker
107
+ Url | null
108
+ VersionOfUserCustomAction | 1.0.1.0
109
+ ```
@@ -22,12 +22,17 @@ m365 spo file retentionlabel ensure [options]
22
22
  `--name <name>`
23
23
  : Name of the retention label to apply to the file.
24
24
 
25
+ `-a, --assetId [assetId]`
26
+ : A Compliance Asset Id to set on the item when it's labeled. See below for more information.
27
+
25
28
  --8<-- "docs/cmd/_global.md"
26
29
 
27
30
  ## Remarks
28
31
 
29
32
  You can also use [spo listitem retentionlabel remove](./../../../cmd/spo//listitem/listitem-retentionlabel-remove.md) for removing the retentionlabel from a listitem.
30
33
 
34
+ The `--assetId` option has 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.
35
+
31
36
  ## Examples
32
37
 
33
38
  Applies a retention label to a file based on the label name and the fileUrl
@@ -39,7 +44,13 @@ m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/site
39
44
  Applies a retention label to a file based on the label name and the fileId
40
45
 
41
46
  ```sh
42
- m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8' --name 'Some label'
47
+ m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8' --name 'Some label'
48
+ ```
49
+
50
+ Applies a event-based retention label to a file and updates the Asset Id field
51
+
52
+ ```sh
53
+ m365 spo file retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --fileId '26541f96-017c-4189-a604-599e083533b8' --name 'Some label' --assetId 'XYZ'
43
54
  ```
44
55
 
45
56
  ## Response
@@ -56,7 +56,7 @@ m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-
56
56
  Remove view with title _MyView_ from a list with url _/sites/project-x/lists/Events_ located in site _https://contoso.sharepoint.com/sites/project-x_
57
57
 
58
58
  ```sh
59
- m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --viewTitle MyView
59
+ m365 spo list view remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl '/sites/project-x/lists/Events' --title MyView
60
60
  ```
61
61
 
62
62
  Remove view with ID _cc27a922-8224-4296-90a5-ebbc54da2e81_ from a list with title _Documents_ located in site _https://contoso.sharepoint.com/sites/project-x_ without being asked for confirmation
@@ -58,13 +58,13 @@ Update view formatting of the specified list view
58
58
  === "PowerShell"
59
59
 
60
60
  ```sh
61
- m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter '{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] &lt;= @now, ''sp-field-severity--severeWarning'', '''')\"}'
61
+ m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'All items' --CustomFormatter '{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] &lt;= @now, ''sp-field-severity--severeWarning'', '''')\"}'
62
62
  ```
63
63
 
64
64
  === "Bash"
65
65
 
66
66
  ```sh
67
- m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --viewTitle 'All items' --CustomFormatter "{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] &lt;= @now, 'sp-field-severity--severeWarning', '')\"}"
67
+ m365 spo list view set --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'My List' --title 'All items' --CustomFormatter "{\"schema\":\"https://developer.microsoft.com/json-schemas/sp/view-formatting.schema.json\",\"additionalRowClass\": \"=if([$DueDate] &lt;= @now, 'sp-field-severity--severeWarning', '')\"}"
68
68
  ```
69
69
 
70
70
  ## Response
@@ -13,17 +13,20 @@ m365 spo listitem get [options]
13
13
  `-u, --webUrl <webUrl>`
14
14
  : URL of the site where the item is located.
15
15
 
16
- `-i, --id <id>`
17
- : ID of the item to retrieve.
16
+ `-i, --id [id]`
17
+ : ID of the item to retrieve. Specify either `id` or `uniqueId` but not both.
18
+
19
+ `--uniqueId [uniqueId]`
20
+ : The Unique ID (GUID) of the item to retrieve. Specify either `id` or `uniqueId` but not both.
18
21
 
19
22
  `-l, --listId [listId]`
20
- : ID of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
23
+ : ID of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
21
24
 
22
25
  `-t, --listTitle [listTitle]`
23
- : Title of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
26
+ : Title of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
24
27
 
25
28
  `--listUrl [listUrl]`
26
- : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
29
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
27
30
 
28
31
  `-p, --properties [properties]`
29
32
  : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested.
@@ -45,6 +48,12 @@ Get an item with the ID parameter from a given list in a given site.
45
48
  m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
46
49
  ```
47
50
 
51
+ Get an item with the Unique ID parameter from a given list in a given site.
52
+
53
+ ```sh
54
+ m365 spo listitem get --listTitle "Demo List" --uniqueId "64dc28c4-3c43-45f6-ba66-307d9eb7e6aa" --webUrl https://contoso.sharepoint.com/sites/project-x
55
+ ```
56
+
48
57
  Get an item columns with the ID parameter from a given list in a given site.
49
58
 
50
59
  ```sh
@@ -31,11 +31,18 @@ m365 spo listitem retentionlabel ensure [options]
31
31
  `-i, --id [id]`
32
32
  : The id of the retention label. Specify either `name` or `id`.
33
33
 
34
+ `-a, --assetId [assetId]`
35
+ : A Compliance Asset Id to set on the item when it's labeled. See below for more information.
36
+
34
37
  --8<-- "docs/cmd/_global.md"
35
38
 
39
+ ## Remarks
40
+
41
+ The `--assetId` option has 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.
42
+
36
43
  ## Examples
37
44
 
38
- Applies the retention label _Some label_ to a list item in a given site based on the list id and label name
45
+ Applies a retention label to a list item in a given site based on the list id and label name
39
46
 
40
47
  ```sh
41
48
  m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listId 0cd891ef-afce-4e55-b836-fce03286cccf --listItemId 1 --name 'Some label'
@@ -47,12 +54,18 @@ Applies a retention label to a list item in a given site based on the list title
47
54
  m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'List 1' --listItemId 1 --id '7a621a91-063b-461b-aff6-d713d5fb23eb'
48
55
  ```
49
56
 
50
- Applies the retention label _Some label_ to a list item in a given site based on the server relative list url
57
+ Applies a retention label to a list item in a given site based on the server relative list url
51
58
 
52
59
  ```sh
53
60
  m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --listItemId 1 --name 'Some label'
54
61
  ```
55
62
 
63
+ Applies a retention label to a list item in a given site based on the server relative list url and updates the Asset Id field
64
+
65
+ ```sh
66
+ m365 spo listitem retentionlabel ensure --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl /sites/project-x/lists/TestList --listItemId 1 --name 'Some label' --assetId 'XYZ'
67
+ ```
68
+
56
69
  ## Response
57
70
 
58
71
  The command won't return a response on success.
@@ -37,20 +37,60 @@ m365 teams team list --joined
37
37
 
38
38
  === "JSON"
39
39
 
40
- ``` json
40
+ ```json
41
41
  [
42
42
  {
43
43
  "id": "5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3",
44
+ "createdDateTime": "2022-12-08T09:17:55.039Z",
44
45
  "displayName": "Architecture",
46
+ "description": "Architecture Discussion",
47
+ "internalId": "19:pLknmKPPkvgeaG0FtegLfjoDINeY3gvmitMkNG9H3X41@thread.tacv2",
48
+ "classification": null,
49
+ "specialization": "none",
50
+ "visibility": "public",
51
+ "webUrl": "https://teams.microsoft.com/l/team/19:a5c6eccad3fb401997756a1501d561aa%40thread.skype/conversations?groupId=8090c93e-ba7c-433e-9f39-08c7ba07c0b3&tenantId=dcd219dd-bc68-4b9b-bf0b-4a33a796be35",
45
52
  "isArchived": false,
46
- "description": "Architecture Discussion"
53
+ "isMembershipLimitedToOwners": false,
54
+ "discoverySettings": {
55
+ "showInTeamsSearchAndSuggestions": true
56
+ },
57
+ "memberSettings": {
58
+ "allowCreateUpdateChannels": true,
59
+ "allowCreatePrivateChannels": true,
60
+ "allowDeleteChannels": true,
61
+ "allowAddRemoveApps": true,
62
+ "allowCreateUpdateRemoveTabs": true,
63
+ "allowCreateUpdateRemoveConnectors": true
64
+ },
65
+ "guestSettings": {
66
+ "allowCreateUpdateChannels": false,
67
+ "allowDeleteChannels": false
68
+ },
69
+ "messagingSettings": {
70
+ "allowUserEditMessages": false,
71
+ "allowUserDeleteMessages": false,
72
+ "allowOwnerDeleteMessages": false,
73
+ "allowTeamMentions": true,
74
+ "allowChannelMentions": true
75
+ },
76
+ "funSettings": {
77
+ "allowGiphy": true,
78
+ "giphyContentRating": "moderate",
79
+ "allowStickersAndMemes": true,
80
+ "allowCustomMemes": false
81
+ },
82
+ "summary": {
83
+ "ownersCount": 1,
84
+ "membersCount": 1,
85
+ "guestsCount": 0
86
+ }
47
87
  }
48
88
  ]
49
89
  ```
50
90
 
51
91
  === "Text"
52
92
 
53
- ``` text
93
+ ```text
54
94
  id displayName isArchived description
55
95
  ------------------------------------ ---------------- ---------- ---------------------------------------
56
96
  5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3 Architecture false Architecture Discussion
@@ -58,7 +98,7 @@ m365 teams team list --joined
58
98
 
59
99
  === "CSV"
60
100
 
61
- ``` text
101
+ ```csv
62
102
  id,displayName,isArchived,description
63
103
  5dc7ba76-b9aa-4fdd-9e91-9fe7d0e8dca3,Architecture,,Architecture Discussion
64
104
  ```