@pnp/cli-microsoft365 9.0.0 → 9.1.0-beta.53b407a

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 (109) hide show
  1. package/allCommands.json +1 -1
  2. package/allCommandsFull.json +1 -1
  3. package/dist/Auth.js +6 -4
  4. package/dist/AuthServer.js +7 -7
  5. package/dist/Command.js +4 -1
  6. package/dist/api.js +1 -1
  7. package/dist/m365/base/PowerAutomateCommand.js +1 -1
  8. package/dist/m365/commands/login.js +1 -1
  9. package/dist/m365/file/commands/file-move.js +135 -0
  10. package/dist/m365/file/commands.js +2 -1
  11. package/dist/m365/flow/commands/environment/environment-get.js +1 -1
  12. package/dist/m365/flow/commands/environment/environment-list.js +1 -1
  13. package/dist/m365/flow/commands/flow-disable.js +1 -1
  14. package/dist/m365/flow/commands/flow-enable.js +1 -1
  15. package/dist/m365/flow/commands/flow-export.js +17 -16
  16. package/dist/m365/flow/commands/flow-get.js +1 -1
  17. package/dist/m365/flow/commands/flow-list.js +1 -1
  18. package/dist/m365/flow/commands/flow-remove.js +1 -1
  19. package/dist/m365/flow/commands/owner/owner-ensure.js +1 -1
  20. package/dist/m365/flow/commands/owner/owner-list.js +1 -1
  21. package/dist/m365/flow/commands/owner/owner-remove.js +1 -1
  22. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-list.js +47 -0
  23. package/dist/m365/flow/commands/recyclebinitem/recyclebinitem-restore.js +48 -0
  24. package/dist/m365/flow/commands/run/run-cancel.js +1 -1
  25. package/dist/m365/flow/commands/run/run-get.js +1 -1
  26. package/dist/m365/flow/commands/run/run-list.js +1 -1
  27. package/dist/m365/flow/commands/run/run-resubmit.js +2 -2
  28. package/dist/m365/flow/commands.js +2 -0
  29. package/dist/m365/spfx/commands/project/project-doctor/doctor-1.20.0-rc.1.js +25 -0
  30. package/dist/m365/spfx/commands/project/project-doctor.js +2 -1
  31. package/dist/m365/spfx/commands/project/project-upgrade/upgrade-1.20.0-rc.1.js +57 -0
  32. package/dist/m365/spfx/commands/project/project-upgrade.js +16 -13
  33. package/dist/m365/spfx/commands/spfx-doctor.js +15 -0
  34. package/dist/m365/spo/commands/file/file-roleassignment-add.js +17 -54
  35. package/dist/m365/spo/commands/file/file-roleassignment-remove.js +13 -40
  36. package/dist/m365/spo/commands/file/file-roleinheritance-break.js +5 -13
  37. package/dist/m365/spo/commands/file/file-roleinheritance-reset.js +5 -13
  38. package/dist/m365/spo/commands/folder/folder-sharinglink-add.js +143 -0
  39. package/dist/m365/spo/commands/folder/folder-sharinglink-clear.js +111 -0
  40. package/dist/m365/spo/commands/folder/folder-sharinglink-remove.js +95 -0
  41. package/dist/m365/spo/commands/list/list-get.js +17 -4
  42. package/dist/m365/spo/commands/page/page-section-add.js +185 -34
  43. package/dist/m365/spo/commands/site/SiteAdmin.js +2 -0
  44. package/dist/m365/spo/commands/site/site-admin-add.js +252 -0
  45. package/dist/m365/spo/commands/site/site-admin-list.js +2 -27
  46. package/dist/m365/spo/commands/site/site-admin-remove.js +193 -0
  47. package/dist/m365/spo/commands/user/user-get.js +67 -9
  48. package/dist/m365/spo/commands.js +5 -0
  49. package/dist/m365/spp/commands/contentcenter/contentcenter-list.js +56 -0
  50. package/dist/m365/spp/commands.js +5 -0
  51. package/dist/m365/teams/MeetingTranscript.js +2 -0
  52. package/dist/m365/teams/commands/meeting/meeting-transcript-get.js +152 -0
  53. package/dist/m365/teams/commands.js +1 -0
  54. package/dist/request.js +46 -61
  55. package/dist/utils/driveUtil.js +51 -0
  56. package/dist/utils/spo.js +75 -7
  57. package/dist/utils/timersUtil.js +12 -0
  58. package/dist/utils/zod.js +1 -1
  59. package/docs/docs/cmd/entra/m365group/m365group-report-activitystorage.mdx +2 -2
  60. package/docs/docs/cmd/file/file-move.mdx +79 -0
  61. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-list.mdx +132 -0
  62. package/docs/docs/cmd/flow/recyclebinitem/recyclebinitem-restore.mdx +55 -0
  63. package/docs/docs/cmd/spo/cdn/cdn-get.mdx +1 -1
  64. package/docs/docs/cmd/spo/cdn/cdn-origin-add.mdx +1 -1
  65. package/docs/docs/cmd/spo/cdn/cdn-origin-list.mdx +1 -1
  66. package/docs/docs/cmd/spo/cdn/cdn-origin-remove.mdx +1 -1
  67. package/docs/docs/cmd/spo/cdn/cdn-policy-list.mdx +1 -1
  68. package/docs/docs/cmd/spo/cdn/cdn-policy-set.mdx +1 -1
  69. package/docs/docs/cmd/spo/externaluser/externaluser-list.mdx +1 -1
  70. package/docs/docs/cmd/spo/folder/folder-sharinglink-add.mdx +125 -0
  71. package/docs/docs/cmd/spo/folder/folder-sharinglink-clear.mdx +50 -0
  72. package/docs/docs/cmd/spo/folder/folder-sharinglink-remove.mdx +50 -0
  73. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-get.mdx +1 -1
  74. package/docs/docs/cmd/spo/hidedefaultthemes/hidedefaultthemes-set.mdx +1 -1
  75. package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +1 -1
  76. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-get.mdx +1 -1
  77. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx +1 -1
  78. package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx +1 -1
  79. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx +1 -1
  80. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx +1 -1
  81. package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx +1 -1
  82. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx +1 -1
  83. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx +1 -1
  84. package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx +1 -1
  85. package/docs/docs/cmd/spo/page/page-section-add.mdx +57 -2
  86. package/docs/docs/cmd/spo/site/site-admin-add.mdx +67 -0
  87. package/docs/docs/cmd/spo/site/site-admin-remove.mdx +67 -0
  88. package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx +1 -1
  89. package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx +1 -1
  90. package/docs/docs/cmd/spo/site/site-commsite-enable.mdx +1 -1
  91. package/docs/docs/cmd/spo/site/site-list.mdx +6 -4
  92. package/docs/docs/cmd/spo/site/site-set.mdx +1 -1
  93. package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx +1 -1
  94. package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx +1 -1
  95. package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx +1 -1
  96. package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx +1 -1
  97. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx +1 -1
  98. package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx +1 -1
  99. package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx +1 -1
  100. package/docs/docs/cmd/spo/theme/theme-apply.mdx +1 -1
  101. package/docs/docs/cmd/spo/theme/theme-get.mdx +1 -1
  102. package/docs/docs/cmd/spo/theme/theme-list.mdx +1 -1
  103. package/docs/docs/cmd/spo/theme/theme-remove.mdx +1 -1
  104. package/docs/docs/cmd/spo/theme/theme-set.mdx +1 -1
  105. package/docs/docs/cmd/spo/user/user-get.mdx +35 -9
  106. package/docs/docs/cmd/spp/contentcenter/contentcenter-list.mdx +287 -0
  107. package/docs/docs/cmd/teams/meeting/meeting-transcript-get.mdx +132 -0
  108. package/npm-shrinkwrap.json +205 -377
  109. package/package.json +17 -18
