Get-CMDeviceCollection

取得一或多個裝置集合。

Syntax

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>]

Description

使用此 Cmdlet 可取得一或多個裝置集合。 若要取得使用者或裝置集合,請使用 CMCollection Cmdlet。 如需有關集合的詳細資訊,請參閱 Configuration Manager 中的集合簡介

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:使用識別碼取得裝置集合

這個命令會取得預設的裝置集合,所有識別碼為SMS00001系統

Get-CMDeviceCollection -CollectionId "SM00001"

範例2:取得與發佈點群組相關聯的所有裝置集合

此範例會取得與名為 dpg1之發佈點群組相關聯的所有裝置集合。

Get-CMDeviceCollection -DistributionPointGroupName "dpg1"

當您將內容散佈至這些集合時,網站會自動將此通訊組的所有目前成員散佈至此群組。 如需詳細資訊,請參閱 管理發佈點群組

參數

-DistributionPointGroup

指定與此集合關聯的發佈點群組物件。 若要取得此物件,請使用 CMDistributionPointGroup Cmdlet。

Type:IResultObject
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroupId

指定與此集合關聯之發佈點群組的 GUID。 這個值是 GroupID 屬性,也就是以大括弧括住的標準 GUID,例如 {537e6303-69eb-4104-bf7b-7baf43ce2352}

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DistributionPointGroupName

指定與此集合相關聯之發佈點群組的名稱。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-名稱

指定要取得之裝置集合的名稱。

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:True

-識別碼

指定要取得之裝置集合的識別碼。 例如,此值為 CollectionID 屬性 XYZ00012 SMS00001

Type:String
Aliases:CollectionId
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

輸入

輸出

系統.物件

備註

如需此 return 物件及其屬性的詳細資訊,請參閱 SMS_Collection SERVER WMI 類別