New-AzureRmApplicationGatewayPathRuleConfig
Cria uma regra de caminho de gateway de aplicativo.
Aviso
O módulo AzureRM do PowerShell foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo Az PowerShell para garantir suporte e atualizações contínuos.
Embora o módulo AzureRM ainda possa funcionar, ele não é mais mantido ou suportado, colocando qualquer uso continuado a critério e risco do usuário. Consulte nossos recursos de migração para obter orientação sobre a transição para o módulo Az.
Sintaxe
New-AzureRmApplicationGatewayPathRuleConfig
-Name <String>
-Paths <System.Collections.Generic.List`1[System.String]>
[-BackendAddressPoolId <String>]
[-BackendHttpSettingsId <String>]
[-RedirectConfigurationId <String>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
New-AzureRmApplicationGatewayPathRuleConfig
-Name <String>
-Paths <System.Collections.Generic.List`1[System.String]>
[-BackendAddressPool <PSApplicationGatewayBackendAddressPool>]
[-BackendHttpSettings <PSApplicationGatewayBackendHttpSettings>]
[-RedirectConfiguration <PSApplicationGatewayRedirectConfiguration>]
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
Description
O cmdlet New-AzureRmApplicationGatewayPathRuleConfig cria uma regra de caminho do gateway de aplicativo. As regras criadas por esse cmdlet podem ser adicionadas a uma coleção de definições de configuração do mapa de caminho de URL e, em seguida, atribuídas a um gateway. As definições de configuração do mapa de caminho são usadas no balanceamento de carga do gateway de aplicativo.
Exemplos
Exemplo 1
PS C:\>$Gateway = Get-AzureRmApplicationGateway -Name "ContosoApplicationGateway"
PS C:\> $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -Name "ContosoAddressPool" -BackendIPAddresses "192.168.1.1", "192.168.1.2"
PS C:\> $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled"
PS C:\> $PathRuleConfig = New-AzureRmApplicationGatewayPathRuleConfig -Name "base" -Paths "/base" -BackendAddressPool $AddressPool -BackendHttpSettings $HttpSettings
PS C:\> Add-AzureRmApplicationGatewayUrlPathMapConfig -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-AzureRmApplicationGatewayUrlPathMapConfig para atribuir essa regra a um gateway de aplicativo. Para fazer isso, o primeiro comando cria uma referência de objeto para o gateway ContosoApplicationGateway. Essa referência de objeto é armazenada em uma variável chamada $Gateway. Os próximos dois comandos 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-AzureRmApplicationGatewayUrlPathMapConfig para adicionar as definições de configuração e a nova regra de caminho contida nessas configurações a ContosoApplicationGateway.
Parâmetros
-BackendAddressPool
Especifica uma referência de objeto a uma coleção de configurações do pool de endereços de back-end a ser adicionada às definições de configuração das regras de caminho do gateway.
Você pode criar essa referência de objeto usando o cmdlet New-AzureRmApplicationGatewayBackendAddressPool e sintaxe semelhante a esta: $AddressPool = New-AzureRmApplicationGatewayBackendAddressPool -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 por 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 back-end.
Esses endereços IP devem pertencer à sub-rede da 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.
Tipo: | PSApplicationGatewayBackendAddressPool |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-BackendAddressPoolId
Especifica a ID de um pool de endereços de back-end existente que pode ser adicionado às definições de configuração da regra de caminho do gateway. As IDs do pool de endereços podem ser retornadas usando o cmdlet Get-AzureRmApplicationGatewayBackendAddressPool. Depois de ter a ID, você pode 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 da rede virtual ou devem ser endereços IP públicos.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-BackendHttpSettings
Especifica uma referência de objeto a uma coleção de configurações HTTP de back-end a serem adicionadas às definições de configuração da regra de caminho do gateway. Você pode criar essa referência de objeto usando o cmdlet New-AzureRmApplicationGatewayBackendHttpSettings e sintaxe semelhante a esta: $HttpSettings = New-AzureRmApplicationGatewayBackendHttpSettings -Name "ContosoHttpSetings" -Port 80 -Protocol "Http" -CookieBasedAffinity "Disabled" A variável resultante, $HttpSettings, pode ser usada como o valor do parâmetro para o DefaultBackendAddressPool parâmetro: -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.
Tipo: | PSApplicationGatewayBackendHttpSettings |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-BackendHttpSettingsId
Especifica a ID de uma coleção de configurações HTTP de back-end existente que pode ser adicionada às definições de configuração da regra de caminho do gateway. As IDs de configuração HTTP podem ser retornadas usando o cmdlet Get-AzureRmApplicationGatewayBackendHttpSettings. Depois de ter a ID, você pode 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.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DefaultProfile
As credenciais, a conta, o locatário e a assinatura usados para comunicação com o azure.
Tipo: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Name
Especifica o nome da configuração da regra de caminho que este cmdlet cria.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Paths
Especifica uma ou mais regras de caminho do gateway de aplicativo.
Tipo: | List<T>[String] |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RedirectConfiguration
Redirecionamento do gateway de aplicativo
Tipo: | PSApplicationGatewayRedirectConfiguration |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-RedirectConfigurationId
ID do gateway de aplicativo RedirectConfiguration
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
Entradas
None
Saídas
Ligações Relacionadas
- Add-AzureRmApplicationGatewayUrlPathMapConfig
- Get-AzureRmApplicationGateway
- Get-AzureRmApplicationGatewayUrlPathMapConfig
- New-AzureRmApplicationGatewayBackendAddressPool
- New-AzureRmApplicationGatewayBackendHttpSettings
- New-AzureRmApplicationGatewayPathRuleConfig
- New-AzureRmApplicationGatewayUrlPathMapConfig
- Remove-AzureRmApplicationGatewayUrlPathMapConfig
- Set-AzureRmApplicationGatewayUrlPathMapConfig