共用方式為

Get-AzureADUser

  • 參考
模組:
AzureAD

取得使用者。

語法

Get-AzureADUser
   [-All <Boolean>]
   [-Top <Int32>]
   [-Filter <String>]
   [<CommonParameters>]
Get-AzureADUser
   [-SearchString <String>]
   [-All <Boolean>]
   [<CommonParameters>]
Get-AzureADUser
   -ObjectId <String>
   [-All <Boolean>]
   [<CommonParameters>]

Description

Get-AzureADUser Cmdlet 會從 Microsoft Entra 識別碼取得使用者。

範例

範例 1：取得前十位使用者

PS C:\>Get-AzureADUser -Top 10

此命令會取得10位使用者。

範例 2：依標識碼取得使用者

PS C:\>Get-AzureADUser -ObjectId "testUpn@tenant.com"

此命令會取得指定的使用者。

範例 3：在擷取的用戶之間搜尋

PS C:\> Get-AzureADUser -SearchString "New"

ObjectId                             DisplayName UserPrincipalName                   UserType
--------                             ----------- -----------------                   --------
5e8b0f4d-2cd4-4e17-9467-b0f6a5c0c4d0 New user    NewUser@contoso.onmicrosoft.com     Member
2b450b8e-1db6-42cb-a545-1b05eb8a358b New user    NewTestUser@contoso.onmicrosoft.com Member

此 Cmdlet 會取得符合 DisplayName 或 UserPrincipalName 中第一個字元之 SearchString 值的所有使用者。

範例 4：依 userPrincipalName 取得使用者

PS C:\>Get-AzureADUser -Filter "userPrincipalName eq 'jondoe@contoso.com'"

此命令會取得指定的使用者。

範例 5：依 JobTitle 取得使用者

PS C:\>Get-AzureADUser -Filter "startswith(JobTitle,'Sales')"

此命令會取得職稱開頭為銷售的所有使用者，例如 Sales Manager 和 Sales Assistant。

參數

-All

如果為 true，則傳回所有使用者。 如果為 false，則傳回 Top 參數所指定的物件數目

類型:Boolean
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Filter

指定 OData v3.0 篩選語句。 此參數可控制傳回的物件。 如需使用 OData 進行查詢的詳細數據，請參閱這裡。 http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. 目前不支援所有 OData v3.0 函式和運算符。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-ObjectId

指定標識碼 (為 Microsoft Entra ID 中使用者的 UPN 或 ObjectId) 。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-SearchString

指定搜尋字串。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

-Top

指定要傳回的記錄數目上限。

類型:Int32
Position:Named
預設值:None
必要:False
接受管線輸入:True
接受萬用字元:False

備註

請參閱 將 Get-AzureADUser 移轉至 Microsoft Graph PowerShell 的移轉指南。