New-CMTSStepConditionIfStatement

  • Referencia
Módulo:
ConfigurationManager

Cree una condición de instrucción if para un paso de secuencia de tareas.

Sintaxis

New-CMTSStepConditionIfStatement
   [-Condition <IResultObject[]>]
   -StatementType <ConditionStatementType>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear un objeto de condición de instrucción if 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.

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 usan primero los cmdlets New-CMTSStepConditionFile y New-CMTSStepConditionQueryWMI para crear objetos de condición secundarios. Pasa esos dos objetos al cmdlet New-CMTSStepConditionIfStatement y guarda ese objeto de condición.

A continuación, usa el cmdlet Set-CMTSStepSetDynamicVariable para agregar este objeto de condición al paso Establecer variables dinámicas de la secuencia de tareas de implementación del sistema operativo predeterminado .

$file = "C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\en-US\AdminUI.PS.dll-Help.xml"
$datetime = Get-Date ("August 2, 2021")
$conditionFile = New-CMTSStepConditionFile -FilePath $file -FileTimestamp $datetime -FileDateTimeOperator Greater

$model = "Latitude E7470"
$wmiQuery = "Select * From Win32_ComputerSystem Where Model = `"$Model`""
$conditionQuery = New-CMTSStepConditionQueryWMI -Namespace "root\cimv2" -Query $wmiQuery

$condition = New-CMTSStepConditionIfStatement -StatementType All -Condition $conditionFile,$conditionQuery

$tsNameOsd = "Default OS deployment"
$tsStepNameSetDynVar = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsNameOsd -StepName $tsStepNameSetDynVar -AddCondition $condition

If  All  the conditions are true:
    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"
    WMI Query  Select * From Win32_ComputerSystem Where Model = "Latitude E7470"

Parámetros

-Condition

Especifique uno o varios objetos de condición que se incluirán en este bloque de instrucciones if . Para obtener estos objetos anidados, use uno de los cmdlets New-CMTSStepCondition* . Por ejemplo, New-CMTSStepConditionFile.

Tipo:IResultObject[]
Alias:SubCondition, SubConditions
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-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

-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

-StatementType

Especifique el tipo de instrucción if que se va a crear. Hay tres tipos de comprobaciones que puede hacer con esta condición:

  • Si All las condiciones son verdaderas
  • Si Any las condiciones son verdaderas
  • Si None las condiciones son verdaderas
Tipo:ConditionStatementType
Alias:Operator
Valores aceptados:All, Any, None
Posición:Named
Valor predeterminado:None
Requerido:True
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_ConditionOperator clase WMI de servidor.