Set-AzureEndpoint
Modifica um ponto de extremidade atribuído a uma máquina virtual.
Observação
Os cmdlets mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
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-AzureVMEste 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. Esse 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.
| Type: | NetworkAclObject |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DirectServerReturn
Especifica se esse cmdlet habilita o retorno direto do servidor. Especifique $True habilitar ou $False desabilitar.
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-IdleTimeoutInMinutes
Especifica o período de tempo limite ocioso TCP, em minutos, para o ponto de extremidade.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationAction
Especifica como esse cmdlet responde a um evento de informações.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Stop
- Suspend
| Type: | ActionPreference |
| Aliases: | infa |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InformationVariable
Especifica uma variável de informação.
| Type: | String |
| Aliases: | iv |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InternalLoadBalancerName
Especifica o nome do balanceador de carga interno.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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
- nenhum. Uma afinidade de cinco tuplas: IP de origem, porta de origem, IP de destino, porta de destino, protocolo
O valor padrão é none.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | Int32 |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Name
Especifica o nome do ponto de extremidade.
| Type: | String |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Protocol
Especifica o protocolo do ponto de extremidade. Os valores válidos são:
- tcp
- udp
| Type: | String |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PublicPort
Especifica a porta pública que o ponto de extremidade usa.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-VM
Especifica a máquina virtual à qual o ponto de extremidade pertence.
| Type: | IPersistentVM |
| Aliases: | InputObject |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |