Freigeben über


ServiceMasterKey-Eigenschaft

Ruft den Diensthauptschlüssel ab, der der SQL Server-Instanz zugeordnet ist.

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

Syntax

'Declaration
<SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)> _
Public ReadOnly Property ServiceMasterKey As ServiceMasterKey
    Get
'Usage
Dim instance As Server
Dim value As ServiceMasterKey

value = instance.ServiceMasterKey
[SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)]
public ServiceMasterKey ServiceMasterKey { get; }
[SfcObjectAttribute(SfcObjectRelationship::Object, SfcObjectCardinality::One)]
public:
property ServiceMasterKey^ ServiceMasterKey {
    ServiceMasterKey^ get ();
}
[<SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)>]
member ServiceMasterKey : ServiceMasterKey
function get ServiceMasterKey () : ServiceMasterKey

Eigenschaftswert

Typ: Microsoft.SqlServer.Management.Smo. . :: . .ServiceMasterKey
Ein ServiceMasterKey-Objekt, das den der SQL Server-Instanz zugeordneten Diensthauptschlüssel angibt.

Hinweise

The ServiceMasterKey property points to the ServiceMasterKey class. This represents the service master key, which is the top layer in the encryption hierarchy. The service master key is used to encrypt all the lower layers of the encryption hierarchy, such as database master keys, certificates, and asymmetric and symmetric keys.

The service master key is automatically generated the first time encryption is required on the instance of SQL Server. The service master key is generated by Windows and secured by the Windows data protection API. It can be decrypted only by the Windows service account under which it was created, or by a user who knows both the service account name and its password. Therefore, if you change the Windows account under which the SQL Server service runs, you must also enable decryption of the service master key by the new account.

Beispiele

Visual Basic

'Connect to the local, default instance of SQL Server.
Dim srv As Server
srv = New Server
'Reference the service master key.
Dim smskey As ServiceMasterKey
smskey = srv.ServiceMasterKey
'Regenerate the encryption on the service master key.
smskey.Regenerate()

PowerShell

$srv = new-object Microsoft.SqlServer.Management.Smo.Server("(local)")
$smskey = $srv.ServiceMasterKey
$smskey.Regenerate()