New-CMTSStepConditionIfStatement

Module:

ConfigurationManager

Créez une condition d’instruction if pour une étape de séquence de tâches.

Syntaxe

New-CMTSStepConditionIfStatement
   [-Condition <IResultObject[]>]
   -StatementType <ConditionStatementType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un objet de condition d’instruction if 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 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

Cet exemple utilise d’abord les applets de commande New-CMTSStepConditionFile et New-CMTSStepConditionQueryWMI pour créer des objets de condition enfant. Il transmet ces deux objets à l’applet de commande New-CMTSStepConditionIfStatement et enregistre cet objet de condition.

Il utilise ensuite l’applet de commande Set-CMTSStepSetDynamicVariable pour ajouter cet objet de condition à l’étape Définir des variables dynamiques de la séquence de tâches de déploiement du système d’exploitation par défaut .

$file = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml"
$datetime = Get-Date ("August 2, 2021")
$conditionFile = New-CMTSStepConditionFile -FilePath $file -FileTimestamp $datetime -FileDateTimeOperator Greater

$model = "Latitude E7470"
$wmiQuery = "Select * From Win32_ComputerSystem Where Model = `"$Model`""
$conditionQuery = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $wmiQuery

$condition = New-CMTSStepConditionIfStatement -StatementType All -Condition $conditionFile,$conditionQuery

$tsNameOsd = "Default OS deployment"
$tsStepNameSetDynVar = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameSetDynVar -AddCondition $condition

If  All  the conditions are true:
    File  C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml exists  and  timestamp greater than "8/1/2021 16:00:00"
    WMI Query  Select * From Win32_ComputerSystem Where Model = "Latitude E7470"

Paramètres

-Condition

Spécifiez un ou plusieurs objets de condition à inclure dans ce bloc d’instructions if . Pour obtenir ces objets imbriqués, utilisez l’une des applets de commande New-CMTSStepCondition* . Par exemple, New-CMTSStepConditionFile.

Type:	IResultObject[]
Alias:	SubCondition, SubConditions
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

-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

-StatementType

Spécifiez le type de l’instruction if à créer. Il existe trois types de vérifications que vous pouvez effectuer avec cette condition :

• Si All des conditions sont remplies
• Si Any des conditions sont remplies
• Si None des conditions sont remplies

Type:	ConditionStatementType
Alias:	Operator
Valeurs acceptées:	All, Any, None
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 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

None

Sorties

IResultObject

Notes

Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_ConditionOperator classe WMI du serveur.

Liens associés

• Get-CMTSStepConditionIfStatement
• Utiliser l’éditeur de séquence de tâches : Conditions