Compartilhar via


New-AzFrontDoorRulesEngineRuleObject

Crie um objeto PSRulesEngineRule para a criação do Mecanismo de Regras.

Sintaxe

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

Description

Crie um objeto PSRulesEngineRule para a criação do Mecanismo de Regras.

Use o cmdlet "New-AzFrontDoorRulesEngineActionObject" para criar o objeto PSRulesEngineAction para passar para o parâmetro "-Action". Use o cmdlet "New-AzFrontDoorRulesEngineMatchConditionObject" para criar o objeto PSRulesEngineMatchCondition para passar para o parâmetro "-MatchCondition".

Exemplos

Exemplo 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}

Crie um novo objeto PSRulesEngineRule e demonstre como ver os subcampos.

Exemplo 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

Espere a saída ao passar o valor de prioridade inválido.

Parâmetros

-Action

Ações a serem executadas na solicitação e resposta se todas as condições de correspondência forem atendidas.

Tipo:PSRulesEngineAction
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MatchCondition

Uma lista de condições de correspondência que devem atender para que as ações dessa regra seja executada. Não ter condições de correspondência significa que as ações sempre serão executadas.

Tipo:PSRulesEngineMatchCondition[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-MatchProcessingBehavior

Se essa regra for uma correspondência, o mecanismo de regras continuará executando as regras restantes ou parando. Os valores possíveis são Continuar e Parar. Se não estiver presente, o padrão será Continuar.

Tipo:PSMatchProcessingBehavior
Valores aceitos:Continue, Stop
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Um nome para se referir a essa regra específica.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Priority

Uma prioridade atribuída a essa regra. Não pode ser negativo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

PSRulesEngineRule