Compartir a través de

New-CMTSStepConditionFolder

  • Referencia
Módulo:
ConfigurationManager

Cree una condición de propiedades de carpeta para un paso de secuencia de tareas.

Sintaxis

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

Description

Use este cmdlet para crear un objeto de condición de propiedades de carpeta 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 dos tipos de comprobaciones que puede hacer con esta condición:

  • Para comprobar si la carpeta existe, use el parámetro FolderPath necesario.
  • Para comprobar también la marca de tiempo de la carpeta, use los parámetros FolderTimestamp y FolderDateTimeOperator .

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 la carpeta del archivo de ayuda del módulo de PowerShell de Configuration Manager. Crea un objeto de condición para la carpeta y que 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 .

$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

Este script de ejemplo crea la siguiente condición en el paso:

Folder C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US 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

-FolderDateTimeOperator

Cuando use el parámetro FolderTimestamp , use este parámetro para especificar el operador de la secuencia de tareas con el fin de evaluar la marca de tiempo de la carpeta.

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

-FolderPath

Especifique la ruta de acceso completa de la carpeta 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

-FolderTimestamp

Para evaluar la marca de tiempo de la carpeta, 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 FolderDateTimeOperator 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

-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

-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_FolderConditionExpression clase WMI de servidor.