New-CMDeviceVariable

  • Referenz
Modul:
ConfigurationManager

Erstellt eine Gerätevariable für ein Configuration Manager Gerät.

Syntax

New-CMDeviceVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   -VariableName <String>
   [-VariableValue <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceVariable
   -DeviceId <String>
   [-IsMask <Boolean>]
   -VariableName <String>
   [-VariableValue <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceVariable
   -DeviceName <String>
   [-IsMask <Boolean>]
   -VariableName <String>
   [-VariableValue <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Beschreibung

Das Cmdlet New-CMDeviceVariable erstellt eine Gerätevariable für ein Configuration Manager Gerät.

Einzelne Geräte verfügen über Gerätevariablen. Bei der Tasksequenzverarbeitung werden Gerätevariablen verwendet.

Hinweis

Führen Sie Configuration Manager Cmdlets auf dem Configuration Manager-Websitelaufwerk aus, z. PS XYZ:\>B. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1: Erstellen einer Gerätevariablen

PS XYZ:\> New-CMDeviceVariable -DeviceName "gateway-server.contoso.com" -VariableName "ServerIPAddress" -VariableValue "192.168.1.1" -IsMask 0

Dieser Befehl erstellt eine Gerätevariable für das Gerät gateway-server.contoso.com. Die Variable heißt ServerIPAddress, und der Wert ist auf 192.168.1.1 festgelegt. Durch Festlegen des IsMask-Parameters auf 0 wird sichergestellt, dass die Variable in der Configuration Manager-Konsole angezeigt wird.

Parameter

-Confirm

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

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

-DeviceId

Gibt eine Geräte-ID an.

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

-DeviceName

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

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

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

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

-ForceWildcardHandling

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

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

-InputObject

Gibt die Eingabe für dieses Cmdlet an. Sie können diesen Parameter verwenden oder die Eingabe an dieses Cmdlet weiterleiten.

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

-IsMask

Gibt an, ob der Variablenwert in der Configuration Manager-Konsole angezeigt wird.

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

-VariableName

Gibt den Namen der Gerätevariablen an.

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

-VariableValue

Gibt den Wert der Variablen an.

Type:String
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Eingaben

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Ausgaben

IResultObject