@pnp/cli-microsoft365 8.1.0-beta.3dec9fa → 8.1.0-beta.75a1364

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 (88) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +9 -9
  4. package/dist/Command.js +49 -2
  5. package/dist/cli/cli.js +66 -39
  6. package/dist/m365/commands/login.js +44 -96
  7. package/dist/m365/connection/commands/connection-remove.js +6 -2
  8. package/dist/m365/connection/commands/connection-set.js +4 -1
  9. package/dist/m365/connection/commands/connection-use.js +25 -4
  10. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-remove.js +123 -0
  11. package/dist/m365/entra/commands/group/group-set.js +256 -0
  12. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  13. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  14. package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
  15. package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
  16. package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
  17. package/dist/m365/entra/commands.js +6 -0
  18. package/dist/m365/flow/commands/flow-get.js +1 -1
  19. package/dist/m365/pa/commands/app/app-export.js +13 -7
  20. package/dist/m365/spe/ContainerTypeProperties.js +2 -0
  21. package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
  22. package/dist/m365/spe/commands.js +2 -1
  23. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -21
  24. package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
  25. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  26. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  27. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  28. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  29. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  30. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  31. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  32. package/dist/m365/spo/commands/list/list-get.js +9 -3
  33. package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
  34. package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
  35. package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
  36. package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
  37. package/dist/m365/spo/commands.js +2 -0
  38. package/dist/m365/teams/commands/message/message-restore.js +106 -0
  39. package/dist/m365/teams/commands.js +1 -0
  40. package/dist/utils/drive.js +61 -0
  41. package/dist/utils/formatting.js +16 -0
  42. package/dist/utils/spo.js +69 -6
  43. package/dist/utils/zod.js +124 -0
  44. package/docs/docs/cmd/connection/connection-use.mdx +8 -2
  45. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
  46. package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
  47. package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
  48. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  49. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  50. package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
  51. package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
  52. package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
  53. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  54. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  55. package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
  56. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
  57. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  58. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +87 -38
  59. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
  60. package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
  61. package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
  62. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
  63. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
  64. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  65. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  66. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  67. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
  68. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  69. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  70. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  71. package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
  72. package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
  73. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
  74. package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
  75. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
  76. package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
  77. package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
  78. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
  79. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
  80. package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
  81. package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
  82. package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
  83. package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
  84. package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
  85. package/docs/docs/cmd/teams/message/message-remove.mdx +2 -1
  86. package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
  87. package/npm-shrinkwrap.json +1002 -1147
  88. package/package.json +26 -23
@@ -44,29 +44,29 @@ m365 spo commandset list --webUrl https://contoso.sharepoint.com/sites/sales
44
44
  ```json
45
45
  [
46
46
  {
47
- "ClientSideComponentId": "b206e130-1a5b-4ae7-86a7-4f91c9924d0a",
48
- "ClientSideComponentProperties": "",
47
+ "ClientSideComponentId": "53dd6a38-1461-44e0-9bf0-14883316a316",
48
+ "ClientSideComponentProperties": "{\"sampleTextOne\":\"One item is selected in the list.\", \"sampleTextTwo\":\"This command is always visible.\"}",
49
49
  "CommandUIExtension": null,
50
50
  "Description": null,
51
51
  "Group": null,
52
52
  "HostProperties": "",
53
- "Id": "e7000aef-f756-4997-9420-01cc84f9ac9c",
53
+ "Id": "bb26547d-c9b7-4ed1-b793-00cbe53388d6",
54
54
  "ImageUrl": null,
55
55
  "Location": "ClientSideExtension.ListViewCommandSet.CommandBar",
56
- "Name": "{e7000aef-f756-4997-9420-01cc84f9ac9c}",
56
+ "Name": "{bb26547d-c9b7-4ed1-b793-00cbe53388d6}",
57
57
  "RegistrationId": "100",
58
- "RegistrationType": 0,
58
+ "RegistrationType": 1,
59
59
  "Rights": {
60
60
  "High": 0,
61
61
  "Low": 0
62
62
  },
63
- "Scope": 2,
63
+ "Scope": 3,
64
64
  "ScriptBlock": null,
65
65
  "ScriptSrc": null,
66
- "Sequence": 0,
67
- "Title": "test",
66
+ "Sequence": 65536,
67
+ "Title": "HelloWorld",
68
68
  "Url": null,
69
- "VersionOfUserCustomAction": "16.0.1.0"
69
+ "VersionOfUserCustomAction": "1.0.1.0"
70
70
  }
71
71
  ]
72
72
  ```
@@ -75,49 +75,43 @@ m365 spo commandset list --webUrl https://contoso.sharepoint.com/sites/sales
75
75
  <TabItem value="Text">
76
76
 
77
77
  ```text
78
- Name Location Scope Id
79
- -------------------------------------- ------------------------------------------------- ----- ------------------------------------
80
- {e7000aef-f756-4997-9420-01cc84f9ac9c} ClientSideExtension.ListViewCommandSet.CommandBar 2 e7000aef-f756-4997-9420-01cc84f9ac9c
78
+ Id Location Name Scope
79
+ ------------------------------------ ------------------------------------------------- -------------------------------------- -----
80
+ bb26547d-c9b7-4ed1-b793-00cbe53388d6 ClientSideExtension.ListViewCommandSet.CommandBar {bb26547d-c9b7-4ed1-b793-00cbe53388d6} 3
81
81
  ```
82
82
 
83
83
  </TabItem>
84
84
  <TabItem value="CSV">
85
85
 
86
86
  ```csv
87
- Name,Location,Scope,Id
88
- {e7000aef-f756-4997-9420-01cc84f9ac9c},ClientSideExtension.ListViewCommandSet.CommandBar,2,e7000aef-f756-4997-9420-01cc84f9ac9c
87
+ ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
88
+ 53dd6a38-1461-44e0-9bf0-14883316a316,"{""sampleTextOne"":""One item is selected in the list."", ""sampleTextTwo"":""This command is always visible.""}",,,,,bb26547d-c9b7-4ed1-b793-00cbe53388d6,,ClientSideExtension.ListViewCommandSet.CommandBar,{bb26547d-c9b7-4ed1-b793-00cbe53388d6},100,1,3,,,65536,HelloWorld,,1.0.1.0
89
89
  ```
90
90
 
91
91
  </TabItem>
92
92
  <TabItem value="Markdown">
93
93
 
94
94
  ```md
95
- # spo commandset list --webUrl "https://ordidev.sharepoint.com"
95
+ # spo commandset list --webUrl "https://contoso.sharepoint.com/sites/Marketing"
96
96
 
97
- Date: 20/2/2023
97
+ Date: 16/05/2024
98
98
 
99
- ## test (e7000aef-f756-4997-9420-01cc84f9ac9c)
99
+ ## HelloWorld (bb26547d-c9b7-4ed1-b793-00cbe53388d6)
100
100
 
101
101
  Property | Value
102
102
  ---------|-------
103
- ClientSideComponentId | b206e130-1a5b-4ae7-86a7-4f91c9924d0a
104
- ClientSideComponentProperties |
105
- CommandUIExtension | null
106
- Description | null
107
- Group | null
103
+ ClientSideComponentId | 53dd6a38-1461-44e0-9bf0-14883316a316
104
+ ClientSideComponentProperties | {"sampleTextOne":"One item is selected in the list.", "sampleTextTwo":"This command is always visible."}
108
105
  HostProperties |
109
- Id | e7000aef-f756-4997-9420-01cc84f9ac9c
110
- ImageUrl | null
106
+ Id | bb26547d-c9b7-4ed1-b793-00cbe53388d6
111
107
  Location | ClientSideExtension.ListViewCommandSet.CommandBar
108
+ Name | {bb26547d-c9b7-4ed1-b793-00cbe53388d6}
112
109
  RegistrationId | 100
113
- RegistrationType | 0
114
- Scope | 2
115
- ScriptBlock | null
116
- ScriptSrc | null
117
- Sequence | 0
118
- Title | test
119
- Url | null
120
- VersionOfUserCustomAction | 16.0.1.0
110
+ RegistrationType | 1
111
+ Scope | 3
112
+ Sequence | 65536
113
+ Title | HelloWorld
114
+ VersionOfUserCustomAction | 1.0.1.0
121
115
  ```
122
116
 
123
117
  </TabItem>
@@ -33,7 +33,7 @@ m365 spo file retentionlabel ensure [options]
33
33
 
34
34
  ## Remarks
35
35
 
36
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
36
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a list item.
37
37
 
38
38
  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.
39
39
 
