@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.
- package/allCommands.json +1 -1
- package/allCommandsFull.json +1 -1
- package/dist/Auth.js +9 -9
- package/dist/Command.js +49 -2
- package/dist/cli/cli.js +66 -39
- package/dist/m365/commands/login.js +44 -96
- package/dist/m365/connection/commands/connection-remove.js +6 -2
- package/dist/m365/connection/commands/connection-set.js +4 -1
- package/dist/m365/connection/commands/connection-use.js +25 -4
- package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-remove.js +123 -0
- package/dist/m365/entra/commands/group/group-set.js +256 -0
- package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
- package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
- package/dist/m365/entra/commands/multitenant/multitenant-add.js +65 -0
- package/dist/m365/entra/commands/multitenant/multitenant-remove.js +118 -0
- package/dist/m365/entra/commands/multitenant/multitenant-set.js +72 -0
- package/dist/m365/entra/commands.js +6 -0
- package/dist/m365/flow/commands/flow-get.js +1 -1
- package/dist/m365/pa/commands/app/app-export.js +13 -7
- package/dist/m365/spe/ContainerTypeProperties.js +2 -0
- package/dist/m365/spe/commands/containertype/containertype-list.js +49 -0
- package/dist/m365/spe/commands.js +2 -1
- package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +16 -21
- package/dist/m365/spo/commands/commandset/commandset-get.js +31 -17
- package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
- package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
- package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
- package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
- package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
- package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
- package/dist/m365/spo/commands/list/ListInstance.js +6 -1
- package/dist/m365/spo/commands/list/list-get.js +9 -3
- package/dist/m365/spo/commands/list/list-roleassignment-add.js +46 -21
- package/dist/m365/spo/commands/list/list-roleassignment-remove.js +48 -46
- package/dist/m365/spo/commands/tenant/tenant-applicationcustomizer-get.js +19 -5
- package/dist/m365/spo/commands/tenant/tenant-commandset-get.js +20 -6
- package/dist/m365/spo/commands.js +2 -0
- package/dist/m365/teams/commands/message/message-restore.js +106 -0
- package/dist/m365/teams/commands.js +1 -0
- package/dist/utils/drive.js +61 -0
- package/dist/utils/formatting.js +16 -0
- package/dist/utils/spo.js +69 -6
- package/dist/utils/zod.js +124 -0
- package/docs/docs/cmd/connection/connection-use.mdx +8 -2
- package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
- package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
- package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
- package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
- package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
- package/docs/docs/cmd/entra/multitenant/multitenant-add.mdx +107 -0
- package/docs/docs/cmd/entra/multitenant/multitenant-remove.mdx +58 -0
- package/docs/docs/cmd/entra/multitenant/multitenant-set.mdx +53 -0
- package/docs/docs/cmd/flow/flow-get.mdx +149 -283
- package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
- package/docs/docs/cmd/planner/plan/plan-remove.mdx +1 -1
- package/docs/docs/cmd/spe/containertype/containertype-list.mdx +102 -0
- package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
- package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +87 -38
- package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-list.mdx +22 -28
- package/docs/docs/cmd/spo/commandset/commandset-get.mdx +75 -24
- package/docs/docs/cmd/spo/commandset/commandset-list.mdx +26 -32
- package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +2 -2
- package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
- package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
- package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +2 -2
- package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
- package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
- package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
- package/docs/docs/cmd/spo/list/list-roleassignment-add.mdx +15 -3
- package/docs/docs/cmd/spo/list/list-roleassignment-remove.mdx +15 -3
- package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-ensure.mdx +4 -4
- package/docs/docs/cmd/spo/listitem/listitem-retentionlabel-remove.mdx +1 -1
- package/docs/docs/cmd/spo/listitem/listitem-roleassignment-add.mdx +9 -9
- package/docs/docs/cmd/spo/listitem/listitem-roleassignment-remove.mdx +7 -7
- package/docs/docs/cmd/spo/site/site-recyclebinitem-list.mdx +1 -1
- package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-get.mdx +79 -30
- package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +20 -19
- package/docs/docs/cmd/spo/tenant/tenant-commandset-get.mdx +84 -38
- package/docs/docs/cmd/spo/tenant/tenant-commandset-list.mdx +20 -19
- package/docs/docs/cmd/spo/web/web-roleassignment-add.mdx +1 -1
- package/docs/docs/cmd/spo/web/web-roleassignment-remove.mdx +1 -1
- package/docs/docs/cmd/teams/meeting/meeting-list.mdx +7 -3
- package/docs/docs/cmd/teams/message/message-remove.mdx +2 -1
- package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
- package/npm-shrinkwrap.json +1002 -1147
- 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": "
|
|
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": "
|
|
53
|
+
"Id": "bb26547d-c9b7-4ed1-b793-00cbe53388d6",
|
|
54
54
|
"ImageUrl": null,
|
|
55
55
|
"Location": "ClientSideExtension.ListViewCommandSet.CommandBar",
|
|
56
|
-
"Name": "{
|
|
56
|
+
"Name": "{bb26547d-c9b7-4ed1-b793-00cbe53388d6}",
|
|
57
57
|
"RegistrationId": "100",
|
|
58
|
-
"RegistrationType":
|
|
58
|
+
"RegistrationType": 1,
|
|
59
59
|
"Rights": {
|
|
60
60
|
"High": 0,
|
|
61
61
|
"Low": 0
|
|
62
62
|
},
|
|
63
|
-
"Scope":
|
|
63
|
+
"Scope": 3,
|
|
64
64
|
"ScriptBlock": null,
|
|
65
65
|
"ScriptSrc": null,
|
|
66
|
-
"Sequence":
|
|
67
|
-
"Title": "
|
|
66
|
+
"Sequence": 65536,
|
|
67
|
+
"Title": "HelloWorld",
|
|
68
68
|
"Url": null,
|
|
69
|
-
"VersionOfUserCustomAction": "
|
|
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
|
-
|
|
79
|
-
|
|
80
|
-
|
|
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
|
-
|
|
88
|
-
{
|
|
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://
|
|
95
|
+
# spo commandset list --webUrl "https://contoso.sharepoint.com/sites/Marketing"
|
|
96
96
|
|
|
97
|
-
Date:
|
|
97
|
+
Date: 16/05/2024
|
|
98
98
|
|
|
99
|
-
##
|
|
99
|
+
## HelloWorld (bb26547d-c9b7-4ed1-b793-00cbe53388d6)
|
|
100
100
|
|
|
101
101
|
Property | Value
|
|
102
102
|
---------|-------
|
|
103
|
-
ClientSideComponentId |
|
|
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 |
|
|
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 |
|
|
114
|
-
Scope |
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
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
|
|
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
|
-
|
|
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
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
|
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`,
|
|
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`,
|
|
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
|
|
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`,
|
|
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`,
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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"
|