ALTER CREDENTIAL (Transact-SQL)ALTER CREDENTIAL (Transact-SQL)

Dieses Thema gilt für:JaSQL Server (ab 2008)JaAzure SQL-Datenbank (nur verwaltete Instanz)keineAzure SQL Data Warehouse keineParallel Datawarehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL Database (Managed Instance only)noAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Eigenschaften von Anmeldeinformationen.Changes the properties of a credential.

Wichtig

Auf Azure SQL-Datenbank verwaltete Instanz, diese T-SQL-Funktion hat bestimmte verhaltensänderungen.On Azure SQL Database Managed Instance, this T-SQL feature has certain behavior changes. Finden Sie unter Azure SQL-Datenbank verwaltet Instanz T-SQL-Unterschiede zu SQL Server Details für alle T-SQL-verhaltensänderungen.See Azure SQL Database Managed Instance T-SQL differences from SQL Server for details for all T-SQL behavior changes.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


ALTER CREDENTIAL credential_name WITH IDENTITY = 'identity_name'  
    [ , SECRET = 'secret' ]  

ArgumenteArguments

credential_namecredential_name
Gibt den Namen der Anmeldeinformationen an, die geändert werden.Specifies the name of the credential that is being altered.

IDENTITY ='identity_name'IDENTITY ='identity_name'
Gibt den Namen des Kontos an, das beim Herstellen einer Verbindung außerhalb des Servers verwendet wird.Specifies the name of the account to be used when connecting outside the server.

SECRET ='secret'SECRET ='secret'
Gibt den geheimen Bereich an, der für die ausgehende Authentifizierung erforderlich ist.Specifies the secret required for outgoing authentication. secret ist optional.secret is optional.

RemarksRemarks

Wenn Anmeldeinformationen geändert werden, werden die Werte von identity_name und secret zurückgesetzt.When a credential is changed, the values of both identity_name and secret are reset. Falls das optionale SECRET-Argument nicht angegeben wird, wird der Wert des gespeicherten Kennworts auf NULL festgelegt.If the optional SECRET argument is not specified, the value of the stored secret will be set to NULL.

Das Kennwort wird mithilfe des Diensthauptschlüssels verschlüsselt.The secret is encrypted by using the service master key. Falls der Diensthauptschlüssel erneut generiert wird, wird das Kennwort erneut mithilfe des neuen Diensthauptschlüssels verschlüsselt.If the service master key is regenerated, the secret is reencrypted by using the new service master key.

Informationen zu Anmeldeinformationen werden in der sys.credentials-Katalogsicht angezeigt.Information about credentials is visible in the sys.credentials catalog view.

BerechtigungenPermissions

Erfordert die ALTER ANY CREDENTIAL-Berechtigung.Requires ALTER ANY CREDENTIAL permission. Falls es sich bei dem Anmeldeinformationen um Systemanmeldeinformationen handelt, ist die CONTROL SERVER-Berechtigung erforderlich.If the credential is a system credential, requires CONTROL SERVER permission.

BeispieleExamples

A.A. Ändern des Kennworts für AnmeldeinformationenChanging the password of a credential

Im folgenden Beispiel wird das Kennwort, das in den Anmeldeinformationen namens Saddles gespeichert ist, geändert.The following example changes the secret stored in a credential called Saddles. Diese Anmeldeinformationen enthalten den Windows-Anmeldenamen RettigB und das zugehörige Kennwort.The credential contains the Windows login RettigB and its password. Das neue Kennwort wird den Anmeldeinformationen mithilfe der SECRET-Klausel hinzugefügt.The new password is added to the credential using the SECRET clause.

ALTER CREDENTIAL Saddles WITH IDENTITY = 'RettigB',   
    SECRET = 'sdrlk8$40-dksli87nNN8';  
GO  

B.B. Entfernen des Kennworts aus AnmeldeinformationenRemoving the password from a credential

Im folgenden Beispiel wird das Kennwort aus Anmeldeinformationen namens Frames entfernt.The following example removes the password from a credential named Frames. Diese Anmeldeinformationen enthalten den Windows-Anmeldenamen Aboulrus8 und ein Kennwort.The credential contains Windows login Aboulrus8 and a password. Nach der Ausführung der Anweisung weisen die Anmeldeinformationen ein NULL-Kennwort auf, weil die Option SECRET nicht angegeben ist.After the statement is executed, the credential will have a NULL password because the SECRET option is not specified.

ALTER CREDENTIAL Frames WITH IDENTITY = 'Aboulrus8';  
GO  

Weitere Informationen finden Sie unterSee Also

Anmeldeinformationen (Datenbank-Engine) Credentials (Database Engine)
CREATE CREDENTIAL (Transact-SQL) CREATE CREDENTIAL (Transact-SQL)
DROP CREDENTIAL (Transact-SQL) DROP CREDENTIAL (Transact-SQL)
ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL) ALTER DATABASE SCOPED CREDENTIAL (Transact-SQL)
CREATE LOGIN (Transact-SQL) CREATE LOGIN (Transact-SQL)
sys.credentials (Transact-SQL)sys.credentials (Transact-SQL)