@pnp/cli-microsoft365 6.2.0-beta.0ce0a85 → 6.2.0-beta.51aa7cb

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 (70) hide show
  1. package/dist/m365/context/commands/option/option-remove.js +105 -0
  2. package/dist/m365/context/commands/option/option-set.js +84 -0
  3. package/dist/m365/context/commands.js +2 -0
  4. package/dist/m365/onenote/commands/page/page-list.js +137 -0
  5. package/dist/m365/onenote/commands.js +2 -1
  6. package/dist/m365/planner/commands/bucket/bucket-add.js +0 -6
  7. package/dist/m365/planner/commands/bucket/bucket-get.js +0 -6
  8. package/dist/m365/planner/commands/bucket/bucket-list.js +0 -6
  9. package/dist/m365/planner/commands/bucket/bucket-remove.js +0 -6
  10. package/dist/m365/planner/commands/bucket/bucket-set.js +0 -6
  11. package/dist/m365/planner/commands/plan/plan-add.js +0 -6
  12. package/dist/m365/planner/commands/plan/plan-get.js +0 -6
  13. package/dist/m365/planner/commands/plan/plan-list.js +0 -6
  14. package/dist/m365/planner/commands/plan/plan-remove.js +0 -6
  15. package/dist/m365/planner/commands/plan/plan-set.js +0 -6
  16. package/dist/m365/planner/commands/task/task-add.js +0 -6
  17. package/dist/m365/planner/commands/task/task-checklistitem-add.js +0 -6
  18. package/dist/m365/planner/commands/task/task-checklistitem-list.js +0 -6
  19. package/dist/m365/planner/commands/task/task-get.js +0 -6
  20. package/dist/m365/planner/commands/task/task-list.js +0 -6
  21. package/dist/m365/planner/commands/task/task-reference-list.js +0 -6
  22. package/dist/m365/planner/commands/task/task-set.js +0 -6
  23. package/dist/m365/pp/commands/aibuildermodel/aibuildermodel-get.js +110 -0
  24. package/dist/m365/pp/commands/aibuildermodel/aibuildermodel-remove.js +130 -0
  25. package/dist/m365/pp/commands/solution/solution-publish.js +156 -0
  26. package/dist/m365/pp/commands.js +3 -0
  27. package/dist/m365/purview/commands/retentionlabel/retentionlabel-add.js +143 -0
  28. package/dist/m365/purview/commands.js +1 -0
  29. package/dist/m365/spo/commands/file/file-retentionlabel-ensure.js +121 -0
  30. package/dist/m365/spo/commands/file/file-retentionlabel-remove.js +141 -0
  31. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +138 -0
  32. package/dist/m365/spo/commands/folder/folder-retentionlabel-remove.js +157 -0
  33. package/dist/m365/spo/commands/group/group-member-add.js +33 -6
  34. package/dist/m365/spo/commands/list/list-add.js +3 -0
  35. package/dist/m365/spo/commands/list/list-retentionlabel-remove.js +146 -0
  36. package/dist/m365/spo/commands/list/list-set.js +3 -0
  37. package/dist/m365/spo/commands/listitem/listitem-list.js +1 -1
  38. package/dist/m365/spo/commands/listitem/listitem-retentionlabel-remove.js +2 -2
  39. package/dist/m365/spo/commands/term/term-list.js +99 -29
  40. package/dist/m365/spo/commands.js +5 -0
  41. package/dist/m365/teams/commands/message/message-send.js +81 -0
  42. package/dist/m365/teams/commands.js +1 -0
  43. package/dist/utils/formatting.js +22 -0
  44. package/docs/docs/cmd/context/option/option-remove.md +37 -0
  45. package/docs/docs/cmd/context/option/option-set.md +31 -0
  46. package/docs/docs/cmd/onenote/page/page-list.md +140 -0
  47. package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-get.md +99 -0
  48. package/docs/docs/cmd/pp/aibuildermodel/aibuildermodel-remove.md +53 -0
  49. package/docs/docs/cmd/pp/solution/solution-publish.md +52 -0
  50. package/docs/docs/cmd/purview/retentionlabel/retentionlabel-add.md +128 -0
  51. package/docs/docs/cmd/spo/cdn/cdn-get.md +1 -1
  52. package/docs/docs/cmd/spo/cdn/cdn-origin-add.md +1 -1
  53. package/docs/docs/cmd/spo/cdn/cdn-origin-list.md +1 -1
  54. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.md +1 -1
  55. package/docs/docs/cmd/spo/cdn/cdn-policy-list.md +1 -1
  56. package/docs/docs/cmd/spo/cdn/cdn-policy-set.md +1 -1
  57. package/docs/docs/cmd/spo/cdn/cdn-set.md +1 -1
  58. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.md +47 -0
  59. package/docs/docs/cmd/spo/file/file-retentionlabel-remove.md +43 -0
  60. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.md +47 -0
  61. package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.md +43 -0
  62. package/docs/docs/cmd/spo/group/group-member-add.md +22 -4
  63. package/docs/docs/cmd/spo/list/list-add.md +3 -9
  64. package/docs/docs/cmd/spo/list/list-retentionlabel-remove.md +52 -0
  65. package/docs/docs/cmd/spo/list/list-set.md +3 -3
  66. package/docs/docs/cmd/spo/listitem/listitem-get.md +11 -12
  67. package/docs/docs/cmd/spo/listitem/listitem-list.md +5 -5
  68. package/docs/docs/cmd/spo/term/term-list.md +138 -0
  69. package/docs/docs/cmd/teams/message/message-send.md +119 -0
  70. package/package.json +1 -1
@@ -0,0 +1,43 @@
1
+ # spo folder retentionlabel remove
2
+
3
+ Clears the retention label from a folder
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo folder retentionlabel remove [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : The url of the web.
15
+
16
+ `--folderUrl [folderUrl]`
17
+ : The site- or server relative URL of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
18
+
19
+ `-i, --folderId [folderId]`
20
+ : The UniqueId (GUID) of the folder of which the label should be removed. Specify either `folderUrl` or `folderId` but not both.
21
+
22
+ `--confirm`
23
+ : Don't prompt for confirming to remove the label.
24
+
25
+ --8<-- "docs/cmd/_global.md"
26
+
27
+ ## Examples
28
+
29
+ Removes the retention label from a folder in a given site based on the folder id
30
+
31
+ ```sh
32
+ m365 spo folder retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --folderId 0cd891ef-afce-4e55-b836-fce03286cccf
33
+ ```
34
+
35
+ Removes the retention label from a folder in a given site based on the folder url
36
+
37
+ ```sh
38
+ m365 spo folder retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --folderUrl /sites/project-x/Shared Documents/Folder --id 1
39
+ ```
40
+
41
+ ## Response
42
+
43
+ The command won't return a response on success.
@@ -20,19 +20,25 @@ m365 spo group member add [options]
20
20
  : Name of the SharePoint Group to which the user needs to be added, specify either `groupId` or `groupName`
21
21
 
22
22
  `--userName [userName]`
23
- : User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
23
+ : User's UPN (user principal name, eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
24
24
 
25
25
  `--email [email]`
26
- : User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com), specify either `userName`, `email` or `userId`
26
+ : User's email (eg. megan.bowen@contoso.com). If multiple users need to be added, they have to be comma separated (ex. megan.bowen@contoso.com,alex.wilber@contoso.com). Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
27
27
 
28
28
  `--userId [userId]`
29
- : The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Id's have to be comma separated. Specify either `userName`, `email` or `userId`
29
+ : The user Id of the user to add as a member. (Id of the site user, for example: 14) If multiple users need to be added, the Ids have to be comma separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
30
+
31
+ `--aadGroupId [aadGroupId]`
32
+ : The object Id of the Azure AD group to add as a member. If multiple groups need to be added, the Ids have to be comma separated. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
33
+
34
+ `--aadGroupName [aadGroupName]`
35
+ : The name of the Azure AD group to add as a member. Specify either `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName`
30
36
 
31
37
  --8<-- "docs/cmd/_global.md"
32
38
 
33
39
  ## Remarks
34
40
 
35
- For the `--userName` or `--email` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list invalid values.
41
+ For the `userId`, `userName`, `email`, `aadGroupId` or `aadGroupName` options you can specify multiple values by separating them with a comma. If one of the specified entries is not valid, the command will fail with an error message showing the list of invalid values.
36
42
 
