Partager via

Get-CMQuery

  • Référence
Module:
ConfigurationManager

Obtenir une requête Configuration Manager.

Syntaxe

Get-CMQuery
   [-Name <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]
Get-CMQuery
   [-Id <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour obtenir une requête à partir du site Configuration Manager. Les requêtes Configuration Manager définissent une expression WQL (WMI Query Language) pour obtenir des informations à partir de la base de données de site en fonction des critères que vous fournissez. WQL est similaire à SQL, mais passe toujours par le fournisseur SMS au lieu d’être directement dans la base de données. Par conséquent, WQL respecte toujours votre configuration d’accès en fonction du rôle.

Les requêtes peuvent retourner la plupart des types d’objets Configuration Manager, notamment les ordinateurs, les sites, les regroupements, les applications et les données d’inventaire. Pour plus d’informations, consultez Présentation des requêtes dans Configuration Manager.

Par défaut, Configuration Manager inclut plusieurs requêtes. Vous pouvez utiliser cette applet de commande pour passer en revue les requêtes par défaut.

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

Cette commande retourne toutes les requêtes dont le nom contient « Clients ConfigMgr ».

Get-CMQuery -Name "*ConfigMgr clients *"

Paramètres

-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

-Id

Spécifiez l’ID de la requête à obtenir. Par exemple : "XYZ00006".

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

-Name

Spécifiez le nom de la requête à obtenir.

Vous pouvez utiliser des caractères génériques :

  • *: plusieurs caractères
  • ?: caractère unique
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:True

Entrées

None

Sorties

IResultObject[]

IResultObject