New-CMTSStepConditionFile

  • Riferimento
Modulo:
ConfigurationManager

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

Sintassi

New-CMTSStepConditionFile
   [-FileDateTimeOperator <VariableOperatorType>]
   -FilePath <String>
   [-FileTimestamp <DateTime>]
   [-FileVersion <String>]
   [-VersionOperator <VariableOperatorType>]
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Descrizione

Usare questo cmdlet per creare un oggetto condizione delle proprietà del file 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 tre tipi di controlli che è possibile eseguire con questa condizione:

  • Per verificare se il file esiste, usare il parametro FilePath obbligatorio.
  • Per controllare anche la versione del file, usare i parametri FileVersion e VersionOperator .
  • Per controllare anche il timestamp del file, usare i parametri FileTimestamp e FileDateTimeOperator .

Nota

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

Esempio

Esempio 1

In questo esempio viene verificata l'esistenza e il timestamp di uno dei file della Guida del modulo powershell Configuration Manager. Crea un oggetto condizione del file per il file 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 powershell della sequenza di attività di distribuzione del sistema operativo predefinito .

$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

Questo script di esempio crea la condizione seguente nel passaggio:

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"

Parametri

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FileDateTimeOperator

Quando si usa il parametro FileTimestamp , usare questo parametro per specificare l'operatore per la sequenza di attività per valutare il timestamp del file.

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

-FilePath

Specificare il percorso completo, incluso il nome del file per questa condizione.

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

-FileTimestamp

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

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

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

-FileVersion

Per valutare la versione del file, usare questo parametro per specificare la stringa di versione.

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

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

-ForceWildcardHandling

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

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

-VersionOperator

Quando si usa il parametro FileVersion , usare questo parametro per specificare l'operatore per la sequenza di attività per valutare la versione del file.

Type:VariableOperatorType
Accepted values:Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual
Position:Named
Default value:None
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Input

None

Output

IResultObject

Note

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