Share via


New-AzFrontDoorRulesEngineRuleObject

Creare un oggetto PSRulesEngineRule per la creazione del motore regole.

Sintassi

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

Descrizione

Creare un oggetto PSRulesEngineRule per la creazione del motore regole.

Usare il cmdlet "New-AzFrontDoorRulesEngineActionObject" per creare un oggetto PSRulesEngineAction da passare al parametro "-Action". Usare il cmdlet "New-AzFrontDoorRulesEngineMatchConditionObject" per creare un oggetto PSRulesEngineMatchCondition da passare al parametro "-MatchCondition".

Esempio

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

Creare un nuovo oggetto PSRulesEngineRule e dimostrare come visualizzare i sottocampi.

Esempio 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

Prevedere l'output quando si passa un valore di priorità non valido.

Parametri

-Action

Azioni da eseguire sulla richiesta e sulla risposta se vengono soddisfatte tutte le condizioni di corrispondenza.

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

-DefaultProfile

Le credenziali, l’account, il tenant e la sottoscrizione usati per comunicare con Azure.

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

-MatchCondition

Elenco di condizioni di corrispondenza che devono essere soddisfatte affinché le azioni di questa regola vengano eseguite. Non avere condizioni di corrispondenza significa che le azioni verranno sempre eseguite.

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

-MatchProcessingBehavior

Se questa regola è una corrispondenza, il motore regole deve continuare a eseguire le regole rimanenti o arrestare. I valori possibili sono Continue e Stop. Se non è presente, l'impostazione predefinita è Continua.

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

-Name

Nome da fare riferimento a questa regola specifica.

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

-Priority

Priorità assegnata a questa regola. Non può essere negativo.

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

Input

None

Output

PSRulesEngineRule