MasterKey-Klasse
The MasterKey object represents a SQL Server database master key.
Vererbungshierarchie
System. . :: . .Object
Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
Microsoft.SqlServer.Management.Smo..::..MasterKey
Namespace: Microsoft.SqlServer.Management.Smo
Assembly: Microsoft.SqlServer.Smo (in Microsoft.SqlServer.Smo.dll)
Syntax
'Declaration
Public NotInheritable Class MasterKey _
Inherits SqlSmoObject _
Implements ISfcSupportsDesignMode, IDroppable
'Usage
Dim instance As MasterKey
public sealed class MasterKey : SqlSmoObject,
ISfcSupportsDesignMode, IDroppable
public ref class MasterKey sealed : public SqlSmoObject,
ISfcSupportsDesignMode, IDroppable
[<SealedAttribute>]
type MasterKey =
class
inherit SqlSmoObject
interface ISfcSupportsDesignMode
interface IDroppable
end
public final class MasterKey extends SqlSmoObject implements ISfcSupportsDesignMode, IDroppable
Der MasterKey-Typ macht folgende Elemente verfügbar.
Konstruktoren
Name | Beschreibung | |
---|---|---|
MasterKey() () () () | Initializes a new instance of the MasterKey class. | |
MasterKey(Database) | Initializes a new instance of the MasterKey class on the specified database. |
Zum Anfang
Eigenschaften
Name | Beschreibung | |
---|---|---|
CreateDate | Gets the date and time when the master key was created. | |
DateLastModified | Gets the date and time when the master key was last modified. | |
ExecuteForScalar | Ruft den Boolean-Eigenschaftswert ab, der angibt, ob das Objekt auf die ExecuteForScalar-Option festgelegt ist, oder legt ihn fest. (Geerbt von SqlSmoObject.) | |
IsEncryptedByServer | Gets the Boolean property value that specifies whether the database master key is encrypted by using the service master key or by using a password. | |
IsOpen | Gets the Boolean property value that specifies whether the database master key is open. | |
IsTouched | Ruft den Boolean-Eigenschaftswert ab, der angibt, ob die Objekteigenschaften aktualisiert, aber noch nicht permanent auf dem Server gespeichert wurden. (Geerbt von SqlSmoObject.) | |
ObjectInSpace | Ruft den Boolean-Eigenschaftswert ab, der angibt, ob das Objekt isoliert vorhanden bzw. direkt oder indirekt mit der SQL Server-Instanz verbunden ist. (Geerbt von SqlSmoObject.) | |
Parent | Gets the Database object that is the parent of the MasterKey object. | |
Properties | Ruft eine Auflistung von Property-Objekten ab, die die Objekteigenschaften darstellen. (Geerbt von SqlSmoObject.) | |
ScalarResult | Ruft das skalare Ergebnis für das Objekt ab, auf das verwiesen wird. (Geerbt von SqlSmoObject.) | |
State | Gets the state of the referenced object. (Geerbt von SmoObjectBase.) | |
Urn | Ruft den Wert der URN (Uniform Resource Name)-Adresse ab, durch den das Objekt eindeutig identifiziert wird. (Geerbt von SqlSmoObject.) | |
UserData | Gets or sets user-defined data associated with the referenced object. (Geerbt von SmoObjectBase.) |
Zum Anfang
Methoden
Name | Beschreibung | |
---|---|---|
AddDatabaseContext(StringCollection) | Fügt der Auflistung der vom queries-Parameter identifizierten Abfragen den Datenbankkontext hinzu. (Geerbt von SqlSmoObject.) | |
AddDatabaseContext(StringCollection, ScriptingOptions) | Fügt der Auflistung der vom queries-Parameter identifizierten Abfragen den Datenbankkontext gemäß den angegebenen Skriptoptionen hinzu. (Geerbt von SqlSmoObject.) | |
AddPasswordEncryption | Adds password encryption to the master key. | |
AddServiceKeyEncryption | Adds service key encryption to the master key. | |
AlterImpl | Aktiviert das Änderungsereignis des Objekts. (Geerbt von SqlSmoObject.) | |
AlterImplFinish | Die Methode, die nach Beendigung des Änderungsereignisses des Objekts aufgerufen wird. (Geerbt von SqlSmoObject.) | |
AlterImplInit | Die Methode, die bei der Initialisierung des Änderungsereignisses des Objekts aufgerufen wird. (Geerbt von SqlSmoObject.) | |
AlterImplWorker | Ruft die ALTER-Methoden auf. (Geerbt von SqlSmoObject.) | |
BindDefaultImpl | Bindet die von den Parametern identifizierten Standardelemente. (Geerbt von SqlSmoObject.) | |
BindRuleImpl | Bindet das Regelschema an die Regel und die Spalten, die von den Parametern identifiziert werden. (Geerbt von SqlSmoObject.) | |
CheckCollation | Überprüft die Reihenfolge der Skriptoptionen anhand der vom collationName-Parameter identifizierten Sortierungsmethode. (Geerbt von SqlSmoObject.) | |
CheckObjectState() () () () | Überprüft den Status des Objekts, auf das verwiesen wird. (Geerbt von SqlSmoObject.) | |
CheckObjectState(Boolean) | Überprüft den Status des Objekts, auf das verwiesen wird. Optional kann angegeben werden, dass eine Ausnahme ausgelöst wird, wenn das Objekt noch nicht erstellt wurde. (Geerbt von SqlSmoObject.) | |
CheckObjectStateImpl | Überprüft den Zustand von SqlSmoObject. (Geerbt von SqlSmoObject.) | |
CheckVersion100 | Überprüft, ob die SQL Server-Version SQL Server 2008 ist. (Geerbt von SqlSmoObject.) | |
CheckVersion80 | Überprüft die Gültigkeit des Objekts für SQL Server 2000. (Geerbt von SqlSmoObject.) | |
CheckVersion80SP3 | Überprüft die Gültigkeit des Objekts für SQL Server 2000 SP3. (Geerbt von SqlSmoObject.) | |
CheckVersion90 | Überprüft die Gültigkeit des Objekts für SQL Server 2005. (Geerbt von SqlSmoObject.) | |
CheckVersionBelow90 | Überprüft, ob die SQL Server-Version älter als SQL Server 2005 ist. (Geerbt von SqlSmoObject.) | |
CleanObject | Legt für das Objekt den unveränderten Zustand fest. (Geerbt von SqlSmoObject.) | |
Close | Closes the master key. | |
Create(String) | Creates a master key that has the specified password. | |
Create(String, String, String) | Creates a master key from the specified file and that has the specified encryption and decryption passwords. | |
CreateImpl | Erstellt ein Objekt mit Skriptoptionen. (Geerbt von SqlSmoObject.) | |
CreateImplFinish | Die Methode, die nach Beendigung des CREATE-Ereignisses aufgerufen wird. (Geerbt von SqlSmoObject.) | |
CreateImplInit | Die Methode, die bei Initialisierung des CREATE-Ereignisses aufgerufen wird. (Geerbt von SqlSmoObject.) | |
Discover | Ermittelt eine Liste vom Typ Object. (Geerbt von SqlSmoObject.) | |
Drop | Removes the master key from the database. | |
DropImpl | Löscht SqlSmoObject. (Geerbt von SqlSmoObject.) | |
DropImplWorker | Ruft die DROP-Methoden auf. (Geerbt von SqlSmoObject.) | |
DropPasswordEncryption | Removes the password encryption from the master key by using the associated password. | |
DropServiceKeyEncryption | Drops service key encryption from the master key. | |
EnumKeyEncryptions | Enumerates a list of the current set of key encryptions for the database master key. | |
EnumScriptImpl | Listet die vom so-Parameter angegebenen Skripts auf. (Geerbt von SqlSmoObject.) | |
EnumScriptImplWorker | Ruft die Methoden auf, die die vom so-Parameter angegebenen Skripts auflisten. (Geerbt von SqlSmoObject.) | |
EnumScriptImplWorkerSOChanged | Gibt eine IEnumerable-Zeichenfolge zurück, die die Skriptoptionen für ein Objekt beschreibt. (Geerbt von SqlSmoObject.) | |
Equals | (Geerbt von Object.) | |
ExecuteNonQuery | (Geerbt von SqlSmoObject.) | |
Export | Saves the database master key to the specified system path location by using the specified password. | |
Finalize | (Geerbt von Object.) | |
FormatSqlVariant | Formatiert ein Objekt als SqlVariant-Typ. (Geerbt von SqlSmoObject.) | |
GenerateDataSpaceFileStreamScript | Generiert ein Skript zum Erstellen der Datendatei. (Geerbt von SqlSmoObject.) | |
GenerateDataSpaceScript | Generiert ein Skript zum Zuordnen von Speicherplatz in der Datendatei. (Geerbt von SqlSmoObject.) | |
GetBindDefaultScript | Ruft das Skript ab, durch das die vom defSchema-Parameter und defName-Parameter angegebenen Standardwerte gebunden werden. (Geerbt von SqlSmoObject.) | |
GetBindRuleScript | Ruft das Skript ab, das die Bindungsregeln angibt. (Geerbt von SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Weist einen booleschen Parameter von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Weist eine boolesche Eigenschaft von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetDateTimeParameter | Weist die datetime-Eigenschaft von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetDateTimeParameterAsInt | Weist die datetime-Eigenschaft von SqlSmoObject als ganzzahligen Wert zu, wenn die datetime-Eigenschaft nicht NULL ist. (Geerbt von SqlSmoObject.) | |
GetDBName | Ruft den Datenbanknamen ab, der dem Objekt zugeordnet ist. (Geerbt von SqlSmoObject.) | |
GetEnumParameter | Weist die Enumerationseigenschaft von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetFragOptionString | Ruft ein FragmentationOption-Objekt als Zeichenfolgenwert ab. (Geerbt von SqlSmoObject.) | |
GetGuidParameter | Weist eine Guid-Eigenschaft von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetHashCode | (Geerbt von Object.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Weist einen Parameter von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Weist einen Parameter von SqlSmoObject zu. (Geerbt von SqlSmoObject.) | |
GetPropValue | Ruft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.) | |
GetPropValueOptional | Ruft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.) | |
GetPropValueOptionalAllowNull | Ruft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.) | |
GetRealValue | Ruft einen Eigenschaftswert des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.) | |
GetScriptingOptionsForCreate | Ruft ScriptingOptions für das SqlSmoObject-Objekt ab. (Geerbt von SqlSmoObject.) | |
GetServerName | Ruft den Namen der SQL Server-Instanz ab, der das Objekt zugeordnet ist. (Geerbt von SqlSmoObject.) | |
GetServerObject | Ruft den Server des SqlSmoObject-Objekts ab. (Geerbt von SqlSmoObject.) | |
GetSqlServerVersionName | Ruft den Versionsnamen der SQL Server-Instanz ab, der das Objekt zugeordnet ist. (Geerbt von SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Weist einen Zeichenfolgenparameter des SqlSmoObject-Objekts zu. (Geerbt von SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Weist einen Zeichenfolgenparameter des SqlSmoObject-Objekts zu. (Geerbt von SqlSmoObject.) | |
GetTimeSpanParameterAsInt | Weist einen Zeitraumparameter des SqlSmoObject-Objekts zu. (Geerbt von SqlSmoObject.) | |
GetType | (Geerbt von Object.) | |
GetUrnRecursive(StringBuilder) | Weist ein Urn-Objekt des SqlSmoObject-Objekts zu. (Geerbt von SqlSmoObject.) | |
GetUrnRecursive(StringBuilder, UrnIdOption) | Weist ein Urn-Objekt des SqlSmoObject-Objekts zu. (Geerbt von SqlSmoObject.) | |
ImplInitialize | Initialisiert die Felder des SqlSmoObject-Objekts. (Geerbt von SqlSmoObject.) | |
Import(String, String, String) | Loads the database master key from the file that is located at the specified system path by using the specified passwords to decrypt and encrypt the master key. | |
Import(String, String, String, Boolean) | Loads the database master key from the file that is located at the specified system path by using the specified passwords to decrypt and encrypt the master key, and with the option to force regeneration. | |
Initialize() () () () | Initialisiert das Objekt und erzwingt das Laden der Eigenschaften. (Geerbt von SqlSmoObject.) | |
Initialize(Boolean) | Initialisiert das Objekt und erzwingt das Laden der Eigenschaften. (Geerbt von SqlSmoObject.) | |
IsObjectDirty | Überprüft, ob die Objekteigenschaften geändert und die Änderungen noch nicht permanent für die SQL Server-Instanz gespeichert wurden. (Geerbt von SqlSmoObject.) | |
IsObjectInitialized | Überprüft, ob das Objekt initialisiert wurde. (Geerbt von SqlSmoObject.) | |
IsObjectInSpace | Überprüft, ob das Objekt isoliert vorhanden oder mit der SQL Server-Instanz verbunden ist. (Geerbt von SqlSmoObject.) | |
IsVersion80SP3 | Ermittelt, ob die SQL Server-Version SQL Server 2000 mit SP3 ist. (Geerbt von SqlSmoObject.) | |
IsVersion90AndAbove | Ermittelt, ob die SQL Server-Version SQL Server 2005 oder höher ist. (Geerbt von SqlSmoObject.) | |
MarkDropped | Legt den zu löschenden SqlSmoState fest. (Geerbt von SqlSmoObject.) | |
MarkForDropImpl | Legt den zu löschenden SqlSmoState fest. (Geerbt von SqlSmoObject.) | |
MemberwiseClone | (Geerbt von Object.) | |
Open | Opens the database master key by using the specified password. | |
PostAlter | Die Methode, die nach dem Ändern von SqlSmoObject aktiviert wird. (Geerbt von SqlSmoObject.) | |
PostCreate | Die Methode, die nach dem Erstellen von SqlSmoObject aktiviert wird. (Geerbt von SqlSmoObject.) | |
PostDrop | Die Methode, die nach dem Löschen von SqlSmoObject aktiviert wird. (Geerbt von SqlSmoObject.) | |
Refresh | Aktualisiert das Objekt und ruft beim nächsten Zugriff auf das Objekt Eigenschaften ab. (Geerbt von SqlSmoObject.) | |
Regenerate(String) | Regenerates the database master key by using the specified new password. | |
Regenerate(String, Boolean) | Regenerates the database master key by using the specified new password, and with the option to force the regeneration, thus removing all items that cannot be successfully decrypted. | |
ScriptAlter | Ändert SqlSmoObject gemäß den Parametern. (Geerbt von SqlSmoObject.) | |
ScriptCreate | Ändert SqlSmoObject gemäß den Parametern. (Geerbt von SqlSmoObject.) | |
ScriptDdl | Löst InvalidSmoOperationException aus. (Geerbt von SqlSmoObject.) | |
ScriptDrop | Löst InvalidSmoOperationException aus. (Geerbt von SqlSmoObject.) | |
ScriptImpl() () () () | Ruft eine Skriptauflistung von SqlSmoObject ab. (Geerbt von SqlSmoObject.) | |
ScriptImpl(ScriptingOptions) | Ruft eine Skriptauflistung von SqlSmoObject ab. (Geerbt von SqlSmoObject.) | |
ScriptImplWorker | Ruft eine Skriptauflistung von SqlSmoObject ab. (Geerbt von SqlSmoObject.) | |
SetParentImpl | Legt das übergeordnete Element von SqlSmoObject auf den newParent-Parameter fest. (Geerbt von SqlSmoObject.) | |
ToString | Gibt eine String zurück, die das Objekt darstellt, auf das verwiesen wird. (Geerbt von SqlSmoObject.) | |
TouchImpl | Nicht implementiert. (Geerbt von SqlSmoObject.) | |
UnbindDefaultImpl | Hebt die Bindung der Standardspalten von SqlSmoObject auf. (Geerbt von SqlSmoObject.) | |
UnbindRuleImpl | Hebt die Bindung der Regeln von SqlSmoObject auf. (Geerbt von SqlSmoObject.) | |
Validate | Validates the state of an object. (Geerbt von SmoObjectBase.) |
Zum Anfang
Ereignisse
Name | Beschreibung | |
---|---|---|
PropertyChanged | Stellt das Ereignis dar, das bei Änderung einer Eigenschaft auftritt. (Geerbt von SqlSmoObject.) | |
PropertyMetadataChanged | Stellt das Ereignis dar, das bei Änderungen an den Eigenschaftsmetadaten auftritt. (Geerbt von SqlSmoObject.) |
Zum Anfang
Felder
Name | Beschreibung | |
---|---|---|
m_ExtendedProperties | Stellt eine Eigenschaft dar, die zur Erweiterung der von SqlSmoObject bereitgestellten Eigenschaften definiert wird. (Geerbt von SqlSmoObject.) | |
singletonParent | Stellt das übergeordnete Singleton-Element dar. (Geerbt von SqlSmoObject.) |
Zum Anfang
Explizite Schnittstellenimplementierungen
Name | Beschreibung | |
---|---|---|
IAlienObject. . :: . .Discover | Ermittelt alle Abhängigkeiten. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .GetDomainRoot | Gibt den Stamm der Domäne zurück. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .GetParent | Ruft das übergeordnete Element dieses Objekts ab. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyType | Ruft den Typ der angegebenen Eigenschaft ab. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyValue | Ruft den Wert der angegebenen Eigenschaft ab. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .GetUrn | Ruft den URN (Uniform Resource Name) des Objekts ab. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .Resolve | Ruft aus dem URN die Instanz ab, die die Informationen zum Objekt enthält. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .SetObjectState | Legt den Objektstatus auf den angegebenen SfcObjectState-Wert fest. (Geerbt von SqlSmoObject.) | |
IAlienObject. . :: . .SetPropertyValue | Legt den Eigenschaftswert fest. (Geerbt von SqlSmoObject.) | |
ISfcPropertyProvider. . :: . .GetPropertySet | Ruft den Schnittstellenverweis auf den Eigenschaftensatz dieses Objekts ab. Verweisen Sie nicht direkt im Code auf dieses Element. Unterstützt die SQL Server-Infrastruktur. (Geerbt von SqlSmoObject.) | |
ISfcSupportsDesignMode. . :: . .IsDesignMode | Gets a Boolean value that indicates whether the object supports design mode. Nur für Informationszwecke identifiziert. Nicht unterstützt. Zukünftige Kompatibilität wird nicht sichergestellt. |
Zum Anfang
Hinweise
A database master key is used to symmetrically encrypt keys and certificates that are stored in the database. A database master key can be encrypted by using the service master key or by using a user-specified password. When a database master key is created, a password must be supplied to encrypt and decrypt it.
When a database is attached to an instance of SQL Server, the database administrator must either supply the master key password or make an unencrypted copy of the master key that is available for encryption with the service master key.
The service master key is the top layer in the encryption hierarchy that is used to encrypt lower layers in the encryption hierarchy. The service master key is generated automatically by Windows. It can be opened 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.
To get MasterKey object properties, users can be a member of the public fixed server role.
To set MasterKey object properties, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.
To create or drop a master key, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.
To open or regenerate a master key, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.
To add or drop service key encryption, users must have CONTROL permission on the database or be a member of the db_owner fixed database role.
To drop a master key, users can be a member of the public fixed server role.
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic)-Elemente dieses Typs sind Threadsicher. Für Instanzelemente wird die Threadsicherheit nicht gewährleistet.
Siehe auch