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.