Get-CMCollectionMember

  • リファレンス
モジュール:
ConfigurationManager

デバイスまたはユーザー コレクションのメンバーを取得します。

構文

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