Update-AzureApplicationGateway

  • Referência
Módulo:
Azure

Atualiza um gateway de aplicativo.

Nota

Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.

Sintaxe

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 antes que você possa modificar a rede virtual ou as sub-redes.

O segundo comando modifica a sub-rede virtual e as sub-redes para o 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"

Este comando modifica a contagem de instâncias, o tamanho do gateway e a descrição do gateway de aplicativo chamado ApplicationGateway06. Este comando não modifica a rede virtual ou sub-redes para o 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 armazena-o 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.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-GatewaySize

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

  • Pequena
  • Médio
  • Grande
Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-InstanceCount

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

Tipo:UInt32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Name

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

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-Profile

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

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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.

Tipo:List<T>[String]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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 estiver em execução. Para parar o gateway de aplicativo, use Stop-AzureApplicationGateway.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

String

Saídas

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse