@pnp/cli-microsoft365 11.0.0-beta.1f852eb → 11.0.0-beta.3143306

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 (159) hide show
  1. package/.devproxy/api-specs/sharepoint.yaml +54 -0
  2. package/.eslintrc.cjs +2 -0
  3. package/allCommands.json +1 -1
  4. package/allCommandsFull.json +1 -1
  5. package/dist/Command.js +4 -0
  6. package/dist/config.js +1 -0
  7. package/dist/m365/adaptivecard/commands/adaptivecard-send.js +1 -1
  8. package/dist/m365/entra/commands/administrativeunit/administrativeunit-add.js +13 -27
  9. package/dist/m365/entra/commands/administrativeunit/administrativeunit-get.js +18 -43
  10. package/dist/m365/entra/commands/administrativeunit/administrativeunit-list.js +10 -21
  11. package/dist/m365/entra/commands/administrativeunit/administrativeunit-remove.js +25 -49
  12. package/dist/m365/entra/commands/app/app-add.js +14 -2
  13. package/dist/m365/entra/commands/group/group-member-add.js +6 -27
  14. package/dist/m365/entra/commands/group/group-member-set.js +5 -26
  15. package/dist/m365/entra/commands/m365group/m365group-get.js +1 -7
  16. package/dist/m365/entra/commands/m365group/m365group-list.js +1 -7
  17. package/dist/m365/entra/commands/pim/pim-role-assignment-eligibility-list.js +1 -7
  18. package/dist/m365/entra/commands/pim/pim-role-assignment-list.js +1 -7
  19. package/dist/m365/entra/commands/pim/pim-role-request-list.js +1 -7
  20. package/dist/m365/entra/commands/roleassignment/roleassignment-add.js +146 -0
  21. package/dist/m365/entra/commands.js +1 -0
  22. package/dist/m365/flow/commands/environment/environment-get.js +19 -29
  23. package/dist/m365/flow/commands/flow-list.js +7 -14
  24. package/dist/m365/flow/commands/run/run-get.js +1 -7
  25. package/dist/m365/graph/commands/openextension/openextension-add.js +2 -2
  26. package/dist/m365/graph/commands/openextension/openextension-set.js +2 -6
  27. package/dist/m365/graph/commands/subscription/subscription-add.js +3 -10
  28. package/dist/m365/outlook/commands/mail/mail-searchfolder-add.js +85 -0
  29. package/dist/m365/outlook/commands.js +1 -0
  30. package/dist/m365/pa/commands/environment/environment-get.js +18 -23
  31. package/dist/m365/pp/commands/copilot/copilot-get.js +0 -4
  32. package/dist/m365/pp/commands/copilot/copilot-list.js +0 -4
  33. package/dist/m365/pp/commands/copilot/copilot-remove.js +0 -4
  34. package/dist/m365/pp/commands/environment/environment-get.js +19 -26
  35. package/dist/m365/pp/commands/solution/solution-publisher-list.js +1 -8
  36. package/dist/m365/pp/commands.js +0 -7
  37. package/dist/m365/purview/commands/threatassessment/threatassessment-get.js +1 -7
  38. package/dist/m365/spe/commands/container/container-add.js +1 -3
  39. package/dist/m365/spe/commands/container/container-list.js +1 -3
  40. package/dist/m365/spe/commands/container/container-recyclebinitem-list.js +1 -3
  41. package/dist/m365/spe/commands/container/container-recyclebinitem-restore.js +1 -3
  42. package/dist/m365/spe/commands/container/container-remove.js +1 -3
  43. package/dist/m365/spe/commands/containertype/containertype-add.js +67 -90
  44. package/dist/m365/spe/commands/containertype/containertype-get.js +53 -81
  45. package/dist/m365/spe/commands/containertype/containertype-list.js +8 -19
  46. package/dist/m365/spe/commands/containertype/containertype-remove.js +27 -5
  47. package/dist/m365/spfx/commands/project/project-upgrade.js +23 -66
  48. package/dist/m365/spo/commands/customaction/customaction-list.js +3 -10
  49. package/dist/m365/spo/commands/file/file-move.js +2 -8
  50. package/dist/m365/spo/commands/file/file-version-keep.js +78 -0
  51. package/dist/m365/spo/commands/homesite/homesite-add.js +26 -2
  52. package/dist/m365/spo/commands/homesite/homesite-get.js +28 -14
  53. package/dist/m365/spo/commands/homesite/homesite-list.js +1 -12
  54. package/dist/m365/spo/commands/homesite/homesite-remove.js +6 -34
  55. package/dist/m365/spo/commands/homesite/homesite-set.js +88 -44
  56. package/dist/m365/spo/commands/hubsite/hubsite-get.js +4 -13
  57. package/dist/m365/spo/commands/hubsite/hubsite-list.js +1 -8
  58. package/dist/m365/spo/commands/list/list-view-add.js +1 -1
  59. package/dist/m365/spo/commands/serviceprincipal/serviceprincipal-grant-list.js +17 -25
  60. package/dist/m365/spo/commands/{tenant/tenant-site-archive.js → site/site-archive.js} +14 -14
  61. package/dist/m365/spo/commands/{tenant/tenant-site-list.js → site/site-list.js} +16 -27
  62. package/dist/m365/spo/commands/{tenant/tenant-site-membership-list.js → site/site-membership-list.js} +15 -15
  63. package/dist/m365/spo/commands/{tenant/tenant-site-rename.js → site/site-rename.js} +14 -14
  64. package/dist/m365/spo/commands/{tenant/tenant-site-unarchive.js → site/site-unarchive.js} +14 -14
  65. package/dist/m365/spo/commands/term/term-list.js +1 -7
  66. package/dist/m365/spo/commands.js +5 -7
  67. package/dist/m365/teams/commands/chat/chat-member-add.js +3 -9
  68. package/dist/m365/teams/commands/report/report-directroutingcalls.js +5 -12
  69. package/dist/m365/teams/commands/report/report-pstncalls.js +5 -12
  70. package/dist/m365/viva/commands/engage/engage-network-list.js +1 -7
  71. package/dist/m365/viva/commands.js +0 -3
  72. package/dist/utils/entraAdministrativeUnit.js +1 -1
  73. package/dist/utils/entraApp.js +15 -0
  74. package/dist/utils/spe.js +5 -39
  75. package/docs/docs/cmd/entra/app/app-add.mdx +7 -1
  76. package/docs/docs/cmd/entra/group/group-member-add.mdx +7 -26
  77. package/docs/docs/cmd/entra/group/group-member-set.mdx +5 -23
  78. package/docs/docs/cmd/entra/m365group/m365group-get.mdx +0 -3
  79. package/docs/docs/cmd/entra/m365group/m365group-list.mdx +0 -3
  80. package/docs/docs/cmd/entra/pim/pim-role-assignment-eligibility-list.mdx +0 -3
  81. package/docs/docs/cmd/entra/pim/pim-role-assignment-list.mdx +0 -3
  82. package/docs/docs/cmd/entra/pim/pim-role-request-list.mdx +0 -3
  83. package/docs/docs/cmd/entra/roleassignment/roleassignment-add.mdx +163 -0
  84. package/docs/docs/cmd/flow/environment/environment-get.mdx +6 -5
  85. package/docs/docs/cmd/flow/flow-list.mdx +0 -3
  86. package/docs/docs/cmd/flow/run/run-get.mdx +0 -3
  87. package/docs/docs/cmd/graph/subscription/subscription-add.mdx +0 -3
  88. package/docs/docs/cmd/outlook/mail/mail-searchfolder-add.mdx +147 -0
  89. package/docs/docs/cmd/pa/environment/environment-get.mdx +5 -2
  90. package/docs/docs/cmd/pp/copilot/copilot-get.mdx +0 -6
  91. package/docs/docs/cmd/pp/copilot/copilot-list.mdx +0 -6
  92. package/docs/docs/cmd/pp/copilot/copilot-remove.mdx +0 -6
  93. package/docs/docs/cmd/pp/environment/environment-get.mdx +5 -2
  94. package/docs/docs/cmd/pp/solution/solution-publisher-list.mdx +0 -3
  95. package/docs/docs/cmd/purview/threatassessment/threatassessment-get.mdx +0 -3
  96. package/docs/docs/cmd/spe/container/container-activate.mdx +21 -0
  97. package/docs/docs/cmd/spe/container/container-add.mdx +29 -0
  98. package/docs/docs/cmd/spe/container/container-get.mdx +20 -1
  99. package/docs/docs/cmd/spe/container/container-list.mdx +29 -0
  100. package/docs/docs/cmd/spe/container/container-permission-list.mdx +19 -0
  101. package/docs/docs/cmd/spe/container/container-recyclebinitem-list.mdx +29 -0
  102. package/docs/docs/cmd/spe/container/container-recyclebinitem-restore.mdx +31 -0
  103. package/docs/docs/cmd/spe/container/container-remove.mdx +31 -0
  104. package/docs/docs/cmd/spe/containertype/containertype-add.mdx +111 -55
  105. package/docs/docs/cmd/spe/containertype/containertype-get.mdx +69 -38
  106. package/docs/docs/cmd/spe/containertype/containertype-list.mdx +59 -31
  107. package/docs/docs/cmd/spe/containertype/containertype-remove.mdx +31 -4
  108. package/docs/docs/cmd/spfx/project/project-upgrade.mdx +18 -5
  109. package/docs/docs/cmd/spo/file/file-move.mdx +0 -3
  110. package/docs/docs/cmd/spo/file/file-version-keep.mdx +68 -0
  111. package/docs/docs/cmd/spo/homesite/homesite-add.mdx +13 -4
  112. package/docs/docs/cmd/spo/homesite/homesite-get.mdx +44 -23
  113. package/docs/docs/cmd/spo/homesite/homesite-list.mdx +0 -6
  114. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +10 -35
  115. package/docs/docs/cmd/spo/homesite/homesite-set.mdx +84 -44
  116. package/docs/docs/cmd/spo/hubsite/hubsite-get.mdx +0 -3
  117. package/docs/docs/cmd/spo/hubsite/hubsite-list.mdx +0 -3
  118. package/docs/docs/cmd/spo/list/list-view-add.mdx +11 -11
  119. package/docs/docs/cmd/spo/serviceprincipal/serviceprincipal-grant-list.mdx +18 -18
  120. package/docs/docs/cmd/spo/{tenant/tenant-site-archive.mdx → site/site-archive.mdx} +4 -4
  121. package/docs/docs/cmd/spo/{tenant/tenant-site-list.mdx → site/site-list.mdx} +7 -16
  122. package/docs/docs/cmd/spo/{tenant/tenant-site-membership-list.mdx → site/site-membership-list.mdx} +5 -5
  123. package/docs/docs/cmd/spo/{tenant/tenant-site-rename.mdx → site/site-rename.mdx} +7 -7
  124. package/docs/docs/cmd/spo/{tenant/tenant-site-unarchive.mdx → site/site-unarchive.mdx} +4 -4
  125. package/docs/docs/cmd/spo/term/term-list.mdx +0 -3
  126. package/docs/docs/cmd/teams/chat/chat-member-add.mdx +2 -5
  127. package/docs/docs/cmd/teams/report/report-directroutingcalls.mdx +25 -44
  128. package/docs/docs/cmd/teams/report/report-pstncalls.mdx +25 -48
  129. package/docs/docs/cmd/viva/engage/engage-community-list.mdx +19 -0
  130. package/docs/docs/cmd/viva/engage/engage-community-user-add.mdx +19 -0
  131. package/docs/docs/cmd/viva/engage/engage-community-user-remove.mdx +19 -0
  132. package/docs/docs/cmd/viva/engage/engage-network-list.mdx +0 -3
  133. package/npm-shrinkwrap.json +51 -51
  134. package/package.json +12 -12
  135. package/dist/m365/pp/commands/card/card-clone.js +0 -101
  136. package/dist/m365/pp/commands/card/card-get.js +0 -89
  137. package/dist/m365/pp/commands/card/card-list.js +0 -55
  138. package/dist/m365/pp/commands/card/card-remove.js +0 -105
  139. package/dist/m365/skype/commands/report/report-activitycounts.js +0 -15
  140. package/dist/m365/skype/commands/report/report-activityusercounts.js +0 -15
  141. package/dist/m365/skype/commands/report/report-activityuserdetail.js +0 -15
  142. package/dist/m365/skype/commands.js +0 -7
  143. package/dist/m365/spo/commands/mail/mail-send.js +0 -108
  144. package/dist/m365/spo/commands/tenant/SPOTenantSitePropertiesEnumerable.js +0 -2
  145. package/dist/m365/spo/commands/tenant/TenantSiteProperties.js +0 -2
  146. package/dist/m365/viva/commands/engage/engage-group-list.js +0 -93
  147. package/dist/m365/viva/commands/engage/engage-group-user-add.js +0 -73
  148. package/dist/m365/viva/commands/engage/engage-group-user-remove.js +0 -88
  149. package/docs/docs/cmd/pp/card/card-clone.mdx +0 -103
  150. package/docs/docs/cmd/pp/card/card-get.mdx +0 -212
  151. package/docs/docs/cmd/pp/card/card-list.mdx +0 -163
  152. package/docs/docs/cmd/pp/card/card-remove.mdx +0 -86
  153. package/docs/docs/cmd/skype/report/report-activitycounts.mdx +0 -96
  154. package/docs/docs/cmd/skype/report/report-activityusercounts.mdx +0 -96
  155. package/docs/docs/cmd/skype/report/report-activityuserdetail.mdx +0 -134
  156. package/docs/docs/cmd/spo/mail/mail-send.mdx +0 -69
  157. package/docs/docs/cmd/viva/engage/engage-group-list.mdx +0 -174
  158. package/docs/docs/cmd/viva/engage/engage-group-user-add.mdx +0 -60
  159. package/docs/docs/cmd/viva/engage/engage-group-user-remove.mdx +0 -58
