New-CMTSRule

  • Referencia
Módulo:
ConfigurationManager

Cree una regla para agregar a un paso de secuencia de tareas Establecer variables dinámicas.

Syntax

New-CMTSRule
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-AssetTag <String>]
   [-MacAddress <String>]
   [-SerialNumber <String>]
   [-Uuid <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-DefaultGateway <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-Make <String>]
   [-Model <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
New-CMTSRule
   [-ReferencedVariableName <String>]
   [-ReferencedVariableOperator <VariableOperatorType>]
   [-ReferencedVariableValue <String>]
   -Variable <Hashtable>
   [-DisableWildcardHandling]
   [-ForceWildcardHandling]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Use este cmdlet para crear un objeto de regla que agregue a un paso de secuencia de tareas Establecer variables dinámicas. Para agregar reglas, use los cmdlets New-CMTSStepSetDynamicVariable o Set-CMTSStepSetDynamicVariable. Cuando la secuencia de tareas ejecuta este paso, evalúa las reglas dinámicas y las variables en orden. Cuando evalúa las reglas en el dispositivo específico, puede establecer variables de secuencia de tareas en función de esas reglas.

Hay cuatro tipos de reglas:

  • Equipo: evalúe los valores de la etiqueta de activo de hardware, UUID, número de serie o dirección MAC.
  • Ubicación: evalúe los valores de la puerta de enlace de red predeterminada.
  • Crear y modelar: evaluar valores para la realización y el modelo de un equipo.
  • Variable de secuencia detareas: agregue una variable de secuencia de tareas, una condición y un valor para evaluar.

Para obtener más información, vea Dynamic rules and variables.

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: Establecer el destino de descarga si se encuentra en Windows PE

En este ejemplo se crea la siguiente regla:

IF _SMSTSInWinPE equals "TRUE" THEN SET OSDDownloadDestinationLocationType = "TSCache"

A continuación, agrega esta regla a una instancia existente de este paso en una secuencia de tareas.

$tsrule = New-CMTSRule -Variable @{'OSDDownloadDestinationLocationType' = 'TSCache'} -ReferencedVariableName "_SMSTSInWinPE" -ReferencedVariableOperator equals -ReferencedVariableValue TRUE

$tsname = "Default IPU"
$tsstep = "Set Dynamic Variables"

Set-CMTSStepSetDynamicVariable -TaskSequenceName $tsname -StepName $tsstep -AddRule $tsrule

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

-AssetTag

Especifique una etiqueta Asset para el tipo de regla Equipo. El valor máximo es de 255 caracteres.

Por ejemplo, si establece este valor en 123456 , agrega la siguiente regla: IF Asset tag equals "123456" THEN

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

-DefaultGateway

Especifique la puerta de enlace predeterminada para el tipo de regla Location.

Por ejemplo, si establece este valor en 192.168.10.1 , agrega la siguiente regla: IF Default gateway equals "192.168.10.1" THEN

Type:String
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

-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

-MacAddress

Especifique la dirección MAC para el tipo de regla Equipo.

Por ejemplo, si establece este valor en 00:11:22:33:44:55 , agrega la siguiente regla: IF MAC address equals "00:11:22:33:44:55" THEN

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

-Make

Especifique el tipo de regla Make para el tipo de regla Make y Model. Para establecer el otro valor, use el parámetro Model. La regla evalúa true cuando ambos valores son true.

Puede usar caracteres comodín:

  • *: Varios caracteres
  • ?: Carácter único

Por ejemplo, si establece este valor en Surface y model en , agrega la siguiente **** * regla:IF Make equals "Surface" AND Model equals "*" THEN

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

-Model

Especifique el modelo para el tipo de regla Make y Model. Para establecer el otro valor, use el parámetro Make. La regla evalúa true cuando ambos valores son true.

Puede usar caracteres comodín:

  • *: Varios caracteres
  • ?: Carácter único

Por ejemplo, si establece este valor en * y make en , agrega la Surface siguiente regla: IF Make equals "Surface" AND Model equals "*" THEN

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

-ReferencedVariableName

Especifique la variable para el tipo de regla Variable de secuencia de tareas. Requiere que también establezca los parámetros ReferencedVariableOperator y ReferencedVariableValue.

Este nombre de variable puede ser una variable de secuencia de tareas integrada o una personalizada que haya creado. Para obtener más información, vea How to use task sequence variables in Configuration Manager.

Por ejemplo, si establece los siguientes valores:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

A continuación, agrega la siguiente regla: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableOperator

Especifique la condición para el tipo de regla Variable de secuencia de tareas. Requiere que también establezca los parámetros ReferencedVariableName y ReferencedVariableValue. Para los operadores disponibles, consulte la lista de valores aceptados para este parámetro.

Por ejemplo, si establece los siguientes valores:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

A continuación, agrega la siguiente regla: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-ReferencedVariableValue

Especifique el valor para el tipo de regla Variable de secuencia de tareas. Requiere que también establezca los parámetros ReferencedVariableName y ReferencedVariableOperator.

Por ejemplo, si establece los siguientes valores:

  • ReferencedVariableName: OSDRegisteredOrgName
  • ReferencedVariableOperator: Equals
  • ReferencedVariableValue: Contoso

A continuación, agrega la siguiente regla: IF OSDRegisteredOrgName equals "Contoso" THEN

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

-SerialNumber

Especifique un número de serie para el tipo de regla Equipo.

Por ejemplo, si establece este valor en 123456 , agrega la siguiente regla: IF Asset tag equals "123456" THEN

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

-Uuid

Especifique un UUID para el tipo de regla Equipo.

Por ejemplo, si establece este valor en de5ba380-f692-45e0-bbd3-0e40543b549e , agrega la siguiente regla: IF UUID equals "de5ba380-f692-45e0-bbd3-0e40543b549e" THEN

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

-Variable

Especifique las variables de secuencia de tareas existentes o personalizadas y los valores asociados que el paso debe establecer cuando la regla se evalúa en true.

Por ejemplo, si establece este valor en @{'OSDDownloadDestinationLocationType' = 'TSCache'} , agrega la siguiente variable después de la THEN regla: SET OSDDownloadDestinationLocationType = "TSCache"

Para especificar más de una variable en la misma tabla hash, use un delimitador de punto y coma ( ; ) . Por ejemplo: @{'OSDRegisteredUserName' = 'Contoso';'OSDRegisteredOrgName' = 'Contoso'}

Type:Hashtable
Aliases:Variables
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