@pnp/cli-microsoft365 9.0.0-beta.33615bd → 9.0.0-beta.39e78b2

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 (83) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Command.js +1 -3
  4. package/dist/cli/cli.js +54 -14
  5. package/dist/config.js +1 -1
  6. package/dist/m365/cli/commands/cli-consent.js +3 -7
  7. package/dist/m365/commands/login.js +10 -5
  8. package/dist/m365/commands/status.js +2 -2
  9. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-add.js +13 -13
  10. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-get.js +18 -18
  11. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-list.js +1 -1
  12. package/dist/m365/entra/commands/enterpriseapp/enterpriseapp-remove.js +123 -0
  13. package/dist/m365/entra/commands/group/group-set.js +256 -0
  14. package/dist/m365/entra/commands/m365group/m365group-user-add.js +109 -32
  15. package/dist/m365/entra/commands/m365group/m365group-user-set.js +159 -84
  16. package/dist/m365/entra/commands.js +3 -0
  17. package/dist/m365/flow/commands/flow-get.js +1 -1
  18. package/dist/m365/onenote/commands/notebook/notebook-add.js +132 -0
  19. package/dist/m365/onenote/commands.js +1 -0
  20. package/dist/m365/pa/commands/app/app-export.js +13 -7
  21. package/dist/m365/spfx/commands/project/DeployWorkflow.js +1 -1
  22. package/dist/m365/spfx/commands/project/project-github-workflow-add.js +1 -10
  23. package/dist/m365/spo/commands/applicationcustomizer/applicationcustomizer-get.js +0 -1
  24. package/dist/m365/spo/commands/file/file-copy.js +55 -34
  25. package/dist/m365/spo/commands/folder/folder-set.js +0 -4
  26. package/dist/m365/spo/commands/folder/folder-sharinglink-get.js +86 -0
  27. package/dist/m365/spo/commands/folder/folder-sharinglink-list.js +110 -0
  28. package/dist/m365/spo/commands/list/ListInstance.js +6 -1
  29. package/dist/m365/spo/commands/list/list-get.js +9 -3
  30. package/dist/m365/spo/commands/site/site-get.js +12 -16
  31. package/dist/m365/spo/commands/site/site-remove.js +1 -7
  32. package/dist/m365/spo/commands.js +2 -1
  33. package/dist/m365/teams/commands/message/message-restore.js +106 -0
  34. package/dist/m365/teams/commands.js +1 -0
  35. package/dist/m365/viva/commands/engage/engage-group-list.js +0 -5
  36. package/dist/m365/viva/commands/engage/engage-group-user-add.js +0 -5
  37. package/dist/m365/viva/commands/engage/engage-group-user-remove.js +0 -5
  38. package/dist/m365/viva/commands/engage/engage-message-add.js +0 -5
  39. package/dist/m365/viva/commands/engage/engage-message-get.js +0 -5
  40. package/dist/m365/viva/commands/engage/engage-message-like-set.js +0 -5
  41. package/dist/m365/viva/commands/engage/engage-message-list.js +0 -5
  42. package/dist/m365/viva/commands/engage/engage-message-remove.js +0 -5
  43. package/dist/m365/viva/commands/engage/engage-network-list.js +0 -5
  44. package/dist/m365/viva/commands/engage/engage-report-activitycounts.js +0 -8
  45. package/dist/m365/viva/commands/engage/engage-report-activityusercounts.js +0 -8
  46. package/dist/m365/viva/commands/engage/engage-report-activityuserdetail.js +0 -8
  47. package/dist/m365/viva/commands/engage/engage-report-deviceusagedistributionusercounts.js +0 -8
  48. package/dist/m365/viva/commands/engage/engage-report-deviceusageusercounts.js +0 -8
  49. package/dist/m365/viva/commands/engage/engage-report-deviceusageuserdetail.js +0 -8
  50. package/dist/m365/viva/commands/engage/engage-report-groupsactivitycounts.js +0 -8
  51. package/dist/m365/viva/commands/engage/engage-report-groupsactivitydetail.js +0 -8
  52. package/dist/m365/viva/commands/engage/engage-report-groupsactivitygroupcounts.js +0 -8
  53. package/dist/m365/viva/commands/engage/engage-search.js +0 -5
  54. package/dist/m365/viva/commands/engage/engage-user-get.js +0 -5
  55. package/dist/m365/viva/commands/engage/engage-user-list.js +0 -5
  56. package/dist/utils/drive.js +61 -0
  57. package/dist/utils/spo.js +106 -0
  58. package/docs/docs/cmd/cli/cli-consent.mdx +1 -1
  59. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-add.mdx +12 -12
  60. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-get.mdx +14 -14
  61. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-list.mdx +5 -5
  62. package/docs/docs/cmd/entra/enterpriseapp/enterpriseapp-remove.mdx +65 -0
  63. package/docs/docs/cmd/entra/group/group-add.mdx +0 -4
  64. package/docs/docs/cmd/entra/group/group-set.mdx +89 -0
  65. package/docs/docs/cmd/entra/m365group/m365group-user-add.mdx +28 -10
  66. package/docs/docs/cmd/entra/m365group/m365group-user-set.mdx +35 -11
  67. package/docs/docs/cmd/flow/flow-get.mdx +149 -283
  68. package/docs/docs/cmd/onenote/notebook/notebook-add.mdx +169 -0
  69. package/docs/docs/cmd/pa/app/app-export.mdx +15 -9
  70. package/docs/docs/cmd/spfx/project/project-github-workflow-add.mdx +11 -12
  71. package/docs/docs/cmd/spo/app/app-uninstall.mdx +1 -1
  72. package/docs/docs/cmd/spo/applicationcustomizer/applicationcustomizer-get.mdx +6 -5
  73. package/docs/docs/cmd/spo/file/file-copy.mdx +119 -12
  74. package/docs/docs/cmd/spo/folder/folder-set.mdx +0 -6
  75. package/docs/docs/cmd/spo/folder/folder-sharinglink-get.mdx +110 -0
  76. package/docs/docs/cmd/spo/folder/folder-sharinglink-list.mdx +114 -0
  77. package/docs/docs/cmd/spo/list/list-get.mdx +6 -0
  78. package/docs/docs/cmd/spo/site/site-remove.mdx +0 -3
  79. package/docs/docs/cmd/teams/message/message-remove.mdx +2 -1
  80. package/docs/docs/cmd/teams/message/message-restore.mdx +62 -0
  81. package/npm-shrinkwrap.json +572 -478
  82. package/package.json +22 -23
  83. package/dist/m365/viva/commands/engage/yammerCommands.js +0 -25