@@ -19,7 +19,7 @@ m365 spo file roleassignment add [options]
19
19
  `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
- `i, --fileId [fileId]`
22
+ `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `--principalId [principalId]`
@@ -29,7 +29,7 @@ m365 spo file roleassignment add [options]
29
29
  : The upn/email of user to assign role to. Specify either `upn`, `groupName`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
33
33
 
34
34
  `--roleDefinitionId [roleDefinitionId]`
35
35
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -29,7 +29,7 @@ m365 spo file roleassignment remove [options]
29
29
  : The upn/email of the user. Specify either `upn`, `groupName`, or `principalId` but not multiple.
30
30
 
31
31
  `--groupName [groupName]`
32
- : The group name of a Microsoft Entra or SharePoint group. Specify either `upn`, `groupName`, or `principalId` but not multiple.
32
+ : The group name of the SharePoint group Specify either `upn`, `groupName`, or `principalId` but not multiple.
33
33
 
34
34
  `-f, --force`
35
35
  : Don't prompt for confirmation.
@@ -19,7 +19,7 @@ m365 spo file roleinheritance break [options]
19
19
  `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
- `i, --fileId [fileId]`
22
+ `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `-c, --clearExistingPermissions`
@@ -19,7 +19,7 @@ m365 spo file roleinheritance reset [options]
19
19
  `--fileUrl [fileUrl]`
20
20
  : The server- or site-relative decoded URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
