Partager via

New-AzFrontDoorRulesEngineActionObject

  • Référence
Module:
Az.FrontDoor

Créez un objet PSRulesEngineAction pour créer une règle de moteur de règles.

Syntaxe

New-AzFrontDoorRulesEngineActionObject
   [-RequestHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-ResponseHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzFrontDoorRulesEngineActionObject
   [-RequestHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-ResponseHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-CustomForwardingPath <String>]
   [-ForwardingProtocol <String>]
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -BackendPoolName <String>
   [-EnableCaching <Boolean>]
   [-QueryParameterStripDirective <String>]
   [-DynamicCompression <PSEnabledState>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzFrontDoorRulesEngineActionObject
   [-RequestHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-ResponseHeaderAction <System.Collections.Generic.List`1[Microsoft.Azure.Commands.FrontDoor.Models.PSHeaderAction]>]
   [-RedirectType <String>]
   [-RedirectProtocol <String>]
   [-CustomHost <String>]
   [-CustomPath <String>]
   [-CustomFragment <String>]
   [-CustomQueryString <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Créez un objet PSRulesEngineAction pour créer une règle de moteur de règles.

Utilisez l’applet de commande « New-AzFrontDoorHeaderActionObject » pour créer PSHeaderObjects pour passer les paramètres « -RequestHeaderActions » et « -ResponseHeaderActions ».

Exemples

Exemple 1

$headerActions = New-AzFrontDoorHeaderActionObject -HeaderActionType "Append" -HeaderName "X-Content-Type-Options" -Value "nosniff"
$headerActions

HeaderName             HeaderActionType Value
----------             ---------------- -----
X-Content-Type-Options           Append nosniff

$rulesEngineAction = New-AzFrontDoorRulesEngineActionObject -ResponseHeaderAction $headerActions
$rulesEngineAction

RequestHeaderActions ResponseHeaderActions    RouteConfigurationOverride
-------------------- ---------------------    --------------------------
{}                   {X-Content-Type-Options}

Créez une action de moteur de règles qui ajoute une valeur d’en-tête de réponse et indiquez comment afficher les propriétés de l’action du moteur de règles créée.

Exemple 2

$rulesEngineAction = New-AzFrontDoorRulesEngineActionObject -RequestHeaderAction $headerActions -ForwardingProtocol HttpsOnly -BackendPoolName mybackendpool -ResourceGroupName Jessicl-Test-RG -FrontDoorName jessicl-test-myappfrontend -QueryParameterStripDirective StripNone -DynamicCompression Disabled -EnableCaching $true
$rulesEngineAction

RequestHeaderAction            ResponseHeaderAction RouteConfigurationOverride
-------------------            -------------------- --------------------------
{headeraction1, headeraction2} {}                   Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration

$rulesEngineAction.RequestHeaderAction

HeaderName    HeaderActionType Value
----------    ---------------- -----
headeraction1        Overwrite
headeraction2           Append

$rulesEngineAction.ResponseHeaderAction
$rulesEngineAction.RouteConfigurationOverride

CustomForwardingPath         :
ForwardingProtocol           : HttpsOnly
BackendPoolId                : /subscriptions/47f4bc68-6fe4-43a2-be8b-dfd0e290efa2/resourceGroups/myresourcegroup/provi
                               ders/Microsoft.Network/frontDoors/myfrontdoor/BackendPools/mybackendpool
QueryParameterStripDirective : StripNone
DynamicCompression           : Disabled
EnableCaching                : True

Créez une action de moteur de règles qui transfère les requêtes à un pool principal spécifique et montrez comment afficher les propriétés de l’action du moteur de règles créée.

Exemple 3

$rulesEngineAction = New-AzFrontDoorRulesEngineActionObject -RedirectType Moved -RedirectProtocol MatchRequest -CustomHost www.contoso.com
$rulesEngineAction

RequestHeaderActions ResponseHeaderActions RouteConfigurationOverride
-------------------- --------------------- --------------------------
{}                   {}                    Microsoft.Azure.Commands.FrontDoor.Models.PSRedirectConfiguration

$rulesEngineAction.RouteConfigurationOverride

RedirectType      : Moved
RedirectProtocol  : MatchRequest
CustomHost        : www.contoso.com
CustomPath        :
CustomFragment    :
CustomQueryString :

Créez une action de moteur de règles qui redirige les requêtes vers un autre hôte et montrez comment afficher les propriétés de l’action du moteur de règles créée.

Paramètres

-BackendPoolName

Nom du BackendPool vers lequel cette règle est acheminée

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

-CustomForwardingPath

Chemin d’accès personnalisé utilisé pour réécrire les chemins de ressources mis en correspondance par cette règle. Laissez vide pour utiliser le chemin entrant.

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

-CustomFragment

Fragment à ajouter à l’URL de redirection. Le fragment fait partie de l’URL qui vient après #. N’incluez pas le #.

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

-CustomHost

Hôte à rediriger. Laissez vide pour utiliser l’hôte entrant comme hôte de destination.

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

-CustomPath

Chemin complet à rediriger. Le chemin d’accès ne peut pas être vide et doit commencer par /. Laissez vide pour utiliser le chemin entrant comme chemin de destination.

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

-CustomQueryString

Ensemble de chaînes de requête à placer dans l’URL de redirection. La définition de cette valeur remplace toute chaîne de requête existante ; laissez vide pour conserver la chaîne de requête entrante. La chaîne de requête doit être au format <clé>=<valeur> format. La première ? et & seront ajoutés automatiquement afin de ne pas les inclure dans le front, mais de séparer plusieurs chaînes de requête avec &.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
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

-DynamicCompression

Indique s’il faut activer la compression dynamique pour le contenu mis en cache. La valeur par défaut est Activée

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

-EnableCaching

Indique s’il faut activer la mise en cache pour cet itinéraire. La valeur par défaut est false

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

-ForwardingProtocol

Le protocole utilisé par cette règle lors du transfert du trafic vers des back-ends. La valeur par défaut est MatchRequest

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

-FrontDoorName

Nom de la porte d’entrée à laquelle appartient cette règle de routage.

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

-QueryParameterStripDirective

Traitement des termes de requête d’URL lors de la formation de la clé de cache. La valeur par défaut est StripAll

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

-RedirectProtocol

Protocole de la destination vers laquelle le trafic est redirigé. La valeur par défaut est MatchRequest

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

-RedirectType

Type de redirection utilisé par la règle lors de la redirection du trafic. La valeur par défaut est déplacée

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

-RequestHeaderAction

Liste des actions d’en-tête à appliquer de la demande de l’AFD à l’origine.

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

-ResourceGroupName

Nom du groupe de ressources dans lequel routingRule sera créé.

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

-ResponseHeaderAction

Liste des actions d’en-tête à appliquer de la réponse de l’AFD au client.

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

Entrées

None

Sorties