Partager via

New-CMTSStepConditionFolder

  • Référence
Module:
ConfigurationManager

Créer une condition de propriétés de dossier pour une étape de séquence de tâches.

Syntaxe

New-CMTSStepConditionFolder
   [-FolderDateTimeOperator <VariableOperatorType>]
   -FolderPath <String>
   [-FolderTimestamp <DateTime>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Utilisez cette applet de commande pour créer un objet de condition des propriétés de dossier 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 deux types de vérifications que vous pouvez effectuer avec cette condition :

  • Pour vérifier si le dossier existe, utilisez le paramètre FolderPath requis.
  • Pour vérifier également l’horodatage du dossier, utilisez les paramètres FolderTimestamp et FolderDateTimeOperator .

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 du dossier du fichier d’aide du module PowerShell Configuration Manager. Il crée un objet de condition pour le dossier 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 .

$folder = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US"
$datetime = Get-Date ("August 2, 2021")

$condition = New-CMTSStepConditionFolder -FolderPath $folder -FolderTimestamp $datetime -FolderDateTimeOperator 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 :

Folder C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US 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

-FolderDateTimeOperator

Lorsque vous utilisez le paramètre FolderTimestamp , utilisez ce paramètre pour spécifier l’opérateur de la séquence de tâches afin d’évaluer l’horodatage du dossier.

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

-FolderPath

Spécifiez le chemin d’accès complet du dossier 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

-FolderTimestamp

Pour évaluer l’horodatage du dossier, 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 FolderDateTimeOperator 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

-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

-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_FolderConditionExpression classe WMI du serveur.