Update-AzureApplicationGateway
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
Saídas
Microsoft.WindowsAzure.Management.ApplicationGateway.Models.ApplicationGatewayOperationResponse