Partager via

Set-CMQuery

  • Référence
Module:
ConfigurationManager

Configurez une requête Configuration Manager.

Syntaxe

Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   -InputObject <IResultObject>
   [-LimitToCollectionId <String>]
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   -Id <String>
   [-LimitToCollectionId <String>]
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
Set-CMQuery
   [-Comment <String>]
   [-Expression <String>]
   [-LimitToCollectionId <String>]
   -Name <String>
   [-NewName <String>]
   [-PassThru]
   [-TargetClassName <String>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour configurer une requête dans 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 l’applet de commande Get-CMQuery pour passer en revue les requêtes par défaut. Pour plus d’exemples d’expressions WQL, consultez Exemples de requêtes WQL.

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 : Renommer une requête

Get-CMQuery -Name "My systems" | Set-CMQuery -NewName "My systems v2"

Exemple 2 : Modifier la requête pour demander une limitation de la collecte

Set-CMQuery -Name "Windows 10" -LimitToCollectionId "<Prompt>"

Paramètres

-Comment

Spécifiez un commentaire facultatif pour identifier davantage la requête dans le site.

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

-Confirm

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

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:None
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

-Expression

Spécifiez l’instruction WQL qui définit les attributs à afficher dans les résultats et les critères pour limiter les résultats.

Les instructions WQL incluent souvent des guillemets doubles ("). Définissez donc la valeur de ce paramètre sous la forme d’une chaîne placée entre guillemets simples (').

Pour plus d’exemples, consultez Exemples de requêtes WQL.

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

-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 à configurer. Par exemple : "XYZ00006".

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

-InputObject

Spécifiez un objet de requête à configurer. Pour obtenir cet objet, utilisez l’applet de commande Get-CMQuery .

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

-LimitToCollectionId

Spécifiez comment configurer la limitation de collecte pour cette requête :

  • Collection non limitée : définissez la valeur de ce paramètre sur une chaîne vide (""). N’utilisez pas la $null variable intégrée.
  • Limite à la collection : spécifiez l’ID d’une collection. Par exemple, "SMSDM003" pour le regroupement Tous les clients de bureau et de serveur .
  • Invite de collecte : définissez la valeur de ce paramètre sur "<Prompt>".
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 à configurer.

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

-NewName

Spécifiez un nouveau nom pour renommer la requête.

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

-PassThru

Ajoutez ce paramètre pour renvoyer un objet qui représente l’élément avec lequel vous travaillez. Par défaut, cette applet de commande peut ne pas générer de sortie.

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

-TargetClassName

Spécifiez le nom de la classe d’objet que vous souhaitez que la requête retourne. De nombreux types d’objets sont disponibles. Le tableau suivant répertorie plusieurs noms de classes courantes avec la description de la console Configuration Manager :

Nom de la classe Description
SMS_R_System Ressource système
SMS_Program Programme
SMS_R_UserGroup Ressource de groupe d’utilisateurs
SMS_R_User Ressource User
SMS_SiteAndSubsites Site et sous-sites
SMS_R_UnknownSystem Ordinateur inconnu
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

-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:None
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