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

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

Per ulteriori informazioni, vedere Use the task sequence editor: Conditions.

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

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

Nota

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

Esempio

Esempio 1

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

Viene quindi utilizzato 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.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-DisableWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FolderDateTimeOperator

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

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FolderPath

Specificare il percorso completo della cartella per questa condizione.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-FolderTimestamp

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

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

Type:DateTime
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-ForceWildcardHandling

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False

Input

Nessuno

Output

IResultObject

Note

Per ulteriori informazioni su questo oggetto restituito e sulle relative proprietà, vedere SMS_TaskSequence_FolderConditionExpression wmi server.