次の方法で共有


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

-InputObject

コレクション オブジェクトを指定します。 コレクション オブジェクトを取得するには、 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