Partager via

Set-CMDeviceCollectionVariable

  • Référence
Module:
ConfigurationManager

Configurez une variable de regroupement d’appareils.

Syntaxe

Set-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-NewVariableName <String>]
   [-NewVariableValue <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour modifier une variable de regroupement d’appareils.

Les collections par défaut ne peuvent pas avoir de variables. Toute collection que vous ciblez doit avoir un ID qui commence par le code de site, et non SMS.

Pour plus d’informations, consultez Guide pratique pour définir des variables de séquence de tâches.

Remarque

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

Exemples

Exemple 1 : Modifier le nom d’une variable

La première commande obtient l’objet de collection d’appareils nommé Device et le stocke dans la variable $Collection .

La deuxième commande remplace le nom de la variable de collection testTS par NewVariable.

$Collection = Get-CMCollection -Name "Device"
Set-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -NewVariableName "NewVariable"

Exemple 2 : Modifier une valeur de variable

Cette commande modifie la valeur de la variable testTS sur le regroupement d’appareils . Elle définit la nouvelle valeur de variable sur 12.

Set-CMDeviceCollectionVariable -CollectionName "Device" -VariableName "testTS" -NewVariableValue 12

Paramètres

-CollectionId

Spécifiez l’ID d’un regroupement d’appareils pour configurer une variable. Cette valeur est la propriété CollectionID, par exemple . XYZ00012 Étant donné que vous ne pouvez pas définir de variables sur des collections par défaut, cette valeur commence par le code de site, et non SMSpar .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-CollectionName

Spécifiez le nom d’un regroupement d’appareils pour configurer une variable.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-InputObject

Spécifiez un objet de regroupement d’appareils pour configurer une variable. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection ou Get-CMDeviceCollection .

Type:IResultObject
Alias:Collection
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-IsMask

Définissez ce paramètre sur $true pour indiquer que la valeur de la variable est masquée. Les valeurs masquées ne sont pas affichées dans la console Configuration Manager, la propriété Value sur la classe WMI SMS_CollectionVariable ou le fichier journal de séquence de tâches. La séquence de tâches peut toujours utiliser la variable .

Vous ne pouvez pas démasquer une variable une fois qu’elle est masquée. Si vous masquez la valeur d’une variable, mais que vous ne souhaitez pas qu’elle soit masquée, vous devez supprimer et recréer la variable.

Type:Boolean
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NewVariableName

Spécifiez un nouveau nom pour la variable de collection. Utilisez ce paramètre pour renommer la variable.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-NewVariableValue

Spécifiez une nouvelle valeur pour la variable de collection.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-VariableName

Spécifiez le nom de la variable de collection à modifier.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

Microsoft.ConfigurationManagement.ManagementProvider.IResultObject

Sorties

System.Object

Notes

Pour définir la priorité de la variable, utilisez l’applet de commande Set-CMCollection avec le paramètre VariablePriority . Pour afficher la priorité actuelle de la variable, utilisez l’applet de commande Get-CMCollectionSetting .