@pnp/cli-microsoft365 6.11.0-beta.7edcad2 → 6.11.0-beta.b75e15f

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 (141) hide show
  1. package/dist/Auth.js +2 -1
  2. package/dist/Command.js +1 -1
  3. package/dist/m365/cli/commands/config/config-list.js +29 -0
  4. package/dist/m365/cli/commands.js +1 -0
  5. package/dist/m365/pa/commands/app/app-permission-ensure.js +177 -0
  6. package/dist/m365/pa/commands/app/app-permission-remove.js +170 -0
  7. package/dist/m365/pa/commands.js +2 -0
  8. package/dist/m365/planner/commands/bucket/bucket-add.js +2 -2
  9. package/dist/m365/planner/commands/bucket/bucket-get.js +2 -2
  10. package/dist/m365/planner/commands/bucket/bucket-list.js +2 -2
  11. package/dist/m365/planner/commands/bucket/bucket-remove.js +2 -2
  12. package/dist/m365/planner/commands/bucket/bucket-set.js +2 -2
  13. package/dist/m365/planner/commands/plan/plan-get.js +1 -2
  14. package/dist/m365/planner/commands/plan/plan-list.js +4 -5
  15. package/dist/m365/planner/commands/plan/plan-set.js +2 -2
  16. package/dist/m365/spfx/commands/project/project-doctor/{doctor-1.18.0-beta.1.js → doctor-1.18.0-beta.5.js} +1 -1
  17. package/dist/m365/spfx/commands/project/project-doctor.js +1 -1
  18. package/dist/m365/spfx/commands/project/project-externalize/rules/PnPJsRule.js +34 -23
  19. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.15.2.js +1 -1
  20. package/dist/m365/spfx/commands/project/project-upgrade/{upgrade-1.18.0-beta.1.js → upgrade-1.18.0-beta.5.js} +26 -26
  21. package/dist/m365/spfx/commands/project/project-upgrade.js +1 -1
  22. package/dist/m365/spfx/commands/spfx-doctor.js +35 -51
  23. package/dist/m365/spo/commands/app/SpoAppBaseCommand.js +26 -14
  24. package/dist/m365/spo/commands/app/app-add.js +9 -9
  25. package/dist/m365/spo/commands/file/file-add.js +13 -13
  26. package/dist/m365/spo/commands/file/file-checkin.js +1 -1
  27. package/dist/m365/spo/commands/file/file-checkout.js +1 -1
  28. package/dist/m365/spo/commands/file/file-copy.js +38 -4
  29. package/dist/m365/spo/commands/file/file-list.js +4 -4
  30. package/dist/m365/spo/commands/file/file-move.js +2 -2
  31. package/dist/m365/spo/commands/file/file-remove.js +6 -6
  32. package/dist/m365/spo/commands/file/file-rename.js +2 -2
  33. package/dist/m365/spo/commands/file/file-retentionlabel-ensure.js +1 -1
  34. package/dist/m365/spo/commands/file/file-retentionlabel-remove.js +1 -1
  35. package/dist/m365/spo/commands/file/file-roleassignment-add.js +1 -1
  36. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +1 -1
  37. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +1 -1
  38. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +1 -1
  39. package/dist/m365/spo/commands/file/file-version-clear.js +1 -1
  40. package/dist/m365/spo/commands/file/file-version-get.js +1 -1
  41. package/dist/m365/spo/commands/file/file-version-list.js +1 -1
  42. package/dist/m365/spo/commands/file/file-version-remove.js +1 -1
  43. package/dist/m365/spo/commands/file/file-version-restore.js +1 -1
  44. package/dist/m365/spo/commands/folder/folder-add.js +2 -4
  45. package/dist/m365/spo/commands/folder/folder-get.js +1 -1
  46. package/dist/m365/spo/commands/folder/folder-list.js +2 -2
  47. package/dist/m365/spo/commands/folder/folder-remove.js +7 -4
  48. package/dist/m365/spo/commands/folder/folder-rename.js +13 -17
  49. package/dist/m365/spo/commands/folder/folder-retentionlabel-ensure.js +1 -1
  50. package/dist/m365/spo/commands/folder/folder-retentionlabel-remove.js +1 -1
  51. package/dist/m365/spo/commands/folder/folder-roleassignment-add.js +1 -1
  52. package/dist/m365/spo/commands/folder/folder-roleassignment-remove.js +1 -1
  53. package/dist/m365/spo/commands/folder/folder-roleinheritance-break.js +1 -1
  54. package/dist/m365/spo/commands/folder/folder-roleinheritance-reset.js +1 -1
  55. package/dist/m365/spo/commands/group/group-list.js +0 -1
  56. package/dist/m365/spo/commands/navigation/navigation-node-set.js +2 -2
  57. package/dist/m365/spo/commands/orgassetslibrary/orgassetslibrary-add.js +32 -3
  58. package/dist/m365/spo/commands/page/Page.js +24 -32
  59. package/dist/m365/spo/commands/propertybag/propertybag-base.js +75 -54
  60. package/dist/m365/spo/commands/propertybag/propertybag-remove.js +41 -40
  61. package/dist/m365/spo/commands/site/FlowsPolicy.js +10 -0
  62. package/dist/m365/spo/commands/site/site-ensure.js +19 -70
  63. package/dist/m365/spo/commands/site/site-hubsite-disconnect.js +24 -22
  64. package/dist/m365/spo/commands/site/site-list.js +28 -36
  65. package/dist/m365/spo/commands/site/site-set.js +52 -39
  66. package/dist/m365/spo/commands/theme/theme-remove.js +26 -24
  67. package/dist/m365/spo/commands/theme/theme-set.js +0 -1
  68. package/dist/m365/spo/commands/user/user-remove.js +29 -27
  69. package/dist/m365/spo/commands/web/web-reindex.js +17 -20
  70. package/dist/m365/spo/commands/web/web-remove.js +23 -21
  71. package/dist/m365/spo/commands/web/web-roleassignment-add.js +45 -52
  72. package/dist/m365/spo/commands/web/web-roleassignment-remove.js +58 -61
  73. package/dist/m365/spo/commands/web/web-roleinheritance-break.js +20 -18
  74. package/dist/m365/spo/commands/web/web-roleinheritance-reset.js +21 -19
  75. package/dist/m365/yammer/commands/message/message-like-set.js +29 -28
  76. package/dist/m365/yammer/commands/message/message-list.js +9 -26
  77. package/dist/m365/yammer/commands/message/message-remove.js +20 -18
  78. package/dist/m365/yammer/commands/yammer-search.js +42 -56
  79. package/dist/utils/aadGroup.js +20 -0
  80. package/dist/utils/planner.js +6 -3
  81. package/dist/utils/spo.js +601 -1
  82. package/docs/docs/cmd/aad/user/user-set.mdx +1 -1
  83. package/docs/docs/cmd/cli/config/config-list.mdx +78 -0
  84. package/docs/docs/cmd/flow/flow-enable.mdx +2 -2
  85. package/docs/docs/cmd/login.mdx +6 -0
  86. package/docs/docs/cmd/pa/app/app-permission-ensure.mdx +85 -0
  87. package/docs/docs/cmd/pa/app/app-permission-remove.mdx +74 -0
  88. package/docs/docs/cmd/pp/dataverse/dataverse-table-get.mdx +2 -2
  89. package/docs/docs/cmd/pp/dataverse/dataverse-table-list.mdx +2 -2
  90. package/docs/docs/cmd/pp/dataverse/dataverse-table-remove.mdx +3 -3
  91. package/docs/docs/cmd/spo/file/file-add.mdx +1 -1
  92. package/docs/docs/cmd/spo/file/file-checkin.mdx +1 -1
  93. package/docs/docs/cmd/spo/file/file-checkout-undo.mdx +1 -9
  94. package/docs/docs/cmd/spo/file/file-checkout.mdx +1 -1
  95. package/docs/docs/cmd/spo/file/file-copy.mdx +20 -16
  96. package/docs/docs/cmd/spo/file/file-get.mdx +1 -1
  97. package/docs/docs/cmd/spo/file/file-list.mdx +2 -2
  98. package/docs/docs/cmd/spo/file/file-move.mdx +2 -2
  99. package/docs/docs/cmd/spo/file/file-remove.mdx +8 -8
  100. package/docs/docs/cmd/spo/file/file-rename.mdx +3 -3
  101. package/docs/docs/cmd/spo/file/file-retentionlabel-ensure.mdx +2 -2
  102. package/docs/docs/cmd/spo/file/file-retentionlabel-remove.mdx +3 -3
  103. package/docs/docs/cmd/spo/file/file-roleassignment-add.mdx +1 -1
  104. package/docs/docs/cmd/spo/file/file-roleassignment-remove.mdx +1 -1
  105. package/docs/docs/cmd/spo/file/file-roleinheritance-break.mdx +1 -1
  106. package/docs/docs/cmd/spo/file/file-roleinheritance-reset.mdx +1 -1
  107. package/docs/docs/cmd/spo/file/file-sharinginfo-get.mdx +1 -1
  108. package/docs/docs/cmd/spo/file/file-sharinglink-add.mdx +1 -1
  109. package/docs/docs/cmd/spo/file/file-sharinglink-clear.mdx +1 -1
  110. package/docs/docs/cmd/spo/file/file-sharinglink-get.mdx +1 -1
  111. package/docs/docs/cmd/spo/file/file-sharinglink-list.mdx +1 -1
  112. package/docs/docs/cmd/spo/file/file-sharinglink-remove.mdx +1 -1
  113. package/docs/docs/cmd/spo/file/file-sharinglink-set.mdx +1 -1
  114. package/docs/docs/cmd/spo/file/file-version-clear.mdx +1 -1
  115. package/docs/docs/cmd/spo/file/file-version-get.mdx +1 -1
  116. package/docs/docs/cmd/spo/file/file-version-list.mdx +1 -1
  117. package/docs/docs/cmd/spo/file/file-version-remove.mdx +1 -1
  118. package/docs/docs/cmd/spo/file/file-version-restore.mdx +1 -1
  119. package/docs/docs/cmd/spo/folder/folder-add.mdx +76 -1
  120. package/docs/docs/cmd/spo/folder/folder-get.mdx +1 -1
  121. package/docs/docs/cmd/spo/folder/folder-list.mdx +1 -1
  122. package/docs/docs/cmd/spo/folder/folder-remove.mdx +1 -1
  123. package/docs/docs/cmd/spo/folder/folder-rename.mdx +5 -1
  124. package/docs/docs/cmd/spo/folder/folder-retentionlabel-ensure.mdx +1 -1
  125. package/docs/docs/cmd/spo/folder/folder-retentionlabel-remove.mdx +1 -1
  126. package/docs/docs/cmd/spo/folder/folder-roleassignment-add.mdx +2 -2
  127. package/docs/docs/cmd/spo/folder/folder-roleassignment-remove.mdx +1 -1
  128. package/docs/docs/cmd/spo/folder/folder-roleinheritance-break.mdx +1 -1
  129. package/docs/docs/cmd/spo/folder/folder-roleinheritance-reset.mdx +1 -1
  130. package/docs/docs/cmd/spo/listitem/listitem-attachment-list.mdx +1 -1
  131. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +14 -1
  132. package/docs/docs/cmd/spo/site/site-ensure.mdx +1 -1
  133. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-add.mdx +1 -1
  134. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-list.mdx +1 -1
  135. package/docs/docs/cmd/spo/tenant/tenant-applicationcustomizer-remove.mdx +1 -1
  136. package/docs/docs/cmd/spo/tenant/tenant-commandset-add.mdx +1 -1
  137. package/docs/docs/cmd/spo/tenant/tenant-commandset-remove.mdx +1 -1
  138. package/docs/docs/cmd/spo/tenant/tenant-commandset-set.mdx +1 -1
  139. package/docs/docs/cmd/yammer/network/network-list.mdx +1 -1
  140. package/npm-shrinkwrap.json +683 -344
  141. package/package.json +13 -13
@@ -0,0 +1,78 @@
1
+ import CLISettings from '/docs/_clisettings.mdx';
2
+ import Global from '/docs/cmd/_global.mdx';
3
+ import Tabs from '@theme/Tabs';
4
+ import TabItem from '@theme/TabItem';
5
+
6
+ # cli config list
7
+
8
+ List all self set CLI for Microsoft 365 configurations
9
+
10
+ ## Usage
11
+
12
+ ```sh
13
+ m365 cli config list [options]
14
+ ```
15
+
16
+ ## Options
17
+
18
+ <Global />
19
+
20
+ ## Available settings
21
+
22
+ Following is the list of configuration settings available in CLI for Microsoft 365.
23
+
24
+ <CLISettings />
25
+
26
+ ## Examples
27
+
28
+ List all self set configuration keys with their value
29
+
30
+ ```sh
31
+ m365 cli config list
32
+ ```
33
+
34
+ ## Response
35
+
36
+ <Tabs>
37
+ <TabItem value="JSON">
38
+
39
+ ```json
40
+ {
41
+ "errorOutput": "stdout"
42
+ }
43
+ ```
44
+
45
+ </TabItem>
46
+ <TabItem value="Text">
47
+
48
+ ```text
49
+ errorOutput: stdout
50
+ ```
51
+
52
+ </TabItem>
53
+ <TabItem value="CSV">
54
+
55
+ ```csv
56
+ errorOutput
57
+ stdout
58
+ ```
59
+
60
+ </TabItem>
61
+ <TabItem value="Markdown">
62
+
63
+ ```md
64
+ # cli config list
65
+
66
+ Date: 29/6/2023
67
+
68
+ Property | Value
69
+ ---------|-------
70
+ errorOutput | stdout
71
+ ```
72
+
73
+ </TabItem>
74
+ </Tabs>
75
+
76
+ ## More information
77
+
78
+ - [Configuring the CLI for Microsoft 365](../../../user-guide/configuring-cli.mdx)
@@ -44,13 +44,13 @@ If the Power Automate flow with the name you specified doesn't exist, you will g
44
44
  Enables Power Automate flow owned by the currently signed-in user
