Partilhar via


New-AzFrontDoorRulesEngineRuleObject

Crie um objeto PSRulesEngineRule para a criação do mecanismo de regras.

Syntax

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
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters: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
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchCondition

Uma lista de condições de correspondência que devem ser atendidas para que as ações desta regra sejam executadas. Não ter condições de jogo significa que as ações serão sempre executadas.

Tipo:PSRulesEngineMatchCondition[]
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-MatchProcessingBehavior

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

Tipo:PSMatchProcessingBehavior
valores aceites:Continue, Stop
Position:Named
valor predefinido:None
Necessário:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

Tipo:String
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

-Priority

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

Tipo:Int32
Position:Named
valor predefinido:None
Necessário:True
Accept pipeline input:False
Accept wildcard characters:False

Entradas

None

Saídas

PSRulesEngineRule