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 パラメーターと共にを指定しないでください。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-City
結果をフィルター処理する市区町村を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Country
結果をフィルター処理する国または地域を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Department
結果をフィルター処理する部署を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-DomainName
結果をフィルター処理するドメインを指定します。 これは、会社の検証済みドメインである必要があります。 このドメインのメール アドレス (プライマリまたはセカンダリ) を持つすべてのユーザーが返されます。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-EnabledFilter
有効または無効なユーザーのフィルターを指定します。 有効な値は、All、EnabledOnly、DisabledOnly です。
| 型: | UserEnabledFilter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-HasErrorsOnly
このコマンドレットは、検証エラーを持つユーザーのみを返します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-LicenseReconciliationNeededOnly
このコマンドレットが、ライセンス調整を必要とするユーザーのみをフィルター処理することを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-MaxResults
このコマンドレットが返す結果の最大数を指定します。 既定値は 500 です。
| 型: | Int32 |
| 配置: | Named |
| 規定値: | 500 |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-ObjectId
取得するユーザーの一意のオブジェクト ID を指定します。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-ReturnDeletedUsers
このコマンドレットは、ごみ箱内のユーザーのみを返します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-SearchString
この文字列で始まる電子メール アドレスまたは表示名に一致する文字列を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-State
ユーザーの状態のフィルターを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Synchronized
このコマンドレットは、Azure Active Directory Sync を介して同期されたユーザーのみを返します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-TenantId
操作を実行するテナントの一意の ID を指定します。 既定値は、現在のユーザーのテナントです。 このパラメーターは、パートナー ユーザーにのみ適用されます。
| 型: | Guid |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | False |
-Title
ユーザーのタイトルのフィルターを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UnlicensedUsersOnly
このコマンドレットでは、ライセンスが割り当てられないユーザーのみが返されることを示します。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UsageLocation
ユーザーがサービスを使用する国または地域のフィルターを指定します。 2 文字の国または地域コードを指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-UserPrincipalName
取得するユーザーのユーザー ID を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | True |
| パイプライン入力を受け取る: | True |
| ワイルドカード文字を受け取る: | 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。 ユーザーにエラーがあるかどうか。