45
45
 
46
46
  ```sh
47
- m365 flow enable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
47
+ m365 flow enable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d
48
48
  ```
49
49
 
50
50
  Enables Power Automate flow owned by another user
51
51
 
52
52
  ```sh
53
- m365 flow enable --environment Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
53
+ m365 flow enable --environmentName Default-d87a7535-dd31-4437-bfe1-95340acd55c5 --name 3989cb59-ce1a-4a5c-bb78-257c5c39381d --asAdmin
54
54
  ```
55
55
 
56
56
  ## Response
@@ -157,6 +157,12 @@ Log in to Microsoft 365 using your own Azure AD application that's restricted on
157
157
  m365 login --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a
158
158
  ```
159
159
 
160
+ Log in to Microsoft 365 using your own Azure AD application and a personal information exchange (.pfx) file
161
+
162
+ ```sh
163
+ m365 login --authType certificate --appId 31359c7f-bd7e-475c-86db-fdb8c937548c --tenant 31359c7f-bd7e-475c-86db-fdb8c937548a --certificateFile /Users/user/dev/localhost.pfx --password 'pass@word1'
164
+ ```
165
+
160
166
  Log in to Microsoft 365 using the interactive browser authentication. Uses the identity of the current user.
161
167
 
162
168
  ```sh
