Share via

New-CMDeviceCollectionVariable

  • Référence
Module:
ConfigurationManager

Créez une variable de regroupement d’appareils.

Syntax

New-CMDeviceCollectionVariable
   -InputObject <IResultObject>
   [-IsMask <Boolean>]
   [-Value <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceCollectionVariable
   -CollectionId <String>
   [-IsMask <Boolean>]
   [-Value <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMDeviceCollectionVariable
   -CollectionName <String>
   [-IsMask <Boolean>]
   [-Value <String>]
   -VariableName <String>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer une variable de regroupement d’appareils. Vous pouvez utiliser une variable de regroupement d’appareils pour définir des variables de séquence de tâches personnalisées et leurs valeurs associées à utiliser par les appareils d’un regroupement. Les variables de séquence de tâches sont un ensemble de paires nom-valeur qui fournissent un mécanisme pour configurer et personnaliser les étapes d’une séquence de tâches lorsque la séquence de tâches est déployée dans une collection spécifique.

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 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 de regroupement d’appareils

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

La deuxième commande crée une variable de collection nommée testTS avec la valeur test001 pour l’objet de collection stocké dans $Collection.

$Collection = Get-CMCollection -Name "Device"
New-CMDeviceCollectionVariable -Collection $Collection -VariableName "testTS" -Value "test001"

Paramètres

-CollectionId

Spécifiez l’ID d’un regroupement d’appareils sur lequel créer la 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Spécifiez le nom d’un regroupement d’appareils sur lequel créer la variable.

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

-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

-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écifiez un objet de collection d’appareils sur lequel créer la variable. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection ou Get-CMDeviceCollection .

Type:IResultObject
Aliases:Collection
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 la 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.

Si vous n’incluez pas ce paramètre, les valeurs ne sont pas masquées par défaut.

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

-Value

Spécifiez une valeur pour la variable de collection.

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

-VariableName

Spécifiez un nom pour la variable de collection à créer.

Type:String
Position:Named
Default value:None
Required:True
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[]

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_CollectionSettings classe WMI du serveur.