ALTER ENDPOINT (Transact-SQL)

Gäller för:SQL Server

Aktiverar ändring av en befintlig slutpunkt på följande sätt:

  • Genom att lägga till en ny metod i en befintlig slutpunkt.
  • Genom att ändra eller ta bort en befintlig metod från slutpunkten.
  • Genom att ändra egenskaperna för en slutpunkt.

Note

I den här artikeln beskrivs syntaxen och argumenten som är specifika för ALTER ENDPOINT. Beskrivningar av argumenten som är gemensamma för båda CREATE ENDPOINT och ALTER ENDPOINTfinns i SKAPA SLUTPUNKT.

Interna XML-webbtjänster (SOAP/HTTP-slutpunkter) tas bort från och med SQL Server 2012 (11.x).

Transact-SQL syntaxkonventioner

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

Följande argument är specifika för ALTER ENDPOINT. Beskrivningar av återstående argument finns i SKAPA SLUTPUNKT.

AS { TCP }

Du kan inte ändra transportprotokollet med ALTER ENDPOINT.

AUKTORISERINGsinloggning

Alternativet AUTHORIZATION är inte tillgängligt i ALTER ENDPOINT. Ägarskap kan bara tilldelas när slutpunkten skapas.

FÖR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }

Du kan inte ändra nyttolasttypen med ALTER ENDPOINT.

Remarks

När du använder ALTER ENDPOINTanger du endast de parametrar som du vill uppdatera. Alla egenskaper för en befintlig slutpunkt förblir desamma om du inte uttryckligen ändrar dem.

Instruktioner ENDPOINT DDL kan inte köras i en användartransaktion.

Information om hur du väljer en krypteringsalgoritm för användning med en slutpunkt finns i Välja en krypteringsalgoritm.

Inaktuell RC4-algoritm

RC4-algoritmen stöds endast för bakåtkompatibilitet. Nytt material kan bara krypteras med hjälp av RC4 eller RC4_128 när databasen är på kompatibilitetsnivå 90 eller 100. (Rekommenderas inte.) Använd en nyare algoritm, till exempel en av AES-algoritmerna i stället. I SQL Server 2012 (11.x) och senare versioner kan material som krypterats med RC4 eller RC4_128 dekrypteras på valfri kompatibilitetsnivå.

behörigheter

Kräver medlemskap i den fasta sysadmin-serverrollen , ägaren av slutpunkten eller ALTER ANY ENDPOINT behörigheten.

Om du vill ändra ägarskapet för en befintlig slutpunkt måste du använda -instruktionen ALTER AUTHORIZATION . Mer information finns i ÄNDRA AUKTORISERING.

Mer information finns i BEVILJA slutpunktsbehörigheter.