ALTER ENDPOINT (Transact-SQL)

S'applique à :SQL Server

Permet de modifier un point de terminaison existant selon plusieurs procédures :

  • en ajoutant une nouvelle méthode à un point de terminaison existant ;
  • en modifiant ou supprimant une méthode existante du point de terminaison ;
  • en modifiant les propriétés d'un point de terminaison.

Notes

Cet article décrit la syntaxe et les arguments spécifiques à ALTER ENDPOINT. Pour obtenir des descriptions des arguments communs aux deux CREATE ENDPOINT et ALTER ENDPOINT, consultez CREATE ENDPOINT.

Les services Web XML natifs (points de terminaison HTTP/SOAP) sont supprimés à compter de SQL Server 2012 (11.x).

Conventions de la syntaxe Transact-SQL

Syntaxe

ALTER ENDPOINT endPointName [ AUTHORIZATION login ]
[ STATE = { STARTED | STOPPED | DISABLED } ]
[ AS { TCP } (
    <protocol_specific_arguments>
) ]
[ FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
    <language_specific_arguments>
) ]

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
    LISTENER_PORT = listenerPort
    [ [ , ] LISTENER_IP = ALL | ( four_part_ipv4_address ) | ( 'ip_address_v6' ) ]
)

<FOR TSQL_language_specific_arguments> ::=
FOR TSQL (
    [ ENCRYPTION = { NEGOTIATED | STRICT } ]
)

<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 { AES | RC4 | AES RC4 | RC4 AES } ]
    } ]
    [ [ , ] MESSAGE_FORWARDING = { ENABLED | DISABLED } ]
    [ [ , ] MESSAGE_FORWARD_SIZE = forward_size ]
)

<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 { AES | RC4 | AES RC4 | RC4 AES } ]
    } ]
    [ , ] ROLE = { WITNESS | PARTNER | ALL }
)

Arguments

Les arguments suivants sont spécifiques à ALTER ENDPOINT. Pour obtenir des descriptions des arguments restants, consultez CREATE ENDPOINT.

AS { TCP }

Vous ne pouvez pas modifier le protocole de transport avec ALTER ENDPOINT.

Connexion d’autorisation

L’option AUTHORIZATION n’est pas disponible dans ALTER ENDPOINT. La propriété ne peut être assignée que lorsque le point de terminaison est créé.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

Vous ne pouvez pas modifier le type de charge utile avec ALTER ENDPOINT.

Notes

Lorsque vous utilisez ALTER ENDPOINT, spécifiez uniquement les paramètres que vous souhaitez mettre à jour. Toutes les propriétés d'un point de terminaison existant restent inchangées tant que vous ne les modifiez pas explicitement.

Les ENDPOINT DDL instructions ne peuvent pas être exécutées à l’intérieur d’une transaction utilisateur.

Pour plus d’informations sur le choix d’un algorithme de chiffrement à utiliser avec un point de terminaison, consultez Choisir un algorithme de chiffrement.

Algorithme RC4 déconseillé

L'algorithme RC4 est uniquement pris en charge pour des raisons de compatibilité descendante. Le nouveau matériel ne peut être chiffré à l'aide de RC4 ou de RC4_128 que lorsque la base de données se trouve dans le niveau de compatibilité 90 ou 100. (Non recommandé.) Utilisez à la place un algorithme plus récent, tel qu'un des algorithmes AES. Dans SQL Server 2012 (11.x) et versions ultérieures, le matériel chiffré à l’aide de RC4 ou de RC4_128 peut être déchiffré dans n’importe quel niveau de compatibilité.

Autorisations

Nécessite l’appartenance au rôle serveur fixe sysadmin , le propriétaire du point de terminaison ou ALTER ANY ENDPOINT l’autorisation.

Pour modifier la propriété d’un point de terminaison existant, vous devez utiliser l’instruction ALTER AUTHORIZATION . Pour plus d’informations, consultez ALTER AUTHORIZATION.

Pour plus d’informations, consultez GRANT Endpoint Permissions.

Contenu connexe

  • Last updated on