Freigeben über


New-AzFrontDoorRulesEngineRuleObject

Erstellen Sie ein PSRulesEngineRule-Objekt für die Erstellung des Regelmoduls.

Syntax

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

Beschreibung

Erstellen Sie ein PSRulesEngineRule-Objekt für die Erstellung des Regelmoduls.

Verwenden Sie das Cmdlet "New-AzFrontDoorRulesEngineActionObject", um PSRulesEngineAction-Objekt zu erstellen, um an den Parameter "-Action" zu übergeben. Verwenden Sie das Cmdlet "New-AzFrontDoorRulesEngineMatchConditionObject", um PSRulesEngineMatchCondition-Objekt zu erstellen, um an den Parameter "-MatchCondition" zu übergeben.

Beispiele

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

Erstellen Sie ein neues PSRulesEngineRule-Objekt, und veranschaulichen Sie, wie Sie die Unterfelder anzeigen.

Beispiel 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

Erwarten Sie die Ausgabe beim Übergeben eines ungültigen Prioritätswerts.

Parameter

-Action

Aktionen, die für die Anforderung und Antwort ausgeführt werden sollen, wenn alle Übereinstimmungsbedingungen erfüllt sind.

Typ:PSRulesEngineAction
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Typ:IAzureContextContainer
Aliase:AzContext, AzureRmContext, AzureCredential
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MatchCondition

Eine Liste der Übereinstimmungsbedingungen, die erfüllt werden müssen, damit die Aktionen dieser Regel ausgeführt werden können. Wenn keine Übereinstimmungsbedingungen vorhanden sind, werden die Aktionen immer ausgeführt.

Typ:PSRulesEngineMatchCondition[]
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-MatchProcessingBehavior

Wenn es sich bei dieser Regel um eine Übereinstimmung handelt, sollte das Regelmodul die verbleibenden Regeln weiterhin ausführen oder beenden. Mögliche Werte sind "Continue" und "Stop". Wenn sie nicht vorhanden ist, wird standardmäßig "Weiter" festgelegt.

Typ:PSMatchProcessingBehavior
Zulässige Werte:Continue, Stop
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Ein Name, der auf diese bestimmte Regel verweist.

Typ:String
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Priority

Eine dieser Regel zugewiesene Priorität. Kann nicht negativ sein.

Typ:Int32
Position:Named
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Eingaben

None

Ausgaben

PSRulesEngineRule