Compartir a través de

New-CMTSRule

  • Referencia
Módulo:
ConfigurationManager

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

Sintaxis

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 basadas en esas reglas.

Hay cuatro tipos de reglas:

  • Equipo: evalúe los valores de etiqueta de recurso 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: evalúe los valores de la creación y el modelo de un equipo.
  • Variable de secuencia de tareas: agregue una variable de secuencia de tareas, una condición y un valor para evaluar.

Para obtener más información, vea Reglas y variables dinámicas.

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: Establecer el destino de descarga si 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

-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

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

-DefaultGateway

Especifique la puerta de enlace predeterminada para el tipo de regla Ubicación .

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

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

-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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Make

Especifique el tipo de regla Make (Crear) y Model (Modelo ). Para establecer el otro valor, use el parámetro Model . La regla se evalúa como true cuando ambos valores son true.

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 se evalúa como true cuando ambos valores son true.

Puede usar caracteres comodín:

  • *: varios caracteres
  • ?: carácter único

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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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, consulte Uso de variables de secuencia de tareas en 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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 conocer 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

Tipo:VariableOperatorType
Valores aceptados:Exists, NotExists, Equals, NotEquals, Greater, GreaterEqual, Less, LessEqual, Like, NotLike
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ReferencedVariableValue

Especifique el valor del 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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín: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 como true.

Por ejemplo, si establece este valor en @{'OSDDownloadDestinationLocationType' = 'TSCache'}, agrega la siguiente variable después de la THEN de la 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'}

Tipo:Hashtable
Alias:Variables
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