@@ -0,0 +1,85 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # pa app permission ensure
4
+
5
+ Assigns/updates permissions to a Power Apps app
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 pa app permission ensure [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `--appName <appName>`
17
+ : The name (GUID) of the Microsoft Power App.
18
+
19
+ `--roleName <roleName>`
20
+ : Permission level given to the app. Valid values: `CanEdit`, `CanView`. Sharing with the entire tenant is only supported with `CanView` role.
21
+
22
+ `--userId [userId]`
23
+ : The Azure AD ID of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
24
+
25
+ `--userName [userName]`
26
+ : The user principal name of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
27
+
28
+ `--groupId [groupId]`
29
+ : The Azure AD ID of the group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
30
+
31
+ `--groupName [groupName]`
32
+ : The name of the Azure AD group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
33
+
34
+ `--tenant`
35
+ : Share the app with the entire tenant. When specifying this, only `CanView` role is supported. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
36
+
37
+ `--sendInvitationMail`
38
+ : When set, an invitation mail will be sent.
39
+
40
+ `--asAdmin`
41
+ : Run the command as admin for apps you don't own.
42
+
43
+ `-e, --environmentName [environmentName]`
44
+ : The name of the environment. Specify only a value when running the command as admin.
45
+ ```
46
+
47
+ <Global />
48
+
49
+ ## Remarks
50
+
51
+ :::note
52
+
53
+ When specifying a value for `groupId` or `groupName`, note that you can only grant permissions to security groups.
54
+
55
+ :::
56
+
57
+ ## Examples
58
+
59
+ Share a Power App app with another user with run-only permissions
60
+
61
+ ```sh
62
+ m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userName john.doe@contoso.com --roleName CanView --sendInvitationMail
63
+ ```
64
+
65
+ Add co-owner permissions for a security group to a Power Apps app
66
+
67
+ ```sh
68
+ m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --groupName Developers --roleName CanEdit
69
+ ```
70
+
71
+ Add permissions as admin to a Power App app that you do not own
72
+
73
+ ```sh
74
+ m365 pa app permission ensure --environment Default-e535e809-c6a1-47b5-8951-d0898a64bf8a --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userId 42a28ec6-972f-4fdd-b483-50ee4b237f91 --roleName CanEdit --asAdmin
75
+ ```
76
+
77
+ Share a Power Apps app with everyone in the tenant
78
+
79
+ ```sh
80
+ m365 pa app permission ensure --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --roleName CanView --tenant
81
+ ```
82
+
83
+ ## Response
84
+
85
+ The command won't return a response on success.
@@ -0,0 +1,74 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+
3
+ # pa app permission remove
4
+
5
+ Removes permissions to a Power Apps app
6
+
7
+ ## Usage
8
+
9
+ ```sh
10
+ m365 pa app permission remove [options]
11
+ ```
12
+
13
+ ## Options
14
+
15
+ ```md definition-list
16
+ `--appName <appName>`
17
+ : The name (GUID) of the Microsoft Power App.
18
+
19
+ `--userId [userId]`
20
+ : The Azure AD ID of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
21
+
22
+ `--userName [userName]`
23
+ : The user principal name of the user. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
24
+
25
+ `--groupId [groupId]`
26
+ : The Azure AD ID of the group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
27
+
28
+ `--groupName [groupName]`
29
+ : The name of the Azure AD group. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
30
+
31
+ `--tenant`
32
+ : When specifying this, tenant permissions (everyone in the tenant) will be removed. Specify either `userId`, `userName`, `groupId`, `groupName`, or `tenant`.
33
+
34
+ `--asAdmin`
35
+ : Run the command as admin for apps you don't own.
36
+
37
+ `-e, --environmentName [environmentName]`
38
+ : The name of the environment. Specify only a value when running the command as admin.
39
+
40
+ `--confirm`
41
+ : Don't prompt for confirmation.
42
+ ```
43
+
44
+ <Global />
45
+
46
+ ## Examples
47
+
48
+ Remove permissions of a specific user for a specific app
49
+
50
+ ```sh
51
+ m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userName john.doe@contoso.com
52
+ ```
53
+
54
+ Remove permissions of a specific security group for a specific app
55
+
56
+ ```sh
57
+ m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --groupName Developers
58
+ ```
59
+
60
+ Removes permissions as administrator for an app which you do not own
61
+
62
+ ```sh
63
+ m365 pa app permission remove --environment Default-e535e809-c6a1-47b5-8951-d0898a64bf8a --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --userId 42a28ec6-972f-4fdd-b483-50ee4b237f91 --asAdmin
64
+ ```
65
+
66
+ Unshare a Power Apps app with the entire tenant
67
+
68
+ ```sh
69
+ m365 pa app permission remove --appName bc9f0a7e-53df-46af-b669-5888bb2f63d0 --tenant
70
+ ```
71
+
72
+ ## Response
73
+
74
+ The command won't return a response on success.
@@ -32,13 +32,13 @@ m365 pp dataverse table get [options]
32
32
  List a table for the given environment
33
33
 
34
34
  ```sh
35
- m365 pp dataverse table get -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
35
+ m365 pp dataverse table get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
36
36
  ```
37
37
 
38
38
  List a table for the given environment as Admin
39
39
 
40
40
  ```sh
41
- m365 pp dataverse table get -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
41
+ m365 pp dataverse table get --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
42
42
  ```
43
43
 
44
44
  ## Response
@@ -29,13 +29,13 @@ m365 pp dataverse table list [options]
29
29
  List all tables for the given environment
30
30
 
31
31
  ```sh
32
- m365 pp dataverse table list -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
32
+ m365 pp dataverse table list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339"
33
33
  ```
34
34
 
35
35
  List all tables for the given environment as Admin
36
36
 
37
37
  ```sh
38
- m365 pp dataverse table list -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
38
+ m365 pp dataverse table list --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --asAdmin
39
39
  ```
40
40
 
41
41
  ## Response
@@ -33,19 +33,19 @@ m365 pp dataverse table remove [options]
33
33
  Removes a dataverse table in a given environment
34
34
 
35
35
  ```sh
36
- m365 pp dataverse table remove -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
36
+ m365 pp dataverse table remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser"
37
37
  ```
38
38
 
39
39
  Removes a dataverse table in a given environment as Admin
40
40
 
41
41
  ```sh
42
- m365 pp dataverse table remove -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
42
+ m365 pp dataverse table remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --asAdmin
43
43
  ```
44
44
 
45
45
  Removes a dataverse table in a given environment without prompting for confirmation
46
46
 
47
47
  ```sh
48
- m365 pp dataverse table remove -e "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --confirm
48
+ m365 pp dataverse table remove --environment "Default-2ca3eaa5-140f-4175-8261-3272edf9f339" --name "aaduser" --confirm
49
49
  ```
50
50
 
51
51
  ## Response
@@ -17,7 +17,7 @@ m365 spo file add [options]
17
17
  : The URL of the site where the file should be uploaded to
18
18
 
19
19
  `-f, --folder <folder>`
20
- : The server- or site-relative URL to the folder where the file should be uploaded
20
+ : The server- or site-relative decoded URL to the folder where the file should be uploaded
21
21
 
22
22
  `-p, --path <path>`
23
23
  : Local path to the file to upload
@@ -17,7 +17,7 @@ m365 spo file checkin [options]
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `-f, --url [url]`
20
- : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
20
+ : The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
21
21
 
22
22
  `-i, --id [id]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -17,7 +17,7 @@ m365 spo file checkout undo [options]
17
17
  : The URL of the site where the file is located.
18
18
 
19
19
  `-f, --fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
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.
@@ -28,14 +28,6 @@ m365 spo file checkout undo [options]
28
28
 
29
29
  <Global />
30
30
 
31
- ## Remarks
32
-
33
- :::info
34
-
35
- When specifying option `fileUrl`, make sure that the URL is decoded. If not, you will get a `File Not Found` error.
36
-
37
- :::
38
-
39
31
  ## Examples
40
32
 
41
33
  Discards a checked-out file with a specific ID.
@@ -17,7 +17,7 @@ m365 spo file checkout [options]
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `-f, --url [url]`
20
- : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
20
+ : The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
21
21
 
22
22
  `-i, --id [id]`
23
23
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -16,11 +16,14 @@ m365 spo file copy [options]
16
16
  `-u, --webUrl <webUrl>`
17
17
  : The URL of the site where the file is located.
18
18
 
19
- `-s, --sourceUrl <sourceUrl>`
20
- : Site-relative, server-relative or absolute URL of the file.
19
+ `-s, --sourceUrl [sourceUrl]`
20
+ : Site-relative, server-relative or absolute decoded URL of the file. Specify either `sourceUrl` or `sourceId` but not both.
21
+
22
+ `-i, --sourceId [sourceId]`
23
+ : The Unique ID (GUID) of the file. Specify either `sourceUrl` or `sourceId` but not both.
21
24
 
22
25
  `-t, --targetUrl <targetUrl>`
23
- : Server-relative or absolute URL of the location.
26
+ : Server-relative or absolute decoded URL of the location.
24
27
 
25
28
  `--newName [newName]`
26
29
  : New name of the destination file.
@@ -28,6 +31,9 @@ m365 spo file copy [options]
28
31
  `--nameConflictBehavior [nameConflictBehavior]`
29
32
  : Behavior when a document with the same name is already present at the destination. Possible values: `fail`, `replace`, `rename`. Default is `fail`.
30
33
 
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
+
31
37
  `--bypassSharedLock`
32
38
  : This indicates whether a file with a share lock can still be copied. Use this option to copy a file that is locked.
33
39
  ```
@@ -36,12 +42,6 @@ m365 spo file copy [options]
36
42
 
37
43
  ## Remarks
38
44
 
39
- :::info
40
-
41
- The required URLs `webUrl`, `sourceUrl` and `targetUrl` cannot be encoded. When you do so, you will get a `File Not Found` error.
42
-
43
- :::
44
-
45
45
  When you specify a value for `nameConflictBehavior`, consider the following:
46
46
 
47
47
  - `fail` will throw an error when the destination file already exists.
@@ -50,30 +50,34 @@ When you specify a value for `nameConflictBehavior`, consider the following:
50
50
 
51
51
  ## Examples
52
52
 
53
- Copy a file to a document library in another site collection with server relative URLs
53
+ Copy a file by server-relative URL to a document library in another site collection with server relative URL
54
54
 
55
55
  ```sh
56
56
  m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents"
57
57
  ```
58
58
 
59
- Copy a file to a document library in another site collection with absolute URLs
59
+ Copy a file by site-relative URL to a document library in another site collection and clear the author and created date
60
60
 
61
61
  ```sh
62
- m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "https://contoso.sharepoint.com/sites/project/Shared Documents/Document.pdf" --targetUrl "https://contoso.sharepoint.com/sites/IT/Shared Documents"
62
+ m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --resetAuthorAndCreated
63
63
  ```
64
64
 
65
- Copy file to a document library in another site collection with a new name
65
+ Copy file by sourceId (UniqueId) to a document library in another site collection and rename the file
66
66
 
67
67
  ```sh
68
- m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf"
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"
69
69
  ```
70
70
 
71
- Copy file to a document library in another site collection with a new name, rename the file if it already exists
71
+ Copy file by sourceId (UniqueId) to a document library in another site collection with a new name, rename the file if it already exists
72
72
 
73
73
  ```sh
74
- m365 spo file copy --webUrl https://contoso.sharepoint.com/sites/project --sourceUrl "/sites/project/Shared Documents/Document.pdf" --targetUrl "/sites/IT/Shared Documents" --newName "Report.pdf" --nameConflictBehavior rename
74
+ 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" --nameConflictBehavior rename
75
75
  ```
76
76
 
77
+ ## Response
78
+
79
+ The command won't return a response on success.
80
+
77
81
  ## More information
78
82
 
79
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)
@@ -19,7 +19,7 @@ m365 spo file get [options]
19
19
  : The URL of the site where the file is located
