Compartir a través de

New-AzFrontDoorRoutingRuleObject

  • Referencia
Módulo:
Az.FrontDoor

Crear un objeto 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

Crear un objeto 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                         :

Crear un objeto PSRoutingRuleObject para la creación de Front Door

Parámetros

-AcceptedProtocol

Esquemas de protocolos que deben coincidir 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 del 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

La ruta de acceso personalizada usada para reescribir las rutas de acceso del recurso con las que coincide esta regla. Déjela en blanco 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

Credenciales, cuenta, inquilino y suscripción usados 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 desea habilitar la compresión dinámica para el contenido almacenado en caché cuando el almacenamiento en caché está habilitado. 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 desea habilitar 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

Si desea 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 al valor predeterminado de back-ends es MatchRequest.

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

-FrontDoorName

El nombre de Front Door al 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 con 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 debe tener ningún *, excepto, posiblemente, después de la última / 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 la consulta de 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

El nombre del grupo de recursos donde 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