New-CMTSStepConditionFolder

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

Syntax

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 Use the task sequence editor: Conditions.

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 los cmdlets de Configuration Manager desde la unidad de sitio de Configuration Manager, por ejemplo PS XYZ:\> . Para obtener más información, vea getting started.

Ejemplos

Ejemplo 1

En este ejemplo se comprueba la existencia y la marca de tiempo de la carpeta de archivos 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.

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

-DisableWildcardHandling

Este parámetro trata los caracteres comodín como valores de caracteres literales. No se puede combinar con ForceWildcardHandling.

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

-FolderDateTimeOperator

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

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

-FolderPath

Especifique la ruta de acceso completa de la carpeta para esta condición.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters: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.

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

-ForceWildcardHandling

Este parámetro procesa caracteres comodín y puede provocar un comportamiento inesperado (no recomendado). No se puede combinar con DisableWildcardHandling.

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

-WhatIf

Muestra lo que ocurriría si se ejecuta el cmdlet. El cmdlet no se ejecuta.

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

Entradas

Ninguno

Salidas

IResultObject

Notas

Para obtener más información sobre este objeto devuelto y sus propiedades, vea SMS_TaskSequence_FolderConditionExpression server WMI class.