20
20
 
21
21
  `-u, --url [url]`
22
- : The server- or site-relative URL of the file to retrieve. Specify either `url` or `id` but not both
22
+ : The server- or site-relative decoded URL of the file to retrieve. Specify either `url` or `id` but not both
23
23
 
24
24
  `-i, --id [id]`
25
25
  : The UniqueId (GUID) of the file to retrieve. Specify either `url` or `id` but not both
@@ -19,10 +19,10 @@ m365 spo file list [options]
19
19
  : The URL of the site where the folder from which to retrieve files is located
20
20
 
21
21
  `-f, --folderUrl <folderUrl>`
22
- : The server- or site-relative URL of the parent folder from which to retrieve files
22
+ : The server- or site-relative decoded URL of the parent folder from which to retrieve files
23
23
 
24
24
  `-f, --folder <folder>`
25
- : (deprecated. Use `folderUrl` instead) The server- or site-relative URL of the folder from which to retrieve files
25
+ : (deprecated. Use `folderUrl` instead) The server- or site-relative decoded URL of the folder from which to retrieve files
26
26
 
27
27
  `--fields [fields]`
28
28
  : Comma-separated list of fields to retrieve. Will retrieve all fields if not specified.
@@ -17,10 +17,10 @@ m365 spo file move [options]
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `-s, --sourceUrl <sourceUrl>`
20
- : The server- or site-relative URL of the file to move
20
+ : The server- or site-relative decoded URL of the file to move
21
21
 
22
22
  `-t, --targetUrl <targetUrl>`
23
- : Server-relative URL where to move the file
23
+ : Server-relative decoded URL where to move the file
24
24
 
25
25
  `--deleteIfAlreadyExists`
26
26
  : If a file already exists at the targetUrl, it will be moved to the recycle bin. If omitted, the move operation will be canceled if the file already exists at the targetUrl location
@@ -26,7 +26,7 @@ m365 spo page template remove
26
26
  : The ID of the file to remove. Specify either `id` or `url` but not both
27
27
 
28
28
  `-u, --url [url]`
29
- : The server- or site-relative URL of the file to remove. Specify either `id` or `url` but not both
29
+ : The server- or site-relative decoded URL of the file to remove. Specify either `id` or `url` but not both
30
30
 
31
31
  `--recycle`
32
32
  : Recycle the file instead of actually deleting it
@@ -39,26 +39,26 @@ m365 spo page template remove
39
39
 
40
40
  ## Examples
41
41
 
42
- Remove the file with ID _0cd891ef-afce-4e55-b836-fce03286cccf_ located in site _https://contoso.sharepoint.com/sites/project-x_
42
+ Remove file by ID
43
43
 
44
44
  ```sh
45
45
  m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --id 0cd891ef-afce-4e55-b836-fce03286cccf
46
46
  ```