37
43
  ## Examples
38
44
 
@@ -72,6 +78,18 @@ Add multiple users with the userId parameter to a SharePoint group with the grou
72
78
  m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --userId "5,12"
73
79
  ```
74
80
 
81
+ Add multiple users with the aadUserId parameter to a SharePoint group with the groupId parameter
82
+
83
+ ```sh
84
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --aadUserId "56ca9023-3449-4e98-a96a-69e81a6f4983,a96c1755-8aec-4f4d-955f-08504510dc56"
85
+ ```
86
+
87
+ Add multiple users with the aadUserName parameter to a SharePoint group with the groupId parameter
88
+
89
+ ```sh
90
+ m365 spo group member add --webUrl https://contoso.sharepoint.com/sites/SiteA --groupId 5 --aadUserName "Azure group one, Azure group two"
91
+ ```
92
+
75
93
  ## Response
76
94
 
77
95
  === "JSON"
@@ -25,9 +25,6 @@ m365 spo list add [options]
25
25
  `--templateFeatureId [templateFeatureId]`
26
26
  : The globally unique identifier (GUID) of a template feature that is associated with the list
27
27
 
28
- `--schemaXml [schemaXml]`
29
- : The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
30
-
31
28
  `--allowDeletion [allowDeletion]`
32
29
  : Boolean value specifying whether the list can be deleted. Valid values are `true,false`
33
30
 
@@ -199,6 +196,9 @@ m365 spo list add [options]
199
196
  `--writeSecurity [writeSecurity]`
200
197
  : Gets or sets the Write security setting for the list. Valid values are 1 (All users can modify all items)|2 (Users can modify only items that they create)|4 (Users cannot modify any list item)
201
198
 
199
+ `--schemaXml [schemaXml]`
200
+ : (deprecated) The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
201
+
202
202
  --8<-- "docs/cmd/_global.md"
203
203
 
204
204
  ## Examples
@@ -209,12 +209,6 @@ Add a list with title _Announcements_ and baseTemplate _Announcements_ in site _
209
209
  m365 spo list add --title Announcements --baseTemplate Announcements --webUrl https://contoso.sharepoint.com/sites/project-x
210
210
  ```
211
211
 
212
- Add a list with title _Announcements_, baseTemplate _Announcements_ in site _https://contoso.sharepoint.com/sites/project-x_ using a custom XML schema
213
-
214
- ```sh
215
- m365 spo list add --title Announcements --baseTemplate Announcements --webUrl https://contoso.sharepoint.com/sites/project-x --schemaXml '<List xmlns:ows="Microsoft SharePoint" Title="List1" FolderCreation="FALSE" Direction="$Resources:Direction;" Url="Lists/List1" BaseType="0" xmlns="http://schemas.microsoft.com/sharepoint/"><MetaData><ContentTypes><ContentTypeRef ID="0x01"><Folder TargetName="Item" /></ContentTypeRef><ContentTypeRef ID="0x0120" /></ContentTypes><Fields><Field ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Type="Text" Name="Title" DisplayName="$Resources:core,Title;" Required="TRUE" SourceID="http://schemas.microsoft.com/sharepoint/v3" StaticName="Title" MaxLength="255" /></Fields><Views><View BaseViewID="0" Type="HTML" MobileView="TRUE" TabularView="FALSE"><Toolbar Type="Standard" /><XslLink Default="TRUE">main.xsl</XslLink><RowLimit Paged="TRUE">30</RowLimit><ViewFields><FieldRef Name="LinkTitleNoMenu"></FieldRef></ViewFields><Query><OrderBy><FieldRef Name="Modified" Ascending="FALSE"></FieldRef></OrderBy></Query><ParameterBindings><ParameterBinding Name="AddNewAnnouncement" Location="Resource(wss,addnewitem)" /><ParameterBinding Name="NoAnnouncements" Location="Resource(wss,noXinviewofY_LIST)" /><ParameterBinding Name="NoAnnouncementsHowTo" Location="Resource(wss,noXinviewofY_ONET_HOME)" /></ParameterBindings></View><View BaseViewID="1" Type="HTML" WebPartZoneID="Main" DisplayName="$Resources:core,objectiv_schema_mwsidcamlidC24;" DefaultView="TRUE" MobileView="TRUE" MobileDefaultView="TRUE" SetupPath="pages\viewpage.aspx" ImageUrl="/_layouts/15/images/generic.png?rev=23" Url="AllItems.aspx"><Toolbar Type="Standard" /><XslLink Default="TRUE">main.xsl</XslLink><JSLink>clienttemplates.js</JSLink><RowLimit Paged="TRUE">30</RowLimit><ViewFields><FieldRef Name="LinkTitle"></FieldRef></ViewFields><Query><OrderBy><FieldRef Name="ID"></FieldRef></OrderBy></Query><ParameterBindings><ParameterBinding Name="NoAnnouncements" Location="Resource(wss,noXinviewofY_LIST)" /><ParameterBinding Name="NoAnnouncementsHowTo" Location="Resource(wss,noXinviewofY_DEFAULT)" /></ParameterBindings></View></Views><Forms><Form Type="DisplayForm" Url="DispForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" /><Form Type="EditForm" Url="EditForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" /><Form Type="NewForm" Url="NewForm.aspx" SetupPath="pages\form.aspx" WebPartZoneID="Main" /></Forms></MetaData></List>'
216
- ```
217
-
218
212
  Add a list with title _Announcements_, baseTemplate _Announcements_ in site _https://contoso.sharepoint.com/sites/project-x_ with content types and versioning enabled and major version limit set to _50_
