Compartilhar via

New-AzApplicationGatewayPathRuleConfig

Módulo:
Az.Network Module

Cria uma regra de caminho do gateway de aplicativo.

Sintaxe

SetByResourceId 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPoolId <String>]
    [-BackendHttpSettingsId <String>]
    [-RewriteRuleSetId <String>]
    [-RedirectConfigurationId <String>]
    [-FirewallPolicyId <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

SetByResource 

New-AzApplicationGatewayPathRuleConfig
    -Name <String>
    -Paths <String[]>
    [-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
    [-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
    [-RewriteRuleSet <PSApplicationGatewayRewriteRuleSet>]
    [-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
    [-FirewallPolicy <PSApplicationGatewayWebApplicationFirewallPolicy>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

O cmdlet New-AzApplicationGatewayPathRuleConfig cria uma regra de caminho do gateway de aplicativo. As regras criadas por esse cmdlet podem ser adicionadas a uma coleção de configurações de mapa de caminho de URL e, em seguida, atribuídas a um gateway. As configurações de mapa de caminho são usadas no balanceamento de carga do gateway de aplicativo.

Exemplos

Exemplo 1

$Gateway = Get-AzApplicationGateway -Name "ContosoApplicationGateway"
$AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
$HttpSettings = New-AzApplicationGatewayBackendHttpSetting -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
Add-AzApplicationGatewayUrlPathMapConfig -ApplicationGateway $Gateway -Name "ContosoUrlPathMap" -PathRules $PathRuleConfig -DefaultBackendAddressPool $AddressPool -DefaultBackendHttpSettings $HttpSettings

Esses comandos criam uma nova regra de caminho do gateway de aplicativo e usam o cmdlet Add-AzApplicationGatewayUrlPathMapConfig para atribuir essa regra a um gateway de aplicativo. Para fazer isso, o primeiro comando cria uma referência de objeto ao gateway ContosoApplicationGateway. Essa referência de objeto é armazenada em uma variável chamada $Gateway. Os dois comandos seguintes criam um pool de endereços de back-end e um objeto de configurações HTTP de back-end; esses objetos (armazenados nas variáveis $AddressPool e $HttpSettings) são necessários para criar um objeto de regra de caminho. O quarto comando cria o objeto de regra de caminho e é armazenado em uma variável chamada $PathRuleConfig. O quinto comando usa Add-AzApplicationGatewayUrlPathMapConfig para adicionar as configurações e a nova regra de caminho contida nessas configurações ao ContosoApplicationGateway.

Exemplo 2

$PathRuleConfig = New-AzApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings -FirewallPolicy $firewallPolicy

Esse comando cria uma regra de caminho com o Nome como "base", Caminhos como "/base", BackendAddressPool como $AddressPool, BackendHttpSettings como $HttpSettings e FirewallPolicy como $firewallPolicy.ngs e a nova regra de caminho contida nessas configurações para ContosoApplicationGateway.

Parâmetros

-BackendAddressPool

Especifica uma referência de objeto a uma coleção de configurações de pool de endereços de back-end a serem adicionadas às configurações de configuração de regras de caminho do gateway. Você pode criar essa referência de objeto usando o cmdlet New-AzApplicationGatewayBackendAddressPool e a sintaxe semelhantes a esta: $AddressPool = New-AzApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2" O comando anterior adiciona dois endereços IP (192.16.1.1 e 192.168.1.2) ao pool de endereços. Observe que o endereço IP está entre aspas e separado usando vírgulas. A variável resultante, $AddressPool, pode ser usada como o valor do parâmetro DefaultBackendAddressPool . O pool de endereços de back-end representa os endereços IP nos servidores de back-end. Esses endereços IP devem pertencer à sub-rede de rede virtual ou devem ser endereços IP públicos. Se você usar esse parâmetro, não poderá usar o parâmetro DefaultBackendAddressPoolId no mesmo comando.

Propriedades do parâmetro

Tipo:PSApplicationGatewayBackendAddressPool
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BackendAddressPoolId

Especifica a ID de um pool de endereços de back-end existente que pode ser adicionado às configurações de configuração da regra de caminho do gateway. As IDs do pool de endereços podem ser retornadas usando o cmdlet Get-AzApplicationGatewayBackendAddressPool. Depois de ter a ID, você poderá usar o parâmetro DefaultBackendAddressPoolId em vez do parâmetro DefaultBackendAddressPool . Por exemplo: -DefaultBackendAddressPoolId "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendAddressPools/ContosoAddressPool" O pool de endereços de back-end representa os endereços IP nos servidores de back-end. Esses endereços IP devem pertencer à sub-rede de rede virtual ou devem ser endereços IP públicos.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BackendHttpSettings

Especifica uma referência de objeto a uma coleção de configurações HTTP de back-end a serem adicionadas às configurações de configuração da regra de caminho do gateway. Você pode criar essa referência de objeto usando o cmdlet New-AzApplicationGatewayBackendHttpSettings e a sintaxe semelhantes a este: $HttpSettings = New-AzApplicationGatewayBackendHttpSettings -Name "ContosoHttpSettings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Desabilitado" A variável resultante, $HttpSettings, pode ser usado como o valor do parâmetro para o parâmetro DefaultBackendAddressPool : -DefaultBackendHttpSettings $HttpSettings As configurações HTTP de back-end configuram propriedades como porta, protocolo e afinidade baseada em cookie para um pool de back-end. Se você usar esse parâmetro, não poderá usar o parâmetro DefaultBackendHttpSettingsId no mesmo comando.

Propriedades do parâmetro

Tipo:PSApplicationGatewayBackendHttpSettings
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-BackendHttpSettingsId

Especifica a ID de uma coleção de configurações HTTP de back-end existente que pode ser adicionada às configurações de configuração da regra de caminho do gateway. As IDs de configuração HTTP podem ser retornadas usando o cmdlet Get-AzApplicationGatewayBackendHttpSettings. Depois de ter a ID, você poderá usar o parâmetro DefaultBackendHttpSettingsId em vez do parâmetro DefaultBackendHttpSettings . Por exemplo: -DefaultBackendSettings ID "/subscriptions/39c54063-01d3-4abf-8f4c-234777bc1f10/resourceGroups/appgw-rg/providers/Microsoft.Network/applicationGateways/appgwtest/backendHttpSettingsCollection/ContosoHttpSettings" As configurações HTTP de back-end configuram propriedades como porta, protocolo, e afinidade baseada em cookie para um pool de back-end. Se você usar esse parâmetro, não poderá usar o parâmetro DefaultBackendHttpSettings no mesmo comando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usados para comunicação com o Azure.

Propriedades do parâmetro

Tipo:IAzureContextContainer
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:AzContext, AzureRmContext, AzureCredential

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FirewallPolicy

Especifica a referência de objeto a uma política de firewall de nível superior. A referência de objeto pode ser criada usando New-AzApplicationGatewayWebApplicationFirewallPolicy cmdlet. $firewallPolicy = New-AzApplicationGatewayFirewallPolicy -Name "wafPolicy1" -ResourceGroup "rgName" Uma política de firewall criada usando o cmdlet acima pode ser referenciada em um nível de regra de caminho. ele acima do comando criaria uma política padrão e regras gerenciadas. Em vez dos valores padrão, os usuários podem especificar PolicySettings, ManagedRules usando New-AzApplicationGatewayFirewallPolicySettings e New-AzApplicationGatewayFirewallPolicyManagedRules respectivamente.

Propriedades do parâmetro

Tipo:PSApplicationGatewayWebApplicationFirewallPolicy
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-FirewallPolicyId

Especifica a ID de um recurso de firewall de aplicativo Web de nível superior existente. As IDs da política de firewall podem ser retornadas usando o cmdlet Get-AzApplicationGatewayWebApplicationFirewallPolicy. Depois de termos a ID, você poderá usar o parâmetro FirewallPolicyId em vez do parâmetro FirewallPolicy . Por exemplo: -FirewallPolicyId /subscriptions/<subscription-id>/resourceGroups/<resource-group-id>/providers/Microsoft.Network/ApplicationGatewayWebApplicationFirewallPolicies/<firewallPolicyName>

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Name

Especifica o nome da configuração da regra de caminho que esse cmdlet cria.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Paths

Especifica uma ou mais regras de caminho do gateway de aplicativo.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RedirectConfiguration

RedirectConfiguration do gateway de aplicativo

Propriedades do parâmetro

Tipo:PSApplicationGatewayRedirectConfiguration
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RedirectConfigurationId

ID do gateway de aplicativo RedirectConfiguration

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RewriteRuleSet

RewriteRuleSet do gateway de aplicativo

Propriedades do parâmetro

Tipo:PSApplicationGatewayRewriteRuleSet
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResource
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-RewriteRuleSetId

ID do RewriteRuleSet do gateway de aplicativo

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

SetByResourceId
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Saídas

PSApplicationGatewayPathRule