Set-CMDeviceVariable

Ändern einer Gerätevariablen.

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>]

Beschreibung

Verwenden Sie dieses Cmdlet, um eine Variable auf einem Configuration Manager-Gerät zu ändern.

Einzelne Geräte verfügen über Gerätevariablen. Die Tasksequenzverarbeitung verwendet Gerätevariablen. Weitere Informationen finden Sie unter Sammlungs- und Gerätevariablen.

Hinweis

Führen Sie Configuration Manager-Cmdlets beispielsweise vom Configuration Manager-Standortlaufwerk PS XYZ:\> aus. Weitere Informationen finden Sie unter "Erste Schritte".

Beispiele

Beispiel 1: Ändern einer Gerätevariablen

Mit diesem Befehl wird die Gerätevariable ServerIPAddress geändert, die dem angegebenen device.com zugeordnet ist. In diesem Beispiel wird der Wert der Variablen auf 192.168.100.10 .

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

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-DeviceName

Geben Sie einen Gerätenamen an. Sie können einen NetBIOS-Namen oder einen vollqualifizierten Domänennamen (FQDN) angeben.

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

-DisableWildcardHandling

Dieser Parameter behandelt Platzhalterzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandlingkombinieren.

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

-ForceWildcardHandling

Dieser Parameter verarbeitet Platzhalterzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandlingkombinieren.

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

-InputObject

Geben Sie ein Geräteobjekt an, für das die Variable festgelegt werden soll. Verwenden Sie zum Abrufen dieses Objekts das Cmdlet "Get-CMDevice".

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

-IsMask

Legen Sie diesen Parameter $true fest, um den Wert in der Configuration Manager-Konsole auszublenden.

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

-NewVariableName

Geben Sie einen neuen Namen für die Variable an.

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

-NewVariableValue

Geben Sie einen neuen Wert für die Variable an.

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

-PassThru

Fügen Sie diesen Parameter hinzu, um ein Objekt zurückzugeben, das das Element darstellt, mit dem Sie arbeiten. Standardmäßig generiert dieses Cmdlet möglicherweise keine Ausgabe.

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

-ResourceId

Geben Sie die Ressourcen-ID des Geräts an.

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

-VariableName

Geben Sie den Namen der Gerätevariablen an.

Ab Version 2111 wird bei diesem Parameter die Groß-/Kleinschreibung nicht beachtet.

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

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

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

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

System.Object