Skip to content

spo user get

Gets a site user within specific web

Usage

m365 spo user get [options]

Options

-u, --webUrl <webUrl>
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.
--email [email]
Email of the user to retrieve information for. Use either email, id or loginName, but not all.
--loginName [loginName]
Login name of the user to retrieve information for. Use either email, id or loginName, but not all.
-h, --help [help]
Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is full.
--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples
-o, --output [output]
Output type. json,text,csv,md. Default json
--verbose
Runs command with verbose logging
--debug
Runs command with debug logging

Examples

Get user with email john.doe@mytenant.onmicrosoft.com for web https://contoso.sharepoint.com/sites/project-x

m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --email john.doe@mytenant.onmicrosoft.com

Get user with ID 6 for web https://contoso.sharepoint.com/sites/project-x

m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --id 6

Get user with login name 'i:0#.f|membership|john.doe@mytenant.onmicrosoft.com' for web https://contoso.sharepoint.com/sites/project-x

m365 spo user get --webUrl https://contoso.sharepoint.com/sites/project-x --loginName "i:0#.f|membership|john.doe@mytenant.onmicrosoft.com"

Response

{
  "Id": 10,
  "IsHiddenInUI": false,
  "LoginName": "i:0#.f|membership|johndoe@contoso.onmicrosoft.com",
  "Title": "John Doe",
  "PrincipalType": 1,
  "Email": "johndoe@contoso.onmicrosoft.com",
  "Expiration": "",
  "IsEmailAuthenticationGuestUser": false,
  "IsShareByEmailGuestUser": false,
  "IsSiteAdmin": false,
  "UserId": {
    "NameId": "100320022ec308a7",
    "NameIdIssuer": "urn:federation:microsoftonline"
  },
  "UserPrincipalName": "johndoe@contoso.onmicrosoft.com"
}

Email                         : johndoe@contoso.onmicrosoft.com
Expiration                    :
Id                            : 10
IsEmailAuthenticationGuestUser: false
IsHiddenInUI                  : false
IsShareByEmailGuestUser       : false
IsSiteAdmin                   : false
LoginName                     : i:0#.f|membership|johndoe@contoso.onmicrosoft.com
PrincipalType                 : 1
Title                         : John Doe
UserId                        : {"NameId":"100320022ec308a7","NameIdIssuer":"urn:federation:microsoftonline"}
UserPrincipalName             : johndoe@contoso.onmicrosoft.com

Id,IsHiddenInUI,LoginName,Title,PrincipalType,Email,Expiration,IsEmailAuthenticationGuestUser,IsShareByEmailGuestUser,IsSiteAdmin,UserId,UserPrincipalName
10,,i:0#.f|membership|johndoe@contoso.onmicrosoft.com,John Doe,1,johndoe@contoso.onmicrosoft.com,,,,,"{""NameId"":""100320022ec308a7"",""NameIdIssuer"":""urn:federation:microsoftonline""}",johndoe@contoso.onmicrosoft.com