Get-AzureADUser
ユーザーを取得します。
構文
Get-AzureADUser
[-All <Boolean>]
[-Top <Int32>]
[-Filter <String>]
[<CommonParameters>]
Get-AzureADUser
[-SearchString <String>]
[-All <Boolean>]
[<CommonParameters>]
Get-AzureADUser
-ObjectId <String>
[-All <Boolean>]
[<CommonParameters>]
説明
Get-AzureADUser コマンドレットは、Microsoft Entra ID からユーザーを取得します。
例
例 1: 上位 10 人のユーザーを取得する
PS C:\>Get-AzureADUser -Top 10
このコマンドは、10 人のユーザーを取得します。
例 2: ID でユーザーを取得する
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
このコマンドレットは、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 フィルター ステートメントを指定します。 このパラメーターは、返されるオブジェクトを制御します。 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
ユーザーの ID (UPN または ObjectId) を Microsoft Entra ID で指定します。
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 |
メモ
Microsoft Graph PowerShell への Get-AzureADUser の移行ガイド を参照してください。
関連リンク
フィードバック
https://aka.ms/ContentUserFeedback。
近日公開予定: 2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub イシューを段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、以下を参照してください:フィードバックの送信と表示