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

package/docs/docs/cmd/spo/knowledgehub/knowledgehub-remove.mdx

@@ -25,7 +25,7 @@ m365 spo knowledgehub remove [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/knowledgehub/knowledgehub-set.mdx

@@ -27,7 +27,7 @@ If the specified url doesn't refer to an existing site collection, you will get
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-add.mdx

@@ -32,7 +32,7 @@ m365 spo orgassetslibrary add [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-list.mdx

@@ -20,7 +20,7 @@ m365 spo orgassetslibrary list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/orgassetslibrary/orgassetslibrary-remove.mdx

@@ -28,7 +28,7 @@ m365 spo orgassetslibrary remove [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/orgnewssite/orgnewssite-list.mdx

@@ -20,7 +20,7 @@ m365 spo orgnewssite list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/orgnewssite/orgnewssite-remove.mdx

@@ -26,7 +26,7 @@ m365 spo orgnewssite remove [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/orgnewssite/orgnewssite-set.mdx

@@ -25,7 +25,7 @@ Using the `-u, --url` option you can specify which site to add to the list of or
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/site/site-admin-add.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo site admin add 
+
+Adds a user or group as a site collection administrator
+
+## Usage
+
+```sh
+m365 spo site admin add [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --siteUrl <siteUrl>`
+: The URL of the SharePoint site
+
+`--userId [userId]`
+: The ID of the user to add as a site collection admin
+
+`--userName [userName]`
+: The user principal name of the user to add as a site collection admin
+
+`--groupId [groupId]`
+: The ID of the Microsoft Entra ID group to add as a site collection admin
+
+`--groupName [groupName]`
+: The name of the Microsoft Entra ID group to add as a site collection admin
+
+`--primary`
+: 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
+
+`--asAdmin`
+: If specified, we will use the SharePoint admin center to execute the command
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command with the `--asAdmin` mode, you have to have permissions to access the tenant admin site.
+
+Without this parameter, you have to have site collection admin permissions for the requested site.
+
+:::
+
+## Examples
+
+Add user as primary site collection administrator
+
+```sh
+m365 spo site admin add --siteUrl https://contoso.sharepoint.com --userId 600713c5-53c6-4f24-b454-3c35e22b2639 --primary
+```
+
+Adds group as secondary site collection administrator as SharePoint admin
+
+```sh
+m365 spo site admin add --siteUrl https://contoso.sharepoint.com --groupName SP_Administrators --asAdmin
+```
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-admin-remove.mdx

@@ -0,0 +1,67 @@
+import Global from '/docs/cmd/_global.mdx';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+# spo site admin remove
+
+Removes a user or group as site collection administrator
+
+## Usage
+
+```sh
+m365 spo site admin remove [options]
+```
+
+## Options
+
+```md definition-list
+`-u, --siteUrl <siteUrl>`
+: The URL of the SharePoint site
+
+`--userId [userId]`
+: The ID of the user to remove as a site collection admin
+
+`--userName [userName]`
+: The user principal name of the user to remove as a site collection admin
+
+`--groupId [groupId]`
+: The ID of the Microsoft Entra ID group to remove as a site collection admin
+
+`--groupName [groupName]`
+: The name of the Microsoft Entra ID group to remove as a site collection admin
+
+`--asAdmin`
+: If specified, we will use the SharePoint admin center to execute the command
+
+`-f, --force`
+: Don't prompt for confirmation
+```
+
+<Global />
+
+## Remarks
+
+:::info
+
+To use this command with the `--asAdmin` mode, you have to have permissions to access the tenant admin site.
+
+Without this parameter, you have to have site collection admin permissions for the requested site.
+
+:::
+
+## Examples
+
+Removes user as site collection admin
+
+```sh
+m365 spo site admin remove --siteUrl https://contoso.sharepoint.com --userId 600713c5-53c6-4f24-b454-3c35e22b2639
+```
+
+Removes group as site collection admin without prompting for confirmation as SharePoint Admin
+
+```sh
+m365 spo site admin remove --siteUrl https://contoso.sharepoint.com --groupName SP_Administrators --force --asAdmin
+```
+## Response
+
+The command won't return a response on success.

package/docs/docs/cmd/spo/site/site-appcatalog-add.mdx

@@ -23,7 +23,7 @@ m365 spo site appcatalog add [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/site/site-appcatalog-remove.mdx

@@ -28,7 +28,7 @@ While the command uses the term *'remove'*, like its equivalent PowerShell cmdle
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/site/site-commsite-enable.mdx

@@ -29,7 +29,7 @@ m365 spo site commsite enable [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/site/site-list.mdx

@@ -173,6 +173,7 @@ m365 spo site list --includeOneDriveSites
       "SharingLockDownEnabled": false,
       "ShowPeoplePickerSuggestionsForGuestUsers": false,
       "SiteDefinedSharingCapability": 1,
+      "SiteId": "/Guid(a7c46398-494d-4a8d-b0db-f6e58432eb67)/",
       "SocialBarOnSitePagesDisabled": false,
       "Status": "Active",
       "StorageMaximumLevel": 1048576,
@@ -205,10 +206,10 @@ m365 spo site list --includeOneDriveSites
   <TabItem value="CSV">
 
   ```csv
-  _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
-  Microsoft.Online.SharePoint.TenantAdministration.SiteProperties;"0a05bfa0-c046-6000-c2a5-1da5123cf537|908bed80-a04a-4433-b4a0-883d9847d110:1e852b49-bf4b-4ba5-bcd4-a8c4706c8ed4
-  SiteProperties
-  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
+  _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
+  Microsoft.Online.SharePoint.TenantAdministration.SiteProperties,"7f934fa1-20ab-9000-f15c-df8f2970f555|908bed80-a04a-4433-b4a0-883d9847d110:18c58817-3bc9-489d-ac63-f7264fb357e5
+SiteProperties
+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
   ```
 
   </TabItem>
@@ -291,6 +292,7 @@ m365 spo site list --includeOneDriveSites
   SharingLockDownEnabled | false
   ShowPeoplePickerSuggestionsForGuestUsers | false
   SiteDefinedSharingCapability | 0
+  SiteId | /Guid(a7c46398-494d-4a8d-b0db-f6e58432eb67)/,
   SocialBarOnSitePagesDisabled | false
   Status | Active
   StorageMaximumLevel | 0

package/docs/docs/cmd/spo/site/site-set.mdx

@@ -103,7 +103,7 @@ Setting site properties is by default asynchronous and depending on the current
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/sitescript/sitescript-get.mdx

@@ -51,7 +51,20 @@ m365 spo sitescript get --id 2c1ba4c4-cd9b-4417-832f-92a34bc34b2a --content
 
   ```json
   {
-    "Content": "{\"$schema\":\"https://developer.microsoft.com/json-schemas/sp/site-design-script-actions.schema.json\",\"actions\":[{\"verb\":\"activateSPFeature\",\"name\":\"SiteNotebook feature\",\"title\":\"SiteNotebook feature\",\"featureId\":\"f151bb39-7c3b-414f-bb36-6bf18872052f\",\"scope\":\"web\"}],\"bindata\":{},\"version\":1}",
+    "Content": { 
+      "$schema": "https://developer.microsoft.com/json-schemas/sp/site-design-script-actions.schema.json",
+      "actions": [ 
+        {
+          "verb":"activateSPFeature",
+          "name": "SiteNotebook feature", 
+          "title": "SiteNotebook feature",
+          "featureId": "f151bb39-7c3b-414f-bb36-6bf18872052f", 
+          "scope": "web"
+        }
+      ], 
+      "bindata":{},
+      "version":1
+    },
     "ContentByteArray": null,
     "Description": "Contoso site script",
     "Id": "43d4ffa0-c7ee-4a97-91d7-db27e5b62de5",

package/docs/docs/cmd/spo/storageentity/storageentity-remove.mdx

@@ -31,7 +31,7 @@ Tenant properties are stored in the app catalog site associated with that tenant
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/storageentity/storageentity-set.mdx

@@ -39,7 +39,7 @@ If you specify the URL of a site different than the app catalog, you will get an
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/tenant/tenant-appcatalog-add.mdx

@@ -41,7 +41,7 @@ Creating an app catalog site might take a while. If you need to wait for the sit
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/tenant/tenant-appcatalogurl-get.mdx

@@ -20,7 +20,7 @@ m365 spo tenant appcatalogurl get [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-list.mdx

@@ -20,7 +20,7 @@ m365 spo tenant recyclebinitem list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/tenant/tenant-recyclebinitem-remove.mdx

@@ -31,7 +31,7 @@ Removing a site collection is by default asynchronous and depending on the curre
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/tenant/tenant-settings-list.mdx

@@ -20,7 +20,7 @@ m365 spo tenant settings list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/theme/theme-apply.mdx

@@ -33,7 +33,7 @@ Following standard SharePoint themes are supported by the CLI for Microsoft 365:
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/theme/theme-get.mdx

@@ -25,7 +25,7 @@ m365 spo theme get [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/theme/theme-list.mdx

@@ -20,7 +20,7 @@ m365 spo theme list [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/theme/theme-remove.mdx

@@ -26,7 +26,7 @@ m365 spo theme remove [options]
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
 

package/docs/docs/cmd/spo/theme/theme-set.mdx

@@ -67,7 +67,7 @@ If any of these checks fails you are presented with a `The specified theme is no
 
 :::info
 
-To use this command you have to have permissions to access the tenant admin site.
+To use this command you must be either **SharePoint Administrator** or **Global Administrator**.
 
 :::
     

package/docs/docs/cmd/spo/user/user-get.mdx

@@ -16,41 +16,68 @@ m365 spo user get [options]
 
 ```md definition-list
 `-u, --webUrl <webUrl>`
-: URL of the web to get the user within
+: URL of the web to get the user within.
 
 `-i, --id [id]`
-: ID of the user to retrieve information for. Use either `email`, `id` or `loginName`, but not all.
+: ID of the user to retrieve information for. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
 
 `--email [email]`
-: Email of the user to retrieve information for. Use either `email`, `id` or `loginName`, but not all.
+: Email of the user to retrieve information for. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
 
 `--loginName [loginName]`
-: Login name of the user to retrieve information for. Use either `email`, `id` or `loginName`, but not all.
+: Login name of the user to retrieve information for. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
+
+`--userName [userName]`
+: User's UPN (user principal name, eg. megan.bowen@contoso.com). Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
+
+`--entraGroupId [entraGroupId]`
+: The object ID of the Microsoft Entra group. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
+
+`--entraGroupName [entraGroupName]`
+: The name of the Microsoft Entra group. Specify either `id`, `loginName`, `email`, `userName`, `entraGroupId`, or `entraGroupName`.
 ```
 
 <Global />
 
 ## Examples
 
-Get user by email for a web
+Get user by email for a web.
 
 ```sh
 m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --email john.doe@mytenant.onmicrosoft.com
 ```
 
-Get user by ID for a web
+Get user by ID for a web.
 
 ```sh
 m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --id 6
 ```
 
-Get user by login name for a web
+Get user by login name for a web.
 
 ```sh
 m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --loginName "i:0#.f|membership|john.doe@mytenant.onmicrosoft.com"
 ```
 
-Get the currently logged-in user
+Get user by user's UPN for a web.
+
+```sh
+m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --userName "john.doe@mytenant.onmicrosoft.com"
+```
+
+Get user by entraGroupId for a web.
+
+```sh
+m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --entraGroupId f832a493-de73-4fef-87ed-8c6fffd91be6
+```
+
+Get user by entraGroupName for a web.
+
+```sh
+m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --entraGroupName "Test Members"
+```
+
+Get the currently logged-in user.
 
 ```sh
 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
 
   </TabItem>
 </Tabs>
-