New-AzFrontDoorRulesEngineRuleObject

  • Referência
Módulo:
Az.FrontDoor

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 a ser passado para o parâmetro "-Action". Use o cmdlet "New-AzFrontDoorRulesEngineMatchConditionObject" para criar o objeto PSRulesEngineMatchCondition a ser passado 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 um 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.

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

-DefaultProfile

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

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

-MatchCondition

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

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

-MatchProcessingBehavior

Se essa regra for uma correspondência, o mecanismo de regras deve 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.

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

-Name

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

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

-Priority

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

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

Entradas

None

Saídas

PSRulesEngineRule