@pnp/cli-microsoft365 10.0.0-beta.a868b81 → 10.0.0-beta.c07d83f

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 (91) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +6 -4
  4. package/dist/AuthServer.js +7 -7
  5. package/dist/Command.js +4 -1
  6. package/dist/api.js +1 -1
  7. package/dist/m365/commands/login.js +1 -1
  8. package/dist/m365/file/commands/file-move.js +135 -0
  9. package/dist/m365/file/commands.js +2 -1
  10. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-list.js +47 -0
  11. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-restore.js +48 -0
  12. package/dist/m365/flow/commands.js +2 -0
  13. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.20.0-rc.1.js +25 -0
  14. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  15. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0-rc.1.js +57 -0
  16. package/dist/m365/spfx/commands/project/project-upgrade.js +16 -13
  17. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  18. package/dist/m365/spo/commands/file/file-copy.js +5 -1
  19. package/dist/m365/spo/commands/file/file-move.js +55 -33
  20. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +143 -0
  21. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +111 -0
  22. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +95 -0
  23. package/dist/m365/spo/commands/site/SiteAdmin.js +2 -0
  24. package/dist/m365/spo/commands/site/site-admin-add.js +252 -0
  25. package/dist/m365/spo/commands/site/site-admin-list.js +2 -27
  26. package/dist/m365/spo/commands/site/site-admin-remove.js +193 -0
  27. package/dist/m365/spo/commands/sitescript/sitescript-get.js +3 -2
  28. package/dist/m365/spo/commands/user/user-get.js +67 -9
  29. package/dist/m365/spo/commands.js +5 -0
  30. package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +56 -0
  31. package/dist/m365/spp/commands.js +5 -0
  32. package/dist/m365/teams/MeetingTranscript.js +2 -0
  33. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  34. package/dist/m365/teams/commands.js +1 -0
  35. package/dist/request.js +46 -61
  36. package/dist/utils/driveUtil.js +51 -0
  37. package/dist/utils/spo.js +48 -1
  38. package/dist/utils/timersUtil.js +12 -0
  39. package/dist/utils/zod.js +1 -1
  40. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  41. package/docs/docs/cmd/file/file-move.mdx +79 -0
  42. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx +132 -0
  43. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx +55 -0
  44. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  45. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  46. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  47. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  48. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  49. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  50. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  51. package/docs/docs/cmd/spo/file/file-move.mdx +116 -9
  52. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +125 -0
  53. package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +50 -0
  54. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +50 -0
  55. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  56. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  57. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  58. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  59. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  60. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  61. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  62. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  63. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  64. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  65. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  66. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  67. package/docs/docs/cmd/spo/site/site-admin-add.mdx +67 -0
  68. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  69. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  70. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  71. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  72. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  73. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  74. package/docs/docs/cmd/spo/sitescript/sitescript-get.mdx +14 -1
  75. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  76. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  77. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  78. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  79. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  80. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  81. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  82. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  83. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  84. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  85. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  86. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  87. package/docs/docs/cmd/spo/user/user-get.mdx +35 -9
  88. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +287 -0
  89. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  90. package/npm-shrinkwrap.json +203 -375
  91. package/package.json +16 -17
