Update-AzureApplicationGateway

Atualiza um gateway de aplicativo.

Observação

Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.

Syntax

Update-AzureApplicationGateway
      -Name <String>
      [-VnetName <String>]
      [-Subnets <System.Collections.Generic.List`1[System.String]>]
      [-InstanceCount <UInt32>]
      [-GatewaySize <String>]
      [-Description <String>]
      [-Profile <AzureSMProfile>]
      [<CommonParameters>]

Description

O cmdlet Update-AzureApplicationGateway atualiza um gateway de aplicativo existente.

Exemplos

Exemplo 1: Modificar um gateway de aplicativo usando seu nome

PS C:\> Stop-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -VnetName "VirutalNetwork18" -Subnets @("Subnet05", "Subnet06")

O primeiro comando interrompe o gateway de aplicativo chamado ApplicationGateway06. Um gateway de aplicativo deve ser interrompido para que você possa modificar a rede virtual ou sub-redes.

O segundo comando modifica a sub-rede virtual e as sub-redes do gateway de aplicativo chamado ApplicationGateway06.

Exemplo 2: Modificar propriedades adicionais de um gateway de aplicativo

PS C:\> Update-AzureApplicationGateway -Name "ApplicationGateway06" -InstanceCount 2 -GatewaySize "Large" -Description "Updated application gateway"

Esse comando modifica a contagem de instâncias, o tamanho do gateway e a descrição do gateway de aplicativo chamado ApplicationGateway06. Esse comando não modifica a rede virtual ou as sub-redes do gateway de aplicativo. Portanto, não é necessário parar o gateway de aplicativo antes de executar esse comando.

Exemplo 3: Modificar um gateway de aplicativo usando o pipeline

PS C:\> $ApplicationGateway = Get-AzureApplicationGateway -Name "ApplicationGateway06"
PS C:\> $ApplicationGateway.GatewaySize = "Medium"
PS C:\> $ApplicationGateway | Update-AzureApplicationGateway

O primeiro comando obtém o gateway de aplicativo chamado ApplicationGateway06 usando o cmdlet Get-AzureApplicationGateway . O comando o armazena na variável $ApplicationGateway.

O segundo comando atribui à propriedade GatewaySize o valor Medium.

O comando final passa o $ApplicationGateway atualizado para o cmdlet atual.

Parâmetros

-Description

Especifica uma descrição que esse cmdlet atribui ao gateway de aplicativo.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-GatewaySize

Especifica o tamanho que esse cmdlet atribui ao gateway de aplicativo. Os valores válidos são:

  • Pequeno
  • Médio
  • grande
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-InstanceCount

Especifica o número de instâncias que esse cmdlet atribui ao gateway de aplicativo.

Type:UInt32
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Name

Especifica o nome do gateway de aplicativo que esse cmdlet atualiza.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Subnets

Especifica uma matriz de sub-redes na qual esse cmdlet implanta o gateway de aplicativo.

Não é possível atualizar sub-redes enquanto o gateway de aplicativo está em execução. Para parar o gateway de aplicativo, use o cmdlet Stop-AzureApplicationGateway.

Type:List<T>[String]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-VnetName

Especifica a rede virtual na qual esse cmdlet implanta o gateway de aplicativo.

Não é possível atualizar uma rede virtual enquanto o gateway de aplicativo está em execução. Para parar o gateway de aplicativo, use Stop-AzureApplicationGateway.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Saídas

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse