次の方法で共有

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>]

説明

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 で始まるすべてのユーザー (Sales Manager、Sales Assistant など) を取得します。

パラメーター

-All

true の場合は、すべてのユーザーを返します。 false の場合は、Top パラメーターで指定されたオブジェクトの数を返します。

型:Boolean
配置: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
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-ObjectId

Microsoft Entra ID のユーザーの ID (UPN または ObjectId) を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-SearchString

検索文字列を指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Top

返すレコードの最大数を指定します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

メモ

Get-AzureADUser の Microsoft Graph PowerShell への移行ガイドを参照してください。