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