ALTER ENDPOINT (Transact-SQL)

Se aplica a:SQL Server

Permite modificar un extremo existente de las siguientes formas:

  • Agregando un método nuevo a un extremo existente.

  • Modificando o quitando un método existente del extremo.

  • Cambiando las propiedades de un extremo.

Nota

En este tema se describen la sintaxis y los argumentos son específicos de ALTER ENDPOINT. Para obtener descripciones de los argumentos comunes a CREATE ENDPOINT y ALTER ENDPOINT, vea CREATE ENDPOINT (Transact-SQL).

Los servicios web XML nativos (extremos HTTP/SOAP) se han quitado a partir de SQL Server 2012 (11.x).

Convenciones de sintaxis de Transact-SQL

Sintaxis

  
ALTER ENDPOINT endPointName [ AUTHORIZATION login ]  
[ STATE = { STARTED | STOPPED | DISABLED } ]  
[ AS { TCP } ( <protocol_specific_items> ) ]  
[ FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (  
   <language_specific_items>  
        ) ]  
  
<AS TCP_protocol_specific_arguments> ::=  
AS TCP (  
  LISTENER_PORT = listenerPort  
  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]  
)  
<FOR SERVICE_BROKER_language_specific_arguments> ::=  
FOR SERVICE_BROKER (  
   [ AUTHENTICATION = {   
      WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]  
      | CERTIFICATE certificate_name   
      | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name   
      | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]   
    } ]  
   [ , ENCRYPTION = { DISABLED   
       |   
         {{SUPPORTED | REQUIRED }   
       [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] }   
   ]  
  
  [ , MESSAGE_FORWARDING = {ENABLED | DISABLED} ]  
  [ , MESSAGE_FORWARD_SIZE = forwardSize  
)  
  
<FOR DATABASE_MIRRORING_language_specific_arguments> ::=  
FOR DATABASE_MIRRORING (  
   [ AUTHENTICATION = {   
      WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]  
      | CERTIFICATE certificate_name   
      | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name   
      | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]   
    } ]  
   [ , ENCRYPTION = { DISABLED   
       |   
         {{SUPPORTED | REQUIRED }   
       [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] }   
    ]   
   [ , ] ROLE = { WITNESS | PARTNER | ALL }  
)  
  

Nota:

Para ver la sintaxis de Transact-SQL para SQL Server 2014 (12.x) y versiones anteriores, consulte Versiones anteriores de la documentación.

Argumentos

Nota

Los siguientes argumentos son específicos de ALTER ENDPOINT. Para obtener las descripciones de los argumentos restantes, vea CREATE ENDPOINT (Transact-SQL).

AS { TCP }
No puede cambiar el protocolo de transporte con ALTER ENDPOINT.

AUTHORIZATIONlogin
La opción AUTHORIZATION no está disponible en ALTER ENDPOINT. La propiedad solo puede asignarse cuando se crea el extremo.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }
No se puede cambiar el tipo de carga útil con ALTER ENDPOINT.

Comentarios

Cuando use ALTER ENDPOINT, especifique solo los parámetros que desee actualizar. Todas las propiedades de un extremo se conservan a menos que las cambie explícitamente.

Las instrucciones ENDPOINT DDL no se pueden ejecutar dentro de una transacción de usuario.

Para obtener información sobre cómo elegir un algoritmo de cifrado para su uso con un extremo, vea Selección de un algoritmo de cifrado.

Nota

El algoritmo RC4 se admite únicamente por razones de compatibilidad con versiones anteriores. El material nuevo solo se puede cifrar con RC4 o RC4_128 cuando la base de datos tenga el nivel de compatibilidad 90 o 100. (No se recomienda). Use un algoritmo más reciente como uno de los algoritmos AES en su lugar. En SQL Server 2012 (11.x) y versiones posteriores, el material cifrado con RC4 o RC4_128 se puede descifrar en cualquier nivel de compatibilidad.

RC4 es un algoritmo relativamente poco seguro y AES un algoritmo relativamente seguro. Sin embargo, AES resulta considerablemente más lento que RC4. Si la seguridad es una prioridad más importante que la velocidad, se recomienda utilizar AES.

Permisos

El usuario debe ser un miembro del rol fijo de servidor sysadmin, el propietario del extremo o tener concedido el permiso ALTER ANY ENDPOINT.

Para cambiar la propiedad de un extremo existente, debe usar la instrucción ALTER AUTHORIZATION. Para obtener más información, vea ALTER AUTHORIZATION (Transact-SQL).

Para más información, consulte Permisos de punto de conexión de GRANT (Transact-SQL).

Consulte también

DROP ENDPOINT (Transact-SQL)
EVENTDATA (Transact-SQL)