New-CMTSRule
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