New-CMTSStepConditionQueryWmi
Créez une condition de requête WMI pour une étape de séquence de tâches.
Syntaxe
New-CMTSStepConditionQueryWmi
[-Namespace <String[]>]
-Query <String>
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette applet de commande pour créer un objet de condition de requête WMI pour une étape de séquence de tâches. Utilisez ensuite l’une des applets de commande New-CMTSStep* ou Set-CMTSStep* avec les paramètres Condition ou AddCondition . Par exemple, Set-CMTSStepApplyDataImage.
Pour plus d’informations, consultez Utiliser l’éditeur de séquence de tâches : conditions.
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 : Créer une condition de requête basée sur le modèle matériel
Cet exemple crée d’abord un objet de condition pour interroger WMI pour le modèle d’ordinateur.
Il utilise ensuite l’applet de commande Set-CMTSStepRunPowerShellScript pour ajouter cet objet de condition à l’étape Exécuter le script PowerShell de la séquence de tâches de déploiement du système d’exploitation par défaut .
$model = "Latitude E7470"
$query = "Select * From Win32_ComputerSystem Where Model = `"$model`""
$condition = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $query
$tsNameOsd = "Default OS deployment"
$tsStepNameRunPwsh = "Run PowerShell Script"
Set-CMTSStepRunPowerShellScript -TaskSequenceName $tsNameOsd -StepName $tsStepNameRunPwsh -AddCondition $condition
Cet exemple de script crée la condition suivante à l’étape :
WMI Query Select * From Win32_ComputerSystem Where Model = "Latitude E7470"
Paramètres
-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 |
-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 |
-Namespace
Spécifiez l’espace de noms WMI pour la requête. Par exemple, root\cimv2
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 |
-Query
Spécifiez la requête WMI. L’applet de commande ne teste pas la validité de la requête.
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 |
-WhatIf
Présente ce qui se produit si le cmdlet s’exécute. L’applet de commande n’est pas exécutée.
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
None
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_WMIConditionExpression classe WMI du serveur.