ALTER ASYMMETRIC KEY (Transact-SQL)ALTER ASYMMETRIC KEY (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)jaAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)yesAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Eigenschaften eines asymmetrischen Schlüssels.Changes the properties of an asymmetric key.

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

SyntaxSyntax

ALTER ASYMMETRIC KEY Asym_Key_Name <alter_option>  

<alter_option> ::=  
      <password_change_option>   
    | REMOVE PRIVATE KEY   

<password_change_option> ::=  
    WITH PRIVATE KEY ( <password_option> [ , <password_option> ] )  

<password_option> ::=  
      ENCRYPTION BY PASSWORD = 'strongPassword'  
    | DECRYPTION BY PASSWORD = 'oldPassword'  

ArgumenteArguments

Asym_Key_NameAsym_Key_Name
Der Name des asymmetrischen Schlüssels in der Datenbank.Is the name by which the asymmetric key is known in the database.

REMOVE PRIVATE KEYREMOVE PRIVATE KEY
Entfernt den privaten Schlüssel aus dem asymmetrischen Schlüssel. Der öffentliche Schlüssel wird nicht entfernt.Removes the private key from the asymmetric key The public key is not removed.

WITH PRIVATE KEYWITH PRIVATE KEY
Ändert den Schutz des privaten Schlüssels.Changes the protection of the private key.

ENCRYPTION BY PASSWORD = "StongPassword"ENCRYPTION BY PASSWORD ='stongPassword'
Gibt ein neues Kennwort zum Schutz des privaten Schlüssels an.Specifies a new password for protecting the private key. Kennwort erfüllt die Anforderungen der Windows-Kennwortrichtlinien des Computers, der die Instanz ausgeführt wird SQL ServerSQL Server.password must meet the Windows password policy requirements of the computer that is running the instance of SQL ServerSQL Server. Falls diese Option ausgelassen wird, wird der private Schlüssel mit dem Datenbank-Hauptschlüssel verschlüsselt.If this option is omitted, the private key will be encrypted by the database master key.

DECRYPTION BY PASSWORD = "OldPassword"DECRYPTION BY PASSWORD ='oldPassword'
Gibt das alte Kennwort an, mit dem der private Schlüssel zurzeit verschlüsselt ist.Specifies the old password, with which the private key is currently protected. Das Kennwort ist nicht erforderlich, wenn der private Schlüssel mit dem Datenbank-Hauptschlüssel verschlüsselt ist.Is not required if the private key is encrypted with the database master key.

HinweiseRemarks

Falls kein Datenbank-Hauptschlüssel vorhanden ist, muss die ENCRYPTION BY PASSWORD-Option angegeben sein. Der Vorgang erzeugt einen Fehler, wenn kein Kennwort angegeben ist.If there is no database master key the ENCRYPTION BY PASSWORD option is required, and the operation will fail if no password is supplied. Informationen zur Vorgehensweise beim Erstellen eines Datenbank-Hauptschlüssels finden Sie unter CREATE MASTER KEY ( Transact-SQL ) .For information about how to create a database master key, see CREATE MASTER KEY (Transact-SQL).

Mit ALTER ASYMMETRIC KEY kann der Schutz des privaten Schlüssels durch Angeben der PRIVATE KEY-Optionen geändert werden, wie in der folgenden Tabelle veranschaulicht ist.You can use ALTER ASYMMETRIC KEY to change the protection of the private key by specifying PRIVATE KEY options as shown in the following table.

Ändern des SchutzesChange protection from ENCRYPTION BY PASSWORDENCRYPTION BY PASSWORD DECRYPTION BY PASSWORDDECRYPTION BY PASSWORD
Altes Kennwort wird geändert zu neuem KennwortOld password to new password ErforderlichRequired RequiredRequired
Kennwort wird geändert zu HauptschlüsselPassword to master key AuslassenOmit RequiredRequired
Hauptschlüssel wird geändert zu KennwortMaster key to password RequiredRequired AuslassenOmit

Der Datenbank-Hauptschlüssel muss geöffnet werden, bevor er zum Schutz eines privaten Schlüssels verwendet werden kann.The database master key must be opened before it can be used to protect a private key. Weitere Informationen finden Sie unter OPEN MASTER KEY ( Transact-SQL ) .For more information, see OPEN MASTER KEY (Transact-SQL).

Verwenden Sie zum Ändern des Besitzes eines asymmetrischen Schlüssels ALTER AUTHORIZATION.To change the ownership of an asymmetric key, use ALTER AUTHORIZATION.

BerechtigungenPermissions

Erfordert die CONTROL-Berechtigung für den asymmetrischen Schlüssel, wenn der private Schlüssel entfernt wird.Requires CONTROL permission on the asymmetric key if the private key is being removed.

BeispieleExamples

A.A. Ändern des Kennworts für den privaten SchlüsselChanging the password of the private key

Im folgenden Beispiel wird das Kennwort geändert, das zum Schutz des privaten Schlüssels des asymmetrischen Schlüssels PacificSales09 verwendet wird.The following example changes the password used to protect the private key of asymmetric key PacificSales09. Das neue Kennwort lautet <enterStrongPasswordHere>.The new password will be <enterStrongPasswordHere>.

ALTER ASYMMETRIC KEY PacificSales09   
    WITH PRIVATE KEY (  
    DECRYPTION BY PASSWORD = '<oldPassword>',  
    ENCRYPTION BY PASSWORD = '<enterStrongPasswordHere>');  
GO  

B.B. Entfernen des privaten Schlüssels aus einem asymmetrischen SchlüsselRemoving the private key from an asymmetric key

Im folgenden Beispiel wird der private Schlüssel aus PacificSales19 entfernt, wobei nur der öffentliche Schlüssel beibehalten wird.The following example removes the private key from PacificSales19, leaving only the public key.

ALTER ASYMMETRIC KEY PacificSales19 REMOVE PRIVATE KEY;  
GO  

C.C. Entfernen des Kennwortschutzes aus einem privaten SchlüsselRemoving password protection from a private key

Im folgenden Beispiel wird der Kennwortschutz für einen privaten Schlüssel entfernt, und der private Schlüssel wird mit dem Datenbank-Hauptschlüssel geschützt.The following example removes the password protection from a private key and protects it with the database master key.

OPEN MASTER KEY;  
ALTER ASYMMETRIC KEY PacificSales09 WITH PRIVATE KEY (  
    DECRYPTION BY PASSWORD = '<enterStrongPasswordHere>' );  
GO  

Siehe auchSee Also

CREATE ASYMMETRIC KEY (Transact-SQL) CREATE ASYMMETRIC KEY (Transact-SQL)
DROP ASYMMETRIC KEY (Transact-SQL) DROP ASYMMETRIC KEY (Transact-SQL)
Verschlüsselungsschlüssel für SQL Server und Datenbank (Datenbankmodul) SQL Server and Database Encryption Keys (Database Engine)
Verschlüsselungshierarchie Encryption Hierarchy
CREATE MASTER KEY (Transact-SQL) CREATE MASTER KEY (Transact-SQL)
Öffnen Sie MASTER KEY ( Transact-SQL ) OPEN MASTER KEY (Transact-SQL)
Erweiterbare Schlüsselverwaltung (EKM)Extensible Key Management (EKM)