@@ -0,0 +1,169 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # onenote notebook add
6
+
7
+ Create a new OneNote notebook.
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 onenote notebook add [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-n, --name <name>`
19
+ : Name of the notebook. Notebook names must be unique. The name cannot contain more than 128 characters or contain the following characters: `?*/:<>`
20
+
21
+ `--userId [userId]`
22
+ : Id of the user. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
23
+
24
+ `--userName [userName]`
25
+ : Name of the user. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
26
+
27
+ `--groupId [groupId]`
28
+ : Id of the SharePoint group. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
29
+
30
+ `--groupName [groupName]`
31
+ : Name of the SharePoint group. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
32
+
33
+ `-u, --webUrl [webUrl]`
34
+ : URL of the SharePoint site. Specify either `userId`, `userName`, `groupId`, `groupName` or `webUrl`, but not multiple.
35
+ ```
36
+
37
+ <Global />
38
+
39
+ ## Examples
40
+
41
+ Create a Microsoft OneNote notebook for the currently logged in user
42
+
43
+ ```sh
44
+ m365 onenote notebook add --name "Private Notebook"
45
+ ```
46
+
47
+ Create a Microsoft OneNote notebook in a group specified by id.
48
+
49
+ ```sh
50
+ m365 onenote notebook add --name "Private Notebook" --groupId 233e43d0-dc6a-482e-9b4e-0de7a7bce9b4
51
+ ```
52
+
53
+ Create a Microsoft OneNote notebook in a group specified by displayName.
54
+
55
+ ```sh
56
+ m365 onenote notebook add --name "Private Notebook" --groupName "MyGroup"
57
+ ```
58
+
59
+ Create a Microsoft OneNote notebook for a user specified by name
60
+
61
+ ```sh
62
+ m365 onenote notebook add --name "Private Notebook" --userName user1@contoso.onmicrosoft.com
63
+ ```
64
+
65
+ Create a Microsoft OneNote notebook for a user specified by id
66
+
67
+ ```sh
68
+ m365 onenote notebook add --name "Private Notebook" --userId 2609af39-7775-4f94-a3dc-0dd67657e900
69
+ ```
70
+
71
+ Creates a Microsoft OneNote notebooks for a site
72
+
73
+ ```sh
74
+ m365 onenote notebook add --name "Private Notebook" --webUrl https://contoso.sharepoint.com/sites/testsite
75
+ ```
76
+
77
+ ## Response
78
+
79
+ <Tabs>
80
+ <TabItem value="JSON">
81
+
82
+ ```json
83
+ {
84
+ "id": "1-08554ffd-b769-4a4a-9563-faaa3191f253",
85
+ "self": "https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-08554ffd-b769-4a4a-9563-faaa3191f253",
86
+ "createdDateTime": "2024-04-05T17:58:27Z",
87
+ "displayName": "Private Notebook",
88
+ "lastModifiedDateTime": "2024-04-05T17:58:27Z",
89
+ "isDefault": false,
90
+ "userRole": "Owner",
91
+ "isShared": false,
92
+ "sectionsUrl": "https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-08554ffd-b769-4a4a-9563-faaa3191f253/sections",
93
+ "sectionGroupsUrl": "https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-08554ffd-b769-4a4a-9563-faaa3191f253/sectionGroups",
94
+ "createdBy": {
95
+ "user": {
96
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
97
+ "displayName": "John Doe"
98
+ }
99
+ },
100
+ "lastModifiedBy": {
101
+ "user": {
102
+ "id": "fe36f75e-c103-410b-a18a-2bf6df06ac3a",
103
+ "displayName": "John Doe"
104
+ }
105
+ },
106
+ "links": {
107
+ "oneNoteClientUrl": {
108
+ "href": "onenote:https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"
109
+ },
110
+ "oneNoteWebUrl": {
111
+ "href": "https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"
112
+ }
113
+ }
114
+ }
115
+ ```
116
+
117
+ </TabItem>
118
+ <TabItem value="Text">
119
+
120
+ ```text
121
+ createdBy : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
122
+ createdDateTime : 2024-04-05T17:58:36Z
123
+ displayName : Private Notebook
124
+ id : 1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f
125
+ isDefault : false
126
+ isShared : false
127
+ lastModifiedBy : {"user":{"id":"fe36f75e-c103-410b-a18a-2bf6df06ac3a","displayName":"John Doe"}}
128
+ lastModifiedDateTime: 2024-04-05T17:58:36Z
129
+ links : {"oneNoteClientUrl":{"href":"onenote:https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"},"oneNoteWebUrl":{"href":"https://contoso-my.sharepoint.com/personal/john_contoso_onmicrosoft_com/Documents/Notebooks/Private Notebook"}}
130
+ sectionGroupsUrl : https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f/sectionGroups
131
+ sectionsUrl : https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f/sections
132
+ self : https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-f4bba32b-9b3e-4892-8df4-931a15f7eb6f
133
+ userRole : Owner
134
+ ```
135
+
136
+ </TabItem>
137
+ <TabItem value="CSV">
138
+
139
+ ```csv
140
+ id,self,createdDateTime,displayName,lastModifiedDateTime,isDefault,userRole,isShared,sectionsUrl,sectionGroupsUrl
141
+ 1-272a5791-2c95-45cf-b27d-7f68e07f6149,https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-272a5791-2c95-45cf-b27d-7f68e07f6149,2024-04-05T18:00:28Z,Private Notebook,2024-04-05T18:00:28Z,,Owner,,https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-272a5791-2c95-45cf-b27d-7f68e07f6149/sections,https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-272a5791-2c95-45cf-b27d-7f68e07f6149/sectionGroups
142
+ ```
143
+
144
+ </TabItem>
145
+ <TabItem value="Markdown">
146
+
147
+ ```md
148
+ # onenote notebook add --name "Private Notebook"
149
+
150
+ Date: 05/04/2024
151
+
152
+ ## Private Notebook (1-fa279d79-4701-43a2-9593-c2abfbe6999f)
153
+
154
+ Property | Value
155
+ ---------|-------
156
+ id | 1-fa279d79-4701-43a2-9593-c2abfbe6999f
157
+ self | https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-fa279d79-4701-43a2-9593-c2abfbe6999f
158
+ createdDateTime | 2024-04-05T18:00:58Z
159
+ displayName | Private Notebook
160
+ lastModifiedDateTime | 2024-04-05T18:00:58Z
161
+ isDefault | false
162
+ userRole | Owner
163
+ isShared | false
164
+ sectionsUrl | https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-fa279d79-4701-43a2-9593-c2abfbe6999f/sections
165
+ sectionGroupsUrl | https://graph.microsoft.com/v1.0/users/fe36f75e-c103-410b-a18a-2bf6df06ac3a/onenote/notebooks/1-fa279d79-4701-43a2-9593-c2abfbe6999f/sectionGroups
166
+ ```
167
+
168
+ </TabItem>
169
+ </Tabs>
@@ -14,25 +14,25 @@ m365 pa app export [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-n, --name <name>`
17
- : The name (GUID) of the Power Apps app to export
17
+ : The name (GUID) of the Power Apps app to export.
18
18
 
19
19
  `-e, --environmentName <environmentName>`
20
- : The name of the environment for which to export the app
20
+ : The name of the environment for which to export the app.
21
21
 
22
22
  `--packageDisplayName [packageDisplayName]`
23
- : The display name to use in the exported package
23
+ : The display name to use in the exported package.
24
24
 
25
25
  `-d, --packageDescription [packageDescription]`
26
- : The description to use in the exported package
26
+ : The description to use in the exported package.
27
27
 
28
28
  `-c, --packageCreatedBy [packageCreatedBy]`
29
- : The name of the person to be used as the creator of the exported package
29
+ : The name of the person to be used as the creator of the exported package.
30
30
 
31
31
  `-s, --packageSourceEnvironment [packageSourceEnvironment]`
32
- : The name of the source environment from which the exported package was taken
32
+ : The name of the source environment from which the exported package was taken.
33
33
 
34
34
  `-p, --path [path]`
35
- : The path to save the exported package to. If not specified the app will be exported in the current working directory
35
+ : The path to save the exported package to. If not specified the app will be exported in the current working directory.
36
36
  ```
37
37
 
38
38
  <Global />
@@ -42,13 +42,19 @@ m365 pa app export [options]
42
42
  Export the specified Power App as a ZIP file
43
43
 
44
44
  ```sh
45
- m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp"
45
+ m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
46
+ ```
47
+
48
+ Export the specified Power App as a ZIP file with a custom package name
49
+
50
+ ```sh
51
+ m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "Assets app"
46
52
  ```
47
53
 
48
54
  Export the specified Power App as a ZIP file with the package displayname, package description, the one who created it, the package source environment and the path
49
55
 
50
56
  ```sh
51
- m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "PowerApp" --packageDescription "Power App Description" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
57
+ m365 pa app export --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --packageDisplayName "Assets app" --packageDescription "App to track assets of people" --packageCreatedBy "John Doe" --packageSourceEnvironment "Contoso" --path "C:/Users/John/Documents"
52
58
  ```
53
59
 
54
60
  ## Response
@@ -14,28 +14,25 @@ m365 spfx project github workflow add [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-n, --name [name]`
17
- : Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'
17
+ : Name of the workflow that will be created. If none is specified a default name will be used 'Deploy Solution ${name of sppkg file}'.
18
18
 
19
19
  `-b, --branchName [branchName]`
20
- : Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'
20
+ : Specify the branch name which should trigger the workflow on push. If none is specified a default will be used which is 'main'.
21
21
 
22
22
  `-m, --manuallyTrigger`
23
- : When specified a manual trigger option will be added to the workflow: `workflow_dispatch`
23
+ : When specified a manual trigger option will be added to the workflow: `workflow_dispatch`.
24
24
 
25
25
  `-l, --loginMethod [loginMethod]`
26
- : Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`'
26
+ : Specify the login method used for the login action. Possible options are: `user`, `application`. Default `application`.
27
27
 
28
28
  `-s, --scope [scope]`
29
- : Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`
29
+ : Scope of the app catalog: `tenant`, `sitecollection`. Default is `tenant`.
30
30
 
31
31
  `-u, --siteUrl [siteUrl]`
32
- : The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`
32
+ : The URL of the site collection where the solution package will be added. Required if scope is set to `sitecollection`.
33
33
 
34
34
  `--skipFeatureDeployment`
35
- : When specified and the app supports tenant-wide deployment, deploy it to the whole tenant
36
-
37
- `--overwrite`
38
- : When specified the workflow will overwrite the existing .sppkg if it is already deployed in the app catalog.
35
+ : When specified and the app supports tenant-wide deployment, deploy it to the whole tenant.
39
36
  ```
40
37
 
41
38
  <Global />
@@ -59,6 +56,8 @@ For the `user` login method you will need to create the following secrets in Git
59
56
 
60
57
  This method is perfect to test your workflow, in a dev context, for personal usage. It will not work for accounts with MFA.
61
58
 
59
+ The workflow will overwrite the existing .sppkg if it is already deployed in the app catalog. Overwriting your sppkg file on every deployment is required to make continuous delivery of the latest version of your app which is the aim of the continuous delivery pipeline.
60
+
62
61
  :::info
63
62
 
64
63
  Run this command in the SPFx solution folder.
@@ -67,7 +66,7 @@ Run this command in the SPFx solution folder.
67
66
 
68
67
  ## Examples
69
68
 
70
- Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main
69
+ Adds a GitHub workflow for a SharePoint Framework project with `application` login method triggered on push to main.
71
70
 
72
71
  ```sh
73
72
  m365 spfx project github workflow add
@@ -79,7 +78,7 @@ Adds a GitHub workflow for a SharePoint Framework project with `user` login meth
79
78
  m365 spfx project github workflow add --manuallyTrigger --loginMethod "user"
80
79
  ```
81
80
 
82
- Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog
81
+ Adds a GitHub workflow for a SharePoint Framework project with deployment to a site collection app catalog.
83
82
 
84
83
  ```sh
85
84
  m365 spfx project github workflow add --scope "sitecollection" --siteUrl "https://some.sharepoint.com/sites/someSite"
@@ -43,7 +43,7 @@ m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https
43
43
  Uninstall the app with the specified ID from the specified site without prompting for confirmation.
44
44
 
45
45
  ```sh
46
- m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com
46
+ m365 spo app uninstall --id b2307a39-e878-458b-bc90-03bc578531d6 --siteUrl https://contoso.sharepoint.com --force
47
47
  ```
48
48
 
49
49
  Uninstall the app with the specified ID from the specified site where the app is deployed to the site collection app catalog.
@@ -93,7 +93,10 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
93
93
  "Name": "{4a428b32-08cf-45c7-9986-17585af38806}",
94
94
  "RegistrationId": null,
95
95
  "RegistrationType": 0,
96
- "Rights": "{\"High\":\"0\",\"Low\":\"0\"}",
96
+ "Rights": {
97
+ "High": 0,
98
+ "Low": 0
99
+ },
97
100
  "Scope": "Web",
98
101
  "ScriptBlock": null,
99
102
  "ScriptSrc": null,
@@ -120,7 +123,6 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
120
123
  Name : {4a428b32-08cf-45c7-9986-17585af38806}
121
124
  RegistrationId : null
122
125
  RegistrationType : 0
123
- Rights : {"High":"0","Low":"0"}
124
126
  Scope : Web
125
127
  ScriptBlock : null
126
128
  ScriptSrc : null
@@ -134,8 +136,8 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
134
136
  <TabItem value="CSV">
135
137
 
136
138
  ```csv
137
- ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,HostProperties,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Rights,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
138
- 9a8b100c-246b-4592-9454-67826523e159,"{""testMessage"":""Test message""}",,,,,4a428b32-08cf-45c7-9986-17585af38806,,ClientSideExtension.ApplicationCustomizer,{4a428b32-08cf-45c7-9986-17585af38806},,0,"{""High"":""0"",""Low"":""0""}",Web,,,65536,HelloWorld,,1.0.1.0
139
+ ClientSideComponentId,ClientSideComponentProperties,CommandUIExtension,Description,Group,Id,ImageUrl,Location,Name,RegistrationId,RegistrationType,Scope,ScriptBlock,ScriptSrc,Sequence,Title,Url,VersionOfUserCustomAction
140
+ 9a8b100c-246b-4592-9454-67826523e159,"{""testMessage"":""Test message""}",,,,4a428b32-08cf-45c7-9986-17585af38806,,ClientSideExtension.ApplicationCustomizer,Some customizer,,0,Web,,,0,Some customizer,,16.0.1.0
139
141
  ```
140
142
 
141
143
  </TabItem>
@@ -157,7 +159,6 @@ m365 spo applicationcustomizer get --id 14125658-a9bc-4ddf-9c75-1b5767c9a337 --w
157
159
  Location | ClientSideExtension.ApplicationCustomizer
158
160
  Name | {4a428b32-08cf-45c7-9986-17585af38806}
159
161
  RegistrationType | 0
160
- Rights | {"High":"0","Low":"0"}
161
162
  Scope | Web
162
163
  Sequence | 65536
163
164
  Title | HelloWorld
@@ -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 copy
4
6
 
@@ -31,11 +33,14 @@ m365 spo file copy [options]
31
33
  `--nameConflictBehavior [nameConflictBehavior]`
32
34
  : Behavior when a document with the same name is already present at the destination. Allowed values: `fail`, `replace`, `rename`. Defaults to `fail`.
33
35
 
34
- `--resetAuthorAndCreated`
35
- : Use this option to clear the author and created date. When not specified, the values from the source file are used.
36
-
37
36
  `--bypassSharedLock`
38
37
  : This indicates whether a file with a share lock can still be copied. Use this option to copy a file that is locked.
38
+
39
+ `--ignoreVersionHistory`
40
+ : Only copy the most recent version of the file and ignore the version history.
41
+
42
+ `--skipWait`
43
+ : Don't wait for the copy operation to complete.
39
44
  ```
40
45
 
41
46
  <Global />
@@ -43,7 +48,6 @@ m365 spo file copy [options]
43
48
  ## Remarks
44
49
 
45
50
  When you specify a value for `nameConflictBehavior`, consider the following:
46
-
47
51
  - `fail` will throw an error when the destination file already exists.
48
52
  - `replace` will replace the destination file if it already exists.
49
53
  - `rename` will add a suffix (e.g. Document1.pdf) when the destination file already exists.
@@ -56,16 +60,16 @@ Copy a file by server-relative URL to a document library in another site collect
56
60
  m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
57
61
  ```
58
62
 
59
- Copy a file by site-relative URL to a document library in another site collection and clear the author and created date.
63
+ Copy a file by site-relative URL to a document library in another site collection and ignore the file history.
60
64
 
61
65
  ```sh
62
- m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --resetAuthorAndCreated
66
+ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --ignoreVersionHistory
63
67
  ```
64
68
 
65
- Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file.
69
+ Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file (without specifying the file extension).
66
70
 
67
71
  ```sh
68
- m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf"
72
+ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceId "b2307a39-e878-458b-bc90-03bc578531d6" --targetUrl "/sites/IT/Shared Documents" --newName "Report"
69
73
  ```
70
74
 
71
75
  Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists.
@@ -76,8 +80,111 @@ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourc
76
80
 
77
81
  ## Response
78
82
 
79
- The command won't return a response on success.
80
-
81
- ## More information
83
+ ### Standard Response
84
+
85
+ <Tabs>
86
+ <TabItem value="JSON">
87
+
88
+ ```json
89
+ {
90
+ "CheckInComment": "",
91
+ "CheckOutType": 2,
92
+ "ContentTag": "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1",
93
+ "CustomizedPageStatus": 0,
94
+ "ETag": "\"{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1\"",
95
+ "Exists": true,
96
+ "IrmEnabled": false,
97
+ "Length": "5987",
98
+ "Level": 1,
99
+ "LinkingUri": null,
100
+ "LinkingUrl": "",
101
+ "MajorVersion": 1,
102
+ "MinorVersion": 0,
103
+ "Name": "Test1.docx",
104
+ "ServerRelativeUrl": "/sites/project-x/documents/Test1.docx",
105
+ "TimeCreated": "2022-10-30T10:16:18Z",
106
+ "TimeLastModified": "2022-10-30T10:16:18Z",
107
+ "Title": null,
108
+ "UIVersion": 512,
109
+ "UIVersionLabel": "1.0",
110
+ "UniqueId": "b2307a39-e878-458b-bc90-03bc578531d6"
111
+ }
112
+ ```
113
+
114
+ </TabItem>
115
+ <TabItem value="Text">
116
+
117
+ ```text
118
+ CheckInComment :
119
+ CheckOutType : 2
120
+ ContentTag : {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
121
+ CustomizedPageStatus: 0
122
+ ETag : "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
123
+ Exists : true
124
+ IrmEnabled : false
125
+ Length : 5987
126
+ Level : 1
127
+ LinkingUri : null
128
+ LinkingUrl :
129
+ MajorVersion : 1
130
+ MinorVersion : 0
131
+ Name : Test1.docx
132
+ ServerRelativeUrl : /sites/project-x/documents/Test1.docx
133
+ TimeCreated : 2022-10-30T10:16:18Z
134
+ TimeLastModified : 2022-10-30T10:16:18Z
135
+ Title : null
136
+ UIVersion : 512
137
+ UIVersionLabel : 1.0
138
+ UniqueId : b2307a39-e878-458b-bc90-03bc578531d6
139
+ ```
140
+
141
+ </TabItem>
142
+ <TabItem value="CSV">
143
+
144
+ ```csv
145
+ CheckInComment,CheckOutType,ContentTag,CustomizedPageStatus,ETag,Exists,IrmEnabled,Length,Level,LinkingUri,LinkingUrl,MajorVersion,MinorVersion,Name,ServerRelativeUrl,TimeCreated,TimeLastModified,Title,UIVersion,UIVersionLabel,UniqueId
146
+ ,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
147
+ ```
148
+
149
+ </TabItem>
150
+ <TabItem value="Markdown">
151
+
152
+ ```md
153
+ # spo file copy --webUrl "https://contoso.sharepoint.com/sites/IT" --sourceUrl "/Shared Documents/Document.docx" --targetUrl "/sites/project-x/Shared Documents"
154
+
155
+ Date: 10/3/2023
156
+
157
+ ## b2307a39-e878-458b-bc90-03bc578531d6
158
+
159
+ Property | Value
160
+ ---------|-------
161
+ CheckInComment |
162
+ CheckOutType | 2
163
+ ContentTag | {03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1,1
164
+ CustomizedPageStatus | 0
165
+ ETag | "{03E171B6-9DF2-46D9-A7A1-D5FA0BD23E4B},1"
166
+ Exists | true
167
+ ExistsAllowThrowForPolicyFailures | true
168
+ IrmEnabled | false
169
+ Length | 5987
170
+ Level | 1
171
+ LinkingUri | https://contoso.sharepoint.com/sites/project-x/shared%20documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
172
+ LinkingUrl | https://contoso.sharepoint.com/sites/project-x/shared documents/Document.docx?d=w59d4e6fcf6f94ce78bea0273cedb1a19
173
+ MajorVersion | 1
174
+ MinorVersion | 0
175
+ Name | Document.docx
176
+ ServerRelativeUrl | /sites/project-x/shared documents/Document.docx
177
+ TimeCreated | 2023-05-23T09:51:34Z
178
+ TimeLastModified | 2023-05-23T10:13:01Z
179
+ Title |
180
+ UIVersion | 1536
181
+ UIVersionLabel | 1.0
182
+ UniqueId | b2307a39-e878-458b-bc90-03bc578531d6
183
+ ```
184
+
185
+ </TabItem>
186
+ </Tabs>
187
+
188
+ ### `skipWait` response
82
189
 
83
- - Copy 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)
190
+ The command won't return a response on success.
@@ -10,12 +10,6 @@ Updates a folder
10
10
  m365 spo folder set [options]
11
11
  ```
12
12
 
13
- ## Alias
14
-
15
- ```sh
16
- m365 spo folder rename [options]
17
- ```
18
-
19
13
  ## Options
20
14
 
21
15
  ```md definition-list
@@ -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>