- `i, --fileId [fileId]`
22
+ `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `-f, --force`
@@ -19,7 +19,7 @@ m365 spo folder retentionlabel ensure [options]
19
19
  `--folderUrl [folderUrl]`
20
20
  : The server- or site-relative decoded URL of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
21
21
 
22
- `i, --folderId [folderId]`
22
+ `-i, --folderId [folderId]`
23
23
  : The UniqueId (GUID) of the folder that should be labelled. Specify either `folderUrl` or `folderId` but not both.
24
24
 
25
25
  `--name <name>`
@@ -30,7 +30,7 @@ m365 spo folder retentionlabel ensure [options]
30
30
 
31
31
  ## Remarks
32
32
 
33
- You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a listitem.
33
+ You can also use [spo listitem retentionlabel remove](./../../../cmd/spo/listitem/listitem-retentionlabel-remove.mdx) for removing the retention label from a list item.
34
34
 
35
35
  ## Examples
36
36
 
@@ -0,0 +1,110 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo folder sharinglink get
6
+
7
+ Gets details about a specific sharing link on a folder
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo folder sharinglink get [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the site where the folder is located.
20
+
21
+ `--folderUrl [folderUrl]`
22
+ : The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
23
+
24
+ `--folderId [folderId]`
25
+ : The Unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
26
+
27
+ `-i, --id <id>`
28
+ : The sharing link ID.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Examples
34
+
35
+ Gets a specific sharing link of a folder by id.
36
+
37
+ ```sh
38
+ m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderId daebb04b-a773-4baa-b1d1-3625418e3234
39
+ ```
40
+
41
+ Gets a specific sharing link of a folder by url.
42
+
43
+ ```sh
44
+ m365 spo folder sharinglink get --webUrl https://contoso.sharepoint.com/sites/demo --id 45fa6aed-362f-48b1-b04e-6da85a526506 --folderUrl "/sites/demo/shared documents/folder"
45
+ ```
46
+
47
+ ## Response
48
+
49
+ <Tabs>
50
+ <TabItem value="JSON">
51
+
52
+ ```json
53
+ {
54
+ "id": "d6f6a428-9857-471f-9635-edd68d5aa6c1",
55
+ "roles": [
56
+ "write"
57
+ ],
58
+ "shareId": "u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE",
59
+ "hasPassword": false,
60
+ "grantedToIdentitiesV2": [],
61
+ "grantedToIdentities": [],
62
+ "link": {
63
+ "scope": "anonymous",
64
+ "type": "edit",
65
+ "webUrl": "https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ",
66
+ "preventsDownload": false
67
+ }
68
+ }
69
+ ```
70
+
71
+ </TabItem>
72
+ <TabItem value="Text">
73
+
74
+ ```text
75
+ grantedToIdentities : []
76
+ grantedToIdentitiesV2 : []
77
+ hasPassword : false
78
+ id : d6f6a428-9857-471f-9635-edd68d5aa6c1
79
+ link : {"scope":"anonymous","type":"edit","webUrl":"https://contoso.sharepoint.com/:f:/s/demo/Eq_9XqtHvK5Eopws__Y-zJ4BSrlQMS-jQ0E9blk8U-SSuQ","preventsDownload":false}
80
+ roles : ["write"]
81
+ shareId : u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
82
+ ```
83
+
84
+ </TabItem>
85
+ <TabItem value="CSV">
86
+
87
+ ```csv
88
+ id,shareId,hasPassword
89
+ d6f6a428-9857-471f-9635-edd68d5aa6c1,u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE,
90
+ ```
91
+
92
+ </TabItem>
93
+ <TabItem value="Markdown">
94
+
95
+ ```md
96
+ # spo folder sharinglink get --webUrl "https://contoso.sharepoint.com/sites/demo" --id "d6f6a428-9857-471f-9635-edd68d5aa6c1" --folderUrl "/sites/demo/shared documents/Test"
97
+
98
+ Date: 5/2/2024
99
+
100
+ ## d6f6a428-9857-471f-9635-edd68d5aa6c1
101
+
102
+ Property | Value
103
+ ---------|-------
104
+ id | d6f6a428-9857-471f-9635-edd68d5aa6c1
105
+ shareId | u!aHR0cHM6Ly9uYWNoYW4zNjUuc2hhcmVwb2ludC5jb20vOmY6L3MvU1BEZW1vL0VxXzlYcXRIdks1RW9wd3NfX1kteko0QlNybFFNUy1qUTBFOWJsazhVLVNTdVE
106
+ hasPassword | false
107
+ ```
108
+
109
+ </TabItem>
110
+ </Tabs>
@@ -0,0 +1,114 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo folder sharinglink list
6
+
7
+ Lists all the sharing links of a specific folder
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo folder sharinglink list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the site where the folder is located.
20
+
21
+ `--folderUrl [folderUrl]`
22
+ : The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
23
+
24
+ `--folderId [folderId]`
25
+ : The UniqueId (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
26
+
27
+ `-s, --scope [scope]`
28
+ : Filter the results to only sharing links of a given scope: `anonymous`, `users` or `organization`. By default all sharing links are listed.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Examples
34
+
35
+ List sharing links of a folder by id.
36
+
37
+ ```sh
38
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234
39
+ ```
40
+
41
+ List sharing links of a folder by url.
42
+
43
+ ```sh
44
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder"
45
+ ```
46
+
47
+ List anonymous sharing links of a folder by url.
48
+
49
+ ```sh
50
+ m365 spo folder sharinglink list --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl "/sites/demo/shared documents/folder" --scope anonymous
51
+ ```
52
+
53
+ ## Response
54
+
55
+ <Tabs>
56
+ <TabItem value="JSON">
57
+
58
+ ```json
59
+ [
60
+ {
61
+ "id": "e6100f73-981c-4bde-986b-eed262f04659",
62
+ "roles": [
63
+ "write"
64
+ ],
65
+ "shareId": "u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc",
66
+ "hasPassword": false,
67
+ "grantedToIdentitiesV2": [],
68
+ "grantedToIdentities": [],
69
+ "link": {
70
+ "scope": "anonymous",
71
+ "type": "edit",
72
+ "webUrl": "https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag",
73
+ "preventsDownload": false
74
+ }
75
+ }
76
+ ]
77
+ ```
78
+
79
+ </TabItem>
80
+ <TabItem value="Text">
81
+
82
+ ```text
83
+ id scope roles link
84
+ ------------------------------------ ------------ ----- -----------------------------------------------------------------------------------
85
+ e6100f73-981c-4bde-986b-eed262f04659 anonymous write https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcBd3QLB9ulPb2A45Po5fdnag
86
+ ```
87
+
88
+ </TabItem>
89
+ <TabItem value="CSV">
90
+
91
+ ```csv
92
+ id,shareId,hasPassword
93
+ e6100f73-981c-4bde-986b-eed262f04659,u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc,
94
+ ```
95
+
96
+ </TabItem>
97
+ <TabItem value="Markdown">
98
+
99
+ ```md
100
+ # spo folder sharinglink list --webUrl "https://contoso.sharepoint.com/" --folderUrl "/shared documents/folder1"
101
+
102
+ Date: 24/04/2024
103
+
104
+ ## e6100f73-981c-4bde-986b-eed262f04659
105
+
106
+ Property | Value
107
+ ---------|-------
108
+ id | e6100f73-981c-4bde-986b-eed262f04659
109
+ shareId | u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQmQzUUxCOXVsUGIyQTQ1UG81ZmRuYWc
110
+ hasPassword | false
111
+ ```
112
+
113
+ </TabItem>
114
+ </Tabs>
@@ -91,6 +91,11 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
91
91
 
92
92
  ```json
