Get-AzureADUser
取得使用者。
Syntax
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 會取得符合 SearchString 值與 DisplayName 或 UserPrincipalName 中第一個字元的所有使用者。
範例 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 參數所指定的物件數目
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Filter
指定 OData v3.0 filter 語句。 此參數可控制要傳回的物件。 如需使用 OData 查詢的詳細資料,請參閱這裡。 http://www.odata.org/documentation/odata-version-3-0/odata-version-3-0-core-protocol/#queryingcollections. 目前不支援所有 OData v3.0 函式和運算子。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ObjectId
指定識別碼 (為MICROSOFT ENTRA識別碼中使用者的 UPN 或 ObjectId) 。
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SearchString
指定搜尋字串。
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Top
指定要傳回的記錄數目上限。
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
備註
請參閱 將 Get-AzureADUser 移轉至 Microsoft Graph PowerShell 的移轉指南。
相關連結
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應