Set-AzureEndpoint
Modifica um ponto de extremidade atribuído a uma máquina virtual.
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
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 esteja com 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
Este comando recupera a configuração de uma máquina virtual chamada VirtualMachine01 usando o cmdlet Get-AzureVM . O comando passa para o cmdlet atual usando o operador de pipeline. Este cmdlet modifica o ponto de extremidade chamado Web para escutar na porta 443. O comando passa o objeto de máquina virtual para o cmdlet Update-AzureVM , que implementa suas alterações.
Parâmetros
-ACL
Especifica um objeto de configuração de lista de controle de acesso (ACL) que esse cmdlet aplica ao ponto de extremidade.
Tipo: | NetworkAclObject |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-DirectServerReturn
Especifica se esse cmdlet permite o retorno direto do servidor. Especifique $True para habilitar ou $False para desabilitar.
Tipo: | Boolean |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-IdleTimeoutInMinutes
Especifica o período de tempo limite ocioso do TCP, em minutos, para o ponto de extremidade.
Tipo: | Int32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informação.
Os valores aceitáveis para este parâmetro são:
- Continuar
- Ignorar
- Informe-se
- SilenciosamenteContinue
- Parar
- Suspender
Tipo: | ActionPreference |
Aliases: | infa |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-InformationVariable
Especifica uma variável de informação.
Tipo: | String |
Aliases: | iv |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-InternalLoadBalancerName
Especifica o nome do balanceador de carga interno.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-LoadBalancerDistribution
Especifica o algoritmo de distribuição do balanceador de carga. Os valores válidos são:
- fonteIP. 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
- nenhuma. Uma afinidade de cinco tuplas: IP de origem, Porta de origem, IP de destino, Porta de destino, Protocolo
O valor padrão é none.
Tipo: | String |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 |
Position: | 2 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-Name
Especifica o nome do ponto de extremidade.
Tipo: | String |
Position: | 0 |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | False |
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 |
-Protocol
Especifica o protocolo do ponto de extremidade. Os valores válidos são:
- tcp
- UDP
Tipo: | String |
Position: | 1 |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-PublicPort
Especifica a porta pública que o ponto de extremidade usa.
Tipo: | Int32 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | 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 |
Position: | Named |
Default value: | None |
Necessário: | False |
Aceitar entrada de pipeline: | False |
Aceitar carateres universais: | False |
-VM
Especifica a máquina virtual à qual o ponto de extremidade pertence.
Tipo: | IPersistentVM |
Aliases: | InputObject |
Position: | Named |
Default value: | None |
Necessário: | True |
Aceitar entrada de pipeline: | True |
Aceitar carateres universais: | False |