93
93
  {
94
+ "VersionPolicies": {
95
+ "DefaultExpireAfterDays": 0,
96
+ "DefaultTrimMode": 0,
97
+ "DefaultTrimModeValue": "NoExpiration"
98
+ },
94
99
  "AllowContentTypes": true,
95
100
  "BaseTemplate": 100,
96
101
  "BaseType": 0,
@@ -210,6 +215,7 @@ m365 spo list get --title Documents --webUrl https://contoso.sharepoint.com/site
210
215
  ServerTemplateCanCreateFolders : true
211
216
  TemplateFeatureId : 00bfea71-de22-43b2-a848-c05709900100
212
217
  Title : Test
218
+ VersionPolicies : {"DefaultExpireAfterDays": 0,"DefaultTrimMode": 0,"DefaultTrimModeValue": "NoExpiration"}
213
219
  ```
214
220
 
215
221
  </TabItem>
@@ -26,13 +26,19 @@ m365 spo list roleassignment add [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
27
27
 
28
28
  `--principalId [principalId]`
29
- : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
29
+ : SharePoint ID of principal it may be either user id or group id we want to add permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
30
30
 
31
31
  `--upn [upn]`
32
- : The upn/email of user to assign role to. Specify either `principalId`, `upn`, or `groupName` but not multiple.
32
+ : The upn/email of user to assign role to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
33
+
34
+ `--entraGroupId [entraGroupId]`
35
+ : ID of the Microsoft Entra group to assign permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
+
37
+ `--entraGroupName [entraGroupName]`
38
+ : Display name of the Microsoft Entra group to assign permissions to. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
33
39
 
34
40
  `--groupName [groupName]`
35
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
41
+ : The group name of the SharePoint group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
42
 
37
43
  `--roleDefinitionId [roleDefinitionId]`
38
44
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -81,6 +87,12 @@ Adds role assignment to list by title located in a specific site for given princ
81
87
  m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --principalId 11 --roleDefinitionName "Full Control"
82
88
  ```
83
89
 
90
+ Adds role assignment to list for a Microsoft Entra group specified by display name.
91
+
92
+ ```sh
93
+ m365 spo list roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --entraGroupName "Marketing" --roleDefinitionName "Full Control"
94
+ ```
95
+
84
96
  ## Response
85
97
 
86
98
  The command won't return a response on success.
@@ -26,13 +26,19 @@ m365 spo list roleassignment remove [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle`, or `listUrl` but not multiple.
27
27
 
28
28
  `--principalId [principalId]`
29
- : SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, or `groupName` but not multiple.
29
+ : SharePoint ID of principal it may be either user id or group id you want to remove permissions. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
30
30
 
31
31
  `--upn [upn]`
32
- : The upn/email of user. Specify either `principalId`, `upn`, or `groupName` but not multiple.
32
+ : The upn/email of user. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
33
33
 
34
34
  `--groupName [groupName]`
35
- : The group name of Microsoft Entra or SharePoint group. Specify either `principalId`, `upn`, or `groupName` but not multiple.
35
+ : The group name of the SharePoint group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
+
37
+ `--entraGroupId [entraGroupId]`
38
+ : ID of the Microsoft Entra group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
39
+
40
+ `--entraGroupName [entraGroupName]`
41
+ : Display name of the Microsoft Entra group. Specify either `principalId`, `upn`, `groupName`, `entraGroupId`, or `entraGroupName`.
36
42
 
37
43
  `-f, --force`
38
44
  : Don't prompt for confirming removing the role assignment.
@@ -60,6 +66,12 @@ Remove roleassignment from list by url based on principal Id.
60
66
  m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --principalId 2
61
67
  ```
62
68
 
69
+ Remove roleassignment from Microsoft Entra group specified by display name.
70
+
71
+ ```sh
72
+ m365 spo list roleassignment remove --webUrl "https://contoso.sharepoint.com/sites/contoso-sales" --listUrl '/sites/contoso-sales/lists/Events' --entraGroupName "Sales Team"
73
+ ```
74
+
63
75
  ## Response
64
76
 
65
77
  The command won't return a response on success.
@@ -14,19 +14,19 @@ m365 spo listitem retentionlabel ensure [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the retentionlabel from a listitem to apply is located
17
+ : URL of the site where the retentionlabel from a list item to apply is located.
18
18
 
19
19
  `--listItemId <listItemId>`
20
20
  : The ID of the list item for which the retention label should be applied.
21
21
 
22
22
  `--listId [listId]`
23
- : ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
23
+ : ID of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`.
24
24
 
25
25
  `--listTitle [listTitle]`
26
- : Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`
26
+ : Title of the list where the retention label should be applied. Specify either `listTitle`, `listId` or `listUrl`.
27
27
 
28
28
  `--listUrl [listUrl]`
29
- : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`
29
+ : Server- or site-relative URL of the list. Specify either `listTitle`, `listId` or `listUrl`.
30
30
 
31
31
  `-n, --name [name]`
32
32
  : The name of the retention label. Specify either `name` or `id`.
@@ -14,7 +14,7 @@ m365 spo listitem retentionlabel remove [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the retentionlabel from a listitem to remove is located
17
+ : URL of the site where the retentionlabel from a list item to remove is located
18
18
 
19
19
  `-i, --listItemId <listItemId>`
20
20
  : The ID of the list item for which the retention label should be removed.
@@ -14,7 +14,7 @@ m365 spo listitem roleassignment add [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the listitem is located
17
+ : URL of the site where the list item is located
18
18
 
19
19
  `--listId [listId]`
20
20
  : ID of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
@@ -26,7 +26,7 @@ m365 spo listitem roleassignment add [options]
26
26
  : Relative URL of the list. Specify either `listId`, `listTitle` or `listUrl` but not multiple.
27
27
 
28
28
  `--listItemId <listItemId>`
29
- : Id of the listitem to assign the role to.
29
+ : Id of the list item to assign the role to.
30
30
 
31
31
  `--principalId [principalId]`
32
32
  : The SharePoint Id of the principal. It may be either a user id or group id to add a role assignment for. Specify either `upn`, `groupName` or `principalId`.
@@ -35,7 +35,7 @@ m365 spo listitem roleassignment add [options]
35
35
  : The upn/email of user to assign role to. Specify either `upn`, `groupName` or `principalId`.
36
36
 
37
37
  `--groupName [groupName]`
38
- : The group name of Microsoft Entra or SharePoint group. Specify either `upn`, `groupName` or `principalId`.
38
+ : The group name of the SharePoint group Specify either `upn`, `groupName` or `principalId`.
39
39
 
40
40
  `--roleDefinitionId [roleDefinitionId]`
41
41
  : ID of role definition. Specify either `roleDefinitionId` or `roleDefinitionName` but not both.
@@ -48,37 +48,37 @@ m365 spo listitem roleassignment add [options]
48
48
 
49
49
  ## Examples
50
50
 
51
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
51
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
52
52
 
53
53
  ```sh
54
54
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
55
55
  ```
56
56
 
57
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
57
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
58
58
 
59
59
  ```sh
60
60
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listId "0CD891EF-AFCE-4E55-B836-FCE03286CCCF" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
61
61
  ```
62
62
 
63
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition id.
63
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition id.
64
64
 
65
65
  ```sh
66
66
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listUrl "sites/documents" --listItemId 1 --principalId 11 --roleDefinitionId 1073741829
67
67
  ```
68
68
 
69
- Add role assignment to specified listitem in specified list located in specified site for specified upn and specified role definition id.
69
+ Add role assignment to specified list item in specified list located in specified site for specified upn and specified role definition id.
70
70
 
71
71
  ```sh
72
72
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --upn "someaccount@tenant.onmicrosoft.com" --roleDefinitionId 1073741829
73
73
  ```
74
74
 
75
- Add role assignment to specified listitem in specified list located in specified site for specified group and specified role definition id.
75
+ Add role assignment to specified list item in specified list located in specified site for specified group and specified role definition id.
76
76
 
77
77
  ```sh
78
78
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --groupName "someGroup" --roleDefinitionId 1073741829
79
79
  ```
80
80
 
81
- Add role assignment to specified listitem in specified list located in specified site for specified principal id and specified role definition name.
81
+ Add role assignment to specified list item in specified list located in specified site for specified principal id and specified role definition name.
82
82
 
83
83
  ```sh
84
84
  m365 spo listitem roleassignment add --webUrl "https://contoso.sharepoint.com/sites/project-x" --listTitle "someList" --listItemId 1 --principalId 11 --roleDefinitionName "Full Control"