@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
4
4
 
5
5
  # spe containertype get
6
6
 
7
- Get a specific Container Type
7
+ Gets a specific container type
8
8
 
9
9
  ## Usage
10
10
 
@@ -16,34 +16,57 @@ m365 containertype get [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-i, --id [id]`
19
- : The Id of the Container Type. Specify either id or name but not both.
19
+ : The ID of the container type. Specify either id or name but not both.
20
20
 
21
21
  `-n, --name [name]`
22
- : The Container Type name. Specify either id or name but not both.
22
+ : The container type name. Specify either id or name but not both.
23
23
  ```
24
24
 
25
25
  <Global />
26
26
 
27
27
  ## Remarks
28
28
 
29
- :::info
29
+ :::warning
30
30
 
31
- To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
31
+ The command is based on an API that is currently in preview and is subject to change once the API reached general availability.
32
32
 
33
33
  :::
34
34
 
35
+ ## Permissions
36
+
37
+ <Tabs>
38
+ <TabItem value="Delegated">
39
+
40
+ | Resource | Permissions |
41
+ |-----------------|-------------------------------------|
42
+ | Microsoft Graph | FileStorageContainerType.Manage.All |
43
+
44
+ :::info
45
+
46
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
47
+
48
+ :::
49
+
50
+ </TabItem>
51
+ <TabItem value="Application">
52
+
53
+ This command does not support application permissions.
54
+
55
+ </TabItem>
56
+ </Tabs>
57
+
35
58
  ## Examples
36
59
 
37
- Gets Container Type by id
60
+ Gets container type by ID
38
61
 
39
62
  ```sh
40
- m365 spe containertype get --id '4ec4aefd-4fa3-0e4a-20c3-6e68389e7138'
63
+ m365 spe containertype get --id 5de5c251-61c2-40f5-8947-5a719c1c0b71
41
64
  ```
42
65
 
43
- Gets Container Type by name
66
+ Gets container type by name
44
67
 
45
68
  ```sh
46
- m365 spe containertype get --name 'test container'
69
+ m365 spe containertype get --name 'Container Type 1'
47
70
  ```
48
71
 
49
72
  ## Response
@@ -53,19 +76,23 @@ m365 spe containertype get --name 'test container'
53
76
 
54
77
  ```json
55
78
  {
56
- "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
57
- "ApplicationRedirectUrl": null,
58
- "AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
59
- "ContainerTypeId": "/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/",
60
- "CreationDate": null,
61
- "DisplayName": "test1",
62
- "ExpiryDate": null,
63
- "IsBillingProfileRequired": true,
64
- "OwningAppId": "/Guid(df4085cc-9a38-4255-badc-5c5225610475)/",
65
- "OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
66
- "Region": null,
67
- "ResourceGroup": null,
68
- "SPContainerTypeBillingClassification": 0
79
+ "id": "5de5c251-61c2-40f5-8947-5a719c1c0b71",
80
+ "name": "Container Type 1",
81
+ "owningAppId": "a6f79b17-a0f5-47d1-bfde-9995caebc2a3",
82
+ "billingClassification": "standard",
83
+ "billingStatus": "invalid",
84
+ "createdDateTime": "2025-06-19T05:17:32.0760075Z",
85
+ "etag": "MC4wLjAuMA==",
86
+ "settings": {
87
+ "urlTemplate": "",
88
+ "isDiscoverabilityEnabled": false,
89
+ "isSearchEnabled": true,
90
+ "isItemVersioningEnabled": true,
91
+ "itemMajorVersionLimit": 500,
92
+ "maxStoragePerContainerInBytes": 27487790694400,
93
+ "isSharingRestricted": false,
94
+ "consumingTenantOverridables": ""
95
+ }
69
96
  }
70
97
  ```
71
98
 
@@ -73,39 +100,43 @@ m365 spe containertype get --name 'test container'
73
100
  <TabItem value="Text">
74
101
 
75
102
  ```text
76
- ContainerTypeId DisplayName OwningAppId
77
- -------------------------------------------- --------------------------------------------- --------------------------------------------
78
- /Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/ test1 /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
103
+ billingClassification: standard
104
+ billingStatus : invalid
105
+ createdDateTime : 2025-06-19T05:17:32.0760075Z
106
+ etag : MC4wLjAuMA==
107
+ id : 5de5c251-61c2-40f5-8947-5a719c1c0b71
108
+ name : Container Type 1
109
+ owningAppId : a6f79b17-a0f5-47d1-bfde-9995caebc2a3
110
+ settings : {"urlTemplate":"","isDiscoverabilityEnabled":false,"isSearchEnabled":true,"isItemVersioningEnabled":true,"itemMajorVersionLimit":500,"maxStoragePerContainerInBytes":27487790694400,"isSharingRestricted":false,"consumingTenantOverridables":""}
79
111
  ```
80
112
 
81
113
  </TabItem>
82
114
  <TabItem value="CSV">
83
115
 
84
116
  ```csv
85
- _ObjectType_,ApplicationRedirectUrl,AzureSubscriptionId,ContainerTypeId,CreationDate,DisplayName,ExpiryDate,IsBillingProfileRequired,OwningAppId,OwningTenantId,Region,ResourceGroup,SPContainerTypeBillingClassification
86
- Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties,,/Guid(00000000-0000-0000-0000-000000000000)/,/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/,,test1,,1,/Guid(df4085cc-9a38-4255-badc-5c5225610475)/,/Guid(00000000-0000-0000-0000-000000000000)/,,,0
117
+ id,name,owningAppId,billingClassification,billingStatus,createdDateTime,etag
118
+ 5de5c251-61c2-40f5-8947-5a719c1c0b71,Container Type 1,a6f79b17-a0f5-47d1-bfde-9995caebc2a3,standard,invalid,2025-06-19T05:17:32.0760075Z,MC4wLjAuMA==
87
119
  ```
88
120
 
89
121
  </TabItem>
90
122
  <TabItem value="Markdown">
91
123
 
92
124
  ```md
93
- # spe containertype list
125
+ # spe containertype get --id "5de5c251-61c2-40f5-8947-5a719c1c0b71"
94
126
 
95
- Date: 5/11/2024
127
+ Date: 27/08/2025
96
128
 
97
- ## test1
129
+ ## Container Type 1 (5de5c251-61c2-40f5-8947-5a719c1c0b71)
98
130
 
99
131
  Property | Value
100
132
  ---------|-------
101
- \_ObjectType\_ | Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties
102
- AzureSubscriptionId | /Guid(00000000-0000-0000-0000-000000000000)/
103
- ContainerTypeId | /Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/
104
- DisplayName | test1
105
- IsBillingProfileRequired | true
106
- OwningAppId | /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
107
- OwningTenantId | /Guid(00000000-0000-0000-0000-000000000000)/
108
- SPContainerTypeBillingClassification | 0
133
+ id | 5de5c251-61c2-40f5-8947-5a719c1c0b71
134
+ name | Container Type 1
135
+ owningAppId | a6f79b17-a0f5-47d1-bfde-9995caebc2a3
136
+ billingClassification | standard
137
+ billingStatus | invalid
138
+ createdDateTime | 2025-06-19T05:17:32.0760075Z
139
+ etag | MC4wLjAuMA==
109
140
  ```
110
141
 
111
142
  </TabItem>
@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
4
4
 
5
5
  # spe containertype list
6
6
 
7
- Lists all Container Types
7
+ Lists all container types
8
8
 
9
9
  ## Usage
10
10
 
@@ -18,12 +18,35 @@ m365 spe containertype list [options]
18
18
 
19
19
  ## Remarks
20
20
 
21
- :::info
21
+ :::warning
22
22
 
23
- To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
23
+ The command is based on an API that is currently in preview and is subject to change once the API reached general availability.
24
24
 
25
25
  :::
26
26
 
27
+ ## Permissions
28
+
29
+ <Tabs>
30
+ <TabItem value="Delegated">
31
+
32
+ | Resource | Permissions |
33
+ |-----------------|-------------------------------------|
34
+ | Microsoft Graph | FileStorageContainerType.Manage.All |
35
+
36
+ :::info
37
+
38
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
39
+
40
+ :::
41
+
42
+ </TabItem>
43
+ <TabItem value="Application">
44
+
45
+ This command does not support application permissions.
46
+
47
+ </TabItem>
48
+ </Tabs>
49
+
27
50
  ## Examples
28
51
 
29
52
  Retrieves a list of Container Types created for a SharePoint Embedded Application from the tenant.
@@ -40,19 +63,24 @@ m365 spe containertype list
40
63
  ```json
41
64
  [
42
65
  {
43
- "_ObjectType_": "Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties",
44
- "ApplicationRedirectUrl": null,
45
- "AzureSubscriptionId": "/Guid(00000000-0000-0000-0000-000000000000)/",
46
- "ContainerTypeId": "/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/",
47
- "CreationDate": null,
48
- "DisplayName": "test1",
49
- "ExpiryDate": null,
50
- "IsBillingProfileRequired": true,
51
- "OwningAppId": "/Guid(df4085cc-9a38-4255-badc-5c5225610475)/",
52
- "OwningTenantId": "/Guid(00000000-0000-0000-0000-000000000000)/",
53
- "Region": null,
54
- "ResourceGroup": null,
55
- "SPContainerTypeBillingClassification": 0
66
+ "id": "5de5c251-61c2-40f5-8947-5a719c1c0b71",
67
+ "name": "Container Type 1",
68
+ "owningAppId": "a6f79b17-a0f5-47d1-bfde-9995caebc2a3",
69
+ "billingClassification": "trial",
70
+ "billingStatus": "valid",
71
+ "createdDateTime": "2025-04-15T17:50:26.9411866Z",
72
+ "expirationDateTime": "2025-05-15T17:50:26.8161883Z",
73
+ "etag": "MC4wLjAuMA==",
74
+ "settings": {
75
+ "urlTemplate": "",
76
+ "isDiscoverabilityEnabled": false,
77
+ "isSearchEnabled": true,
78
+ "isItemVersioningEnabled": true,
79
+ "itemMajorVersionLimit": 500,
80
+ "maxStoragePerContainerInBytes": 209715200,
81
+ "isSharingRestricted": false,
82
+ "consumingTenantOverridables": ""
83
+ }
56
84
  }
57
85
  ]
58
86
  ```
@@ -61,17 +89,17 @@ m365 spe containertype list
61
89
  <TabItem value="Text">
62
90
 
63
91
  ```text
64
- ContainerTypeId DisplayName OwningAppId
65
- -------------------------------------------- --------------------------------------------- --------------------------------------------
66
- /Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/ test1 /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
92
+ id name owningAppId
93
+ ------------------------------------ --------------------------- ------------------------------------
94
+ 5de5c251-61c2-40f5-8947-5a719c1c0b71 Container Type 1 a6f79b17-a0f5-47d1-bfde-9995caebc2a3
67
95
  ```
68
96
 
69
97
  </TabItem>
70
98
  <TabItem value="CSV">
71
99
 
72
100
  ```csv
73
- _ObjectType_,ApplicationRedirectUrl,AzureSubscriptionId,ContainerTypeId,CreationDate,DisplayName,ExpiryDate,IsBillingProfileRequired,OwningAppId,OwningTenantId,Region,ResourceGroup,SPContainerTypeBillingClassification
74
- Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties,,/Guid(00000000-0000-0000-0000-000000000000)/,/Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/,,test1,,1,/Guid(df4085cc-9a38-4255-badc-5c5225610475)/,/Guid(00000000-0000-0000-0000-000000000000)/,,,0
101
+ id,name,owningAppId,billingClassification,billingStatus,createdDateTime,etag
102
+ 5de5c251-61c2-40f5-8947-5a719c1c0b71,Container Type 1,a6f79b17-a0f5-47d1-bfde-9995caebc2a3,trial,valid,2025-04-15T17:50:26.9411866Z,MC4wLjAuMA==
75
103
  ```
76
104
 
77
105
  </TabItem>
@@ -82,18 +110,18 @@ m365 spe containertype list
82
110
 
83
111
  Date: 5/11/2024
84
112
 
85
- ## test1
113
+ ## Container Type 1
86
114
 
87
115
  Property | Value
88
116
  ---------|-------
89
- \_ObjectType\_ | Microsoft.Online.SharePoint.TenantAdministration.SPContainerTypeProperties
90
- AzureSubscriptionId | /Guid(00000000-0000-0000-0000-000000000000)/
91
- ContainerTypeId | /Guid(073269af-f1d2-042d-2ef5-5bdd6ac83115)/
92
- DisplayName | test1
93
- IsBillingProfileRequired | true
94
- OwningAppId | /Guid(df4085cc-9a38-4255-badc-5c5225610475)/
95
- OwningTenantId | /Guid(00000000-0000-0000-0000-000000000000)/
96
- SPContainerTypeBillingClassification | 0
117
+ id | 5de5c251-61c2-40f5-8947-5a719c1c0b71
118
+ name | Container Type 1
119
+ owningAppId | a6f79b17-a0f5-47d1-bfde-9995caebc2a3
120
+ billingClassification | trial
121
+ billingStatus | valid
122
+ createdDateTime | 2025-04-15T17:50:26.9411866Z
123
+ expirationDateTime | 2025-05-15T17:50:26.8161883Z
124
+ etag | MC4wLjAuMA==
97
125
  ```
98
126
 
99
127
  </TabItem>
@@ -107,4 +135,4 @@ Container Type is a property stamped on every Container instance. Each Container
107
135
 
108
136
  The primary function of a Container Type is to manage the application workload that can access the Containers. Container Type defines the access permissions an Application has towards all Containers of that type, including create, read, write, delete containers; manage container permissions, etc.
109
137
 
110
- More information about SharePoint Embedded and the limits can be found at the following location: [SharePoint Embedded](https://learn.microsoft.com/en-us/sharepoint/dev/embedded/concepts/app-concepts/containertypes#sharepoint-embedded-trial-container-types)
138
+ More information about SharePoint Embedded and the limits can be found at the following location: [SharePoint Embedded](https://learn.microsoft.com/sharepoint/dev/embedded/concepts/app-concepts/containertypes#sharepoint-embedded-trial-container-types)
@@ -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
  # spe containertype remove
4
6
 
@@ -27,21 +29,46 @@ m365 spe containertype remove [options]
27
29
 
28
30
  ## Remarks
29
31
 
30
- :::info
32
+ :::danger[Important]
31
33
 
32
- To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
34
+ This command relies on a different API endpoint due to current API limitations. As a result, it requires different permissions than other `spe containertype` commands. We plan to align the permissions in the future once these limitations are resolved.
33
35
 
34
36
  :::
35
37
 
38
+ ## Permissions
39
+
40
+ <Tabs>
41
+ <TabItem value="Delegated">
42
+
43
+ | Resource | Permissions |
44
+ |------------|--------------------|
45
+ | SharePoint | Container.Selected |
46
+
47
+ :::info
48
+
49
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
50
+
51
+ :::
52
+
53
+ </TabItem>
54
+ <TabItem value="Application">
55
+
56
+ | Resource | Permissions |
57
+ |------------|--------------------|
58
+ | SharePoint | Container.Selected |
59
+
60
+ </TabItem>
61
+ </Tabs>
62
+
36
63
  ## Examples
37
64
 
38
- Removes a container type by ID
65
+ Removes a container type by ID.
39
66
 
40
67
  ```sh
41
68
  m365 spe containertype remove --id 4ec4aefd-4fa3-0e4a-20c3-6e68389e7138
42
69
  ```
43
70
 
44
- Removes a container type by name
71
+ Removes a container type by name.
45
72
 
46
73
  ```sh
47
74
  m365 spe containertype remove --name 'My container type'
@@ -22,13 +22,26 @@ m365 spfx project upgrade [options]
22
22
  : The package manager you use. Supported managers `npm`, `pnpm`, `yarn`. Default `npm`
23
23
 
24
24
  `--shell [shell]`
25
- : The shell you use. Supported shells `bash`, `powershell`, `cmd`. Default `bash`
25
+ : The shell you use. Supported shells `bash`, `powershell`, `cmd`. Default `powershell`
26
26
 
27
27
  `--preview`
28
28
  : Upgrade project to the latest SPFx preview version
29
- ```
30
29
 
31
- <Global />
30
+ `-h, --help [help]`
31
+ : Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are `options`, `examples`, `remarks`, `permissions`, `response`, `full`. Default is `options`.
32
+
33
+ `--query [query]`
34
+ : JMESPath query string. See [http://jmespath.org/](http://jmespath.org/) for more information and examples.
35
+
36
+ `-o, --output [output]`
37
+ : Output type. `json`, `text`, `csv`, `md`, `tour`, `none`. Default `json`.
38
+
39
+ `--verbose`
40
+ : Runs command with verbose logging.
41
+
42
+ `--debug`
43
+ : Runs command with debug logging.
44
+ ```
32
45
 
33
46
  ## Remarks
34
47
 
@@ -83,7 +96,7 @@ m365 spfx project upgrade --output text
83
96
  Get instructions to upgrade the current SharePoint Framework project to the latest SharePoint Framework version supported by the CLI for Microsoft 365 using PowerShell
84
97
 
85
98
  ```sh
86
- m365 spfx project upgrade --shell powershell --output text
99
+ m365 spfx project upgrade --output text
87
100
  ```
88
101
 
89
102
  Get instructions to upgrade the current SharePoint Framework project to the latest version of SharePoint Framework and save the findings in a [CodeTour](https://aka.ms/codetour) file
@@ -134,7 +147,7 @@ When upgrading an SPFx project built using version 1.15.0 to SPFx version 1.15.2
134
147
  <TabItem value="Text">
135
148
 
136
149
  ```text
137
- Execute in bash
150
+ Execute in powershell
138
151
  -----------------------
139
152
  npm i -SE @microsoft/sp-core-library@1.15.2
140
153
 
@@ -33,9 +33,6 @@ m365 spo file move [options]
33
33
  `--nameConflictBehavior [nameConflictBehavior]`
34
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`.
35
35
 
36
- `--includeItemPermissions`
37
- : (deprecated. Use option `withItemPermissions` instead) Ensure that item-level permissions are preserved during the move.
38
-
39
36
  `--withItemPermissions`
40
37
  : Ensure that item-level permissions are preserved during the move.
41
38
 
@@ -0,0 +1,68 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo file version keep
6
+
7
+ Ensure that a specific file version will never expire
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo file version keep [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --webUrl <webUrl>`
19
+ : The URL of the site where the file is located.
20
+
21
+ `--fileUrl [fileUrl]`
22
+ : The server- or site-relative decoded URL. Specify either `fileUrl` or `fileId` but not both.
23
+
24
+ `-i, --fileId [fileId]`
25
+ : The UniqueId (GUID) of the file. Specify either `fileUrl` or `fileId` but not both.
26
+
27
+ `--label <label>`
28
+ : Label of the version.
29
+ ```
30
+
31
+ <Global />
32
+
33
+ ## Permissions
34
+
35
+ <Tabs>
36
+ <TabItem value="Delegated">
37
+
38
+ | Resource | Permissions |
39
+ |------------|----------------|
40
+ | SharePoint | AllSites.Write |
41
+
42
+ </TabItem>
43
+ <TabItem value="Application">
44
+
45
+ | Resource | Permissions |
46
+ |------------|---------------------|
47
+ | SharePoint | Sites.ReadWrite.All |
48
+
49
+ </TabItem>
50
+ </Tabs>
51
+
52
+ ## Examples
53
+
54
+ Mark a file version as never expiring by file URL.
55
+
56
+ ```sh
57
+ m365 spo file version keep --webUrl "https://contoso.sharepoint.com/sites/marketing" --fileUrl "/sites/marketing/Documents/report.docx" --label "6.0"
58
+ ```
59
+
60
+ Mark a file version as never expiring by file ID.
61
+
62
+ ```sh
63
+ m365 spo file version keep --webUrl "https://contoso.sharepoint.com/sites/marketing" --fileId "12345678-90ab-cdef-1234-567890abcdef" --label "6.0"
64
+ ```
65
+
66
+ ## Response
67
+
68
+ The command won't return a response on success.
@@ -24,8 +24,11 @@ m365 spo homesite add [options]
24
24
  `--vivaConnectionsDefaultStart [vivaConnectionsDefaultStart]`
25
25
  : Specifies whether the home site is the default start for Viva Connections. Accepts `true` or `false`. Default is `true`.
26
26
 
27
- `--audiences [audiences]`
28
- : Comma-separated list of Microsoft Entra group IDs that will be used as audience.
27
+ `--audienceIds [audienceIds]`
28
+ : Comma-separated list of Microsoft Entra group IDs to be used as audiences. Specify either `audienceIds` or `audienceNames`, but not both.
29
+
30
+ `--audienceNames [audienceNames]`
31
+ : Comma-separated list of Microsoft Entra group names to be used as audiences. You must use either `audienceIds` or `audienceNames`, but not both.
29
32
 
30
33
  `--order [order]`
31
34
  : Order of the home site. Must be a positive integer.
@@ -41,10 +44,16 @@ Add a home site
41
44
  m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms"
42
45
  ```
43
46
 
44
- Add a home site with additional options
47
+ Add a home site with audiences specified by their groups ids and with additional options
48
+
49
+ ```sh
50
+ m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms" --isInDraftMode true --vivaConnectionsDefaultStart false --audienceIds "af8c0bc8-7b1b-44b4-b087-ffcc8df70d16,754ff15c-76b1-44cb-88c7-0065a4d3cfb7" --order 2
51
+ ```
52
+
53
+ Add a home site with audiences specified by their groups names and with additional options
45
54
 
46
55
  ```sh
47
- m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms" --isInDraftMode true --vivaConnectionsDefaultStart false --audiences "af8c0bc8-7b1b-44b4-b087-ffcc8df70d16,754ff15c-76b1-44cb-88c7-0065a4d3cfb7" --order 2
56
+ m365 spo homesite add --url "https://contoso.sharepoint.com/sites/testcomms" --isInDraftMode true --vivaConnectionsDefaultStart false --audienceNames "Marketing, IT department" --order 2
48
57
  ```
49
58
 
50
59
  ## Response
@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
4
4
 
5
5
  # spo homesite get
6
6
 
7
- Gets information about the Home Site
7
+ Gets information about a home site
8
8
 
9
9
  ## Usage
10
10
 
@@ -14,14 +14,19 @@ m365 spo homesite get [options]
14
14
 
15
15
  ## Options
16
16
 
17
+ ```md definition-list
18
+ `-u, --url <url>`
19
+ : URL of the home site.
20
+ ```
21
+
17
22
  <Global />
18
23
 
19
24
  ## Examples
20
25
 
21
- Get information about the Home Site.
26
+ Get information about a home site.
22
27
 
23
28
  ```sh
24
- m365 spo homesite get
29
+ m365 spo homesite get --url https://contoso.sharepoint.com/sites/Home
25
30
  ```
26
31
 
27
32
  ## Response
@@ -31,11 +36,21 @@ m365 spo homesite get
31
36
 
32
37
  ```json
33
38
  {
34
- "SiteId": "af80c11f-0138-4d72-bb37-514542c3aabb",
35
- "WebId": "6f90666d-b0e7-40c3-991f-4ab051d00a70",
36
- "LogoUrl": "https://contoso.sharepoint.com/sites/intra/siteassets/work.png",
37
- "Title": "Intranet",
38
- "Url": "https://contoso.sharepoint.com/sites/intra"
39
+ "Audiences": [
40
+ {
41
+ "Email": "Marketing@contoso.onmicrosoft.com",
42
+ "Id": "contoso73155a8f-4db7-42e7-baf4-c724d24bf373",
43
+ "Title": "Marketing Members"
44
+ }
45
+ ],
46
+ "IsInDraftMode": false,
47
+ "IsVivaBackendSite": false,
48
+ "SiteId": "e16a5a81-67fb-4a5e-a959-1f33ae44c69f",
49
+ "TargetedLicenseType": 0,
50
+ "Title": "Home",
51
+ "Url": "https://contoso.sharepoint.com/",
52
+ "VivaConnectionsDefaultStart": false,
53
+ "WebId": "2779dcbb-fae0-4b0c-a845-89ab4c941fab"
39
54
  }
40
55
  ```
41
56
 
@@ -43,39 +58,45 @@ m365 spo homesite get
43
58
  <TabItem value="Text">
44
59
 
45
60
  ```text
46
- LogoUrl: https://contoso.sharepoint.com/sites/intra/siteassets/work.png
47
- SiteId : af80c11f-0138-4d72-bb37-514542c3aabb
48
- Title : Intranet
49
- Url : https://contoso.sharepoint.com/sites/intra
50
- WebId : 6f90666d-b0e7-40c3-991f-4ab051d00a70
61
+ Audiences : [{"Email":"Marketing@contoso.onmicrosoft.com","Id":"contoso73155a8f-4db7-42e7-baf4-c724d24bf373","Title":"Marketing Members"}]
62
+ IsInDraftMode : false
63
+ IsVivaBackendSite : false
64
+ SiteId : e16a5a81-67fb-4a5e-a959-1f33ae44c69f
65
+ TargetedLicenseType : 0
66
+ Title : Home
67
+ Url : https://contoso.sharepoint.com/
68
+ VivaConnectionsDefaultStart: false
69
+ WebId : 2779dcbb-fae0-4b0c-a845-89ab4c941fab
51
70
  ```
52
71
 
53
72
  </TabItem>
54
73
  <TabItem value="CSV">
55
74
 
56
75
  ```csv
57
- SiteId,WebId,LogoUrl,Title,Url
58
- af80c11f-0138-4d72-bb37-514542c3aabb,6f90666d-b0e7-40c3-991f-4ab051d00a70,https://contoso.sharepoint.com/sites/intra/siteassets/work.png,Intranet,https://contoso.sharepoint.com/sites/intra
76
+ IsInDraftMode,IsVivaBackendSite,SiteId,TargetedLicenseType,Title,Url,VivaConnectionsDefaultStart,WebId
77
+ 0,0,e16a5a81-67fb-4a5e-a959-1f33ae44c69f,0,Home,https://contoso.sharepoint.com/,0,2779dcbb-fae0-4b0c-a845-89ab4c941fab
59
78
  ```
60
79
 
61
80
  </TabItem>
62
81
  <TabItem value="Markdown">
63
82
 
64
83
  ```md
65
- # spo homesite get
84
+ # spo homesite get --url "https://contoso.sharepoint.com"
66
85
 
67
- Date: 2/20/2023
86
+ Date: 23/08/2025
68
87
 
69
- ## Intranet (https://contoso.sharepoint.com/sites/intra)
88
+ ## Home (https://contoso.sharepoint.com/)
70
89
 
71
90
  Property | Value
72
91
  ---------|-------
73
92
  IsInDraftMode | false
74
- SiteId | af80c11f-0138-4d72-bb37-514542c3aabb
75
- WebId |6f90666d-b0e7-40c3-991f-4ab051d00a70
76
- LogoUrl | https://contoso.sharepoint.com/sites/intra/siteassets/work.png
77
- Title | Intranet
78
- Url | https://contoso.sharepoint.com/sites/intra
93
+ IsVivaBackendSite | false
94
+ SiteId | e16a5a81-67fb-4a5e-a959-1f33ae44c69f
95
+ TargetedLicenseType | 0
96
+ Title | Home
97
+ Url | https://contoso.sharepoint.com/
98
+ VivaConnectionsDefaultStart | false
99
+ WebId | 2779dcbb-fae0-4b0c-a845-89ab4c941fab
79
100
  ```
80
101
 
81
102
  </TabItem>
@@ -12,12 +12,6 @@ Lists all home sites
12
12
  m365 spo homesite list [options]
13
13
  ```
14
14
 
15
- ## Alias
16
-
17
- ```sh
18
- m365 spo tenant homesite list [options]
19
- ```
20
-
21
15
  ## Options
22
16
 
23
17
  <Global />