Compartilhar via

Update-AzureApplicationGateway

  • Referência
Módulo:
Azure

Atualiza um gateway de aplicativo.

Observação

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

O módulo do Az PowerShell é o módulo recomendado do PowerShell 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 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, você não precisa interromper 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-GatewaySize

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

  • Small
  • Médio
  • grande
Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-InstanceCount

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

Tipo:UInt32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Name

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-Profile

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

Tipo:AzureSMProfile
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Subnets

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

Você não pode atualizar sub-redes enquanto o gateway de aplicativo está em execução. Para interromper o gateway de aplicativo, use o cmdlet Stop-AzureApplicationGateway.

Tipo:List<T>[String]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-VnetName

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

Você não pode atualizar uma rede virtual enquanto o gateway de aplicativo está em execução. Para interromper o gateway de aplicativo, use Stop-AzureApplicationGateway.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Saídas

Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse