New-CMDeviceCollection
建立裝置集合。
Syntax
New-CMDeviceCollection
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollection
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-CMDeviceCollection
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
使用此 Cmdlet 根據特定的限制集合，建立裝置集合。 限制集合會決定哪些裝置可以是您建立之裝置集合的成員。 例如，當您使用 [ 所有系統 集合] 做為限制集合時，新集合可以包含 Configuration Manager 階層中的任何裝置。
然後您就可以使用成員資格規則，將裝置新增至集合。 若要將成員新增至裝置集合，請使用下列成員資格規則 Cmdlet 之一：
- 載入 CMDeviceCollectionDirectMembershipRule
- 載入 CMDeviceCollectionExcludeMembershipRule
- 載入 CMDeviceCollectionIncludeMembershipRule
- 載入 CMDeviceCollectionQueryMembershipRule
如需詳細資訊，請參閱 如何在 Configuration Manager 中建立集合。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet，例如 PS XYZ:\> 。 如需詳細資訊，請參閱 快速入門。
範例
範例1：建立裝置集合
這個命令會建立所有執行Windows 11的電腦的集合。 LimitingCollectionName參數會指定 [ All Systems ] 集合中的任何裝置都可以是新集合的成員。
New-CMDeviceCollection -Name "Windows 11" -LimitingCollectionName "All Systems"參數
-Comment
指定選用的批註以描述及識別此集合。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
執行 Cmdlet 之前提示您確認。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
指定限制集合的物件。 若要取得此物件，請使用 CMCollection 或 CMDeviceCollection Cmdlet。
| Type: | IResultObject |
| Aliases: | LimitingCollection |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-LimitingCollectionId
指定限制集合的識別碼。 例如，此值為 CollectionID 屬性 XYZ00012 SMS00001 。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-LimitingCollectionName
指定限制集合的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RefreshSchedule
如果您將 RefreshType 參數設定為 [ Periodic 或] Both ，請使用此參數來設定排程。 指定當網站執行集合成員資格的完整更新時的排程物件。 若要取得此物件，請使用 CMSchedule Cmdlet。
| Type: | IResultObject |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RefreshType
指定集合成員資格的更新方式：
Manual(1) ：系統管理員會在 Configuration Manager 主控台中或搭配 CMCollectionUpdate Cmdlet 手動觸發成員資格更新。Periodic(2) ：網站定期執行完整更新。 它不使用增量更新。 如果您未指定類型，此值為預設值。Continuous(4) ：網站定期評估新的資源，然後新增新的成員。 這種類型也稱為「 增量更新」。 它不會對排程執行完整更新。Both(6) ：兩者的組合Periodic，以及Continuous增量更新及排程的完整更新。
如果您指定 Periodic or Both ，請使用 RefreshSchedule 參數來設定排程。
注意
None (0) 的值的功能相同 Manual 。
| Type: | CollectionRefreshType |
| Accepted values: | None, Manual, Periodic, Continuous, Both |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
顯示執行 Cmdlet 時會發生什麼情況。 不會執行 Cmdlet。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-名稱
指定新裝置集合的名稱。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
輸入
ConfigurationManagement IResultObject
輸出
系統.物件