Compartilhar via

Set-AzureEndpoint

  • Referência
Módulo:
Azure

Modifica um ponto de extremidade atribuído a uma máquina virtual.

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

Set-AzureEndpoint
   [-Name] <String>
   [[-Protocol] <String>]
   [[-LocalPort] <Int32>]
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Set-AzureEndpoint modifica um ponto de extremidade atribuído a uma máquina virtual do Azure. Você pode especificar alterações em um ponto de extremidade que não tenha balanceamento de carga.

Exemplos

Exemplo 1: Modificar um ponto de extremidade para escutar em uma porta

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | Update-AzureVM

Esse comando recupera a configuração de uma máquina virtual chamada VirtualMachine01 usando o cmdlet Get-AzureVM . O comando o passa para o cmdlet atual usando o operador de pipeline. Esse cmdlet modifica o ponto de extremidade chamado Web para escutar na porta 443. O comando passa o objeto da máquina virtual para o cmdlet Update-AzureVM, que implementa suas alterações.

Parâmetros

-ACL

Especifica um objeto de configuração da lista de controle de acesso (ACL) que esse cmdlet aplica ao ponto de extremidade.

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

-DirectServerReturn

Especifica se esse cmdlet habilita o retorno direto do servidor. Especifique $True ativar ou $False desativar.

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

-IdleTimeoutInMinutes

Especifica o período de tempo limite ocioso do TCP, em minutos, para o ponto de extremidade.

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

-InformationAction

Especifica como esse cmdlet responde a um evento de informação.

Os valores aceitáveis para esse parâmetro são:

  • Continuar
  • Ignorar
  • Perguntar
  • SilentlyContinue
  • Stop
  • Suspend
Tipo:ActionPreference
Aliases:infa
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InformationVariable

Especifica uma variável de informação.

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

-InternalLoadBalancerName

Especifica o nome do balanceador de carga interno.

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

-LoadBalancerDistribution

Especifica o algoritmo de distribuição do balanceador de carga. Os valores válidos são:

  • sourceIP. Uma afinidade de duas tuplas: IP de origem, IP de destino
  • fonteIPProtocol. Uma afinidade de três tuplas: IP de origem, IP de destino, protocolo
  • nenhum. Uma afinidade de cinco tuplas: IP de origem, porta de origem, IP de destino, porta de destino, protocolo

O valor padrão é nenhum.

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

-LocalPort

Especifica a porta local, privada, que esse ponto de extremidade usa. Os aplicativos dentro da máquina virtual escutam nessa porta solicitações de entrada de serviço para esse ponto de extremidade.

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

-Name

Especifica o nome do ponto de extremidade.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
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

-Protocol

Especifica o protocolo do ponto de extremidade. Os valores válidos são:

  • TCP
  • udp
Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-PublicPort

Especifica a porta pública que o ponto de extremidade usa.

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

-VirtualIPName

Especifica o nome de um endereço IP virtual que o Azure associa ao ponto de extremidade. Seu serviço pode ter vários IPs virtuais. Para criar IPs virtuais, use o cmdlet Add-AzureVirtualIP .

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

-VM

Especifica a máquina virtual à qual o ponto de extremidade pertence.

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

Saídas

Object