SymmetricKey.Create Method (SymmetricKeyEncryption, SymmetricKeyEncryptionAlgorithm, SecureString, String)

Creates a symmetric key on the database with the specified encryption type and method.

Namespace:  Microsoft.SqlServer.Management.Smo
Assembly:  Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)

Syntax

'Declaration
Public Sub Create ( _
    keyEncryption As SymmetricKeyEncryption, _
    keyEncryptionAlgorithm As SymmetricKeyEncryptionAlgorithm, _
    passPhrase As SecureString, _
    identityPhrase As String _
)
'Usage
Dim instance As SymmetricKey 
Dim keyEncryption As SymmetricKeyEncryption 
Dim keyEncryptionAlgorithm As SymmetricKeyEncryptionAlgorithm 
Dim passPhrase As SecureString 
Dim identityPhrase As String

instance.Create(keyEncryption, keyEncryptionAlgorithm, _
    passPhrase, identityPhrase)

public void Create(
    SymmetricKeyEncryption keyEncryption,
    SymmetricKeyEncryptionAlgorithm keyEncryptionAlgorithm,
    SecureString passPhrase,
    string identityPhrase
)

public:
void Create(
    SymmetricKeyEncryption^ keyEncryption, 
    SymmetricKeyEncryptionAlgorithm keyEncryptionAlgorithm, 
    SecureString^ passPhrase, 
    String^ identityPhrase
)

member Create : 
        keyEncryption:SymmetricKeyEncryption * 
        keyEncryptionAlgorithm:SymmetricKeyEncryptionAlgorithm * 
        passPhrase:SecureString * 
        identityPhrase:string -> unit

public function Create(
    keyEncryption : SymmetricKeyEncryption, 
    keyEncryptionAlgorithm : SymmetricKeyEncryptionAlgorithm, 
    passPhrase : SecureString, 
    identityPhrase : String
)

Parameters

• keyEncryption
  Type: Microsoft.SqlServer.Management.Smo.SymmetricKeyEncryption
  A SymmetricKeyEncryption object value that specifies the encryption type.

• keyEncryptionAlgorithm
  Type: Microsoft.SqlServer.Management.Smo.SymmetricKeyEncryptionAlgorithm
  A SymmetricKeyEncryptionAlgorithm value that specifies the encryption method.

• passPhrase
  Type: System.Security.SecureString
  A SecureString value that specifies the pass phrase from which the symmetric key can be derived.

• identityPhrase
  Type: System.String
  A String value that specifies the identity phrase used to tag data that is encrypted with the key. Either passPhrase or identityPhrase can be null, but at least one needs to be set.

Examples

Using Encryption

See Also

Reference

SymmetricKey Class

Create Overload

Microsoft.SqlServer.Management.Smo Namespace

Other Resources

Encryption Hierarchy

CREATE SYMMETRIC KEY (Transact-SQL)

OPEN SYMMETRIC KEY (Transact-SQL)