Compartilhar via

Update-AzureApplicationGateway

  • Referência
Módulo:
Azure

Atualiza um gateway de aplicativo.

Observação

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 herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo do 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 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.

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 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.

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.

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]
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.

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.

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