Get-MsolUser
Azure Active Directory からユーザーを取得します。
構文
Get-MsolUser
[-ReturnDeletedUsers]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DomainName <String>]
[-EnabledFilter <UserEnabledFilter>]
[-State <String>]
[-Synchronized]
[-Title <String>]
[-HasErrorsOnly]
[-LicenseReconciliationNeededOnly]
[-UnlicensedUsersOnly]
[-UsageLocation <String>]
[-SearchString <String>]
[-MaxResults <Int32>]
[-TenantId <Guid>]
[<CommonParameters>] Get-MsolUser
-ObjectId <Guid>
[-ReturnDeletedUsers]
[-TenantId <Guid>]
[<CommonParameters>] Get-MsolUser
[-ReturnDeletedUsers]
-UserPrincipalName <String>
[-TenantId <Guid>]
[<CommonParameters>] Get-MsolUser
[-ReturnDeletedUsers]
[-City <String>]
[-Country <String>]
[-Department <String>]
[-DomainName <String>]
[-EnabledFilter <UserEnabledFilter>]
[-State <String>]
[-Synchronized]
[-Title <String>]
[-HasErrorsOnly]
[-LicenseReconciliationNeededOnly]
[-UnlicensedUsersOnly]
[-UsageLocation <String>]
[-SearchString <String>]
[-All]
[-TenantId <Guid>]
[<CommonParameters>] 説明
Get-MsolUser コマンドレットは、個々のユーザーまたはユーザーの一覧を取得します。 ObjectId または UserPrincipalName パラメーターを指定して、特定のユーザーを取得します。
例
例 1: すべてのユーザーを取得する
PS C:\> Get-MsolUserこのコマンドは、社内のすべてのユーザーを取得します。 既定値の 500 件までの結果が表示されます。
例 2: 有効なユーザーを取得する
PS C:\> Get-MsolUser -EnabledFilter EnabledOnly -MaxResults 2000このコマンドは、最大 2,000 人の有効なユーザーを取得します。
例 3: UPN でユーザーを取得する
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.com"このコマンドは、UPN davidchew@contoso.comを使用してユーザーを取得します。
例 4: オブジェクト ID でユーザーを取得する
PS C:\> Get-MsolUser -ObjectId 81701046-cb37-439b-90ce-2afd9630af7dこのコマンドは、指定されたオブジェクト ID を持つユーザーを取得します。
例 5: 検索文字列でユーザーを取得する
PS C:\> Get-MsolUser -SearchString "David"このコマンドは、表示名または電子メール アドレスに David を持つユーザーの一覧を取得します。
例 6: ユーザーの優先データの場所を取得する
PS C:\> Get-MsolUser -UserPrincipalName "davidchew@contoso.onmicrosoft.com" | Select PreferredDataLocationこのコマンドは、ユーザーの優先データの場所を返します。
パラメーター
-All
このコマンドレットによってすべての結果が返されることを示します。 MaxResults パラメーターと共にを指定しないでください。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-City
結果をフィルター処理する市区町村を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Country
結果をフィルター処理する国または地域を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Department
結果をフィルター処理する部署を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DomainName
結果をフィルター処理するドメインを指定します。 これは、会社の検証済みドメインである必要があります。 このドメインのメール アドレス (プライマリまたはセカンダリ) を持つすべてのユーザーが返されます。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EnabledFilter
有効または無効なユーザーのフィルターを指定します。 有効な値は、All、EnabledOnly、DisabledOnly です。
| Type: | UserEnabledFilter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HasErrorsOnly
このコマンドレットは、検証エラーを持つユーザーのみを返します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LicenseReconciliationNeededOnly
このコマンドレットが、ライセンス調整を必要とするユーザーのみをフィルター処理することを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaxResults
このコマンドレットが返す結果の最大数を指定します。 既定値は 500 です。
| Type: | Int32 |
| Position: | Named |
| Default value: | 500 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ObjectId
取得するユーザーの一意のオブジェクト ID を指定します。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ReturnDeletedUsers
このコマンドレットは、ごみ箱内のユーザーのみを返します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SearchString
この文字列で始まる電子メール アドレスまたは表示名に一致する文字列を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-State
ユーザーの状態のフィルターを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Synchronized
このコマンドレットは、Azure Active Directory Sync を介して同期されたユーザーのみを返します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TenantId
操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。
| Type: | Guid |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Title
ユーザーのタイトルのフィルターを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UnlicensedUsersOnly
このコマンドレットでは、ライセンスが割り当てられないユーザーのみが返されることを示します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UsageLocation
ユーザーがサービスを使用する国または地域のフィルターを指定します。 2 文字の国または地域コードを指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-UserPrincipalName
取得するユーザーのユーザー ID を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
出力
Microsoft.Online.Administration.User
このコマンドレットは、次の情報を含むユーザー オブジェクトを返します。
AlternateEmailAddresses。 ユーザーの代替メール アドレス (Azure Active Directory の外部)。
BlockCredential。 ユーザーがサインイン可能かどうかを示します。
City : ユーザーの都市。
国。 ユーザーの国または地域。
部署。 ユーザーの部門。
DisplayName。 ユーザーの表示名。
エラー。 エラーの配列。 これは、サービス ロスが発生する可能性がある検証エラーです。
Fax。 ユーザーの FAX 番号。
Firstname。 ユーザーの名前 (名)。
ImmutableID。 フェデレーション ユーザーにのみ返されます。 これは、Azure Active Directory とフェデレーションするために必要な ID です。
isBlackBerryUser。 ユーザーが Blackberry デバイスを所有しているかどうかを返します。
isLicensed。 ユーザーにライセンスが割り当てられているかどうかを返します。
LastDirSyncTime。 最後のディレクトリ同期の日時 (Active Directory 同期によって Azure Active Directory と同期されたユーザーからのみ返されます)。
LastPasswordChangeTimestamp。 ユーザーのパスワード変更が Azure Active Directory に登録された最新の時刻。
Lastname。 ユーザーの名前 (姓)。
LicenseReconciliationNeeded。 ユーザーが現在、ライセンスなしでメールボックスを所有しているかどうか。 この場合、メールボックスを失わないように、ユーザーには 30 日間のライセンスが付与されます。
ライセンス。 ユーザーのライセンス一覧。
LiveID。 ユーザーの一意のログイン ID。
携帯 電話。 ユーザーの携帯電話番号。
Objectid。 ユーザーの一意の ID。
オフィス。 ユーザーの Office 番号。
OverallProvisioningStatus。 ユーザーにサービスがプロビジョニングされているかどうか。
PasswordNeverExpires。 ユーザーのパスワードを 90 日ごとに強制的に変更するかどうか。
Phonenumber。 ユーザーの電話番号。
Postalcode。 ユーザーの郵便番号。
PreferredDataLocation。 ユーザーが優先するデータの場所。
PreferredLanguage。 ユーザーの優先言語。
Proxyaddresses。 このユーザーに関連付けられているプロキシ アドレス。
State。 ユーザーの州。
StreetAddress。 ユーザーの住所。
StrongPasswordRequired。 パスワードの変更時に強力なパスワードを設定する必要があるかどうか。 強力なパスワードをお勧めします。
タイトル。 ユーザーの肩書き。
UsageLocation。 ユーザーがサービスを使用する国または地域。 これは、2 文字の国または地域コードである必要があります。
UserPrincipalName。 ユーザーのユーザー ID。
ValidationStatus。 ユーザーにエラーがあるかどうか。
関連リンク
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示