Share via

New-CMDeviceVariable

  • Référence
Module:
ConfigurationManager

Crée une variable d’appareil pour un appareil Configuration Manager.

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

Description

L’applet de commande New-CMDeviceVariable crée une variable d’appareil pour un appareil Configuration Manager.

Les appareils individuels ont des variables d’appareil. Le traitement des séquences de tâches utilise des variables d’appareil.

Remarque

Exécutez Configuration Manager applets de commande à partir du lecteur de site Configuration Manager, par exemple PS XYZ:\>. Pour plus d’informations, consultez Prise en main.

Exemples

Exemple 1 : Créer une variable d’appareil

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

Cette commande crée une variable d’appareil pour l’appareil gateway-server.contoso.com. La variable est nommée ServerIPAddress et la valeur est définie sur 192.168.1.1. Le fait de définir le paramètre IsMask sur 0 garantit que la variable est affichée dans la console Configuration Manager.

Paramètres

-Confirm

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

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

-DeviceId

Spécifie un ID d’appareil.

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

-DeviceName

Spécifie un nom d’appareil. Vous pouvez spécifier un nom NetBIOS ou un nom de domaine complet (FQDN).

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

-DisableWildcardHandling

Ce paramètre traite les caractères génériques comme des valeurs de caractère littéral. Vous ne pouvez pas la combiner avec ForceWildcardHandling.

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

-ForceWildcardHandling

Ce paramètre traite les caractères génériques et peut entraîner un comportement inattendu (non recommandé). Vous ne pouvez pas la combiner avec DisableWildcardHandling.

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

-InputObject

Spécifie l’entrée de cette applet de commande. Vous pouvez utiliser ce paramètre ou diriger l’entrée vers cette applet de commande.

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

-IsMask

Indique si la valeur de la variable est affichée dans la console Configuration Manager.

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

-VariableName

Spécifie le nom de la variable d’appareil.

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

-VariableValue

Spécifie la valeur de la variable.

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

-WhatIf

Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande ne s’exécute pas.

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

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

IResultObject