MasterKey クラス
MasterKey オブジェクトは、SQL Server データベース マスター キーを表します。
継承階層
System. . :: . .Object
Microsoft.SqlServer.Management.Smo. . :: . .SmoObjectBase
Microsoft.SqlServer.Management.Smo. . :: . .SqlSmoObject
Microsoft.SqlServer.Management.Smo..::..MasterKey
名前空間: Microsoft.SqlServer.Management.Smo
アセンブリ: Microsoft.SqlServer.Smo (Microsoft.SqlServer.Smo.dll)
構文
'宣言
Public NotInheritable Class MasterKey _
Inherits SqlSmoObject _
Implements ISfcSupportsDesignMode, IDroppable
'使用
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
MasterKey 型は、以下のメンバーを公開しています。
コンストラクター
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック メソッド") |
MasterKey() () () () | MasterKey クラスの新しいインスタンスを初期化します。 |
|
MasterKey(Database) | 指定したデータベースの MasterKey クラスの新しいインスタンスを初期化します。 |
先頭に戻る
プロパティ
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック プロパティ") |
CreateDate | マスター キーが作成された日時を取得します。 |
|
DateLastModified | マスター キーが前回変更された日時を取得します。 |
.gif "プロテクト プロパティ") |
ExecuteForScalar | オブジェクトがスカラー オプションの実行に対して設定されるかどうかを示す Boolean プロパティ値を取得または設定します。 (SqlSmoObject から継承されています。) |
|
IsEncryptedByServer | データベース マスター キーがサービス マスター キーを使用して暗号化されるか、パスワードを使用して暗号化されるかを示す Boolean プロパティ値を取得します。 |
|
IsOpen | データベース マスター キーが開いているかどうかを示す Boolean プロパティ値を取得します。 |
|
IsTouched | オブジェクトのプロパティが更新されていてもサーバーに保存されていないかどうかを示す Boolean プロパティ値を取得します。 (SqlSmoObject から継承されています。) |
|
ObjectInSpace | オブジェクトが孤立して存在するか、SQL Server のインスタンスに直接的または間接的に接続されているかを示す Boolean プロパティ値を取得します。 (SqlSmoObject から継承されています。) |
|
Parent | MasterKey オブジェクトの親である Database オブジェクトを取得します。 |
|
Properties | オブジェクトのプロパティを表す Property オブジェクトのコレクションを取得します。 (SqlSmoObject から継承されています。) |
|
ScalarResult | 参照先オブジェクトのスカラー結果を取得します。 (SqlSmoObject から継承されています。) |
|
State | 参照先のオブジェクトの状態を取得します。 (SmoObjectBase から継承されています。) |
|
Urn | オブジェクトを一意に識別する URN (Uniform Resource Name) アドレスの値を取得します。 (SqlSmoObject から継承されています。) |
|
UserData | 参照先のオブジェクトに関連付けられたユーザー定義データを取得します。値の設定も可能です。 (SmoObjectBase から継承されています。) |
先頭に戻る
メソッド
| 名前 | 説明 | |
|---|---|---|
.gif "プロテクト メソッド") |
AddDatabaseContext(StringCollection) | queries パラメーターによって識別されたクエリのコレクションにデータベース コンテキストを追加します。 (SqlSmoObject から継承されています。) |
|
AddDatabaseContext(StringCollection, ScriptingOptions) | queries パラメーターによって識別されたクエリのコレクションに、指定したスクリプト作成オプションを使用してデータベース コンテキストを追加します。 (SqlSmoObject から継承されています。) |
|
AddPasswordEncryption | マスター キーにパスワード暗号化を追加します。 |
|
AddServiceKeyEncryption | マスター キーにサービス キー暗号化を追加します。 |
|
AlterImpl | Object Altered イベントをアクティブにします。 (SqlSmoObject から継承されています。) |
|
AlterImplFinish | Object Altered イベントの終了時に呼び出されるメソッドです。 (SqlSmoObject から継承されています。) |
|
AlterImplInit | Object-Altered イベントの初期化時に呼び出されるメソッドです。 (SqlSmoObject から継承されています。) |
|
AlterImplWorker | Alter メソッドを呼び出します。 (SqlSmoObject から継承されています。) |
|
BindDefaultImpl | パラメーターによって識別された既定のアイテムをバインドします。 (SqlSmoObject から継承されています。) |
|
BindRuleImpl | パラメーターによって識別されたルールおよび列にルール スキーマをバインドします。 (SqlSmoObject から継承されています。) |
|
CheckCollation | collationName パラメーターによって識別された Collation メソッドを使用して、スクリプト作成オプションの順序を確認します。 (SqlSmoObject から継承されています。) |
|
CheckObjectState() () () () | 参照先オブジェクトの状態を検証します。 (SqlSmoObject から継承されています。) |
|
CheckObjectState(Boolean) | 参照先オブジェクトの状態を検証します。オブジェクトがまだ作成されていない場合は、例外をスローするように指定することも可能です。 (SqlSmoObject から継承されています。) |
|
CheckObjectStateImpl | SqlSmoObject の状態を確認します。 (SqlSmoObject から継承されています。) |
|
CheckVersion100 | SQL Server のバージョンが SQL Server 2008 かどうかを確認します。 (SqlSmoObject から継承されています。) |
|
CheckVersion80 | SQL Server 2000 でのオブジェクトの有効性を確認します。 (SqlSmoObject から継承されています。) |
|
CheckVersion80SP3 | SQL Server 2000 SP3 でのオブジェクトの有効性を確認します。 (SqlSmoObject から継承されています。) |
|
CheckVersion90 | SQL Server 2005 でのオブジェクトの有効性を確認します。 (SqlSmoObject から継承されています。) |
|
CheckVersionBelow90 | SQL Server のバージョンが SQL Server 2005 より前のバージョンかどうかを確認します。 (SqlSmoObject から継承されています。) |
|
CleanObject | オブジェクトを変更されていない状態に設定します。 (SqlSmoObject から継承されています。) |
|
Close | マスター キーを閉じます。 |
|
Create(String) | 指定したパスワードが設定されたマスター キーを作成します。 |
|
Create(String, String, String) | 指定した暗号化パスワードおよび暗号化解除パスワードが設定されたマスター キーを、指定したファイルから作成します。 |
|
CreateImpl | スクリプト作成オプションを使用してオブジェクトを作成します。 (SqlSmoObject から継承されています。) |
|
CreateImplFinish | Create イベントの終了時に呼び出されるメソッドです。 (SqlSmoObject から継承されています。) |
|
CreateImplInit | Create イベントによる初期化時に呼び出されるメソッドです。 (SqlSmoObject から継承されています。) |
|
Discover | Object 型の一覧を検出します。 (SqlSmoObject から継承されています。) |
|
Drop | データベースからマスター キーを削除します。 |
|
DropImpl | SqlSmoObject を削除します。 (SqlSmoObject から継承されています。) |
|
DropImplWorker | Drop メソッドを呼び出します。 (SqlSmoObject から継承されています。) |
|
DropPasswordEncryption | 関連付けられたパスワードを使用して、マスター キーからパスワード暗号化を削除します。 |
|
DropServiceKeyEncryption | マスター キーからサービス キー暗号化を削除します。 |
|
EnumKeyEncryptions | データベース マスター キーのキー暗号化の現在のセットの一覧を列挙します。 |
|
EnumScriptImpl | so パラメーターで指定されたスクリプトを列挙します。 (SqlSmoObject から継承されています。) |
|
EnumScriptImplWorker | so パラメーターで指定されたスクリプトを列挙するメソッドを呼び出します。 (SqlSmoObject から継承されています。) |
|
EnumScriptImplWorkerSOChanged | オブジェクトのスクリプト作成オプションを説明する IEnumerable 文字列を返します。 (SqlSmoObject から継承されています。) |
|
Equals | (Object から継承されています。) |
|
ExecuteNonQuery | 返される結果がないデータベースのコンテキストで、バッチを実行します。 (SqlSmoObject から継承されています。) |
|
Export | 指定したパスワードを使用して、データベース マスター キーを指定したシステム パスの場所に保存します。 |
|
Finalize | (Object から継承されています。) |
|
FormatSqlVariant | SqlVariant 型としてオブジェクトの書式を設定します。 (SqlSmoObject から継承されています。) |
|
GenerateDataSpaceFileStreamScript | データ ファイルを作成するスクリプトを生成します。 (SqlSmoObject から継承されています。) |
|
GenerateDataSpaceScript | データ ファイルに領域を割り当てるスクリプトを生成します。 (SqlSmoObject から継承されています。) |
|
GetBindDefaultScript | defSchema パラメーターおよび defName パラメーターで指定された既定値をバインドするスクリプトを取得します。 (SqlSmoObject から継承されています。) |
|
GetBindRuleScript | バインド ルールを示すスクリプトを取得します。 (SqlSmoObject から継承されています。) |
|
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | SqlSmoObject のブール型パラメーターを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetBoolParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | SqlSmoObject のブール型プロパティを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetDateTimeParameter | SqlSmoObject の日時プロパティを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetDateTimeParameterAsInt | 日時プロパティが NULL でない場合、整数値として SqlSmoObject の日時プロパティを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetDBName | オブジェクトに関連付けられたデータベース名を取得します。 (SqlSmoObject から継承されています。) |
|
GetEnumParameter | SqlSmoObject の列挙プロパティを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetFragOptionString | FragmentationOption オブジェクトを文字列値として取得します。 (SqlSmoObject から継承されています。) |
|
GetGuidParameter | SqlSmoObject の Guid プロパティを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetHashCode | (Object から継承されています。) |
|
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | SqlSmoObject のパラメーターを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | SqlSmoObject のパラメーターを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetPropValue | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetPropValueOptional | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetPropValueOptionalAllowNull | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetRealValue | SqlSmoObject オブジェクトのプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
GetScriptingOptionsForCreate | SqlSmoObject オブジェクトの ScriptingOptions を取得します。 (SqlSmoObject から継承されています。) |
|
GetServerName | オブジェクトが関連付けられている SQL Server のインスタンスの名前を取得します。 (SqlSmoObject から継承されています。) |
|
GetServerObject | SqlSmoObject オブジェクトのサーバーを取得します。 (SqlSmoObject から継承されています。) |
|
GetSqlServerVersionName | オブジェクトが関連付けられている SQL Server のインスタンスのバージョン名を取得します。 (SqlSmoObject から継承されています。) |
|
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%) | SqlSmoObject オブジェクトの文字列パラメーターを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetStringParameter(StringBuilder, ScriptingOptions, String, String, Int32%, Boolean) | SqlSmoObject オブジェクトの文字列パラメーターを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetTimeSpanParameterAsInt | SqlSmoObject オブジェクトの期間パラメーターを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetType | (Object から継承されています。) |
|
GetUrnRecursive(StringBuilder) | SqlSmoObject オブジェクトの Urn オブジェクトを割り当てます。 (SqlSmoObject から継承されています。) |
|
GetUrnRecursive(StringBuilder, UrnIdOption) | SqlSmoObject オブジェクトの Urn オブジェクトを割り当てます。 (SqlSmoObject から継承されています。) |
|
ImplInitialize | SqlSmoObject オブジェクトのフィールドを初期化します。 (SqlSmoObject から継承されています。) |
|
Import(String, String, String) | マスター キーの暗号化解除と暗号化のために指定したパスワードを使用して、指定したシステム パスにあるファイルからデータベース マスター キーを読み込みます。 |
|
Import(String, String, String, Boolean) | マスター キーの暗号化解除と暗号化のために指定したパスワードを使用し、再生成を強制実行するオプションを使用して、指定したシステム パスにあるファイルからデータベース マスター キーを読み込みます。 |
|
Initialize() () () () | オブジェクトを初期化し、プロパティを強制的に読み込ませます。 (SqlSmoObject から継承されています。) |
|
Initialize(Boolean) | オブジェクトを初期化し、プロパティを強制的に読み込ませます。 (SqlSmoObject から継承されています。) |
|
IsObjectDirty | オブジェクトのプロパティが変更されているかどうか、およびその変更が SQL Server のインスタンスにまだ保存されていないかどうかを確認します。 (SqlSmoObject から継承されています。) |
|
IsObjectInitialized | オブジェクトが初期化されたかどうかを確認します。 (SqlSmoObject から継承されています。) |
|
IsObjectInSpace | オブジェクトが孤立しているか、または SQL Server のインスタンスに接続されているかを確認します。 (SqlSmoObject から継承されています。) |
|
IsVersion80SP3 | SQL Server のバージョンが SQL Server 2000 SP3 かどうかを示します。 (SqlSmoObject から継承されています。) |
|
IsVersion90AndAbove | SQL Server のバージョンが SQL Server 2005 以降かどうかを示します。 (SqlSmoObject から継承されています。) |
|
MarkDropped | SqlSmoState が削除されるように設定します。 (SqlSmoObject から継承されています。) |
|
MarkForDropImpl | SqlSmoState が削除されるように設定します。 (SqlSmoObject から継承されています。) |
|
MemberwiseClone | (Object から継承されています。) |
|
Open | 指定したパスワードを使用して、データベース マスター キーを開きます。 |
|
PostAlter | SqlSmoObject の変更後にアクティブ化されるメソッドです。 (SqlSmoObject から継承されています。) |
|
PostCreate | SqlSmoObject の作成後にアクティブ化されるメソッドです。 (SqlSmoObject から継承されています。) |
|
PostDrop | SqlSmoObject の削除後にアクティブ化されるメソッドです。 (SqlSmoObject から継承されています。) |
|
Refresh | オブジェクトが次回アクセスされるときに、オブジェクトを更新し、プロパティを取得します。 (SqlSmoObject から継承されています。) |
|
Regenerate(String) | 指定した新しいパスワードを使用して、データベース マスター キーを再生成します。 |
|
Regenerate(String, Boolean) | 指定した新しいパスワードを使用し、暗号化解除に失敗したすべてのアイテムを削除して再生成を強制実行するオプションを使用して、データベース マスター キーを再生成します。 |
|
ScriptAlter | パラメーターに従って SqlSmoObject を変更します。 (SqlSmoObject から継承されています。) |
|
ScriptCreate | パラメーターに従って SqlSmoObject を変更します。 (SqlSmoObject から継承されています。) |
|
ScriptDdl | InvalidSmoOperationException をスローします。 (SqlSmoObject から継承されています。) |
|
ScriptDrop | InvalidSmoOperationException をスローします。 (SqlSmoObject から継承されています。) |
|
ScriptImpl() () () () | SqlSmoObject のスクリプトのコレクションを取得します。 (SqlSmoObject から継承されています。) |
|
ScriptImpl(ScriptingOptions) | SqlSmoObject のスクリプトのコレクションを取得します。 (SqlSmoObject から継承されています。) |
|
ScriptImplWorker | SqlSmoObject のスクリプトのコレクションを取得します。 (SqlSmoObject から継承されています。) |
|
SetParentImpl | SqlSmoObject の親を newParent パラメーターに設定します。 (SqlSmoObject から継承されています。) |
|
ToString | 参照するオブジェクトを表す String を返します。 (SqlSmoObject から継承されています。) |
|
TouchImpl | 未実装です。 (SqlSmoObject から継承されています。) |
|
UnbindDefaultImpl | SqlSmoObject の既定の列をバインド解除します。 (SqlSmoObject から継承されています。) |
|
UnbindRuleImpl | SqlSmoObject のルールをバインド解除します。 (SqlSmoObject から継承されています。) |
|
Validate | オブジェクトの状態を検証します。 (SmoObjectBase から継承されています。) |
先頭に戻る
イベント
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック イベント") |
PropertyChanged | プロパティが変更されるときに発生するイベントを表します。 (SqlSmoObject から継承されています。) |
|
PropertyMetadataChanged | プロパティ メタデータが変更されたときに発生するイベントを表します。 (SqlSmoObject から継承されています。) |
先頭に戻る
フィールド
| 名前 | 説明 | |
|---|---|---|
.gif "プロテクト フィールド") |
m_ExtendedProperties | SqlSmoObject によって指定されたプロパティを拡張するよう定義されたプロパティを表します。 (SqlSmoObject から継承されています。) |
|
singletonParent | 単一の親を表します。 (SqlSmoObject から継承されています。) |
先頭に戻る
明示的なインターフェイスの実装
| 名前 | 説明 | |
|---|---|---|
.gif "明示的なインターフェイスの実装") .gif "プライベート メソッド") |
IAlienObject. . :: . .Discover | 依存関係を検出します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .GetDomainRoot | ドメインのルートを返します。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .GetParent | このオブジェクトの親を取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .GetPropertyType | 指定したプロパティの種類を取得します。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .GetPropertyValue | 指定されたプロパティの値を取得します。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .GetUrn | オブジェクトの Uniform Resource Name を取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .Resolve | オブジェクトに関する情報を含むインスタンスを、オブジェクトの Unified Resource Name から取得します。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .SetObjectState | オブジェクトの状態を、指定した SfcObjectState 値に設定します。 (SqlSmoObject から継承されています。) |
|
IAlienObject. . :: . .SetPropertyValue | プロパティの値を設定します。 (SqlSmoObject から継承されています。) |
|
ISfcPropertyProvider. . :: . .GetPropertySet | このオブジェクトのプロパティ セットへのインターフェイス リファレンスを取得します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SqlSmoObject から継承されています。) |
.gif "プライベート プロパティ") |
ISfcSupportsDesignMode. . :: . .IsDesignMode | オブジェクトがデザイン モードをサポートしているかどうかを示すブール値を取得します。単に情報を示すためだけに特定されます。サポートされていません。将来の互換性は保証されません。 |
先頭に戻る
説明
データベース マスター キーは、データベースに格納されているキーと証明書の対称的な暗号化に使用します。データベース マスター キーは、サービス マスター キーまたはユーザー指定のパスワードを使用して暗号化できます。データベース マスター キーの作成時に、そのマスター キーの暗号化および暗号化解除に使用するパスワードを指定する必要があります。
データベースが SQL Server のインスタンスにアタッチされている場合、データベース管理者は、マスター キーのパスワードを指定するか、サービス マスター キーを使用した暗号化に使用できるマスター キーの暗号化されていないコピーを作成する必要があります。
サービス マスター キーは、暗号化階層の下位層の暗号化に使用される暗号化階層の最上位層です。サービス マスター キーは Windows によって自動的に生成されます。サービス マスター キーは、そのキーを作成した Windows サービス アカウント、またはサービス アカウント名とパスワードの両方を把握しているユーザーによってのみ開くことができます。
MasterKey オブジェクトのプロパティを取得するには、固定サーバー ロール public のメンバーでもかまいません。
MasterKey オブジェクトのプロパティを設定するには、データベースの CONTROL 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
マスター キーを作成または削除するには、データベースの CONTROL 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
マスター キーを開いたり再生成したりするには、データベースの CONTROL 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
サービス キー暗号化を追加または削除するには、データベースの CONTROL 権限を持っているか、固定データベース ロール db_owner のメンバーである必要があります。
マスター キーを削除するには、固定サーバー ロール public のメンバーでもかまいません。
スレッド セーフ
この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。