Get-CMUser
Configuration Manager ユーザーを取得します。
構文
ByName (既定)
Get-CMUser
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
SearchByIdMandatory
Get-CMUser
-CollectionId <String>
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
SearchByNameMandatory
Get-CMUser
-CollectionName <String>
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
SearchByValueMandatory
Get-CMUser
-InputObject <IResultObject>
[-Name <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
ById
Get-CMUser
-ResourceId <Int32>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>]
説明
Get-CMUser コマンドレットは、Configuration Managerユーザー オブジェクトを取得します。 既定では、All Users コレクションに対してクエリ を実行 します。
CollectionID パラメーターまたは CollectionName パラメーターを使用して、クエリ対象のコレクションを変更できます。 サイトでのロールベースのアクセスに応じて、これらの他のパラメーターのいずれかを使用する必要がある場合があります。 たとえば、SMS00002 (すべてのユーザー コレクション) にアクセスできない場合、既定では、このコマンドレットは 0 個の結果を返します。
注:
PS XYZ:\>など、Configuration Manager サイト ドライブからConfiguration Managerコマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。
例
例 1: ユーザーを名前で取得する
PS XYZ:\> Get-CMUser -CollectionName "All Users" -Name "Contoso\username01"
このコマンドは、すべてのユーザー コレクションから username01 という名前のユーザーを取得します。
例 2: コレクションを渡し、そこからユーザーを取得する
PS XYZ:\> Get-CMCollection -Name "All Users" | Get-CMUser -Name "Contoso\testuser01"
このコマンドは、All Users という名前のコレクション オブジェクトを取得し、パイプライン演算子を使用して オブジェクトを Get-CMUser に渡します。このオブジェクトは、コレクション オブジェクトから testuser01 という名前のユーザーを取得します。
パラメーター
-CollectionId
ユーザー コレクションの ID を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SearchByIdMandatory
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-CollectionName
ユーザー コレクションの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
SearchByNameMandatory
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。
ForceWildcardHandling と組み合わせることはできません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。
DisableWildcardHandling と組み合わせることはできません。
パラメーターのプロパティ
| 型: | SwitchParameter
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
コレクション オブジェクトを指定します。
コレクション オブジェクトを取得するには、 Get-CMCollection コマンドレットを使用します。
| 型: | IResultObject
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | コレクション |
SearchByValueMandatory
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
ユーザーの名前を指定します。
パラメーターのプロパティ
| 型: | String
|
| 規定値: | None |
| ワイルドカードのサポート: | True |
| DontShow: | False |
パラメーター セット
ByName
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
SearchByIdMandatory
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
SearchByNameMandatory
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
SearchByValueMandatory
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ResourceId
ユーザーのリソース ID を指定します。
パラメーターのプロパティ
| 型: | Int32
|
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ID, UserId |
パラメーター セット
ById
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
IResultObject
IResultObject