New-CMTSStepConditionFolder

  • Referenz
Modul:
ConfigurationManager

Erstellen Sie eine Ordnereigenschaftenbedingung für einen Tasksequenzschritt.

Syntax

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

Beschreibung

Verwenden Sie dieses Cmdlet, um ein Bedingungsobjekt für ordnereigenschaften für einen Tasksequenzschritt zu erstellen. Verwenden Sie dann eines der Cmdlets New-CMTSStep* oder Set-CMTSStep* mit den Parametern Condition oder AddCondition . Beispiel: Set-CMTSStepApplyDataImage.

Weitere Informationen finden Sie unter Verwenden des Tasksequenz-Editors: Bedingungen.

Es gibt zwei Arten von Überprüfungen, die Sie mit dieser Bedingung durchführen können:

  • Um zu überprüfen, ob der Ordner vorhanden ist, verwenden Sie den erforderlichen FolderPath-Parameter .
  • Um auch den Ordnerzeitstempel zu überprüfen, verwenden Sie die Parameter FolderTimestamp und FolderDateTimeOperator .

Hinweis

Führen Sie Configuration Manager-Cmdlets auf dem Configuration Manager-Standortlaufwerk aus, z. B PS XYZ:\>. . Weitere Informationen finden Sie unter Erste Schritte.

Beispiele

Beispiel 1

In diesem Beispiel wird das Vorhandensein und der Zeitstempel für den Hilfedateiordner des Configuration Manager PowerShell-Moduls überprüft. Es wird ein Bedingungsobjekt für den Ordner erstellt, dessen Zeitstempel größer als der 2. August 2021 ist.

Anschließend wird das Cmdlet Set-CMTSStepRunPowerShellScript verwendet, um dieses Bedingungsobjekt dem Schritt PowerShell-Skript ausführen der Tasksequenz Standardbetriebssystembereitstellung hinzuzufügen.

$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

Dieses Beispielskript erstellt die folgende Bedingung für den Schritt:

Folder C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US exists and timestamp greater than "8/1/2021 16:00:00"

Parameter

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

Typ:SwitchParameter
Aliase:cf
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DisableWildcardHandling

Dieser Parameter behandelt Wildcardzeichen als Literalzeichenwerte. Sie können es nicht mit ForceWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FolderDateTimeOperator

Wenn Sie den FolderTimestamp-Parameter verwenden, verwenden Sie diesen Parameter, um den Operator für die Tasksequenz anzugeben, um den Zeitstempel des Ordners auszuwerten.

Typ:VariableOperatorType
Zulässige Werte:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FolderPath

Geben Sie den vollständigen Pfad des Ordners für diese Bedingung an.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-FolderTimestamp

Verwenden Sie zum Auswerten des Zeitstempels des Ordners diesen Parameter, um ein datetime-Objekt anzugeben. Verwenden Sie zum Abrufen dieses Objekts das integrierte Cmdlet Get-Date .

Verwenden Sie dann den Parameter FolderDateTimeOperator , um den Auswertungsoperator festzulegen.

Typ:DateTime
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-ForceWildcardHandling

Dieser Parameter verarbeitet Wildcardzeichen und kann zu unerwartetem Verhalten führen (nicht empfohlen). Sie können es nicht mit DisableWildcardHandling kombinieren.

Typ:SwitchParameter
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-WhatIf

Zeigt, was passieren würde, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:SwitchParameter
Aliase:wi
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

IResultObject

Hinweise

Weitere Informationen zu diesem Rückgabeobjekt und seinen Eigenschaften finden Sie unter SMS_TaskSequence_FolderConditionExpression WMI-Serverklasse.