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