ALTER ENDPOINT (Transact-SQL)

Van toepassing op:SQL Server

Hiermee schakelt u het wijzigen van een bestaand eindpunt op de volgende manieren in:

• Door een nieuwe methode toe te voegen aan een bestaand eindpunt.
• Door een bestaande methode van het eindpunt te wijzigen of neer te halen.
• Door de eigenschappen van een eindpunt te wijzigen.

Systeemeigen XML-webservices (SOAP/HTTP-eindpunten) worden verwijderd vanaf SQL Server 2012 (11.x).

Transact-SQL syntaxis-conventies

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

Arguments

De volgende argumenten zijn specifiek voor ALTER ENDPOINT. Zie CREATE ENDPOINT voor beschrijvingen van de resterende argumenten.

AS { TCP }

U kunt het transportprotocol niet wijzigen met ALTER ENDPOINT.

AUTORISATIEaanmelding

De AUTHORIZATION optie is niet beschikbaar in ALTER ENDPOINT. Eigendom kan alleen worden toegewezen wanneer het eindpunt wordt gemaakt.

FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

U kunt het nettoladingtype niet wijzigen met ALTER ENDPOINT.

Opmerkingen

Wanneer u deze gebruikt ALTER ENDPOINT, geeft u alleen de parameters op die u wilt bijwerken. Alle eigenschappen van een bestaand eindpunt blijven hetzelfde, tenzij u ze expliciet wijzigt.

De ENDPOINT DDL instructies kunnen niet worden uitgevoerd binnen een gebruikerstransactie.

Zie Een versleutelingsalgoritmen kiezen voor gebruik met een eindpunt voor meer informatie over het kiezen van een versleutelingsalgoritmen.

Verouderd RC4-algoritme

Het RC4-algoritme wordt alleen ondersteund voor achterwaartse compatibiliteit. Nieuw materiaal kan alleen worden versleuteld met RC4 of RC4_128 wanneer de database compatibiliteitsniveau 90 of 100 heeft. (Niet aanbevolen.) Gebruik in plaats daarvan een nieuwer algoritme, zoals een van de AES-algoritmen. In SQL Server 2012 (11.x) en latere versies kan materiaal dat is versleuteld met RC4 of RC4_128 worden ontsleuteld in elk compatibiliteitsniveau.

toestemmingen

Vereist lidmaatschap van de vaste serverfunctie sysadmin , de eigenaar van het eindpunt of ALTER ANY ENDPOINT de machtiging.

Als u het eigendom van een bestaand eindpunt wilt wijzigen, moet u de ALTER AUTHORIZATION instructie gebruiken. Zie ALTER AUTHORIZATION voor meer informatie.

Zie GRANT Endpoint Permissions voor meer informatie.

Verwante inhoud

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