Compartir a través de

Add-AzureEndpoint

  • Referencia
Módulo:
Azure

Agrega un punto de conexión a una máquina virtual.

Nota:

Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.

El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.

Sintaxis

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

El cmdlet Add-AzureEndpoint agrega un punto de conexión a un objeto de máquina virtual de Azure.

Ejemplos

Ejemplo 1: Agregar un punto de conexión

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

Este comando recupera la configuración de una máquina virtual denominada VirtualMachine01 mediante el cmdlet Get-AzureVM . El comando lo pasa al cmdlet actual mediante el operador de canalización. Este cmdlet agrega un punto de conexión denominado HttpIn. El punto de conexión tiene un puerto público 80 y un puerto local 8080. El comando pasa el objeto de máquina virtual al cmdlet Update-AzureVM , que implementa los cambios.

Ejemplo 2: Adición de un punto de conexión que pertenece a un grupo de carga equilibrada

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 la configuración de una máquina virtual denominada VirtualMachine07. El cmdlet actual agrega un punto de conexión denominado HttpIn. El punto de conexión tiene un puerto público 80 y un puerto local 8080. El punto de conexión pertenece al grupo de carga equilibrada compartido denominado WebFarm. Un sondeo HTTP en el puerto 80 con una ruta de acceso de "/" supervisa la disponibilidad del punto de conexión. El comando implementa los cambios.

Ejemplo 3: Asociar una dirección IP virtual a un punto de conexión

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 la configuración de una máquina virtual denominada VirtualMachine25. El cmdlet actual agrega un punto de conexión denominado HttpIn. El punto de conexión tiene un puerto público 80 y un puerto local 8080. Este comando asocia una dirección IP virtual al punto de conexión. El comando implementa los cambios.

Parámetros

-ACL

Especifica un objeto de configuración de lista de control de acceso (ACL) para el punto de conexión.

Tipo:NetworkAclObject
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProbe

Indica que este cmdlet usa la configuración de sondeo predeterminada.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DirectServerReturn

Especifica si este cmdlet habilita la devolución directa del servidor. Especifique $True para habilitar o $False deshabilitar.

Tipo:Boolean
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-IdleTimeoutInMinutes

Especifica el período de tiempo de espera de inactividad de TCP, en minutos, para el punto de conexión.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationAction

Especifica cómo responde este cmdlet a un evento de información.

Los valores permitidos para este parámetro son los siguientes:

  • Continuar
  • Ignorar
  • Inquire
  • SilentlyContinue
  • Stop
  • Suspender
Tipo:ActionPreference
Alias:infa
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InformationVariable

Especifica una variable de información.

Tipo:String
Alias:iv
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-InternalLoadBalancerName

Especifica el nombre del equilibrador de carga interno.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LBSetName

Especifica el nombre del equilibrador de carga establecido para el punto de conexión.

Tipo:String
Alias:LoadBalancedEndpointSetName
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LoadBalancerDistribution

Especifica el algoritmo de distribución del equilibrador de carga. Los valores válidos son:

  • sourceIP. Una afinidad de dos tuplas: IP de origen, IP de destino
  • sourceIPProtocol. Una afinidad de tres tuplas: IP de origen, IP de destino, protocolo
  • ninguno. Una afinidad de cinco tuplas: IP de origen, puerto de origen, IP de destino, puerto de destino, protocolo

El valor predeterminado no es ninguno.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-LocalPort

Especifica el puerto local, privado y que usa este punto de conexión. Las aplicaciones dentro de la máquina virtual escuchan en este puerto para las solicitudes de entrada de servicio para este punto de conexión.

Tipo:Int32
Posición:2
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica un nombre para el punto de conexión.

Tipo:String
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-NoProbe

Indica que este cmdlet usa la configuración sin sondeo.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProbeIntervalInSeconds

Especifica el intervalo de sondeo de sondeo, en segundos, para el punto de conexión.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProbePath

Especifica la ruta de acceso relativa al sondeo HTTP.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProbePort

Especifica el puerto que usa el punto de conexión.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProbeProtocol

Especifica el protocolo de puerto. Los valores válidos son:

  • tcp
  • http
Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-ProbeTimeoutInSeconds

Especifica el período de tiempo de espera de sondeo de sondeo en segundos.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Profile

Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.

Tipo:AzureSMProfile
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Protocol

Especifica el protocolo del punto de conexión. Los valores válidos son:

  • tcp
  • UDP
Tipo:String
Posición:1
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublicPort

Especifica el puerto público que usa el punto de conexión. Si no especifica un valor, Azure asigna un puerto disponible.

Tipo:Int32
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VirtualIPName

Especifica el nombre de una dirección IP virtual que Azure asocia al punto de conexión. El servicio puede tener varias direcciones IP virtuales. Para crear direcciones IP virtuales, use el cmdlet Add-AzureVirtualIP .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-VM

Especifica la máquina virtual a la que pertenece el punto de conexión.

Tipo:IPersistentVM
Alias:InputObject
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

Salidas

Object