Compartir a través de

New-AzFrontDoorRoutingRuleObject

  • Referencia
Módulo:
Az.FrontDoor

Creación de un PSRoutingRuleObject para la creación de Front Door

Sintaxis

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

Creación de un PSRoutingRuleObject para la creación de Front Door

Ejemplos

Ejemplo 1: Creación de un PSRoutingRuleObject para la creación de Front Door con una regla de reenvío

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                         :

Ejemplo 2: Creación de un PSRoutingRuleObject para la creación de Front Door con una regla de redirección

$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                         :

Creación de un PSRoutingRuleObject para la creación de Front Door

Parámetros

-AcceptedProtocol

Esquemas de protocolo que coincidirán con esta regla. El valor predeterminado es {Https, Http}

Tipo:PSProtocol[]
Valores aceptados:Http, Https
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-BackendPoolName

Identificador de recurso de backendPool al que se enruta esta regla

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomForwardingPath

Ruta de acceso personalizada que se usa para reescribir las rutas de acceso de recursos coincidentes con esta regla. Deje vacío para usar la ruta de acceso entrante.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomFragment

Fragmento que se va a agregar a la dirección URL de redireccionamiento. El fragmento es la parte de la dirección URL que viene después de #. No incluya #.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomHost

Host para redirigir. Deje vacío para usar el host entrante como host de destino.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomPath

Ruta de acceso completa que se va a redirigir. La ruta de acceso no puede estar vacía y debe comenzar con /. Deje vacío para usar la ruta de acceso entrante como ruta de acceso de destino.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-CustomQueryString

Conjunto de cadenas de consulta que se colocarán en la dirección URL de redireccionamiento. Establecer este valor reemplazaría cualquier cadena de consulta existente; deje vacío para conservar la cadena de consulta entrante. La cadena de consulta debe estar en <key>=<value> formato. ¿La primera? y & se agregarán automáticamente, por lo que no los incluyan en el frente, pero separe varias cadenas de consulta con &.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure.

Tipo:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DynamicCompression

Si se habilita la compresión dinámica para el contenido almacenado en caché cuando se habilita el almacenamiento en caché. El valor predeterminado es Enabled

Tipo:PSEnabledState
Valores aceptados:Enabled, Disabled
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnableCaching

Si se habilita el almacenamiento en caché para esta ruta. El valor predeterminado es false

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-EnabledState

Indica si se va a habilitar el uso de esta regla. El valor predeterminado es Enabled

Tipo:PSEnabledState
Valores aceptados:Enabled, Disabled
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ForwardingProtocol

El protocolo que usará esta regla al reenviar el tráfico a back-end El valor predeterminado es MatchRequest.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FrontDoorName

Nombre de la instancia de Front Door a la que pertenece esta regla de enrutamiento.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-FrontendEndpointName

Los nombres de los puntos de conexión de front-end asociados a esta regla

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Nombre de RoutingRule.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PatternToMatch

Los patrones de ruta de la regla, no deben tener ningún * excepto posiblemente después de la final / al final de la ruta de acceso. El valor predeterminado es /*

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-QueryParameterStripDirective

El tratamiento de los términos de consulta url al formar la clave de caché. El valor predeterminado es StripAll

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RedirectProtocol

Protocolo del destino al que se redirige el tráfico. El valor predeterminado es MatchRequest

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RedirectType

El tipo de redireccionamiento que usará la regla al redirigir el tráfico. El valor predeterminado se mueve

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ResourceGroupName

Nombre del grupo de recursos en el que se creará routingRule.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RulesEngineName

Referencia a una configuración específica del motor de reglas que se aplicará a esta ruta.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

PSRoutingRule