Classe MasterKey
The MasterKey object represents a SQL Server database master key.
Hiérarchie d'héritage
System. . :: . .Object
Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
Microsoft.SqlServer.Management.Smo..::..MasterKey
Espace de noms : Microsoft.SqlServer.Management.Smo
Assembly : Microsoft.SqlServer.Smo (en Microsoft.SqlServer.Smo.dll)
Syntaxe
'Déclaration
Public NotInheritable Class MasterKey _
Inherits SqlSmoObject _
Implements ISfcSupportsDesignMode, IDroppable
'Utilisation
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
Le type MasterKey expose les membres suivants.
Constructeurs
Nom | Description | |
---|---|---|
MasterKey() () () () | Initializes a new instance of the MasterKey class. | |
MasterKey(Database) | Initializes a new instance of the MasterKey class on the specified database. |
Haut de la page
Propriétés
Nom | Description | |
---|---|---|
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 | Obtient ou définit la valeur de la propriété Boolean qui spécifie si l'objet est défini selon l'option permettant l'exécution qui retourne une valeur scalaire. (hérité de 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 | Obtient la valeur de la propriété Boolean qui spécifie si les propriétés de l'objet ont été mises à jour mais n'ont pas encore été rendues persistantes sur le serveur. (hérité de SqlSmoObject.) | |
ObjectInSpace | Obtient la valeur de la propriété Boolean qui spécifie si l'objet existe dans l'isolation, ou s'il est connecté directement ou indirectement à l'instance de SQL Server. (hérité de SqlSmoObject.) | |
Parent | Gets the Database object that is the parent of the MasterKey object. | |
Properties | Obtient une collection d'objets Property qui représentent les propriétés de l'objet. (hérité de SqlSmoObject.) | |
ScalarResult | Obtient le résultat scalaire pour l'objet référencé. (hérité de SqlSmoObject.) | |
State | Gets the state of the referenced object. (hérité de SmoObjectBase.) | |
Urn | Obtient la valeur URN (Uniform Resource Name) qui identifie de façon unique l'objet. (hérité de SqlSmoObject.) | |
UserData | Gets or sets user-defined data associated with the referenced object. (hérité de SmoObjectBase.) |
Haut de la page
Méthodes
Nom | Description | |
---|---|---|
AddDatabaseContext(StringCollection) | Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries. (hérité de SqlSmoObject.) | |
AddDatabaseContext(StringCollection, ScriptingOptions) | Ajoute le contexte de base de données à la collection de requêtes identifiée par le paramètre queries, à l'aide des options de script spécifiées. (hérité de SqlSmoObject.) | |
AddPasswordEncryption | Adds password encryption to the master key. | |
AddServiceKeyEncryption | Adds service key encryption to the master key. | |
AlterImpl | Active l'événement d'objet modifié. (hérité de SqlSmoObject.) | |
AlterImplFinish | Méthode appelée lorsque l'événement d'objet modifié est terminé. (hérité de SqlSmoObject.) | |
AlterImplInit | Méthode appelée lorsque l'événement d'objet modifié est initialisé. (hérité de SqlSmoObject.) | |
AlterImplWorker | Appelle les méthodes de modification. (hérité de SqlSmoObject.) | |
BindDefaultImpl | Lie les éléments par défaut identifiés par les paramètres. (hérité de SqlSmoObject.) | |
BindRuleImpl | Lie le schéma de règle à la règle et aux colonnes identifiées par les paramètres. (hérité de SqlSmoObject.) | |
CheckCollation | Vérifie l'ordre des options de script par la méthode de classement identifiée par le paramètre collationName. (hérité de SqlSmoObject.) | |
CheckObjectState() () () () | Valide l'état de l'objet référencé. (hérité de SqlSmoObject.) | |
CheckObjectState(Boolean) | Valide l'état de l'objet référencé avec l'option permettant de spécifier qu'une exception est levée si l'objet n'est pas encore créé. (hérité de SqlSmoObject.) | |
CheckObjectStateImpl | Vérifie l'état de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
CheckVersion100 | Vérifie si la version de SQL Server est SQL Server 2008. (hérité de SqlSmoObject.) | |
CheckVersion80 | Vérifie la validité de l'objet sur SQL Server 2000. (hérité de SqlSmoObject.) | |
CheckVersion80SP3 | Vérifie la validité de l'objet sur SQL Server 2000 SP3. (hérité de SqlSmoObject.) | |
CheckVersion90 | Vérifie la validité de l'objet sur SQL Server 2005. (hérité de SqlSmoObject.) | |
CheckVersionBelow90 | Vérifie si la version de SQL Server est antérieure à SQL Server 2005. (hérité de SqlSmoObject.) | |
CleanObject | Définit l'objet sur l'état non modifié. (hérité de 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 | Crée un objet avec les options de script. (hérité de SqlSmoObject.) | |
CreateImplFinish | Méthode appelée lorsque l'événement de création est terminé. (hérité de SqlSmoObject.) | |
CreateImplInit | Méthode appelée lorsque l'événement de création est initialisé. (hérité de SqlSmoObject.) | |
Discover | Découvre une liste de type Object. (hérité de SqlSmoObject.) | |
Drop | Removes the master key from the database. | |
DropImpl | Supprime un SqlSmoObject. (hérité de SqlSmoObject.) | |
DropImplWorker | Appelle les méthodes de suppression. (hérité de 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 | Énumère des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.) | |
EnumScriptImplWorker | Appelle les méthodes qui énumèrent des scripts spécifiés par le paramètre so. (hérité de SqlSmoObject.) | |
EnumScriptImplWorkerSOChanged | Retourne une chaîne IEnumerable qui décrit les options de script pour un objet. (hérité de SqlSmoObject.) | |
Equals | (hérité de Object.) | |
ExecuteNonQuery | (hérité de SqlSmoObject.) | |
Export | Saves the database master key to the specified system path location by using the specified password. | |
Finalize | (hérité de Object.) | |
FormatSqlVariant | Met en forme un objet en tant que type SqlVariant. (hérité de SqlSmoObject.) | |
GenerateDataSpaceFileStreamScript | Génère un script pour créer un fichier de données. (hérité de SqlSmoObject.) | |
GenerateDataSpaceScript | Génère un script pour allouer l'espace dans le fichier de données. (hérité de SqlSmoObject.) | |
GetBindDefaultScript | Obtient le script qui lie les valeurs par défaut spécifiées par les paramètres defName et defSchema. (hérité de SqlSmoObject.) | |
GetBindRuleScript | Obtient le script qui spécifie les règles de liaison. (hérité de SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Affecte un paramètre booléen du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Affecte une propriété booléenne du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetDateTimeParameter | Affecte une propriété datetime du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetDateTimeParameterAsInt | Affecte la propriété datetime du SqlSmoObject comme une valeur entière, si la propriété datetime n'est pas Null. (hérité de SqlSmoObject.) | |
GetDBName | Obtient le nom de la base de données associée à l'objet. (hérité de SqlSmoObject.) | |
GetEnumParameter | Affecte une propriété d'énumération du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetFragOptionString | Obtient un objet FragmentationOption en tant que valeur de chaîne. (hérité de SqlSmoObject.) | |
GetGuidParameter | Affecte une propriété Guid du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetHashCode | (hérité de Object.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Affecte un paramètre du SqlSmoObject. (hérité de SqlSmoObject.) | |
GetPropValue | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetPropValueOptional | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetPropValueOptionalAllowNull | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetRealValue | Obtient une valeur de propriété de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetScriptingOptionsForCreate | Obtient ScriptingOptions pour l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetServerName | Obtient le nom de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.) | |
GetServerObject | Obtient le serveur de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetSqlServerVersionName | Obtient le nom de version de l'instance de SQL Server à laquelle l'objet est associé. (hérité de SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | Affecte un paramètre de chaîne de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetTimeSpanParameterAsInt | Affecte un paramètre d'intervalle de temps de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetType | (hérité de Object.) | |
GetUrnRecursive(StringBuilder) | Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
GetUrnRecursive(StringBuilder, UrnIdOption) | Affecte un objet Urn de l'objet SqlSmoObject. (hérité de SqlSmoObject.) | |
ImplInitialize | Initialise les champs de l'objet SqlSmoObject. (hérité de 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() () () () | Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.) | |
Initialize(Boolean) | Initialise l'objet et force le chargement des propriétés. (hérité de SqlSmoObject.) | |
IsObjectDirty | Vérifie si les propriétés de l'objet ont été modifiées et si les modifications n'ont pas encore été rendues persistantes sur l'instance de SQL Server. (hérité de SqlSmoObject.) | |
IsObjectInitialized | Vérifie si l'objet a été initialisé. (hérité de SqlSmoObject.) | |
IsObjectInSpace | Vérifie si l'objet est isolé ou connecté à l'instance de SQL Server. (hérité de SqlSmoObject.) | |
IsVersion80SP3 | Détermine si la version de SQL Server est SQL Server 2000 avec SP3. (hérité de SqlSmoObject.) | |
IsVersion90AndAbove | Détermine si la version de SQL Server est SQL Server 2005 ou une version ultérieure. (hérité de SqlSmoObject.) | |
MarkDropped | Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.) | |
MarkForDropImpl | Définit l'objet SqlSmoState à supprimer. (hérité de SqlSmoObject.) | |
MemberwiseClone | (hérité de Object.) | |
Open | Opens the database master key by using the specified password. | |
PostAlter | Méthode activée après la modification du SqlSmoObject. (hérité de SqlSmoObject.) | |
PostCreate | Méthode activée après la création du SqlSmoObject. (hérité de SqlSmoObject.) | |
PostDrop | Méthode activée après la suppression du SqlSmoObject. (hérité de SqlSmoObject.) | |
Refresh | Actualise l'objet et récupère les propriétés lors du prochain accès à l'objet. (hérité de 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 | Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.) | |
ScriptCreate | Modifie l'objet SqlSmoObject d'après les paramètres. (hérité de SqlSmoObject.) | |
ScriptDdl | Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.) | |
ScriptDrop | Lève une exception InvalidSmoOperationException. (hérité de SqlSmoObject.) | |
ScriptImpl() () () () | Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.) | |
ScriptImpl(ScriptingOptions) | Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.) | |
ScriptImplWorker | Obtient une collection de scripts du SqlSmoObject. (hérité de SqlSmoObject.) | |
SetParentImpl | Définit le parent du SqlSmoObject sur le paramètre newParent. (hérité de SqlSmoObject.) | |
ToString | Retourne un String qui représente l'objet référencé. (hérité de SqlSmoObject.) | |
TouchImpl | Non implémenté. (hérité de SqlSmoObject.) | |
UnbindDefaultImpl | Annule la liaison des colonnes par défaut du SqlSmoObject. (hérité de SqlSmoObject.) | |
UnbindRuleImpl | Annule la liaison des règles du SqlSmoObject. (hérité de SqlSmoObject.) | |
Validate | Validates the state of an object. (hérité de SmoObjectBase.) |
Haut de la page
Événements
Nom | Description | |
---|---|---|
PropertyChanged | Représente l'événement qui se produit lorsqu'une propriété est modifiée. (hérité de SqlSmoObject.) | |
PropertyMetadataChanged | Représente l'événement qui se produit lorsque les métadonnées de la propriété sont modifiées. (hérité de SqlSmoObject.) |
Haut de la page
Champs
Nom | Description | |
---|---|---|
m_ExtendedProperties | Représente une propriété définie pour étendre les propriétés fournies par un SqlSmoObject. (hérité de SqlSmoObject.) | |
singletonParent | Représente le parent de singleton. (hérité de SqlSmoObject.) |
Haut de la page
Implémentations d'interfaces explicites
Nom | Description | |
---|---|---|
IAlienObject. . :: . .Discover | Découvre les éventuelles dépendances. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetDomainRoot | Retourne la racine du domaine. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetParent | Obtient le parent de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyType | Obtient le type de la propriété spécifiée. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetPropertyValue | Obtient la valeur de la propriété spécifiée. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .GetUrn | Obtient l'URN (Uniform Resource Name) de l'objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .Resolve | Obtient l'instance qui contient les informations relatives à l'objet de l'URN (Unified Resource Name) de l'objet. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .SetObjectState | Définit l'état de l'objet sur la valeur SfcObjectState spécifiée. (hérité de SqlSmoObject.) | |
IAlienObject. . :: . .SetPropertyValue | Définit la valeur de la propriété. (hérité de SqlSmoObject.) | |
ISfcPropertyProvider. . :: . .GetPropertySet | Obtient la référence d'interface au jeu de propriétés de cet objet. Ne référencez pas directement ce membre dans votre code. Il prend en charge l'infrastructure SQL Server. (hérité de SqlSmoObject.) | |
ISfcSupportsDesignMode. . :: . .IsDesignMode | Gets a Boolean value that indicates whether the object supports design mode. Identifié à titre d'information uniquement. Non pris en charge. La compatibilité future n'est pas garantie. |
Haut de la page
Notes
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.
Sécurité des threads
Tous les membres publics static (Shared dans Visual Basic) de ce type sont thread-safe. Tous les membres de l'instance ne sont pas garantis comme étant thread-safe.
Voir aussi