New-CMTSStepConditionFile
Créer une condition de propriétés de fichier pour une étape de séquence de tâches.
Syntaxe
New-CMTSStepConditionFile
[-FileDateTimeOperator <VariableOperatorType>]
-FilePath <String>
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Utilisez cette applet de commande pour créer un objet de condition de propriétés de fichier 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.
Il existe trois types de vérifications que vous pouvez effectuer avec cette condition :
- Pour vérifier si le fichier existe, utilisez le paramètre FilePath requis.
- Pour vérifier également la version du fichier, utilisez les paramètres FileVersion et VersionOperator .
- Pour vérifier également l’horodatage du fichier, utilisez les paramètres FileTimestamp et FileDateTimeOperator .
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
Cet exemple vérifie l’existence et l’horodatage de l’un des fichiers d’aide du module PowerShell Configuration Manager. Il crée un objet de condition de fichier pour le fichier et que son horodatage est supérieur au 2 août 2021.
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 .
$file = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml"
$datetime = Get-Date ("August 2, 2021")
$condition = New-CMTSStepConditionFile -FilePath $file -FileTimestamp $datetime -FileDateTimeOperator Greater
$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 :
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"
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 |
-FileDateTimeOperator
Lorsque vous utilisez le paramètre FileTimestamp , utilisez ce paramètre pour spécifier l’opérateur de la séquence de tâches afin d’évaluer l’horodatage du fichier.
Type: | VariableOperatorType |
Valeurs acceptées: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-FilePath
Spécifiez le chemin d’accès complet, y compris le nom du fichier pour cette condition.
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 |
-FileTimestamp
Pour évaluer l’horodatage du fichier, utilisez ce paramètre pour spécifier un objet datetime. Pour obtenir cet objet, utilisez l’applet de commande Get-Date intégrée.
Utilisez ensuite le paramètre FileDateTimeOperator pour définir l’opérateur d’évaluation.
Type: | DateTime |
Position: | Named |
Valeur par défaut: | None |
Obligatoire: | False |
Accepter l'entrée de pipeline: | False |
Accepter les caractères génériques: | False |
-FileVersion
Pour évaluer la version du fichier, utilisez ce paramètre pour spécifier la chaîne de version.
Utilisez ensuite le paramètre VersionOperator pour définir l’opérateur d’évaluation.
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 |
-VersionOperator
Lorsque vous utilisez le paramètre FileVersion , utilisez ce paramètre pour spécifier l’opérateur de la séquence de tâches afin d’évaluer la version du fichier.
Type: | VariableOperatorType |
Valeurs acceptées: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
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
None
Sorties
IResultObject
Notes
Pour plus d’informations sur cet objet de retour et ses propriétés, consultez SMS_TaskSequence_FileConditionExpression classe WMI du serveur.