New-CMTSStepConditionFolder

  • Riferimento
Modulo:
ConfigurationManager

Creare una condizione delle proprietà della cartella per un passaggio della sequenza di attività.

Sintassi

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

Descrizione

Usare questo cmdlet per creare un oggetto condizione delle proprietà della cartella per un passaggio della sequenza di attività. Usare quindi uno dei cmdlet New-CMTSStep* o Set-CMTSStep* con i parametri Condition o AddCondition . Ad esempio, Set-CMTSStepApplyDataImage.

Per altre informazioni, vedere Usare l'editor della sequenza di attività: Condizioni.

Esistono due tipi di controlli che è possibile eseguire con questa condizione:

  • Per verificare se la cartella esiste, usare il parametro FolderPath obbligatorio.
  • Per controllare anche il timestamp della cartella, usare i parametri FolderTimestamp e FolderDateTimeOperator .

Nota

Eseguire i cmdlet di Configuration Manager dall'unità del sito di Configuration Manager, ad esempio PS XYZ:\>. Per altre informazioni, vedere Introduzione.

Esempio

Esempio 1

In questo esempio viene verificata l'esistenza e il timestamp della cartella del file della Guida del modulo PowerShell di Configuration Manager. Crea un oggetto condizione per la cartella e il relativo timestamp è maggiore del 2 agosto 2021.

Viene quindi usato il cmdlet Set-CMTSStepRunPowerShellScript per aggiungere questo oggetto condizione al passaggio Esegui script di PowerShell della sequenza di attività di distribuzione del sistema operativo predefinito .

$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

Questo script di esempio crea la condizione seguente nel passaggio:

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

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Tipo:SwitchParameter
Alias:cf
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DisableWildcardHandling

Questo parametro considera i caratteri jolly come valori letterali. Non è possibile combinarlo con ForceWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FolderDateTimeOperator

Quando si usa il parametro FolderTimestamp , usare questo parametro per specificare l'operatore per la sequenza di attività per valutare il timestamp della cartella.

Tipo:VariableOperatorType
Valori accettati:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FolderPath

Specificare il percorso completo della cartella per questa condizione.

Tipo:String
Posizione:Named
Valore predefinito:None
Necessario:True
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-FolderTimestamp

Per valutare il timestamp della cartella, usare questo parametro per specificare un oggetto datetime. Per ottenere questo oggetto, usare il cmdlet Get-Date predefinito.

Usare quindi il parametro FolderDateTimeOperator per impostare l'operatore di valutazione.

Tipo:DateTime
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-ForceWildcardHandling

Questo parametro elabora caratteri jolly e può causare un comportamento imprevisto (non consigliato). Non è possibile combinarlo con DisableWildcardHandling.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WhatIf

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

Tipo:SwitchParameter
Alias:wi
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Output

IResultObject

Note

Per altre informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_FolderConditionExpression classe WMI del server.