47
47
 
48
- Remove the file with site-relative URL _SharedDocuments/Test.docx_ from located in site _https://contoso.sharepoint.com/sites/project-x_
48
+ Remove the file by site-relative URL
49
49
 
50
50
  ```sh
51
- m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url SharedDocuments/Test.docx
51
+ m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents/Test.docx"
52
52
  ```
53
53
 
54
- Move the file with server-relative URL _/sites/project-x/SharedDocuments/Test.docx_ located in site _https://contoso.sharepoint.com/sites/project-x_ to the recycle bin
54
+ Move the file by server-relative URL to the recycle bin
55
55
 
56
56
  ```sh
57
- m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url /sites/project-x/SharedDocuments/Test.docx --recycle
57
+ m365 spo file remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/sites/project-x/SharedDocuments/Test.docx" --recycle
58
58
  ```
59
59
 
60
- Remove the page template with site-relative URL _SharedDocuments/Test.docx_ from located in site _https://contoso.sharepoint.com/sites/project-x_
60
+ Remove a page template by site-relative URL
61
61
 
62
62
  ```sh
63
- m365 spo page template remove --webUrl https://contoso.sharepoint.com/sites/project-x --url SharedDocuments/Forms/Template.dotx
63
+ m365 spo page template remove --webUrl https://contoso.sharepoint.com/sites/project-x --url "/Shared Documents/Forms/Template.dotx"
64
64
  ```
