Add-AzureEndpoint
Adiciona um ponto de extremidade a uma máquina virtual.
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
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.
Tipo: | NetworkAclObject |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DefaultProbe
Indica que esse cmdlet usa a configuração de teste padrão.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-DirectServerReturn
Especifica se esse cmdlet habilita o retorno direto do servidor. Especifique $True habilitar ou $False desabilitar.
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 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ções.
Os valores aceitáveis para esse parâmetro são:
- Continuar
- Ignorar
- Perguntar
- SilentlyContinue
- Parar
- 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 |
-LBSetName
Especifica o nome do balanceador de carga definido para o ponto de extremidade.
Tipo: | String |
Aliases: | LoadBalancedEndpointSetName |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
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:
- 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.
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: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-Name
Especifica um nome para o ponto de extremidade.
Tipo: | String |
Cargo: | 0 |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-NoProbe
Indica que esse cmdlet usa a configuração sem teste.
Tipo: | SwitchParameter |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProbeIntervalInSeconds
Especifica o intervalo de sondagem do teste, em segundos, 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 |
-ProbePath
Especifica o caminho relativo para o teste HTTP.
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProbePort
Especifica a porta que o ponto de extremidade usa.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProbeProtocol
Especifica o protocolo de porta. Os valores válidos são:
- TCP
- http
Tipo: | String |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | False |
-ProbeTimeoutInSeconds
Especifica o período de tempo limite de sondagem do teste em segundos.
Tipo: | Int32 |
Cargo: | Named |
Valor padrão: | None |
Obrigatório: | False |
Aceitar a entrada de pipeline: | False |
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 |
-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: | True |
Aceitar a entrada de pipeline: | False |
Aceitar caracteres curinga: | 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.
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 |