Przeczytaj w języku angielskim

Udostępnij za pośrednictwem

  • Artykuł

Server.ServiceMasterKey Property

Gets the service master key associated with the instance of SQL Server.

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

Syntax

'Deklaracja
<SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)> _
Public ReadOnly Property ServiceMasterKey As ServiceMasterKey

[SfcObjectAttribute(SfcObjectRelationship.Object, SfcObjectCardinality.One)] 
public ServiceMasterKey ServiceMasterKey { get; }

[SfcObjectAttribute(SfcObjectRelationship::Object, SfcObjectCardinality::One)] 
public:
property ServiceMasterKey^ ServiceMasterKey {
    ServiceMasterKey^ get ();
}

/** @property */
public ServiceMasterKey get_ServiceMasterKey ()

public function get ServiceMasterKey () : ServiceMasterKey

Property Value

A ServiceMasterKey object that specifies the service master key associated with the instance of SQL Server.

Remarks

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.

Example

'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()

Thread Safety

Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Platforms

Development Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server.

Target Platforms

For a list of the supported platforms, see Hardware and Software Requirements for Installing SQL Server.