New-CMTSStepConditionFile
Cree una condición de propiedades de archivo para un paso de secuencia de tareas.
Sintaxis
New-CMTSStepConditionFile
[-FileDateTimeOperator <VariableOperatorType>]
-FilePath <String>
[-FileTimestamp <DateTime>]
[-FileVersion <String>]
[-VersionOperator <VariableOperatorType>]
[-DisableWildcardHandling]
[-ForceWildcardHandling]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Use este cmdlet para crear un objeto de condición de propiedades de archivo para un paso de secuencia de tareas. A continuación, use uno de los cmdlets New-CMTSStep* o Set-CMTSStep* con los parámetros Condition o AddCondition . Por ejemplo, Set-CMTSStepApplyDataImage.
Para obtener más información, vea Usar el editor de secuencia de tareas: Condiciones.
Hay tres tipos de comprobaciones que puede hacer con esta condición:
- Para comprobar si el archivo existe, use el parámetro FilePath necesario.
- Para comprobar también la versión del archivo, use los parámetros FileVersion y VersionOperator .
- Para comprobar también la marca de tiempo del archivo, use los parámetros FileTimestamp y FileDateTimeOperator .
Nota:
Ejecute cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\>. Para obtener más información, consulte Introducción.
Ejemplos
Ejemplo 1
En este ejemplo se comprueba la existencia y la marca de tiempo de uno de los archivos de ayuda del módulo de PowerShell de Configuration Manager. Crea un objeto de condición de archivo para el archivo y su marca de tiempo es mayor que el 2 de agosto de 2021.
A continuación, usa el cmdlet Set-CMTSStepRunPowerShellScript para agregar este objeto de condición al paso Ejecutar script de PowerShell de la secuencia de tareas de implementación predeterminada del sistema operativo .
$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 $conditionEste script de ejemplo crea la siguiente condición en el paso:
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"
Parámetros
-Confirm
Solicitará confirmación antes de ejecutar el cmdlet.
| Tipo: | SwitchParameter |
| Alias: | cf |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-DisableWildcardHandling
Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FileDateTimeOperator
Cuando use el parámetro FileTimestamp , use este parámetro para especificar el operador de la secuencia de tareas para evaluar la marca de tiempo del archivo.
| Tipo: | VariableOperatorType |
| Valores aceptados: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FilePath
Especifique la ruta de acceso completa, incluido el nombre del archivo para esta condición.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | True |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FileTimestamp
Para evaluar la marca de tiempo del archivo, use este parámetro para especificar un objeto datetime. Para obtener este objeto, use el cmdlet Get-Date integrado.
A continuación, use el parámetro FileDateTimeOperator para establecer el operador de evaluación.
| Tipo: | DateTime |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-FileVersion
Para evaluar la versión del archivo, use este parámetro para especificar la cadena de versión.
A continuación, use el parámetro VersionOperator para establecer el operador de evaluación.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-ForceWildcardHandling
Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.
| Tipo: | SwitchParameter |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-VersionOperator
Cuando use el parámetro FileVersion , use este parámetro para especificar el operador de la secuencia de tareas con el fin de evaluar la versión del archivo.
| Tipo: | VariableOperatorType |
| Valores aceptados: | Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-WhatIf
Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.
| Tipo: | SwitchParameter |
| Alias: | wi |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
Entradas
None
Salidas
IResultObject
Notas
Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_FileConditionExpression clase WMI de servidor.