New-CMCollection
建立裝置或使用者集合。
Syntax
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionName <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-InputObject <IResultObject>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
New-CMCollection
-CollectionType <CollectionType>
[-Comment <String>]
-LimitingCollectionId <String>
-Name <String>
[-RefreshSchedule <IResultObject>]
[-RefreshType <CollectionRefreshType>]
[-VariablePriority <Int32>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
使用此 Cmdlet 來建立裝置或使用者集合。
限制集合會決定哪些資源可以是您所建立之集合的成員。 例如,當您使用 [ 全部系統 集合] 做為限制集合時,新裝置集合可以包含 Configuration Manager 階層中的任何裝置。
若要限定您建立的集合類型,您也可以使用 CMDeviceCollection 或 新的 CMUserCollection Cmdlet。
建立集合之後,將資源新增至具有成員資格規則的集合。 若要將成員新增至集合,請使用其中一個 Cmdlet 來新增成員資格規則,例如:
如需詳細資訊,請參閱 如何在 Configuration Manager 中建立集合。
注意
從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\>
。 如需詳細資訊,請參閱 快速入門。
範例
範例1:建立使用者集合
這個命令會建立名為 testUser 的使用者集合,此集合會將 所有 Users 集合設定為限制集合。
New-CMCollection -CollectionType User -LimitingCollectionName "All Users" -Name "testUser"
範例2:設定透過管線的限制集合
此命令會先使用 CMCollection 取得 [ 所有使用者 ] 集合物件。 然後,它會使用管線運算子將物件傳遞至 CMCollection Cmdlet,該指令 程式 會建立名為 testUser的集合。 新 testUser 集合的限制集合是 [ 所有使用者 ] 集合。
Get-CMCollection -Name "All Users" | New-CMCollection -Name "testUser" -CollectionType "User"
參數
-CollectionType
指定要建立的集合類型。 此參數的功能與使用 CMDeviceCollection 或 CMUserCollection Cmdlet 相同。
Type: | CollectionType |
Accepted values: | User, Device |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-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 |
-DisableWildcardHandling
此參數會將萬用字元視為常值字元值。 您無法將它與 ForceWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceWildcardHandling
這個參數會處理萬用字元,而且可能會造成未預期的行為 (不建議) 。 您無法將它與 DisableWildcardHandling合併。
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
指定限制集合的物件。 若要取得此物件,請使用 CMCollection、 CMDeviceCollection或 CMUserCollection Cmdlet。
Type: | IResultObject |
Aliases: | LimitingCollection |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LimitingCollectionId
指定限制集合的識別碼。 例如,此值為 CollectionID 屬性 XYZ00012
SMS00001
。
Type: | String |
Aliases: | LimitToCollectionId |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LimitingCollectionName
指定限制集合的名稱。
Type: | String |
Aliases: | LimitToCollectionName |
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 |
-VariablePriority
指定從1-9 的整數值,以用於裝置集合變數的優先順序。 1
是最低優先順序, 9
最高優先順序。
若要在裝置集合上建立變數,請使用 CMDeviceCollectionVariable Cmdlet。
Type: | Int32 |
Aliases: | DeviceCollectionVariablePrecedence |
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
輸出
IResultObject
備註
如需此 return 物件及其屬性的詳細資訊,請參閱 SMS_Collection SERVER WMI 類別。