Get-CMCollection
取得裝置或使用者集合物件。
語法
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 相同。
| 類型: | CollectionType |
| 接受的值: | User, Device |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DisableWildcardHandling
此參數會將通配符視為常值字元值。 您無法將其與 ForceWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DistributionPointGroup
指定與這個集合相關聯的發佈點群組物件。 若要取得此物件，請使用 Get-CMDistributionPointGroup Cmdlet。
| 類型: | IResultObject |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-DistributionPointGroupId
指定與這個集合相關聯之發佈點群組的 GUID。 這個值是 GroupID 屬性，這是以大括弧括住的標準 GUID，例如 。 {537e6303-69eb-4104-bf7b-7baf43ce2352}
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DistributionPointGroupName
指定與這個集合相關聯之發佈點群組的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ForceWildcardHandling
此參數會處理通配符，並可能導致非預期的行為 (不建議) 。 您無法將其與 DisableWildcardHandling 結合。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Id
指定要取得之集合的識別碼。 這個值是 CollectionID 屬性，例如 或 XYZ00012SMS00001。
| 類型: | String |
| 別名: | CollectionId |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
指定要取得的集合名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | True |
輸入
Microsoft.ConfigurationManagement.ManagementProvider.IResultObject
輸出
IResultObject[]
IResultObject
備註
如需此傳回物件及其屬性的詳細資訊，請 參閱SMS_Collection伺服器 WMI 類別。