共用方式為

Set-CMCollection

  • 參考
模組:
ConfigurationManager

設定裝置或使用者集合。

語法

Set-CMCollection
   [-Comment <String>]
   -InputObject <IResultObject>
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   -CollectionId <String>
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMCollection
   [-Comment <String>]
   [-LimitingCollection <IResultObject>]
   [-LimitingCollectionId <String>]
   [-LimitingCollectionName <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-RefreshSchedule <IResultObject>]
   [-RefreshType <CollectionRefreshType>]
   [-VariablePriority <Int32>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 來設定裝置或使用者集合。

限制集合會決定哪些資源可以是集合的成員。 例如，當您使用 All Systems 集合做為限制集合時，新的集合可以在 Configuration Manager 階層中包含任何裝置。

使用成員資格規則將資源新增至集合。 若要將成員新增至集合，請使用其中一個 Cmdlet 來新增成員資格規則，例如：

您無法設定預設集合。 您目標的任何集合都應該有以月臺碼開頭的識別碼，而不是 SMS。

如需詳細資訊，請 參閱如何在 Configuration Manager 中建立集合。

注意事項

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

範例

範例 1：重新命名集合

第一個命令會取得名為 testUser 的集合物件，並將它儲存在 $userCollection 變數中。

第二個命令會更新集合的名稱。

$userCollection = Get-CMCollection -Name "testUser"
Set-CMCollection -InputObject $userCollection -NewName "newTestUser"

參數

-CollectionId

指定要設定之集合的識別碼。 這個值是 CollectionID 屬性， 例如 。 XYZ00012 您無法設定預設集合，因此此值的開頭是月臺碼，而不是 SMS。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Comment

指定選擇性批注來描述及識別此集合。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

執行 Cmdlet 之前提示您確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-DisableWildcardHandling

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ForceWildcardHandling

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

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-InputObject

指定要設定的集合物件。 若要取得此物件，請使用 Get-CMCollection、 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet。

類型:IResultObject
別名:Collection
Position:Named
預設值:None
必要:True
接受管線輸入:True
接受萬用字元:False

-LimitingCollection

指定限制集合的物件。 若要取得此物件，請使用 Get-CMCollection、 Get-CMDeviceCollection 或 Get-CMUserCollection Cmdlet。

類型:IResultObject
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LimitingCollectionId

指定限制集合的識別碼。 這個值是 CollectionID 屬性，例如 或 XYZ00012SMS00001。

類型:String
別名:LimitToCollectionId
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-LimitingCollectionName

指定限制集合的名稱。

類型:String
別名:LimitToCollectionName
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Name

指定要設定的集合名稱。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-NewName

指定集合的新名稱。 使用此參數將它重新命名。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-PassThru

新增此參數以傳回 物件，代表您正在使用的專案。 根據預設，此 Cmdlet 可能不會產生任何輸出。

類型:SwitchParameter
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RefreshSchedule

如果您將 RefreshType 參數設定為 Periodic 或 Both，請使用此參數來設定排程。 指定當網站執行集合成員資格的完整更新時的排程物件。 若要取得此物件，請使用 New-CMSchedule Cmdlet。

類型:IResultObject
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-RefreshType

指定集合成員資格的更新方式：

  • Manual (1) ：系統管理員在 Configuration Manager 控制台或 使用 Invoke-CMCollectionUpdate Cmdlet 手動觸發成員資格更新。
  • Periodic (2) ：網站會依排程執行完整更新。 它不會使用累加式更新。 如果您未指定類型，則此值為預設值。
  • Continuous (4) ：網站會定期評估新的資源，然後新增成員。 此類型也稱為 累加式更新。 它不會依排程執行完整更新。
  • Both (6) ：和 的PeriodicContinuous組合，同時包含累加式更新和排程上的完整更新。

如果您指定 Periodic 或 Both，請使用 RefreshSchedule 參數來設定排程。

注意事項

None (0) 的值在功能上與 Manual相同。

類型:CollectionRefreshType
接受的值:None, Manual, Periodic, Continuous, Both
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-VariablePriority

針對裝置集合變數的優先順序，指定從 1 到 9 的整數值。 1 是最低優先順序，且 9 是最高的。

若要在裝置集合上設定變數，請使用 Set-CMDeviceCollectionVariable Cmdlet。

若要檢視目前的變數優先順序，請使用 Get-CMCollectionSetting Cmdlet。

類型:Int32
別名:DeviceCollectionVariablePrecedence
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示執行 Cmdlet 時會發生什麼情況。 Cmdlet 不會執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object