Get-CMCollection

  • 參考
模組:
ConfigurationManager

取得裝置或使用者集合物件。

Syntax

Get-CMCollection
   [-CollectionType <CollectionType>]
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroup <IResultObject>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupId <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -DistributionPointGroupName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMCollection
   [-CollectionType <CollectionType>]
   -Id <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

使用此 Cmdlet 取得裝置或使用者集合物件。

集合可協助您將資源組織成可管理的單位。 您可以建立集合以符合用戶端管理需求，以及一次對多個資源執行作業。 大部分的管理工作都依賴或需要使用一或多個集合。

若要界定您取得的集合類型，請使用 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet。

如果您未依名稱、識別碼或物件指定集合，此 Cmdlet 會傳回所有集合。

如需詳細資訊，請參閱 Configuration Manager 中的集合簡介。

注意事項

從Configuration Manager月臺磁片磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請 參閱開始使用。

範例

範例 1：依名稱取得集合

此命令會取得名為 testUser 的集合。

Get-CMCollection -Name "testUser"

範例 2：取得發佈點群組的集合

此命令會取得名為 dpg1 的發佈點群組物件，並使用管線運算子將物件傳遞至 Get-CMCollection，以取得與發佈點群組相關聯的集合。

Get-CMDistributionPointGroup -Name "dpg1" | Get-CMCollection

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

參數

-CollectionType

篩選要取得的集合類型。 此參數的功能與使用 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet 相同。

Type:CollectionType
Accepted values:User, Device
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

此參數會將萬用字元視為常值字元值。 您無法將其與 ForceWildcardHandling結合。

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

-DistributionPointGroup

指定與這個集合相關聯的發佈點群組物件。 若要取得此物件，請使用 Get-CMDistributionPointGroup Cmdlet。

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

-DistributionPointGroupId

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

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

-DistributionPointGroupName

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

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

-ForceWildcardHandling

此參數會處理萬用字元，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling結合。

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

-Id

指定要取得之集合的識別碼。 這個值是 CollectionID 屬性，例如 或 XYZ00012SMS00001 。

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

-Name

指定要取得的集合名稱。

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

IResultObject[]

IResultObject

備註

如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_Collection伺服器 WMI 類別。