共用方式為

Set-CMDeviceCollectionVariable

  • 參考
模組:
ConfigurationManager

設定裝置集合變數。

Syntax

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 來變更裝置集合變數。

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

如需詳細資訊，請 參閱如何設定工作順序變數。

注意事項

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

範例

範例 1：變更變數名稱

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

第二個命令會將集合變數 testTS 的名稱變更為 NewVariable。

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

範例 2：變更變數值

此命令會變更Device集合上變數testTS的值。 它會將新的變數值設定為 12。

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

參數

-CollectionId

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

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

-CollectionName

指定要設定變數的裝置集合名稱。

Type:String
Position:Named
Default value:None
Required:True
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 Cmdlet。

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

-IsMask

將此參數設定為 $true ，表示變數值已隱藏。 遮罩值不會顯示在Configuration Manager主控台、WMI 類別上的Value屬性SMS_CollectionVariable或工作順序記錄檔中。 工作順序仍然可以使用 變數。

一旦變數隱藏之後，您就無法取消遮罩變數。 如果您遮罩變數的值，但不想遮罩變數，則必須刪除並重新建立變數。

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

-NewVariableName

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

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

-NewVariableValue

指定集合變數的新值。

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

-VariableName

指定要變更的集合變數名稱。

Type:String
Position:Named
Default value:None
Required:True
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

備註

若要設定變數優先順序，請使用 Set-CMCollection Cmdlet 搭配 VariablePriority 參數。 若要檢視目前的變數優先順序，請使用 Get-CMCollectionSetting Cmdlet。