New-CMQuery
Créez une requête Configuration Manager.
Syntax
New-CMQuery
[-Comment <String>]
-Expression <String>
[-LimitToCollectionId <String>]
-Name <String>
[-TargetClassName <String>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette applet de commande pour créer une requête dans Configuration Manager.
Configuration Manager requêtes définissent une expression WQL (WMI Query Language) pour obtenir des informations à partir de la base de données du 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 collections, 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 comprend 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 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 requête pour les serveurs d’une version spécifique
Cet exemple crée une requête nommée Server 2016 qui recherche les clients dont la légende du système d’exploitation commence par Microsoft Windows Server 2012. Elle retourne les trois propriétés suivantes : Nom, Nom de la dernière ouverture de session et Légende du système d’exploitation.
New-CMQuery -Name "Server 2016" -Expression 'select SMS_R_System.Name, SMS_R_System.LastLogonUserName, SMS_G_System_OPERATING_SYSTEM.Caption from SMS_R_System inner join SMS_G_System_OPERATING_SYSTEM on SMS_G_System_OPERATING_SYSTEM.ResourceID = SMS_R_System.ResourceId where SMS_G_System_OPERATING_SYSTEM.Caption like "Microsoft Windows Server 2012%"' -TargetClassName "SMS_R_System" -LimitToCollectionId "SMS00001"
Exemple 2 : Créer une requête pour les appareils de bureau
Cet exemple crée une requête nommée Appareils de bureau qui recherche des appareils avec des valeurs spécifiques pour la propriété Types de châssis de la classe Boîtier système . Elle retourne plusieurs propriétés et est limitée par une collection spécifique.
New-CMQuery -Name "Desktop devices" -Expression 'select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client from SMS_R_System inner join SMS_G_System_SYSTEM_ENCLOSURE on SMS_G_System_SYSTEM_ENCLOSURE.ResourceID = SMS_R_System.ResourceId where SMS_G_System_SYSTEM_ENCLOSURE.ChassisTypes in ( "3", "4", "5","6", "7", "15","16")' -TargetClassName "SMS_R_System" -LimitToCollectionId "XYZ000049"
Paramètres
-Comment
Spécifiez un commentaire facultatif pour identifier davantage la requête dans le site.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
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: | None |
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 |
-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 |
Default value: | None |
Required: | True |
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 |
-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 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Spécifiez le nom de la requête.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | 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 |
Default value: | None |
Required: | False |
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: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Entrées
None
Sorties
IResultObject
Liens associés
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour