Partager via

New-AzFrontDoorRoutingRuleObject

  • Référence
Module:
Az.FrontDoor

Créer un PSRoutingRuleObject pour la création de Front Door

Syntaxe

New-AzFrontDoorRoutingRuleObject
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -Name <String>
   -FrontendEndpointName <String[]>
   -BackendPoolName <String>
   [-AcceptedProtocol <PSProtocol[]>]
   [-PatternToMatch <String[]>]
   [-CustomForwardingPath <String>]
   [-ForwardingProtocol <String>]
   [-EnableCaching <Boolean>]
   [-QueryParameterStripDirective <String>]
   [-DynamicCompression <PSEnabledState>]
   [-EnabledState <PSEnabledState>]
   [-RulesEngineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
New-AzFrontDoorRoutingRuleObject
   -ResourceGroupName <String>
   -FrontDoorName <String>
   -Name <String>
   -FrontendEndpointName <String[]>
   [-AcceptedProtocol <PSProtocol[]>]
   [-PatternToMatch <String[]>]
   [-RedirectType <String>]
   [-RedirectProtocol <String>]
   [-CustomHost <String>]
   [-CustomPath <String>]
   [-CustomFragment <String>]
   [-CustomQueryString <String>]
   [-EnabledState <PSEnabledState>]
   [-RulesEngineName <String>]
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

Créer un PSRoutingRuleObject pour la création de Front Door

Exemples

Exemple 1 : Créer un OBJET PSRoutingRuleObject pour Front Door avec une règle de transfert

New-AzFrontDoorRoutingRuleObject -Name $routingRuleName -FrontDoorName $frontDoorName -ResourceGroupName $rgname -FrontendEndpointName "frontendEndpoint1" -BackendPoolName "backendPool1"

FrontendEndpointIds          : {/subscriptions/{subid}/resourceGroups/{rgname}/pro
                               viders/Microsoft.Network/frontDoors/{frontdoorname}/FrontendEndpoints/frontendEndpoint1}
AcceptedProtocols            : {Http, Https}
PatternsToMatch              : {/*}
HealthProbeSettings          :
RouteConfiguration           : Microsoft.Azure.Commands.FrontDoor.Models.PSForwardingConfiguration
EnabledState                 : Enabled
ResourceState                :
Id                           :
Name                         : {routingRuleName}
Type                         :

Exemple 2 : Créer un objet PSRoutingRuleObject pour la création de Front Door avec une règle de redirection

$customHost = "www.contoso.com"
$customPath = "/images/contoso.png"
$queryString = "field1=value1&field2=value2"
$destinationFragment = "section-header-2"
New-AzFrontDoorRoutingRuleObject -Name $routingRuleName -FrontDoorName $frontDoorName -ResourceGroupName $rgname -FrontendEndpointName "frontendEndpoint1" -CustomHost $customHost -CustomPath $customPath -CustomQueryString $queryString -CustomFragment $destinationFragment

FrontendEndpointIds          : {/subscriptions/{subid}/resourceGroups/{rgname}/pro
                               viders/Microsoft.Network/frontDoors/{frontdoorname}/FrontendEndpoints/frontendEndpoint1}
AcceptedProtocols            : {Http, Https}
PatternsToMatch              : {/*}
HealthProbeSettings          :
RouteConfiguration           : Microsoft.Azure.Commands.FrontDoor.Models.PSRedirectConfiguration
EnabledState                 : Enabled
ResourceState                :
Id                           :
Name                         : {routingRuleName}
Type                         :

Créer un PSRoutingRuleObject pour la création de Front Door

Paramètres

-AcceptedProtocol

Schémas de protocole correspondant à cette règle. La valeur par défaut est {Https, Http}

Type:PSProtocol[]
Valeurs acceptées:Http, Https
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-BackendPoolName

ID de ressource 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 <key>=<value>. 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 lorsque la mise en cache est activée. 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

-EnabledState

Indique s’il faut activer l’utilisation de cette règle. 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

-ForwardingProtocol

Le protocole utilisé par cette règle lors du transfert du trafic vers les back-ends 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

-FrontendEndpointName

Noms des points de terminaison frontaux associés à cette règle

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

-Name

Nom routingRule.

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

-PatternToMatch

Les modèles d’itinéraire de la règle, ne doivent pas avoir * sauf éventuellement après le final / à la fin du chemin. La valeur par défaut est /*

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

-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

-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

-RulesEngineName

Référence à une configuration spécifique du moteur de règles à appliquer à cet itinéraire.

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

Entrées

None

Sorties