ALTER ENDPOINT (Transact-SQL)

Gilt für:SQL Server

Ermöglicht das Ändern eines vorhandenen Endpunktes auf die folgenden Arten:

  • Durch Hinzufügen einer neuen Methode zu einem vorhandenen Endpunkt.
  • Durch Ändern oder Löschen einer vorhandenen Methode aus dem Endpunkt.
  • Durch Ändern der Eigenschaften eines Endpunkts.

Hinweis

In diesem Artikel werden die Syntax und argumente beschrieben, die spezifisch sind ALTER ENDPOINT. Beschreibungen der Argumente, die für beides CREATE ENDPOINT gemeinsam sind, und ALTER ENDPOINTfinden Sie unter CREATE ENDPOINT.

Systemeigene XML-Webdienste (SOAP/HTTP-Endpunkte) wurden ab SQL Server 2012 (11.x) entfernt.

Transact-SQL-Syntaxkonventionen

Syntax

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 }
)

Argumente

Die folgenden Argumente sind spezifisch für ALTER ENDPOINT. Beschreibungen der verbleibenden Argumente finden Sie unter CREATE ENDPOINT.

AS { TCP }

Sie können das Transportprotokoll nicht mit ALTER ENDPOINT.

AUTORISIERUNGsanmeldung

Die AUTHORIZATION Option ist in ALTER ENDPOINT. Besitz kann nur zugewiesen werden, wenn der Endpunkt erstellt wird.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

Sie können den Nutzlasttyp nicht mit ALTER ENDPOINT.

Bemerkungen

Geben Sie bei Verwendung ALTER ENDPOINTnur die Parameter an, die Sie aktualisieren möchten. Alle Eigenschaften eines vorhandenen Endpunktes bleiben unverändert, es sei denn, Sie ändern diese explizit.

Die ENDPOINT DDL Anweisungen können nicht innerhalb einer Benutzertransaktion ausgeführt werden.

Informationen zum Auswählen eines Verschlüsselungsalgorithmus für die Verwendung mit einem Endpunkt finden Sie unter Auswählen eines Verschlüsselungsalgorithmus.

Veralteter RC4-Algorithmus

Der RC4-Algorithmus wird nur aus Gründen der Abwärtskompatibilität unterstützt. Neues Material kann nur mit RC4 oder RC4_128 verschlüsselt werden, wenn die Datenbank den Kompatibilitätsgrad 90 oder 100 besitzt. (Nicht empfohlen.) Verwenden Sie stattdessen einen neueren Algorithmus, z. B. einen der AES-Algorithmen. In SQL Server 2012 (11.x) und höheren Versionen kann mit RC4 oder RC4_128 verschlüsseltes Material in jedem Kompatibilitätsgrad entschlüsselt werden.

Berechtigungen

Erfordert die Mitgliedschaft in der festen Serverrolle sysadmin , dem Besitzer des Endpunkts oder ALTER ANY ENDPOINT der Berechtigung.

Um den Besitz eines vorhandenen Endpunkts zu ändern, müssen Sie die ALTER AUTHORIZATION Anweisung verwenden. Weitere Informationen finden Sie unter ALTER AUTHORIZATION.

Weitere Informationen finden Sie unter GRANT-Endpunktberechtigungen.

Verwandte Inhalte

  • Last updated on