@@ -17,7 +17,7 @@ m365 spo file rename [options]
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `-s, --sourceUrl <sourceUrl>`
20
- : The server- or site-relative URL of the file to rename
20
+ : The server- or site-relative decoded URL of the file to rename
21
21
 
22
22
  `-t, --targetFileName <targetFileName>`
23
23
  : New file name of the file
@@ -34,13 +34,13 @@ If you try to rename a file without the `--force` flag and a file with this name
34
34
 
35
35
  ## Examples
36
36
 
37
- Renames a file with server-relative URL _/Shared Documents/Test1.docx_ located in site _<https://contoso.sharepoint.com/sites/project-x>_ to _Test2.docx_
37
+ Renames a file
38
38
 
39
39
  ```sh
40
40
  m365 spo file rename --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl '/Shared Documents/Test1.docx' --targetFileName 'Test2.docx'
41
41
  ```
42
42
 
43
- Renames a file with server-relative URL _/Shared Documents/Test1.docx_ located in site _<https://contoso.sharepoint.com/sites/project-x>_ to _Test2.docx_. If the file with the target file name already exists, this file will be moved to the recycle bin
43
+ Renames a file. If the file with the target file name already exists, this file will be moved to the recycle bin.
44
44
 
45
45
  ```sh
46
46
  m365 spo file rename --webUrl https://contoso.sharepoint.com/sites/project-x --sourceUrl '/Shared Documents/Test1.docx' --targetFileName 'Test2.docx' --force
@@ -14,10 +14,10 @@ m365 spo file retentionlabel ensure [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the retention label from a file to apply is located
17
+ : URL of the site where the retention label from a file to apply is located.
18
18
 
19
19
  `--fileUrl [fileUrl]`
20
- : The site- or server-relative URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
20
+ : The site- or server-relative decoded URL of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file that should be labelled. Specify either `fileUrl` or `fileId` but not both.
@@ -14,16 +14,16 @@ m365 spo file retentionlabel remove [options]
14
14
 
15
15
  ```md definition-list
16
16
  `-u, --webUrl <webUrl>`
17
- : URL of the site where the retention label from a file to remove is located
17
+ : URL of the site where the retention label from a file to remove is located.
18
18
 
19
19
  `--fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
20
+ : The server- or site-relative decoded URL of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file of which the label should be removed. Specify either `fileUrl` or `fileId` but not both.
24
24
 
25
25
  `--confirm`
26
- : Don't prompt for confirming removing the retention label from a file
26
+ : Don't prompt for confirming removing the retention label from a file.
27
27
  ```
28
28
 
29
29
  <Global />
@@ -17,7 +17,7 @@ m365 spo file roleassignment add [options]
17
17
  : URL of the site where the file is located.
18
18
 
19
19
  `--fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both.
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.
@@ -17,7 +17,7 @@ m365 spo file roleassignment remove [options]
17
17
  : URL of the site where the file is located.
18
18
 
19
19
  `--fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both.
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.
@@ -17,7 +17,7 @@ m365 spo file roleinheritance break [options]
17
17
  : URL of the site where the file is located
18
18
 
19
19
  `--fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file. Specify either `fileUrl` or `fileId` but not both
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
@@ -17,7 +17,7 @@ m365 spo file roleinheritance reset [options]
17
17
  : URL of the site where the file is located
18
18
 
19
19
  `--fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file to retrieve. Specify either `fileUrl` or `fileId` but not both
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
@@ -17,7 +17,7 @@ m365 spo file sharinginfo get [options]
17
17
  : The URL of the site where the file is located
18
18
 
19
19
  `-f, --fileUrl [fileUrl]`
20
- : The server- or site-relative URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
20
+ : The server- or site-relative decoded URL of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both
21
21
 
22
22
  `-i, --fileId [fileId]`
23
23
  : The UniqueId (GUID) of the file for which to build the report. Specify either `fileUrl` or `fileId` but not both