Share via


New-AzFrontDoorRulesEngineRuleObject

Cree un objeto PSRulesEngineRule para la creación del motor de reglas.

Syntax

New-AzFrontDoorRulesEngineRuleObject
   -Name <String>
   -Priority <Int32>
   -Action <PSRulesEngineAction>
   [-MatchProcessingBehavior <PSMatchProcessingBehavior>]
   [-MatchCondition <PSRulesEngineMatchCondition[]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Cree un objeto PSRulesEngineRule para la creación del motor de reglas.

Use el cmdlet "New-AzFrontDoorRulesEngineActionObject" para crear el objeto PSRulesEngineAction para pasar al parámetro "-Action". Use el cmdlet "New-AzFrontDoorRulesEngineMatchConditionObject" para crear un objeto PSRulesEngineMatchCondition para pasarlo al parámetro "-MatchCondition".

Ejemplos

Ejemplo 1

New-AzFrontDoorRulesEngineRuleObject -Name rules1 -Priority 0 -Action $rulesEngineAction -MatchProcessingBehavior Stop -MatchCondition $rulesEngineMatchCondition

Name                    : rules1
Priority                : 0
MatchProcessingBehavior : Stop
MatchCondition          : {Microsoft.Azure.Commands.FrontDoor.Models.PSRulesEngineMatchCondition}
Action                  : Microsoft.Azure.Commands.FrontDoor.Models.PSRulesEngineAction


$rulesEngineRule1.Action

RequestHeaderActions           ResponseHeaderActions RouteConfigurationOverride
--------------------           --------------------- --------------------------
{headeraction1, headeraction2} {}                    Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration

$rulesEngineRule1.MatchCondition[0]

RulesEngineMatchVariable : RequestHeader
RulesEngineMatchValue    : {allowoverride}
Selector                 : Rules-Engine-Route-Forward
RulesEngineOperator      : Equal
NegateCondition          : False
Transforms               : {Lowercase, Uppercase}

Cree un nuevo objeto PSRulesEngineRule y muestre cómo ver los subcampos.

Ejemplo 2

New-AzFrontDoorRulesEngineRuleObject -Name rules1 -Priority -1

New-AzFrontDoorRulesEngineRuleObject : Cannot validate argument on parameter 'Priority'. The -1 argument is less than the minimum allowed range of 0. Supply an argument that is greater than or equal to 0 and then try the command again.
At line:1 char:81
+ ... ule1 = New-AzFrontDoorRulesEngineRuleObject -Name rules1 -Priority -1
+                                                                        ~~
+ CategoryInfo          : InvalidData: (:) [New-AzFrontDoorRulesEngineRuleObject], ParameterBindingValidationException
+ FullyQualifiedErrorId : ParameterArgumentValidationError,Microsoft.Azure.Commands.FrontDoor.Cmdlets.NewFrontDoorRulesEngineRuleObject

Se espera la salida al pasar un valor de prioridad no válido.

Parámetros

-Action

Acciones que se deben realizar en la solicitud y respuesta si se cumplen todas las condiciones de coincidencia.

Type:PSRulesEngineAction
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Credenciales, cuenta, inquilino y suscripción usados para la comunicación con Azure.

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchCondition

Lista de condiciones de coincidencia que deben cumplirse para que se ejecuten las acciones de esta regla. No tener condiciones de coincidencia significa que las acciones siempre se ejecutarán.

Type:PSRulesEngineMatchCondition[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchProcessingBehavior

Si esta regla es una coincidencia, el motor de reglas seguirá ejecutando las reglas restantes o deténgase. Los valores posibles son Continue y Stop. Si no está presente, el valor predeterminado es Continuar.

Type:PSMatchProcessingBehavior
Accepted values:Continue, Stop
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Un nombre para hacer referencia a esta regla específica.

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

-Priority

Prioridad asignada a esta regla. No puede ser negativo.

Type:Int32
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Salidas

PSRulesEngineRule