Partager via

Get-CMDeviceCollectionVariable

  • Référence
Module:
ConfigurationManager

Obtenir une variable de regroupement d’appareils.

Syntaxe

Get-CMDeviceCollectionVariable
   -CollectionName <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -Collection <IResultObject>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMDeviceCollectionVariable
   -CollectionId <String>
   [-VariableName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir les variables de séquence de tâches sur un 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 : Obtenir une variable de regroupement d’appareils par nom

Cette commande obtient la variable de collecte nommée testTS pour le regroupement d’appareils nommé Device.

Get-CMDeviceCollectionVariable -CollectionName "DeviceCollection02" -VariableName "testTS"

Exemple 2 : Obtenir toutes les variables non masquées pour une collection

Cet exemple obtient toutes les variables des serveurs informatiques de collection et filtre la liste uniquement sur les variables qui ne sont pas masquées. Il affiche ensuite le nom et la valeur de chaque variable d’une table.

Get-CMDeviceCollectionVariable -CollectionName "IT servers" | Where-Object { -not $_.IsMasked } | Select-Object Name, Value

Paramètres

-Collection

Spécifiez un objet de collection d’appareils pour obtenir ses variables. Pour obtenir cet objet, utilisez les applets de commande Get-CMCollection ou Get-CMDeviceCollection .

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

-CollectionId

Spécifiez l’ID d’un regroupement d’appareils pour obtenir ses variables. 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 obtenir ses variables.

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

-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

-VariableName

Spécifiez le nom d’une variable de collection à obtenir.

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

Entrées

None

Sorties

IResultObject[]

IResultObject

Notes

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