Get-CMCollectionMember
デバイスまたはユーザー コレクションのメンバーを取得します。
構文
Get-CMCollectionMember
-CollectionName <String>
[-Name <String>]
[-ResourceId <Int32>]
[-SmsId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMCollectionMember
-CollectionId <String>
[-Name <String>]
[-ResourceId <Int32>]
[-SmsId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] Get-CMCollectionMember
-InputObject <IResultObject>
[-Name <String>]
[-ResourceId <Int32>]
[-SmsId <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[<CommonParameters>] 説明
このコマンドレットを使用して、コレクションのメンバーを取得します。 コレクションにはデバイスまたはユーザーを含め、両方は含めできません。 コレクションをクエリすると、このコマンドレットは、すべてのメンバーのオブジェクトを返します。
詳細については 、「Configuration Manager のコレクションの概要」を参照してください。
注意
Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します PS XYZ:\> 。 詳細については 、「Getting started」を参照してください。
例
例 1: パイプライン 演算子を使用してコレクションのメンバーを取得する
このコマンドは、 まず Get-CMCollection コマンドレットを使用して UserCol1という名前のコレクション オブジェクトを取得します。 次に、パイプライン 演算子を使用してオブジェクトを Get-CMCollectionMemberに渡し、コレクション内のすべてのメンバーを取得します。 最後に、この例では Select-Object コマンドレットを使用してメンバー名のみを表示します。
Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name例 2: コレクションのメンバーを名前で取得する
このコマンドは、コレクション DeviceCol1 で始まる名前を持つメンバーを照会します domain 。 アスタリスク ( * ) ワイルドカードは、複数の文字と一致します。 そのため、結果には "domain1" や "domain-controller" などの名前を含めることができます。
Get-CMCollectionMember -CollectionName "DeviceCol1" -Name "domain*"例 3: コレクションの詳細を CSV にエクスポートする
この例では 、XYZ0004Bデバイス コレクションに一連のプロパティを照会し、そのプロパティを変数に格納 $collMem。 2 行目は、そのデータをコンマ区切り値 (CSV) 形式に変換し、ファイルに出力します。
$collMem = Get-CMCollectionMember -CollectionId "XYZ0004B" | Select-Object Name,Domain,LastLogonUser,DeviceOS,DeviceOSBuild,MACAddress,SerialNumber
$collMem | ConvertTo-Csv -NoTypeInformation | Out-File -FilePath "C:\output\XYZ0004B.csv"パラメーター
-CollectionId
クエリを実行するコレクションの ID を指定します。 たとえば、「 "XYZ0004B" 」のように入力します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CollectionName
クエリするコレクションの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DisableWildcardHandling
このパラメーターは、ワイルドカード文字をリテラル文字値として扱います。 ForceWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ForceWildcardHandling
このパラメーターはワイルドカード文字を処理し、予期しない動作を引き起こします (推奨されません)。 DisableWildcardHandling と組み合わせは使用できない。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
クエリするコレクション オブジェクトを指定します。 コレクション オブジェクトを取得するには、次のいずれかのコマンドレットを使用します。
パイプライン演算子 ( ) を使用して、コレクション オブジェクトをコマンド ラインの | Get-CMCollectionMemeber に渡することもできます。
| Type: | IResultObject |
| Aliases: | Collection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
結果をフィルター処理するには、コレクション内のリソースの名前を指定します。 このフィルターでは大文字と小文字が区別されません。
ワイルドカード文字を使用できます。
*: 複数の文字?: 1 文字
| Type: | String |
| Aliases: | ResourceName |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
-ResourceId
結果をフィルター処理するには、リソース ID を指定します。 たとえば、「 16777242 」のように入力します。 コマンドレットは、対象となるコレクション内のリソースのレコードのみを返します。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SmsId
結果をフィルター処理するには、リソースの SMSID を指定します。 たとえば、「 "GUID:7a186367-7372-4841-889e-ba2e3aad1e85" 」のように入力します。 このフィルターでは大文字と小文字が区別されません。
ワイルドカード文字を使用できます。
*: 複数の文字?: 1 文字
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | True |
入力
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
出力
System.Object