Add-AzureEndpoint

Módulo:

Azure

Adiciona um ponto de extremidade 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

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

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

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

Add-AzureEndpoint
   [-Name] <String>
   [-Protocol] <String>
   [-LocalPort] <Int32>
   [-PublicPort <Int32>]
   [-DirectServerReturn <Boolean>]
   [-ACL <NetworkAclObject>]
   -LBSetName <String>
   -ProbePort <Int32>
   -ProbeProtocol <String>
   [-ProbePath <String>]
   [-ProbeIntervalInSeconds <Int32>]
   [-ProbeTimeoutInSeconds <Int32>]
   [-InternalLoadBalancerName <String>]
   [-IdleTimeoutInMinutes <Int32>]
   [-LoadBalancerDistribution <String>]
   [-VirtualIPName <String>]
   -VM <IPersistentVM>
   [-Profile <AzureSMProfile>]
   [-InformationAction <ActionPreference>]
   [-InformationVariable <String>]
   [<CommonParameters>]

Description

O cmdlet Add-AzureEndpoint adiciona um ponto de extremidade a um objeto de máquina virtual do Azure.

Exemplos

Exemplo 1: Adicionar um ponto de extremidade

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 | 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. Esse cmdlet adiciona um ponto de extremidade chamado HttpIn. O ponto de extremidade tem uma porta pública 80 e uma porta local 8080. O comando passa o objeto de máquina virtual para o cmdlet Update-AzureVM , que implementa suas alterações.

Exemplo 2: Adicionar um ponto de extremidade que pertence a um grupo com balanceamento de carga

PS C:\> Get-AzureVM -ServiceName "LoadBalancedService" -Name "VirtualMachine12" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -PublicPort 80 -LocalPort 8080 -LBSetName "WebFarm" -ProbePort 80 -ProbeProtocol "http" -ProbePath '/' | Update-AzureVM

Este comando recupera a configuração de uma máquina virtual chamada VirtualMachine07. O cmdlet atual adiciona um ponto de extremidade chamado HttpIn. O ponto de extremidade tem uma porta pública 80 e uma porta local 8080. O ponto de extremidade pertence ao grupo de balanceamento de carga compartilhado chamado WebFarm. Um teste HTTP na porta 80 com um caminho de '/' monitora a disponibilidade do ponto de extremidade. O comando implementa as alterações.

Exemplo 3: Associar um IP virtual a um ponto de extremidade

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirtualMachine25" | Add-AzureEndpoint -Name "HttpIn" -Protocol "tcp" -LocalPort 8080 -PublicPort 80 -VirtualIPName "ContosoVip11" | Update-AzureVM

Este comando recupera a configuração de uma máquina virtual chamada VirtualMachine25. O cmdlet atual adiciona um ponto de extremidade chamado HttpIn. O ponto de extremidade tem uma porta pública 80 e uma porta local 8080. Esse comando associa um IP virtual ao ponto de extremidade. O comando implementa as alterações.

Parâmetros

-ACL

Especifica um objeto de configuração de lista de controle de acesso (ACL) para o ponto de extremidade.

Type:	NetworkAclObject
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProbe

Indica que esse cmdlet usa a configuração de teste padrão.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
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

-LBSetName

Especifica o nome do balanceador de carga definido para o ponto de extremidade.

Type:	String
Aliases:	LoadBalancedEndpointSetName
Position:	Named
Default value:	None
Required:	True
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

Especifica um nome para o ponto de extremidade.

Type:	String
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-NoProbe

Indica que esse cmdlet usa a configuração sem teste.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ProbeIntervalInSeconds

Especifica o intervalo de sondagem do teste, em segundos, para o ponto de extremidade.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProbePath

Especifica o caminho relativo para o teste HTTP.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ProbePort

Especifica a porta que o ponto de extremidade usa.

Type:	Int32
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ProbeProtocol

Especifica o protocolo de porta. Os valores válidos são:

• tcp
• http

Type:	String
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-ProbeTimeoutInSeconds

Especifica o período de tempo limite de sondagem do teste em segundos.

Type:	Int32
Position:	Named
Default value:	None
Required:	False
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:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-PublicPort

Especifica a porta pública que o ponto de extremidade usa. Se você não especificar um valor, o Azure atribuirá uma porta disponível.

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

Saídas

Object

Links Relacionados

• Add-AzureVirtualIP
• Get-AzureEndpoint
• Get-AzureVM
• Remove-AzureEndpoint
• Set-AzureEndpoint
• Update-AzureVM