219
213
 
220
214
  ```sh
@@ -0,0 +1,52 @@
1
+ # spo list retentionlabel remove
2
+
3
+ Clears the retention label on the specified list or library.
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 spo list retentionlabel remove [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-u, --webUrl <webUrl>`
14
+ : The URL of the site where the list is located.
15
+
16
+ `-t, --listTitle [listTitle]`
17
+ : The title of the list on which to remove the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
18
+
19
+ `-i, --listId [listId]`
20
+ : The ID of the list on which to remove the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
21
+
22
+ `-l, --listUrl [listUrl]`
23
+ : Server- or web-relative URL of the list on which to remove the label. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
24
+
25
+ `--confirm`
26
+ : Don't prompt for confirmation.
27
+
28
+ --8<-- "docs/cmd/_global.md"
29
+
30
+ ## Examples
31
+
32
+ Clears the retention label on a given list by URL
33
+
34
+ ```sh
35
+ m365 spo list retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --listUrl 'Shared Documents'
36
+ ```
37
+
38
+ Clears the retention label on a given list by title
39
+
40
+ ```sh
41
+ m365 spo list retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --listTitle 'Documents'
42
+ ```
43
+
44
+ Clears the retention label on a given list by ID without confirmation
45
+
46
+ ```sh
47
+ m365 spo list retentionlabel remove --webUrl https://contoso.sharepoint.com/sites/project-x --listId 'Documents' --confirm
48
+ ```
49
+
50
+ ## Response
51
+
52
+ The command won't return a response on success.
@@ -178,9 +178,6 @@ m365 spo list set [options]
178
178
  `--restrictUserUpdates [restrictUserUpdates]`
179
179
  : A boolean value that indicates whether the this list is a restricted one or not The value can't be changed if there are existing items in the list
180
180
 
181
- `--schemaXml [schemaXml]`
182
- : The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
183
-
184
181
  `--sendToLocationName [sendToLocationName]`
185
182
  : Gets or sets a file name to use when copying an item in the list to another document library.
186
183
 
@@ -205,6 +202,9 @@ m365 spo list set [options]
205
202
  `--writeSecurity [writeSecurity]`
206
203
  : Gets or sets the Write security setting for the list. Valid values are 1 (All users can modify all items)|2 (Users can modify only items that they create)|4 (Users cannot modify any list item)
207
204
 
205
+ `--schemaXml [schemaXml]`
206
+ : (deprecated) The schema in Collaborative Application Markup Language (CAML) schemas that defines the list
207
+
208
208
  --8<-- "docs/cmd/_global.md"
209
209
 
210
210
  ## Examples
@@ -11,25 +11,25 @@ m365 spo listitem get [options]
11
11
  ## Options
12
12
 
13
13
  `-u, --webUrl <webUrl>`
14
- : URL of the site from which the item should be retrieved
14
+ : URL of the site where the item is located.
15
15
 
16
16
  `-i, --id <id>`
17
17
  : ID of the item to retrieve.
18
18
 
19
19
  `-l, --listId [listId]`
20
- : ID of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
20
+ : ID of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
21
21
 
22
22
  `-t, --listTitle [listTitle]`
23
- : Title of the list where the item should be added. Specify either `listTitle`, `listId` or `listUrl`
23
+ : Title of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
24
24
 
25
25
  `--listUrl [listUrl]`
26
- : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
26
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl` but not multiple.
27
27
 
28
28
  `-p, --properties [properties]`
29
- : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested
29
+ : Comma-separated list of properties to retrieve. Will retrieve all properties if not specified and json output is requested.
30
30
 
31
31
  `--withPermissions`
32
- : Set if you want to return associated roles and permissions
32
+ : Set if you want to return associated roles and permissions.
33
33
 
34
34
  --8<-- "docs/cmd/_global.md"
35
35
 
@@ -39,37 +39,36 @@ If you want to specify a lookup type in the `properties` option, define which co
39
39
 
40
40
  ## Examples
41
41
 
42
- Get an item with the ID parameter from a given list in a given site
42
+ Get an item with the ID parameter from a given list in a given site.
43
43
 
44
44
  ```sh
45
45
  m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x
46
46
  ```
47
47
 
48
- Get an item columns with the ID parameter from a given list in a given site
48
+ Get an item columns with the ID parameter from a given list in a given site.
49
49
 
50
50
  ```sh
51
51
  m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created"
52
52
  ```
53
53
 
54
- Get an item columns and lookup column with the ID parameter from a given list in a given site
54
+ Get an item columns and lookup column with the ID parameter from a given list in a given site.
55
55
 
56
56
  ```sh
57
57
  m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
58
58
  ```
59
59
 
60
- Get an item with specific properties from a given list based on the server-relative URL in a specific site
60
+ Get an item with specific properties from a given list based on the server-relative URL in a specific site.
61
61
 
62
62
  ```sh
63
63
  m365 spo listitem get --listUrl /sites/project-x/documents --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --properties "Title,Created,Company/Title"
64
64
  ```
65
65
 
66
- Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions
66
+ Get an item with ID parameter from a given list based on the server-relative URL in a specific site with permissions.
67
67
 
68
68
  ```sh
69
69
  m365 spo listitem get --listTitle "Demo List" --id 147 --webUrl https://contoso.sharepoint.com/sites/project-x --withPermissions
70
70
  ```
71
71
 
72
-
73
72
  ## Response
74
73
 
75
74
  === "JSON"
@@ -13,14 +13,14 @@ m365 spo listitem list [options]
13
13
  `-u, --webUrl <webUrl>`
14
14
  : URL of the site from which the item should be retrieved.
15
15
 
16
- `-i, --listId [listId]`
17
- : ID of the list to retrieve items from. Specify `listId` or `listTitle` but not both.
18
-
19
16
  `-l, --listId [listId]`
20
- : ID of the list where the item should be added. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
17
+ : ID of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
21
18
 
22
19
  `-t, --listTitle [listTitle]`
23
- : Title of the list where the item should be added. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
20
+ : Title of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
21
+
22
+ `--listUrl [listUrl]`
23
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId`, or `listUrl` but not multiple.
24
24
 
25
25
  `-q, --camlQuery [camlQuery]`
26
26
  : CAML query to use to query the list of items with.
@@ -22,6 +22,9 @@ m365 spo term list [options]
22
22
  `--termSetName [termSetName]`
23
23
  : Name of the term set for which to retrieve terms. Specify `termSetId` or `termSetName` but not both
24
24
 
25
+ `--includeChildTerms`
26
+ : If specified, child terms are loaded as well.
27
+
25
28
  --8<-- "docs/cmd/_global.md"
26
29
 
27
30
  !!! important
@@ -40,3 +43,138 @@ List taxonomy terms from the term group and term set with the given ID
40
43
  ```sh
41
44
  m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec
42
45
  ```
46
+
47
+ List taxonomy terms from the term group and term set with the given ID including child terms if any are found
48
+
49
+ ```sh
50
+ m365 spo term list --termGroupId 0e8f395e-ff58-4d45-9ff7-e331ab728beb --termSetId 0e8f395e-ff58-4d45-9ff7-e331ab728bec --includeChildTerms
51
+ ```
52
+
53
+ ## Response
54
+
55
+ ### Standard response
56
+
57
+ === "JSON"
58
+
59
+ ```json
60
+ [
61
+ {
62
+ "_ObjectType_": "SP.Taxonomy.Term",
63
+ "_ObjectIdentity_": "430486a0-200a-6000-02cc-2eb89d8dd424|fec14c62-7c3b-481b-851b-c80d7802b224:te:kTm3XibpGUiE5nxBtVMTf14Jch8b6X1EtvEo9yq4/mCesjVWlBPHRaBqFOZeTRSNsaKRf7N4K0qppo4zwLIRZg==",
64
+ "CreatedDate": "2021-10-12T09:42:44.880Z",
65
+ "Id": "7f91a2b1-78b3-4a2b-a9a6-8e33c0b21166",
66
+ "LastModifiedDate": "2021-10-12T09:42:45.237Z",
67
+ "Name": "Departments",
68
+ "CustomProperties": {},
69
+ "CustomSortOrder": null,
70
+ "IsAvailableForTagging": true,
71
+ "Owner": "i:0#.f|membership|admin@contoso.onmicrosoft.com",
72
+ "Description": "",
73
+ "IsDeprecated": false,
74
+ "IsKeyword": false,
75
+ "IsPinned": false,
76
+ "IsPinnedRoot": false,
77
+ "IsReused": false,
78
+ "IsRoot": true,
79
+ "IsSourceTerm": true,
80
+ "LocalCustomProperties": {
81
+ "Id": "termDepartments"
82
+ },
83
+ "MergedTermIds": [],
84
+ "PathOfTerm": "Departments",
85
+ "TermsCount": 1
86
+ }
87
+ ]
88
+ ```
89
+
90
+ === "Text"
91
+
92
+ ```text
93
+ Id Name
94
+ ------------------------------------ ---------
95
+ c387e91c-b553-4b92-886b-9af717cd73b0 Financing
96
+ ```
97
+
98
+ === "CSV"
99
+
100
+ ```csv
101
+ Id,Name
102
+ c387e91c-b553-4b92-886b-9af717cd73b0,Financing
103
+ ```
104
+
105
+ ### `includeChildTerms` response
106
+
107
+ When we make use of the option `includeChildTerms` the response will differ.
108
+
109
+ === "JSON"
110
+
111
+ ```json
112
+ [
113
+ {
114
+ "_ObjectType_": "SP.Taxonomy.Term",
115
+ "_ObjectIdentity_": "430486a0-200a-6000-02cc-2eb89d8dd424|fec14c62-7c3b-481b-851b-c80d7802b224:te:kTm3XibpGUiE5nxBtVMTf14Jch8b6X1EtvEo9yq4/mCesjVWlBPHRaBqFOZeTRSNsaKRf7N4K0qppo4zwLIRZg==",
116
+ "CreatedDate": "2021-10-12T09:42:44.880Z",
117
+ "Id": "7f91a2b1-78b3-4a2b-a9a6-8e33c0b21166",
118
+ "LastModifiedDate": "2021-10-12T09:42:45.237Z",
119
+ "Name": "Departments",
120
+ "CustomProperties": {},
121
+ "CustomSortOrder": null,
122
+ "IsAvailableForTagging": true,
123
+ "Owner": "i:0#.f|membership|admin@contoso.onmicrosoft.com",
124
+ "Description": "",
125
+ "IsDeprecated": false,
126
+ "IsKeyword": false,
127
+ "IsPinned": false,
128
+ "IsPinnedRoot": false,
129
+ "IsReused": false,
130
+ "IsRoot": true,
131
+ "IsSourceTerm": true,
132
+ "LocalCustomProperties": {
133
+ "Id": "termDepartments"
134
+ },
135
+ "MergedTermIds": [],
136
+ "PathOfTerm": "Departments",
137
+ "TermsCount": 1,
138
+ "Children": [{
139
+ "_ObjectType_": "SP.Taxonomy.Term",
140
+ "_ObjectIdentity_": "d10486a0-4067-5000-de97-bf1ab5bff53c|fec14c62-7c3b-481b-851b-c80d7802b224:te:kTm3XibpGUiE5nxBtVMTf14Jch8b6X1EtvEo9yq4/mCesjVWlBPHRaBqFOZeTRSNf5ybB0mfG0Kx6YO5CODZ1A==",
141
+ "CreatedDate": "2022-12-25T23:59:15.200Z",
142
+ "Id": "079b9c7f-9f49-421b-b1e9-83b908e0d9d4",
143
+ "LastModifiedDate": "2022-12-25T23:59:15.200Z",
144
+ "Name": "Financing",
145
+ "CustomProperties": {},
146
+ "CustomSortOrder": null,
147
+ "IsAvailableForTagging": true,
148
+ "Owner": "i:0#.f|membership|admin@mathijsdev2.onmicrosoft.com",
149
+ "Description": "",
150
+ "IsDeprecated": false,
151
+ "IsKeyword": false,
152
+ "IsPinned": false,
153
+ "IsPinnedRoot": false,
154
+ "IsReused": false,
155
+ "IsRoot": false,
156
+ "IsSourceTerm": true,
157
+ "LocalCustomProperties": {},
158
+ "MergedTermIds": [],
159
+ "PathOfTerm": "Departments;Financing",
160
+ "TermsCount": 0
161
+ }]
162
+ }
163
+ ]
164
+ ```
165
+
166
+ === "Text"
167
+
168
+ ```text
169
+ Id Name ParentTermId
170
+ ------------------------------------ --------- ------------------------------------
171
+ c387e91c-b553-4b92-886b-9af717cd73b0 Financing 079b9c7f-9f49-421b-b1e9-83b908e0d9d4
172
+ ```
173
+
174
+ === "CSV"
175
+
176
+ ```csv
177
+ Id,Name,ParentTermId
178
+ c387e91c-b553-4b92-886b-9af717cd73b0,Financing,079b9c7f-9f49-421b-b1e9-83b908e0d9d4
179
+ ```
180
+
@@ -0,0 +1,119 @@
1
+ # teams message send
2
+
3
+ Sends a message to a channel in a Microsoft Teams team
4
+
5
+ ## Usage
6
+
7
+ ```sh
8
+ m365 teams message send [options]
9
+ ```
10
+
11
+ ## Options
12
+
13
+ `-t, --teamId <teamId>`
14
+ : The ID of the team where the channel is located.
15
+
16
+ `-c, --channelId <channelId>`
17
+ : The ID of the channel.
18
+
19
+ `-m, --message <message>`
20
+ : The message to send.
21
+
22
+ --8<-- "docs/cmd/_global.md"
23
+
24
+ ## Remarks
25
+
26
+ You can only send a message to a channel in a Microsoft Teams team if you are a member of that team or channel.
27
+
28
+ ## Examples
29
+
30
+ Send a message to a specified channel in a Microsoft Teams team.
31
+
32
+ ```sh
33
+ m365 teams message send --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --message "Hello World!"
34
+ ```
35
+
36
+ Send an HTML formatted message to a specified channel in a Microsoft Teams team.
37
+
38
+ ```sh
39
+ m365 teams message send --teamId 5f5d7b71-1161-44d8-bcc1-3da710eb4171 --channelId 19:88f7e66a8dfe42be92db19505ae912a8@thread.skype --message "Hello <b>World</b>!"
40
+ ```
41
+
42
+ ## Response
43
+
44
+ === "JSON"
45
+
46
+ ```json
47
+ {
48
+ "id": "1674320428077",
49
+ "replyToId": null,
50
+ "etag": "1674320428077",
51
+ "messageType": "message",
52
+ "createdDateTime": "2023-01-21T17:00:28.077Z",
53
+ "lastModifiedDateTime": "2023-01-21T17:00:28.077Z",
54
+ "lastEditedDateTime": null,
55
+ "deletedDateTime": null,
56
+ "subject": null,
57
+ "summary": null,
58
+ "chatId": null,
59
+ "importance": "normal",
60
+ "locale": "en-us",
61
+ "webUrl": "https://teams.microsoft.com/l/message/19%3Aeeafac000f844fcc8d98fdbc4ca17570%40thread.skype/1674320428077?groupId=6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2&tenantId=189eb7cd-b689-4d93-88d8-8b8d30cd8847&createdTime=1674320428077&parentMessageId=1674320428077",
62
+ "policyViolation": null,
63
+ "eventDetail": null,
64
+ "from": {
65
+ "application": null,
66
+ "device": null,
67
+ "user": {
68
+ "id": "b2091e18-7882-4efe-b7d1-90703f5a5c65",
69
+ "displayName": "John Doe",
70
+ "userIdentityType": "aadUser"
71
+ }
72
+ },
73
+ "body": {
74
+ "contentType": "html",
75
+ "content": "<h2>Header</h2><ol><li>item 1</li><li>item 2</li><li>item 3</li></ol><p>This is <b>bold</b> text</p>"
76
+ },
77
+ "channelIdentity": {
78
+ "teamId": "6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2",
79
+ "channelId": "19:eeafac000f844fcc8d98fdbc4ca17570@thread.skype"
80
+ },
81
+ "attachments": [],
82
+ "mentions": [],
83
+ "reactions": []
84
+ }
85
+ ```
86
+
87
+ === "Text"
88
+
89
+ ```text
90
+ attachments : []
91
+ body : {"contentType":"html","content":"<h2>Header</h2><ol><li>item 1</li><li>item 2</li><li>item 3</li></ol><p>This is <b>bold</b> text</p>"}
92
+ channelIdentity : {"teamId":"6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2","channelId":"19:eeafac000f844fcc8d98fdbc4ca17570@thread.skype"}
93
+ chatId : null
94
+ createdDateTime : 2023-01-21T17:04:52.284Z
95
+ deletedDateTime : null
96
+ etag : 1674320692284
97
+ eventDetail : null
98
+ from : {"application":null,"device":null,"user":{"id":"b2091e18-7882-4efe-b7d1-90703f5a5c65","displayName":"John Doe","userIdentityType":"aadUser"}}
99
+ id : 1674320692284
100
+ importance : normal
101
+ lastEditedDateTime : null
102
+ lastModifiedDateTime: 2023-01-21T17:04:52.284Z
103
+ locale : en-us
104
+ mentions : []
105
+ messageType : message
106
+ policyViolation : null
107
+ reactions : []
108
+ replyToId : null
109
+ subject : null
110
+ summary : null
111
+ webUrl : https://teams.microsoft.com/l/message/19%3Aeeafac000f844fcc8d98fdbc4ca17570%40thread.skype/1674320428077?groupId=6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2&tenantId=189eb7cd-b689-4d93-88d8-8b8d30cd8847&createdTime=1674320428077&parentMessageId=1674320428077
112
+ ```
113
+
114
+ === "CSV"
115
+
116
+ ```csv
117
+ id,replyToId,etag,messageType,createdDateTime,lastModifiedDateTime,lastEditedDateTime,deletedDateTime,subject,summary,chatId,importance,locale,webUrl,policyViolation,eventDetail,from,body,channelIdentity,attachments,mentions,reactions
118
+ 1674320748808,,1674320748808,message,2023-01-21T17:05:48.808Z,2023-01-21T17:05:48.808Z,,,,,,normal,en-us,https://teams.microsoft.com/l/message/19%3Aeeafac000f844fcc8d98fdbc4ca17570%40thread.skype/1674320428077?groupId=6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2&tenantId=189eb7cd-b689-4d93-88d8-8b8d30cd8847&createdTime=1674320428077&parentMessageId=1674320428077,,,"{""application"":null,""device"":null,""user"":{""id"":""b2091e18-7882-4efe-b7d1-90703f5a5c65"",""displayName"":""John Doe"",""userIdentityType"":""aadUser""}}","{""contentType"":""html"",""content"":""<h2>Header</h2><ol><li>item 1</li><li>item 2</li><li>item 3</li></ol><p>This is <b>bold</b> text</p>""}","{""teamId"":""6fb1231b-b2ad-4a81-b5d8-ed40ec7b3cd2"",""channelId"":""19:eeafac000f844fcc8d98fdbc4ca17570@thread.skype""}",[],[],[]
119
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pnp/cli-microsoft365",
3
- "version": "6.2.0-beta.0ce0a85",
3
+ "version": "6.2.0-beta.51aa7cb",
4
4
  "description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
5
5
  "license": "MIT",
6
6
  "main": "./dist/api.js",