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 のコレクションの概要」を参照してください。

注:

PS XYZ:\>など、Configuration Manager サイト ドライブから Configuration Manager コマンドレットを実行します。 詳細については、「作業の 開始」を参照してください。

例

例 1: パイプライン演算子を使用してコレクションのメンバーを取得する

このコマンドでは、まず Get-CMCollection コマンドレットを使用して 、UserCol1 という名前のコレクション オブジェクトを取得します。 次に、パイプライン演算子を使用して Get-CMCollectionMember にオブジェクトを渡します。このオブジェクトは、コレクション内のすべてのメンバーを取得します。 最後に、この例では Select-Object コマンドレットを使用してメンバー名のみを表示します。

Get-CMCollection -Name "UserCol1" | Get-CMCollectionMember | Select-Object Name

例 2: 名前でコレクションのメンバーを取得する

このコマンドは、domainで始まる名前を持つメンバーについて、コレクション DeviceCol1 に対してクエリを実行します。 アスタリスク (*) ワイルドカードは、複数の文字と一致します。 そのため、結果には "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" 」のように入力します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-CollectionName

クエリを実行するコレクションの名前を指定します。

型:String
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DisableWildcardHandling

このパラメーターは、ワイルドカード文字をリテラル文字の値として扱います。 ForceWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-ForceWildcardHandling

このパラメーターはワイルドカード文字を処理し、予期しない動作が発生する可能性があります (推奨されません)。 DisableWildcardHandling と組み合わせることはできません。

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-InputObject

クエリを実行するコレクション オブジェクトを指定します。 コレクション オブジェクトを取得するには、次のいずれかのコマンドレットを使用します。

パイプライン演算子 (|) を使用して、コマンド ラインの Get-CMCollectionMemeber にコレクション オブジェクトを渡すこともできます。

型:IResultObject
Aliases:Collection
配置:Named
規定値:None
必須:True
パイプライン入力を受け取る:True
ワイルドカード文字を受け取る:False

-Name

結果をフィルター処理するには、コレクション内のリソースの名前を指定します。 このフィルターでは、大文字と小文字は区別されません。

ワイルドカード文字を使用できます。

  • *: 複数の文字
  • ?: 1 文字
型:String
Aliases:ResourceName
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

-ResourceId

結果をフィルター処理するには、リソース ID を指定します。 たとえば、「 16777242 」のように入力します。 コマンドレットは、ターゲット コレクション内のそのリソースのレコードのみを返します。

型:Int32
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-SmsId

結果をフィルター処理するには、リソースの SMSID を指定します。 たとえば、「 "GUID:7a186367-7372-4841-889e-ba2e3aad1e85" 」のように入力します。 このフィルターでは、大文字と小文字は区別されません。

ワイルドカード文字を使用できます。

  • *: 複数の文字
  • ?: 1 文字
型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:True

入力

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

出力

System.Object