@@ -26,10 +26,46 @@ m365 spo page section add [options]
26
26
  : Order of the section to add.
27
27
 
28
28
  `--zoneEmphasis [zoneEmphasis]`
29
- : Section background shading. Allowed values `None`, `Neutral`, `Soft`, `Strong`
29
+ : Section background shading. Allowed values `None`, `Neutral`, `Soft`, `Strong`, `Image`,`Gradient`
30
30
 
31
31
  `--isLayoutReflowOnTop`
32
- : The position of the Vertical section for smaller screens. Applied only for Vertical section.
32
+ : The position of the Vertical section for smaller screens. Applied only for `Vertical` section.
33
+
34
+ `--isCollapsibleSection`
35
+ : Set section to be collapsible.
36
+
37
+ `--showDivider`
38
+ : Shows a divider line between sections.
39
+
40
+ `--iconAlignment [iconAlignment]`
41
+ : Specifies the alignment of the expand/collapse icon. Sets `Left` alignment if not specified.
42
+
43
+ `--isExpanded`
44
+ : Sets the default display state of the collapsible section. Sets `false` if not specified.
45
+
46
+ `--gradientText [gradientText]`
47
+ : Sets the gradient setting of the background of a section. Required when `zoneEmphasis` is `Gradient`.
48
+
49
+ `--imageUrl [imageUrl]`
50
+ : The background image URL. Required when `zoneEmphasis` is `Image`.
51
+
52
+ `--imageHeight [imageHeight]`
53
+ : The height of the background image. Applied only when when `zoneEmphasis` is `Image`. Sets `955` value if not specified.
54
+
55
+ `--imageWidth [imageWidth]`
56
+ : The width of the background image. Applied only when `zoneEmphasis` is `Image`. Sets `555` value if not specified.
57
+
58
+ `--fillMode [fillMode]`
59
+ : The fill mode of the background image. Applied only when `zoneEmphasis` is `Image`. Possible values are `ScaleToFill`, `ScaleToFit`, `Tile`, `OriginalSize`. Sets `ScaleToFill` value if not specified.
60
+
61
+ `--useLightText`
62
+ : Specifies whether to use light text for the background. Applied only when `zoneEmphasis` is `Image`.
63
+
64
+ `--overlayColor [overlayColor]`
65
+ : The overlay color for the background in #RRGGBB format. Applied only when `zoneEmphasis` is `Image` or `Gradient`. Sets `#ffffff` value if not specified.
66
+
67
+ `--overlayOpacity [overlayOpacity]`
68
+ : The overlay opacity for the background. Applied only when `zoneEmphasis` is `Image` or `Gradient`. Sets `60` value if not specified.
33
69
  ```
34
70
 
35
71
  <Global />
@@ -64,6 +100,25 @@ Add Vertical section with background shading to the modern page with adjusting t
64
100
  m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Vertical --zoneEmphasis Neutral --isLayoutReflowOnTop
65
101
  ```
