Compartir a través de

Set-AzureEndpoint

  • Referencia
Módulo:
Azure

Modifica un punto de conexión asignado 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

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

El cmdlet Set-AzureEndpoint modifica un punto de conexión asignado a una máquina virtual de Azure. Puede especificar cambios en un punto de conexión que no tenga equilibrio de carga.

Ejemplos

Ejemplo 1: Modificación de un punto de conexión para escuchar en un puerto

PS C:\> Get-AzureVM -ServiceName "ContosoService" -Name "VirutalMachine01" | Set-AzureEndpoint -Name "Web" -PublicPort 443 -LocalPort 443 -Protocol tcp | 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 modifica el punto de conexión denominado Web para escuchar en el puerto 443. El comando pasa el objeto de máquina virtual al cmdlet Update-AzureVM , que implementa los cambios.

Parámetros

-ACL

Especifica un objeto de configuración de lista de control de acceso (ACL) que este cmdlet aplica al 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

-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
  • Ignore
  • Inquire
  • SilentlyContinue
  • Detención
  • 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

-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:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Name

Especifica el nombre del 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

-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:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-PublicPort

Especifica el puerto público que usa 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

-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