Set-CMDeviceVariable

修改裝置變數。

Syntax

Set-CMDeviceVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   [-PassThru]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceVariable
   -DeviceName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   [-PassThru]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceVariable
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   [-PassThru]
   -ResourceId <String>
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

使用此 Cmdlet 可修改 Configuration Manager 裝置上的變數。

個別裝置具有裝置變數。 任務連續處理使用裝置變數。 如需詳細資訊,請參閱 集合和裝置變數

注意

從 Configuration Manager 網站磁碟機執行 Configuration Manager Cmdlet,例如 PS XYZ:\> 。 如需詳細資訊,請參閱 快速入門。

範例

範例1:修改裝置變數

這個命令會修改與指定之 device.com 相關聯的裝置變數 ServerIPAddress 。 在此範例中,變數的值設為 192.168.100.10

Set-CMDeviceVariable -DeviceName "server01" -VariableName "ServerIPAddress" -NewVariableValue "192.168.100.10"

參數

-Confirm

執行 Cmdlet 之前提示您確認。

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

-DeviceName

指定裝置名稱。 您可以指定 NetBIOS 名稱或 (FQDN) 的完整功能變數名稱。

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

指定要設定變數的裝置物件。 若要取得此物件,請使用 CMDevice Cmdlet。

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

-IsMask

將此參數設定為 $true 以隱藏 Configuration Manager 主控台中的值。

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

-NewVariableName

指定變數的新名稱。

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

-NewVariableValue

指定變數的新值。

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

-PassThru

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

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

-ResourceId

指定裝置的資源識別碼。

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

-VariableName

指定裝置變數的名稱。

從版本2111開始,此參數不區分大小寫。

Type:String
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

輸入

ConfigurationManagement IResultObject

輸出

系統.物件