New-CMTSStepConditionFile
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 proprietà 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 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 di uno dei file della Guida del modulo PowerShell di 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 di 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 $conditionQuesto 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.
| 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 |
-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.
| 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 |
-FilePath
Specificare il percorso completo, incluso il nome del file per questa condizione.
| Tipo: | String |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | True |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | DateTime |
| Posizione: | Named |
| Valore predefinito: | None |
| Necessario: | False |
| Accettare l'input della pipeline: | False |
| Accettare caratteri jolly: | 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.
| Tipo: | String |
| 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 |
-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.
| 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 |
-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_FileConditionExpression classe WMI del server.