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