Get-CMDeviceCollection

1 つ以上のデバイス コレクションを取得します。

構文

Get-CMDeviceCollection
   [-Name <String>]
   [<CommonParameters>]
Get-CMDeviceCollection
   -Id <String>
   [<CommonParameters>]
Get-CMDeviceCollection
   -DistributionPointGroupName <String>
   [<CommonParameters>]
Get-CMDeviceCollection
   -DistributionPointGroupId <String>
   [<CommonParameters>]
Get-CMDeviceCollection
   -DistributionPointGroup <IResultObject>
   [<CommonParameters>]

説明

このコマンドレットを使用して、1 つ以上のデバイス コレクションを取得します。 ユーザーコレクションまたはデバイス コレクションを取得するには、 Get-CMCollection コマンドレットを使用します。 コレクションの詳細については、「 Configuration Manager でのコレクションの概要」を参照してください。

注:

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

例 1: ID を使用してデバイス コレクションを取得する

このコマンドは、ID SMS00001を持つ既定のデバイス コレクション [すべてのシステム] を取得します。

Get-CMDeviceCollection -CollectionId "SM00001"

例 2: 配布ポイント グループに関連付けられているすべてのデバイス コレクションを取得する

この例では、 dpg1 という配布ポイント グループに関連付けられているすべてのデバイス コレクションを取得します。

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

これらのコレクションにコンテンツを配布すると、サイトはこの配布ポイント グループのすべての現在のメンバーに自動的に配布されます。 詳細については、「 配布ポイント グループの管理」を参照してください。

パラメーター

-DistributionPointGroup

このコレクションに関連付けられている配布ポイント グループ オブジェクトを指定します。 このオブジェクトを取得するには、 Get-CMDistributionPointGroup コマンドレットを 使用します。

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

-DistributionPointGroupId

このコレクションに関連付けられている配布ポイント グループの GUID を指定します。 この値は GroupID プロパティで、 {537e6303-69eb-4104-bf7b-7baf43ce2352}など、中かっこで囲まれた標準の GUID です。

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

-DistributionPointGroupName

このコレクションに関連付けられている配布ポイント グループの名前を指定します。

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

-Id

取得するデバイス コレクションの ID を指定します。 この値は CollectionID プロパティです (たとえば、 XYZ00012SMS00001)。

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

-Name

取得するデバイス コレクションの名前を指定します。

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

入力

None

出力

System.Object

メモ

この戻りオブジェクトとそのプロパティの詳細については、「 サーバー WMI クラスSMS_Collection」を参照してください。