66
102
 
103
+ Add OneColumn section as a collapsible section as expanded with icon alligned to the left
104
+
105
+ ```sh
106
+ m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --isCollapsibleSection --isExpanded --iconAlignment Left
107
+ ```
108
+
109
+ Add TwoColumn section with Image background
110
+
111
+ ```sh
112
+ m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate TwoColumn --imageUrl "https://contoso.com/image.jpg" --zoneEmphasis Image --fillMode Tile
113
+ ```
114
+
115
+ Add OneColumn section with Gradient background
116
+
117
+ ```sh
118
+ m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate TwoColumn --zoneEmphasis Gradient --gradientText "linear-gradient(72.44deg, #E6FBFE 0%, #EDDDFB 100%)"
119
+ ```
120
+
121
+
67
122
  ## Response
68
123
 
69
124
  The command won't return a response on success.
@@ -0,0 +1,67 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo site admin add
6
+
7
+ Adds a user or group as a site collection administrator
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo site admin add [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --siteUrl <siteUrl>`
19
+ : The URL of the SharePoint site
20
+
21
+ `--userId [userId]`
22
+ : The ID of the user to add as a site collection admin
23
+
24
+ `--userName [userName]`
25
+ : The user principal name of the user to add as a site collection admin
26
+
27
+ `--groupId [groupId]`
28
+ : The ID of the Microsoft Entra ID group to add as a site collection admin
29
+
30
+ `--groupName [groupName]`
31
+ : The name of the Microsoft Entra ID group to add as a site collection admin
32
+
33
+ `--primary`
34
+ : If set, will add the user as primary site collection admin. The old primary site collection admin will be replaced and set as secondary site collection admin
35
+
36
+ `--asAdmin`
37
+ : If specified, we will use the SharePoint admin center to execute the command
38
+ ```
39
+
40
+ <Global />
41
+
42
+ ## Remarks
43
+
44
+ :::info
45
+
46
+ To use this command with the `--asAdmin` mode, you have to have permissions to access the tenant admin site.
47
+
48
+ Without this parameter, you have to have site collection admin permissions for the requested site.
49
+
50
+ :::
51
+
52
+ ## Examples
53
+
54
+ Add user as primary site collection administrator
55
+
56
+ ```sh
57
+ m365 spo site admin add --siteUrl https://contoso.sharepoint.com --userId 600713c5-53c6-4f24-b454-3c35e22b2639 --primary
58
+ ```
59
+
60
+ Adds group as secondary site collection administrator as SharePoint admin
61
+
62
+ ```sh
63
+ m365 spo site admin add --siteUrl https://contoso.sharepoint.com --groupName SP_Administrators --asAdmin
64
+ ```
65
+ ## Response
66
+
67
+ The command won't return a response on success.
@@ -0,0 +1,67 @@
1
+ import Global from '/docs/cmd/_global.mdx';
2
+ import Tabs from '@theme/Tabs';
3
+ import TabItem from '@theme/TabItem';
4
+
5
+ # spo site admin remove
6
+
7
+ Removes a user or group as site collection administrator
8
+
9
+ ## Usage
10
+
11
+ ```sh
12
+ m365 spo site admin remove [options]
13
+ ```
14
+
15
+ ## Options
16
+
17
+ ```md definition-list
18
+ `-u, --siteUrl <siteUrl>`
19
+ : The URL of the SharePoint site
20
+
21
+ `--userId [userId]`
22
+ : The ID of the user to remove as a site collection admin
23
+
24
+ `--userName [userName]`
25
+ : The user principal name of the user to remove as a site collection admin
26
+
27
+ `--groupId [groupId]`
28
+ : The ID of the Microsoft Entra ID group to remove as a site collection admin
29
+
30
+ `--groupName [groupName]`
31
+ : The name of the Microsoft Entra ID group to remove as a site collection admin
32
+
33
+ `--asAdmin`
34
+ : If specified, we will use the SharePoint admin center to execute the command
35
+
36
+ `-f, --force`
37
+ : Don't prompt for confirmation
38
+ ```
39
+
40
+ <Global />
41
+
42
+ ## Remarks
43
+
44
+ :::info
45
+
46
+ To use this command with the `--asAdmin` mode, you have to have permissions to access the tenant admin site.
47
+
48
+ Without this parameter, you have to have site collection admin permissions for the requested site.
49
+
50
+ :::
51
+
52
+ ## Examples
53
+
54
+ Removes user as site collection admin
55
+
56
+ ```sh
57
+ m365 spo site admin remove --siteUrl https://contoso.sharepoint.com --userId 600713c5-53c6-4f24-b454-3c35e22b2639
58
+ ```
59
+
60
+ Removes group as site collection admin without prompting for confirmation as SharePoint Admin
61
+
62
+ ```sh
63
+ m365 spo site admin remove --siteUrl https://contoso.sharepoint.com --groupName SP_Administrators --force --asAdmin
64
+ ```
65
+ ## Response
66
+
67
+ The command won't return a response on success.
@@ -23,7 +23,7 @@ m365 spo site appcatalog add [options]
23
23
 
24
24
  :::info
25
25
 
26
- To use this command you have to have permissions to access the tenant admin site.
26
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
27
27
 
28
28
  :::
29
29
 
@@ -25,7 +25,7 @@ While the command uses the term *'remove'*, like its equivalent PowerShell cmdle
25
25
 
26
26
  :::info
27
27
 
28
- To use this command you have to have permissions to access the tenant admin site.
28
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
29
29
 
30
30
  :::
31
31
 
@@ -29,7 +29,7 @@ m365 spo site commsite enable [options]
29
29
 
30
30
  :::info
31
31
 
32
- To use this command you have to have permissions to access the tenant admin site.
32
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
33
33
 
34
34
  :::
35
35
 
@@ -173,6 +173,7 @@ m365 spo site list --includeOneDriveSites
173
173
  "SharingLockDownEnabled": false,
174
174
  "ShowPeoplePickerSuggestionsForGuestUsers": false,
175
175
  "SiteDefinedSharingCapability": 1,
176
+ "SiteId": "/Guid(a7c46398-494d-4a8d-b0db-f6e58432eb67)/",
176
177
  "SocialBarOnSitePagesDisabled": false,
177
178
  "Status": "Active",
178
179
  "StorageMaximumLevel": 1048576,
@@ -205,10 +206,10 @@ m365 spo site list --includeOneDriveSites
205
206
  <TabItem value="CSV">
206
207
 
207
208
  ```csv
208
- _ObjectType_;_ObjectIdentity_;AllowDownloadingNonWebViewableFiles;AllowEditing;AllowSelfServiceUpgrade;AnonymousLinkExpirationInDays;AuthenticationContextLimitedAccess;AverageResourceUsage;BlockDownloadLinksFileType;BlockDownloadPolicy;BlockGuestsAsSiteAdmin;ClearRestrictedAccessControl;CommentsOnSitePagesDisabled;CompatibilityLevel;ConditionalAccessPolicy;CurrentResourceUsage;DefaultLinkPermission;DefaultLinkToExistingAccess;DefaultLinkToExistingAccessReset;DefaultShareLinkRole;DefaultShareLinkScope;DefaultSharingLinkType;DenyAddAndCustomizePages;DisableAppViews;DisableCompanyWideSharingLinks;DisableFlows;ExcludeBlockDownloadPolicySiteOwners;ExternalUserExpirationInDays;GroupId;HasHolds;HubSiteId;IsGroupOwnerSiteAdmin;IsHubSite;IsTeamsChannelConnected;IsTeamsConnected;LastContentModifiedDate;Lcid;LimitedAccessFileType;ListsShowHeaderAndNavigation;LockState;LoopDefaultSharingLinkRole;LoopDefaultSharingLinkScope;LoopOverrideSharingCapability;LoopSharingCapability;MediaTranscription;OverrideBlockUserInfoVisibility;OverrideSharingCapability;OverrideTenantAnonymousLinkExpirationPolicy;OverrideTenantExternalUserExpirationPolicy;Owner;PWAEnabled;ReadOnlyAccessPolicy;ReadOnlyForBlockDownloadPolicy;ReadOnlyForUnmanagedDevices;RelatedGroupId;RequestFilesLinkEnabled;RequestFilesLinkExpirationInDays;RestrictedAccessControl;RestrictedToRegion;SandboxedCodeActivationCapability;SensitivityLabel;SetOwnerWithoutUpdatingSecondaryAdmin;SharingCapability;SharingDomainRestrictionMode;SharingLockDownCanBeCleared;SharingLockDownEnabled;ShowPeoplePickerSuggestionsForGuestUsers;SiteDefinedSharingCapability;SocialBarOnSitePagesDisabled;Status;StorageMaximumLevel;StorageUsage;StorageWarningLevel;TeamsChannelType;Template;TimeZoneId;Title;Url;UserCodeMaximumLevel;UserCodeWarningLevel;WebsCount
209
- Microsoft.Online.SharePoint.TenantAdministration.SiteProperties;"0a05bfa0-c046-6000-c2a5-1da5123cf537|908bed80-a04a-4433-b4a0-883d9847d110:1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
210
- SiteProperties
211
- https%3a%2f%2fcontoso.sharepoint.com%2fsites%2fteam1";;;1;0;;0;0;;0;;;15;0;0;0;;;0;0;0;2;0;0;0;;0;/Guid(00000000-0000-0000-0000-000000000000)/;;/Guid(5337976b-b560-4b64-b3fa-8eaf0339501a)/;;;;;/Date(2023,5,6,12,43,38,333)/;1033;0;;Unlock;0;0;;0;0;0;;;;john@contoso.onmicrosoft.com;1;;;;/Guid(00000000-0000-0000-0000-000000000000)/;;0;;3;0;/Guid(00000000-0000-0000-0000-000000000000)/;;0;0;;;;0;;Active;1048576;10;1022361;0;SITEPAGEPUBLISHING#0;13;Give @ Contoso;https://contoso.sharepoint.com/sites/team1;300;200;0
209
+ _ObjectType_,_ObjectIdentity_,AllowDownloadingNonWebViewableFiles,AllowEditing,AllowSelfServiceUpgrade,AnonymousLinkExpirationInDays,ApplyToExistingDocumentLibraries,ApplyToNewDocumentLibraries,ArchivedBy,ArchivedTime,ArchiveStatus,AuthContextStrength,AuthenticationContextLimitedAccess,AuthenticationContextName,AverageResourceUsage,BlockDownloadLinksFileType,BlockDownloadMicrosoft365GroupIds,BlockDownloadPolicy,BlockDownloadPolicyFileTypeIds,BlockGuestsAsSiteAdmin,BonusDiskQuota,ClearGroupId,ClearRestrictedAccessControl,CommentsOnSitePagesDisabled,CompatibilityLevel,ConditionalAccessPolicy,CurrentResourceUsage,DefaultLinkPermission,DefaultLinkToExistingAccess,DefaultLinkToExistingAccessReset,DefaultShareLinkRole,DefaultShareLinkScope,DefaultSharingLinkType,DenyAddAndCustomizePages,Description,DisableAppViews,DisableCompanyWideSharingLinks,DisableFlows,EnableAutoExpirationVersionTrim,ExcludeBlockDownloadPolicySiteOwners,ExpireVersionsAfterDays,ExternalUserExpirationInDays,GroupId,GroupOwnerLoginName,HasHolds,HubSiteId,IBMode,IBSegments,IBSegmentsToAdd,IBSegmentsToRemove,InheritVersionPolicyFromTenant,IsGroupOwnerSiteAdmin,IsHubSite,IsTeamsChannelConnected,IsTeamsConnected,LastContentModifiedDate,Lcid,LimitedAccessFileType,ListsShowHeaderAndNavigation,LockIssue,LockReason,LockState,LoopDefaultSharingLinkRole,LoopDefaultSharingLinkScope,MajorVersionLimit,MajorWithMinorVersionsLimit,MediaTranscription,OverrideBlockUserInfoVisibility,OverrideSharingCapability,OverrideTenantAnonymousLinkExpirationPolicy,OverrideTenantExternalUserExpirationPolicy,Owner,OwnerEmail,OwnerLoginName,OwnerName,PWAEnabled,ReadOnlyAccessPolicy,ReadOnlyForBlockDownloadPolicy,ReadOnlyForUnmanagedDevices,RelatedGroupId,RequestFilesLinkEnabled,RequestFilesLinkExpirationInDays,RestrictContentOrgWideSearch,RestrictedAccessControl,RestrictedAccessControlGroups,RestrictedAccessControlGroupsToAdd,RestrictedAccessControlGroupsToRemove,RestrictedToRegion,SandboxedCodeActivationCapability,SensitivityLabel,SensitivityLabel2,SetOwnerWithoutUpdatingSecondaryAdmin,SharingAllowedDomainList,SharingBlockedDomainList,SharingCapability,SharingDomainRestrictionMode,SharingLockDownCanBeCleared,SharingLockDownEnabled,ShowPeoplePickerSuggestionsForGuestUsers,SiteDefinedSharingCapability,SiteId,SocialBarOnSitePagesDisabled,Status,StorageMaximumLevel,StorageQuotaType,StorageUsage,StorageWarningLevel,TeamsChannelType,Template,TimeZoneId,Title,TitleTranslations,Url,UserCodeMaximumLevel,UserCodeWarningLevel,WebsCount
210
+ Microsoft.Online.SharePoint.TenantAdministration.SiteProperties,"7f934fa1-20ab-9000-f15c-df8f2970f555|908bed80-a04a-4433-b4a0-883d9847d110:18c58817-3bc9-489d-ac63-f7264fb357e5
211
+ SiteProperties
212
+ https%3a%2f%2fcontoso.sharepoint.com%2fsites%2fteam1",,,1,0,,,,"/Date(1,0,1,0,0,0,0)/",NotArchived,,,,0,0,,,,0,0,,,,15,0,0,0,,,0,0,0,2,,0,0,0,,,0,0,/Guid(004db326-a1de-4c5e-ad45-746fd89f57bb)/,,,/Guid(00000000-0000-0000-0000-000000000000)/,,,,,,,,,,"/Date(2024,6,17,21,54,44,437)/",1033,0,,,0,Unlock,0,0,0,0,0,0,,,,,,,,1,,,,/Guid(004db326-a1de-4c5e-ad45-746fd89f57bb)/,,0,,,,,,3,0,/Guid(00000000-0000-0000-0000-000000000000)/,,,,,1,0,,,,1,/Guid(a7c46398-494d-4a8d-b0db-f6e58432eb67)/,,Active,26214400,,1,25574400,0,GROUP#0,3,team1,,https://contoso.sharepoint.com/sites/team1,300,200,0
212
213
  ```
213
214
 
214
215
  </TabItem>
@@ -291,6 +292,7 @@ m365 spo site list --includeOneDriveSites
291
292
  SharingLockDownEnabled | false
292
293
  ShowPeoplePickerSuggestionsForGuestUsers | false
293
294
  SiteDefinedSharingCapability | 0
295
+ SiteId | /Guid(a7c46398-494d-4a8d-b0db-f6e58432eb67)/,
294
296
  SocialBarOnSitePagesDisabled | false
295
297
  Status | Active
296
298
  StorageMaximumLevel | 0
@@ -103,7 +103,7 @@ Setting site properties is by default asynchronous and depending on the current
103
103
 
104
104
  :::info
105
105
 
106
- To use this command you have to have permissions to access the tenant admin site.
106
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
107
107
 
108
108
  :::
109
109
 
@@ -31,7 +31,7 @@ Tenant properties are stored in the app catalog site associated with that tenant
31
31
 
32
32
  :::info
33
33
 
34
- To use this command you have to have permissions to access the tenant admin site.
34
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
35
35
 
36
36
  :::
37
37
 
@@ -39,7 +39,7 @@ If you specify the URL of a site different than the app catalog, you will get an
39
39
 
40
40
  :::info
41
41
 
42
- To use this command you have to have permissions to access the tenant admin site.
42
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
43
43
 
44
44
  :::
45
45
 
@@ -41,7 +41,7 @@ Creating an app catalog site might take a while. If you need to wait for the sit
41
41
 
42
42
  :::info
43
43
 
44
- To use this command you have to have permissions to access the tenant admin site.
44
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
45
45
 
46
46
  :::
47
47
 
@@ -20,7 +20,7 @@ m365 spo tenant appcatalogurl get [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -20,7 +20,7 @@ m365 spo tenant recyclebinitem list [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -31,7 +31,7 @@ Removing a site collection is by default asynchronous and depending on the curre
31
31
 
32
32
  :::info
33
33
 
34
- To use this command you have to have permissions to access the tenant admin site.
34
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
35
35
 
36
36
  :::
37
37
 
@@ -20,7 +20,7 @@ m365 spo tenant settings list [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -33,7 +33,7 @@ Following standard SharePoint themes are supported by the CLI for Microsoft 365:
33
33
 
34
34
  :::info
35
35
 
36
- To use this command you have to have permissions to access the tenant admin site.
36
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
37
37
 
38
38
  :::
39
39
 
@@ -25,7 +25,7 @@ m365 spo theme get [options]
25
25
 
26
26
  :::info
27
27
 
28
- To use this command you have to have permissions to access the tenant admin site.
28
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
29
29
 
30
30
  :::
31
31
 
@@ -20,7 +20,7 @@ m365 spo theme list [options]
20
20
 
21
21
  :::info
22
22
 
23
- To use this command you have to have permissions to access the tenant admin site.
23
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
24
24
 
25
25
  :::
26
26
 
@@ -26,7 +26,7 @@ m365 spo theme remove [options]
26
26
 
27
27
  :::info
28
28
 
29
- To use this command you have to have permissions to access the tenant admin site.
29
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
30
30
 
31
31
  :::
32
32
 
@@ -67,7 +67,7 @@ If any of these checks fails you are presented with a `The specified theme is no
67
67
 
68
68
  :::info
69
69
 
70
- To use this command you have to have permissions to access the tenant admin site.
70
+ To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
71
71
 
72
72
  :::
73
73
 
@@ -16,41 +16,68 @@ m365 spo user get [options]
16
16
 
17
17
  ```md definition-list
18
18
  `-u, --webUrl <webUrl>`
19
- : URL of the web to get the user within
19
+ : URL of the web to get the user within.
20
20
 
21
21
  `-i, --id [id]`
22
- : ID of the user to retrieve information for. Use either `email`, `id` or `loginName`, but not all.
22
+ : ID of the user to retrieve information for. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
23
23
 
24
24
  `--email [email]`
25
- : Email of the user to retrieve information for. Use either `email`, `id` or `loginName`, but not all.
25
+ : Email of the user to retrieve information for. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
26
26
 
27
27
  `--loginName [loginName]`
28
- : Login name of the user to retrieve information for. Use either `email`, `id` or `loginName`, but not all.
28
+ : Login name of the user to retrieve information for. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
29
+
30
+ `--userName [userName]`
31
+ : User's UPN (user principal name, eg. megan.bowen@contoso.com). Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
32
+
33
+ `--entraGroupId [entraGroupId]`
34
+ : The object ID of the Microsoft Entra group. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
35
+
36
+ `--entraGroupName [entraGroupName]`
37
+ : The name of the Microsoft Entra group. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
29
38
  ```
30
39
 
31
40
  <Global />
32
41
 
33
42
  ## Examples
34
43
 
35
- Get user by email for a web
44
+ Get user by email for a web.
36
45
 
37
46
  ```sh
38
47
  m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --email john.doe@mytenant.onmicrosoft.com
39
48
  ```
40
49
 
41
- Get user by ID for a web
50
+ Get user by ID for a web.
42
51
 
43
52
  ```sh
44
53
  m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --id 6
45
54
  ```
46
55
 
47
- Get user by login name for a web
56
+ Get user by login name for a web.
48
57
 
49
58
  ```sh
50
59
  m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --loginName "i:0#.f|membership|john.doe@mytenant.onmicrosoft.com"
51
60
  ```
52
61
 
53
- Get the currently logged-in user
62
+ Get user by user's UPN for a web.
63
+
64
+ ```sh
65
+ m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --userName "john.doe@mytenant.onmicrosoft.com"
66
+ ```
67
+
68
+ Get user by entraGroupId for a web.
69
+
70
+ ```sh
71
+ m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --entraGroupId f832a493-de73-4fef-87ed-8c6fffd91be6
72
+ ```
73
+
74
+ Get user by entraGroupName for a web.
75
+
76
+ ```sh
77
+ m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --entraGroupName "Test Members"
78
+ ```
79
+
80
+ Get the currently logged-in user.
54
81
 
55
82
  ```sh
56
83
  m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x
@@ -134,4 +161,3 @@ m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x
134
161
 
135
162
  </TabItem>
136
163
  </Tabs>
137
-