Set-CMCollection

  • 參考
模組:
ConfigurationManager

設定裝置或使用者集合。

Syntax

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 。

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

-Comment

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

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

-Confirm

執行 Cmdlet 之前提示您確認。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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

-ForceWildcardHandling

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

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

-InputObject

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

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

-LimitingCollection

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

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

-LimitingCollectionId

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

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

-LimitingCollectionName

指定限制集合的名稱。

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

-Name

指定要設定的集合名稱。

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

-NewName

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

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

-PassThru

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

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

-RefreshSchedule

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

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

-RefreshType

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

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

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

注意事項

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

Type:CollectionRefreshType
Accepted values:None, Manual, Periodic, Continuous, Both
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VariablePriority

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

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

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

Type:Int32
Aliases:DeviceCollectionVariablePrecedence
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

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

輸入

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

輸出

System.Object