Partager via


New-AzFrontDoorRulesEngineRuleObject

Créez un objet PSRulesEngineRule pour la création du moteur de règles.

Syntaxe

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

Description

Créez un objet PSRulesEngineRule pour la création du moteur de règles.

Utilisez l’applet de commande « New-AzFrontDoorRulesEngineActionObject » pour créer un objet PSRulesEngineAction à transmettre au paramètre « -Action ». Utilisez l’applet de commande « New-AzFrontDoorRulesEngineMatchConditionObject » pour créer un objet PSRulesEngineMatchCondition pour passer au paramètre « -MatchCondition ».

Exemples

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

Créez un objet PSRulesEngineRule et montrez comment afficher les sous-champs.

Exemple 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

Attendez-vous à la sortie lors de la transmission d’une valeur de priorité non valide.

Paramètres

-Action

Actions à effectuer sur la demande et la réponse si toutes les conditions de correspondance sont remplies.

Type:PSRulesEngineAction
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure.

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MatchCondition

Liste des conditions de correspondance qui doivent être remplies pour que les actions de cette règle s’exécutent. L’absence de conditions de correspondance signifie que les actions s’exécutent toujours.

Type:PSRulesEngineMatchCondition[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-MatchProcessingBehavior

Si cette règle est une correspondance, le moteur de règles continue à exécuter les règles restantes ou à arrêter. Les valeurs possibles sont Continuer et Arrêter. S’il n’est pas présent, la valeur par défaut est Continuer.

Type:PSMatchProcessingBehavior
Valeurs acceptées:Continue, Stop
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Name

Nom auquel faire référence à cette règle spécifique.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Priority

Priorité affectée à cette règle. Ne peut pas être négatif.

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

PSRulesEngineRule