Get-CMDeviceCollectionVariable

  • Référence
Module:
ConfigurationManager

Obtenir une variable de regroupement d’appareils.

Syntax

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 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 : 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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-CollectionName

Spécifiez le nom d’un regroupement d’appareils pour obtenir ses variables.

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

-VariableName

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

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