@@ -0,0 +1,132 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # flow recyclebinitem list
6
+
7
+ Lists all soft-deleted Power Automate flows within an environment
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 flow recyclebinitem list [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-e, --environmentName <environmentName>`
19
+ : The name of the environment.
20
+ ```
21
+
22
+ <Global />
23
+
24
+ ## Remarks
25
+
26
+ :::warning
27
+
28
+ This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
29
+
30
+ :::
31
+
32
+ :::info
33
+
34
+ To use this command, you must be a Global or Power Platform administrator.
35
+
36
+ :::
37
+
38
+ A Power Automate flow is soft-deleted when:
39
+ - It's a non-solution flow.
40
+ - It's been deleted less than 21 days ago.
41
+
42
+ If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
43
+
44
+ ## Examples
45
+
46
+ List all soft-deleted flows within a specific environment
47
+
48
+ ```sh
49
+ m365 flow recyclebinitem list --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5
50
+ ```
51
+
52
+ ## Response
53
+
54
+ <Tabs>
55
+ <TabItem value="JSON">
56
+
57
+ ```json
58
+ [
59
+ {
60
+ "name": "26a9a283-af42-4c09-aa3e-60c3cc166b90",
61
+ "id": "/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90",
62
+ "type": "Microsoft.ProcessSimple/environments/flows",
63
+ "properties": {
64
+ "apiId": "/providers/Microsoft.PowerApps/apis/shared_logicflows",
65
+ "displayName": "Invoicing flow",
66
+ "state": "Deleted",
67
+ "createdTime": "2024-08-05T23:13:54Z",
68
+ "lastModifiedTime": "2024-08-05T23:14:00Z",
69
+ "flowSuspensionReason": "None",
70
+ "environment": {
71
+ "name": "Default-d87a7535-dd31-4437-bfe1-95340acd55c5",
72
+ "type": "Microsoft.ProcessSimple/environments",
73
+ "id": "/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
74
+ },
75
+ "definitionSummary": {
76
+ "triggers": [],
77
+ "actions": []
78
+ },
79
+ "creator": {
80
+ "tenantId": "a16e76a1-837f-4bf9-82dc-78874d18e434",
81
+ "objectId": "bd51c64d-c262-4184-ba3f-5361ea553820",
82
+ "userId": "bd51c64d-c262-4184-ba3f-5361ea553820",
83
+ "userType": "ActiveDirectory"
84
+ },
85
+ "flowFailureAlertSubscribed": false,
86
+ "isManaged": false,
87
+ "machineDescriptionData": {},
88
+ "flowOpenAiData": {
89
+ "isConsequential": false,
90
+ "isConsequentialFlagOverwritten": false
91
+ }
92
+ }
93
+ }
94
+ ]
95
+ ```
96
+
97
+ </TabItem>
98
+ <TabItem value="Text">
99
+
100
+ ```text
101
+ name displayName
102
+ ------------------------------------ --------------
103
+ 26a9a283-af42-4c09-aa3e-60c3cc166b90 Invoicing flow
104
+ ```
105
+
106
+ </TabItem>
107
+ <TabItem value="CSV">
108
+
109
+ ```csv
110
+ name,id,type
111
+ 26a9a283-af42-4c09-aa3e-60c3cc166b90,/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90,Microsoft.ProcessSimple/environments/flows
112
+ ```
113
+
114
+ </TabItem>
115
+ <TabItem value="Markdown">
116
+
117
+ ```md
118
+ # flow recyclebinitem list --environmentName "Default-d87a7535-dd31-4437-bfe1-95340acd55c5"
119
+
120
+ Date: 06/08/2024
121
+
122
+ ## 26a9a283-af42-4c09-aa3e-60c3cc166b90 (/providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90)
123
+
124
+ Property | Value
125
+ ---------|-------
126
+ name | 26a9a283-af42-4c09-aa3e-60c3cc166b90
127
+ id | /providers/Microsoft.ProcessSimple/environments/Default-d87a7535-dd31-4437-bfe1-95340acd55c5/flows/26a9a283-af42-4c09-aa3e-60c3cc166b90
128
+ type | Microsoft.ProcessSimple/environments/flows
129
+ ```
130
+
131
+ </TabItem>
132
+ </Tabs>
@@ -0,0 +1,55 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # flow recyclebinitem restore
6
+
7
+ Restores a soft-deleted Power Automate flow
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 flow recyclebinitem restore [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-e, --environmentName <environmentName>`
19
+ : The name of the environment where the flow is located.
20
+
21
+ `-n, --flowName <flowName>`
22
+ : The name of the Power Automate flow.
23
+ ```
24
+
25
+ <Global />
26
+
27
+ ## Remarks
28
+
29
+ :::warning
30
+
31
+ This command is based on an API that is currently in preview and is subject to change once the API reaches general availability.
32
+
33
+ :::
34
+
35
+ :::info
36
+
37
+ To use this command, you must be a Global or Power Platform administrator.
38
+
39
+ :::
40
+
41
+ When a Power Automate flow is restored, it will be automatically disabled. To make it operational again, you must [enable](../flow-enable.mdx) it.
42
+
43
+ If the environment with the name you specified doesn't exist, you will get the `Access to the environment 'xyz' is denied.` error.
44
+
45
+ ## Examples
46
+
47
+ Restores a soft-deleted flow within a specific environment
48
+
49
+ ```sh
50
+ m365 flow recyclebinitem restore --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --flowName 5923cb07-ce1a-4a5c-ab81-257ce820109a
51
+ ```
52
+
53
+ ## Response
54
+
55
+ The command won't return a response on success.
@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
27
27
 
28
28
  :::info
29
29
 
30
- To use this command you have to have permissions to access the tenant admin site.
30
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
31
 
32
32
  :::
33
33
 
@@ -28,7 +28,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
28
28
 
29
29
  :::info
30
30
 
31
- To use this command you have to have permissions to access the tenant admin site.
31
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
32
32
 
33
33
  :::
34
34
 
@@ -27,7 +27,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
27
27
 
28
28
  :::info
29
29
 
30
- To use this command you have to have permissions to access the tenant admin site.
30
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
31
 
32
32
  :::
33
33
 
@@ -31,7 +31,7 @@ Using the `-t, --type` option you can choose whether you want to manage the sett
31
31
 
32
32
  :::info
33
33
 
34
- To use this command you have to have permissions to access the tenant admin site.
34
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
35
35
 
36
36
  :::
37
37
 
@@ -27,7 +27,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
27
27
 
28
28
  :::info
29
29
 
30
- To use this command you have to have permissions to access the tenant admin site.
30
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
31
 
32
32
  :::
33
33
 
@@ -31,7 +31,7 @@ Using the `-t, --cdnType` option you can choose whether you want to manage the s
31
31
 
32
32
  :::info
33
33
 
34
- To use this command you have to have permissions to access the tenant admin site.
34
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
35
35
 
36
36
  :::
37
37
 
@@ -37,7 +37,7 @@ m365 spo externaluser list [options]
37
37
 
38
38
  :::info
39
39
 
40
- To use this command you have to have permissions to access the tenant admin site.
40
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
41
41
 
42
42
  :::
43
43
 
@@ -1,4 +1,6 @@
1
1
  import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
2
4
 
3
5
  # spo file move
4
6
 
@@ -31,11 +33,14 @@ m365 spo file move [options]
31
33
  `--nameConflictBehavior [nameConflictBehavior]`
32
34
  : Behavior when a file or folder with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
33
35
 
34
- `--retainEditorAndModified`
35
- : Use this option to retain the editor and modified date. When not specified, these values are reset when moving to another library.
36
+ `--includeItemPermissions`
37
+ : Ensure that item-level permissions are preserved during the move.
36
38
 
37
39
  `--bypassSharedLock`
38
40
  : This indicates whether a file with a share lock can still be moved. Use this option to move a file that is locked.
41
+
42
+ `--skipWait`
43
+ : Don't wait for the copy operation to complete.
39
44
  ```
40
45
 
41
46
  <Global />
@@ -45,7 +50,6 @@ m365 spo file move [options]
45
50
  All file versions are retained while moving a file.
46
51
 
47
52
  When you specify a value for `nameConflictBehavior`, consider the following:
48
-
49
53
  - `fail` will throw an error when the destination file already exists.
50
54
  - `replace` will replace the destination file if it already exists.
51
55
  - `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
@@ -70,16 +74,119 @@ Move a file to another document library and replace a file with the same name.
70
74
  m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl "/Shared Documents/Report project-x.pdf" --targetUrl "/sites/project-x/My Documents" --newName Report.pdf --nameConflictBehavior replace
71
75
  ```
72
76
 
73
- Move a file referenced by its ID to another document library and retain editor and modified date.
77
+ Move a file referenced by its ID to another document library and retain item-level permissions.
74
78
 
75
79
  ```sh
76
- m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --retainEditorAndModified
80
+ m365 spo file move --webUrl https://contoso.sharepoint.com/sites/project-x --sourceId b8cc341b-9c11-4f2d-aa2b-0ce9c18bcba2 --targetUrl "/sites/project-x/My Documents" --includeItemPermissions
77
81
  ```
78
82
 
79
83
  ## Response
80
84
 
81
- The command won't return a response on success.
85
+ ### Standard Response
86
+
87
+ <Tabs>
88
+ <TabItem value="JSON">
89
+
90
+ ```json
91
+ {
92
+ "CheckInComment": "",
93
+ "CheckOutType": 2,
94
+ "ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
95
+ "CustomizedPageStatus": 0,
96
+ "ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
97
+ "Exists": true,
98
+ "IrmEnabled": false,
99
+ "Length": "5987",
100
+ "Level": 1,
101
+ "LinkingUri": null,
102
+ "LinkingUrl": "",
103
+ "MajorVersion": 1,
104
+ "MinorVersion": 0,
105
+ "Name": "Test1.docx",
106
+ "ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
107
+ "TimeCreated": "2022-10-30T10:16:18Z",
108
+ "TimeLastModified": "2022-10-30T10:16:18Z",
109
+ "Title": null,
110
+ "UIVersion": 512,
111
+ "UIVersionLabel": "1.0",
112
+ "UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
113
+ }
114
+ ```
115
+
116
+ </TabItem>
117
+ <TabItem value="Text">
118
+
119
+ ```text
120
+ CheckInComment :
121
+ CheckOutType : 2
122
+ ContentTag : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
123
+ CustomizedPageStatus: 0
124
+ ETag : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
125
+ Exists : true
126
+ IrmEnabled : false
127
+ Length : 5987
128
+ Level : 1
129
+ LinkingUri : null
130
+ LinkingUrl :
131
+ MajorVersion : 1
132
+ MinorVersion : 0
133
+ Name : Test1.docx
134
+ ServerRelativeUrl : /sites/project-x/documents/Test1.docx
135
+ TimeCreated : 2022-10-30T10:16:18Z
136
+ TimeLastModified : 2022-10-30T10:16:18Z
137
+ Title : null
138
+ UIVersion : 512
139
+ UIVersionLabel : 1.0
140
+ UniqueId : b2307a39-e878-458b-bc90-03bc578531d6
141
+ ```
142
+
143
+ </TabItem>
144
+ <TabItem value="CSV">
145
+
146
+ ```csv
147
+ CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
148
+ ,2,"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",0,"""{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1""",1,,5987,1,,,1,0,Test1.docx,/sites/project-x/documents/Test1.docx,2022-10-30T10:16:18Z,2022-10-30T10:16:18Z,,512,1.0,b2307a39-e878-458b-bc90-03bc578531d6
149
+ ```
150
+
151
+ </TabItem>
152
+ <TabItem value="Markdown">
153
+
154
+ ```md
155
+ # spo file move --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
156
+
157
+ Date: 10/3/2023
158
+
159
+ ## b2307a39-e878-458b-bc90-03bc578531d6
160
+
161
+ Property | Value
162
+ ---------|-------
163
+ CheckInComment |
164
+ CheckOutType | 2
165
+ ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
166
+ CustomizedPageStatus | 0
167
+ ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
168
+ Exists | true
169
+ ExistsAllowThrowForPolicyFailures | true
170
+ IrmEnabled | false
171
+ Length | 5987
172
+ Level | 1
173
+ LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
174
+ LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
175
+ MajorVersion | 1
176
+ MinorVersion | 0
177
+ Name | Document.docx
178
+ ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
179
+ TimeCreated | 2023-05-23T09:51:34Z
180
+ TimeLastModified | 2023-05-23T10:13:01Z
181
+ Title |
182
+ UIVersion | 1536
183
+ UIVersionLabel | 1.0
184
+ UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
185
+ ```
186
+
187
+ </TabItem>
188
+ </Tabs>
189
+
190
+ ### `skipWait` response
82
191
 
83
- ## More information
84
-
85
- - Move items from a SharePoint document library: [https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc](https://support.office.com/en-us/article/move-or-copy-items-from-a-sharepoint-document-library-00e2f483-4df3-46be-a861-1f5f0c1a87bc)
192
+ The command won't return a response on success.
@@ -0,0 +1,125 @@
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 add
6
+
7
+ Creates a new sharing link to a folder
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo folder sharinglink add [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
+ `--type <type>`
28
+ : The type of sharing link to create. Either `view` or `edit`.
29
+
30
+ `--expirationDateTime [expirationDateTime]`
31
+ : The date and time to set the expiration. This should be defined as a valid ISO 8601 string.
32
+
33
+ `--scope [scope]`
34
+ : The scope of link to create. Either `anonymous`, `organization` or `users`. If not specified, the default of the organization will be used.
35
+
36
+ `--retainInheritedPermissions [retainInheritedPermissions]`
37
+ : If `true`, any existing inherited permissions are retained on the shared item when sharing this item for the first time. If `false`, all existing permissions are removed when sharing for the first time.
38
+
39
+ `--recipients [recipients]`
40
+ : Comma separated list of users with whom we wish to share the item with. Required when using scope `users`.
41
+ ```
42
+
43
+ <Global />
44
+
45
+ ## Examples
46
+
47
+ Creates a view-only anonymous sharing link of a folder by id.
48
+
49
+ ```sh
50
+ m365 spo folder sharinglink add --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234 --type view --scope anonymous
51
+ ```
52
+
53
+ Creates an edit organization sharing link of a folder by url with a specific expiration date.
54
+
55
+ ```sh
56
+ m365 spo folder sharinglink add --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl /sites/demo/shared%20documents/Folder --type edit --scope organization --expirationDateTime '2022-11-30T00:00:00Z'
57
+ ```
58
+
59
+ Creates a user sharing link of a folder by id.
60
+
61
+ ```sh
62
+ m365 spo folder sharinglink add --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234 --type view --scope users --recipients john@contoso.com,doe@contoso.com
63
+ ```
64
+
65
+ ## Response
66
+
67
+ <Tabs>
68
+ <TabItem value="JSON">
69
+
70
+ ```json
71
+ {
72
+ "id": "4fe11ccb-6c83-4927-8072-95642422b8ae",
73
+ "roles": [
74
+ "read"
75
+ ],
76
+ "shareId": "u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQjNHWkRRNlVhQ3VwNEhWeFpiR25mRkE",
77
+ "hasPassword": false,
78
+ "link": {
79
+ "scope": "anonymous",
80
+ "type": "view",
81
+ "webUrl": "https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcB3GZDQ6UaCup4HVxZbGnfFA",
82
+ "preventsDownload": false
83
+ }
84
+ }
85
+ ```
86
+
87
+ </TabItem>
88
+ <TabItem value="Text">
89
+
90
+ ```text
91
+ hasPassword: false
92
+ id : 4fe11ccb-6c83-4927-8072-95642422b8ae
93
+ link : {"scope":"anonymous","type":"view","webUrl":"https://contoso.sharepoint.com/:f:/g/EvAQivzKWfhOvI8rb6mTTHcB3GZDQ6UaCup4HVxZbGnfFA","preventsDownload":false}
94
+ roles : ["read"]
95
+ shareId : u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQjNHWkRRNlVhQ3VwNEhWeFpiR25mRkE
96
+ ```
97
+
98
+ </TabItem>
99
+ <TabItem value="CSV">
100
+
101
+ ```csv
102
+ id,shareId,hasPassword
103
+ 4fe11ccb-6c83-4927-8072-95642422b8ae,u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQjNHWkRRNlVhQ3VwNEhWeFpiR25mRkE,
104
+ ```
105
+
106
+ </TabItem>
107
+ <TabItem value="Markdown">
108
+
109
+ ```md
110
+ # spo folder sharinglink add --webUrl "https://contoso.sharepoint.com" --folderUrl "/shared documents/folder1" --type "view" --scope "anonymous"
111
+
112
+ Date: 29/04/2024
113
+
114
+ ## 4fe11ccb-6c83-4927-8072-95642422b8ae
115
+
116
+ Property | Value
117
+ ---------|-------
118
+ id | 4fe11ccb-6c83-4927-8072-95642422b8ae
119
+ shareId | u!aHR0cHM6Ly83NTY2YXZhLnNoYXJlcG9pbnQuY29tLzpmOi9nL0V2QVFpdnpLV2ZoT3ZJOHJiNm1UVEhjQjNHWkRRNlVhQ3VwNEhWeFpiR25mRkE
120
+ hasPassword | false
121
+ ```
122
+
123
+ </TabItem>
124
+ </Tabs>
125
+
@@ -0,0 +1,50 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo folder sharinglink clear
4
+
5
+ Removes sharing links of a folder
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo folder sharinglink clear [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-u, --webUrl <webUrl>`
17
+ : The URL of the site where the folder is located.
18
+
19
+ `--folderUrl [folderUrl]`
20
+ : The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
21
+
22
+ `--folderId [folderId]`
23
+ : The Unique ID (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
24
+
25
+ `-s, --scope [scope]`
26
+ : Scope of the sharing link. Possible options are: `anonymous`, `users` or `organization`. If not specified, all links will be removed.
27
+
28
+ `-f, --force`
29
+ : Don't prompt for confirmation.
30
+ ```
31
+
32
+ <Global />
33
+
34
+ ## Examples
35
+
36
+ Removes all sharing links from a folder specified by id without prompting for confirmation.
37
+
38
+ ```sh
39
+ m365 spo folder sharinglink clear --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234 --force
40
+ ```
41
+
42
+ Removes sharing links of type anonymous from a folder specified by url with prompting for confirmation.
43
+
44
+ ```sh
45
+ m365 spo folder sharinglink clear --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl '/sites/demo/Shared Documents/folder1' --scope anonymous
46
+ ```
47
+
48
+ ## Response
49
+
50
+ The command won't return a response on success.
@@ -0,0 +1,50 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # spo folder sharinglink remove
4
+
5
+ Removes a specific sharing link of a folder
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 spo folder sharinglink remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `-u, --webUrl <webUrl>`
17
+ : The URL of the site where the folder is located.
18
+
19
+ `--folderUrl [folderUrl]`
20
+ : The server- or site-relative decoded URL of the folder. Specify either `folderUrl` or `folderId` but not both.
21
+
22
+ `--folderId [folderId]`
23
+ : The UniqueId (GUID) of the folder. Specify either `folderUrl` or `folderId` but not both.
24
+
25
+ `-i, --id <id>`
26
+ : The ID of the sharing link.
27
+
28
+ `-f, --force`
29
+ : Don't prompt for confirmation.
30
+ ```
31
+
32
+ <Global />
33
+
34
+ ## Examples
35
+
36
+ Removes a specific sharing link from a folder by id without prompting for confirmation.
37
+
38
+ ```sh
39
+ m365 spo folder sharinglink remove --webUrl https://contoso.sharepoint.com/sites/demo --folderId daebb04b-a773-4baa-b1d1-3625418e3234 --id c391b57d-5783-4c53-9236-cefb5c6ef323 --force
40
+ ```
41
+
42
+ Removes a specific sharing link from a folder by url with prompting for confirmation.
43
+
44
+ ```sh
45
+ m365 spo folder sharinglink remove --webUrl https://contoso.sharepoint.com/sites/demo --folderUrl /sites/demo/shared%20documents/Folder --id c391b57d-5783-4c53-9236-cefb5c6ef323
46
+ ```
47
+
48
+ ## Response
49
+
50
+ The command won't return a response on success.
@@ -20,7 +20,7 @@ m365 spo hidedefaultthemes get [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -23,7 +23,7 @@ m365 spo hidedefaultthemes set [options]
23
23
 
24
24
  :::info
25
25
 
26
- To use this command you have to have permissions to access the tenant admin site.
26
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
27
27
 
28
28
  :::
29
29
 
@@ -25,7 +25,7 @@ m365 spo homesite remove [options]
25
25
 
26
26
  :::info
27
27
 
28
- To use this command you have to have permissions to access the tenant admin site.
28
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
29
29
 
30
30
  :::
31
31
 
@@ -20,7 +20,7 @@ m365 spo knowledgehub get [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26