Policy クラス
Policy オブジェクトは、ポリシー ベースの管理ポリシーを表します。 ポリシーは対象オブジェクトと条件との関係を表します。
継承階層
System.Object
Microsoft.SqlServer.Management.Sdk.Sfc.SfcInstance
Microsoft.SqlServer.Management.Dmf.Policy
名前空間: Microsoft.SqlServer.Management.Dmf
アセンブリ: Microsoft.SqlServer.Dmf (Microsoft.SqlServer.Dmf.dll)
構文
'宣言
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey := "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey := "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")> _
Public NotInheritable Class Policy _
Inherits SfcInstance _
Implements ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, _
ISfcAlterable, IAlterable, ISfcRenamable, IRenamable, ISfcValidate
'使用
Dim instance As Policy
[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
[StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
public sealed class Policy : SfcInstance,
ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable,
IAlterable, ISfcRenamable, IRenamable, ISfcValidate
[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey = L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
[StrongNameIdentityPermissionAttribute(SecurityAction::LinkDemand, PublicKey = L"0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")]
public ref class Policy sealed : public SfcInstance,
ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable,
IAlterable, ISfcRenamable, IRenamable, ISfcValidate
[<SealedAttribute>]
[<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")>]
[<StrongNameIdentityPermissionAttribute(SecurityAction.LinkDemand, PublicKey = "0024000004800000940000000602000000240000525341310004000001000100272736ad6e5f9586bac2d531eabc3acc666c2f8ec879fa94f8f7b0327d2ff2ed523448f83c3d5c5dd2dfc7bc99c5286b2c125117bf5cbe242b9d41750732b2bdffe649c6efb8e5526d526fdd130095ecdb7bf210809c6cdad8824faa9ac0310ac3cba2aa0523567b2dfa7fe250b30facbd62d4ec99b94ac47c7d3b28f1f6e4c8")>]
type Policy =
class
inherit SfcInstance
interface ISfcCreatable
interface ICreatable
interface ISfcDroppable
interface IDroppable
interface ISfcAlterable
interface IAlterable
interface ISfcRenamable
interface IRenamable
interface ISfcValidate
end
public final class Policy extends SfcInstance implements ISfcCreatable, ICreatable, ISfcDroppable, IDroppable, ISfcAlterable, IAlterable, ISfcRenamable, IRenamable, ISfcValidate
Policy 型は、以下のメンバーを公開しています。
コンストラクター
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック メソッド") |
Policy() | Policy クラスの新しいインスタンスを初期化します。 |
|
Policy(PolicyStore, String) | Policy クラスの新しいインスタンスを初期化します。 |
先頭に戻る
プロパティ
| 名前 | 説明 | |
|---|---|---|
.gif "プロテクト プロパティ") |
AbstractIdentityKey | このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
.gif "パブリック プロパティ") |
AutomatedPolicyEvaluationMode | 評価モードを取得または設定します。 |
|
CategoryId | ポリシーに関連付けられたカテゴリを一意に識別する ID 値を取得します。 |
|
Condition | 条件を取得または設定します。 |
|
CreateDate | ポリシーが作成された日時を取得します。 |
|
CreatedBy | ポリシーを作成したユーザーのポリシー ストア認証資格情報を取得します。 |
|
DateModified | ポリシーが最後に変更された日時を取得します。 |
|
Description | ポリシーの説明テキストを取得または設定します。 |
|
Enabled | ポリシーが有効かどうかを示す Boolean 値を取得または設定します。 |
|
EvaluationHistories | 評価履歴のコレクションを取得します。 |
|
HasScript | ポリシーにスクリプトが含まれるかどうかを示す Boolean 値を取得します。 |
|
HelpLink | ポリシーの追加ヘルプ情報への URN を取得または設定します。 |
|
HelpText | ヘルプ テキストの表示名を取得または設定します。 |
|
ID | ポリシーを一意に識別する ID 値を取得します。 |
|
IdentityKey | ポリシーを識別するキーを取得します。 |
|
IsSystemObject | Policy オブジェクトが Object かどうかを示します。 |
|
Metadata | インスタンスとそのドメインに関するメタデータを返します。 (SfcInstance から継承されています。) |
|
ModifiedBy | ポリシーを最後に変更したユーザーのポリシー ストア認証資格情報を取得します。 |
|
Name | Policy オブジェクトの名前を取得します。 |
|
ObjectSet | ポリシーに関連付けられているオブジェクトのセットを取得または設定します。 |
|
Parent | ポリシー オブジェクトの親である PolicyStore を取得または設定します。 |
|
PolicyCategory | ポリシーに関連付けられたカテゴリを取得または設定します。 |
|
Properties | コレクション インスタンスのプロパティを返します。 (SfcInstance から継承されています。) |
|
RootCondition | このポリシーのルート条件の名前を取得または設定します。 |
|
ScheduleUid | ポリシーを確認する SQL Server エージェント スケジュールを識別する Guid を取得または設定します。 |
|
State | SfcInstance オブジェクトの状態を返します。 (SfcInstance から継承されています。) |
|
Urn | SfcInstance オブジェクトの URN (Uniform Resource Name) を返します。 (SfcInstance から継承されています。) |
先頭に戻る
メソッド
| 名前 | 説明 | |
|---|---|---|
|
Alter | SQL Server のインスタンスにおける Policy オブジェクト プロパティに対する変更をすべて更新します。 |
|
Create | 管理ポリシー アイテムを作成します。 |
.gif "プロテクト メソッド") |
CreateIdentityKey | このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
|
Discover | ObjectSet の条件を検出して、sink パラメーターが示す ISfcDependencyDiscoveryObjectSink に追加します。 (SfcInstance.Discover(ISfcDependencyDiscoveryObjectSink) をオーバーライドします。) |
|
Drop | SQL Server のインスタンスからポリシーを削除します。 |
|
Equals | (Object から継承されています。) |
|
Evaluate(AdHocPolicyEvaluationMode, array<ISfcConnection[]) | Policy オブジェクトを評価し、targetConnections パラメーターが示すデータにポリシーを適用します。 |
|
Evaluate(AdHocPolicyEvaluationMode, array<Object[]) | 指定した評価モードを使用して、指定した対象のオブジェクトに対してすぐにポリシーを実行します。 |
|
Evaluate(AdHocPolicyEvaluationMode, SfcQueryExpression, array<ISfcConnection[]) | Policy オブジェクトを評価し、targetConnections パラメーターが示すデータにポリシーを適用します。 |
|
GetChildCollection | このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
|
GetDomain | このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
|
GetHashCode | (Object から継承されています。) |
.gif "静的メンバー") |
GetObjectFactory | オブジェクトのオブジェクト ファクトリを取得します。 |
|
GetPropertySet | SfcInstance オブジェクトのプロパティのセットを返します。 (SfcInstance から継承されています。) |
|
GetType | (Object から継承されています。) |
|
GetTypeMetadataImpl | 適切な TypeMetadata クラスを直接返すことでオーバーライドするドメインを示します。このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
|
InitializeUIPropertyState | このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
|
OnPropertyMetadataChanges | 任意の SfcInstance メタデータの有効な値が更新されるたびに呼び出されます。 (SfcInstance から継承されています。) |
|
OnPropertyValueChanges | 任意の SfcInstance プロパティの有効な値が更新されるたびに呼び出されます。 (SfcInstance から継承されています。) |
|
ProduceConfigureScript | Policy オブジェクトの条件を取得します。 |
|
Refresh | オブジェクトのプロパティを、サーバーから読み取ることによって更新します。 (SfcInstance から継承されています。) |
|
Rename | ポリシーの名前を変更します。 |
|
ResetKey | このメンバーをコード内で直接参照しないでください。このメンバーは、SQL Server インフラストラクチャをサポートしています。 (SfcInstance から継承されています。) |
|
ScriptAlter | ポリシーの作成に使用されるスクリプトを変更します。 |
|
ScriptAlterWithObjectSet | 前に作成された、Policy オブジェクトの ISfcScript オブジェクトを変更します。 |
|
ScriptCreate | ポリシーの作成に使用されるスクリプトを作成します。 |
|
ScriptCreateWithDependencies | Policy オブジェクトの ISfcScript オブジェクトを作成します。 |
|
ScriptCreateWithObjectSet | ObjectSet オブジェクトの ISfcScript オブジェクトを作成します。 |
|
ScriptDrop | ポリシーの作成に使用されるスクリプトを削除します。 |
|
ScriptDropWithObjectSet | ObjectSet の ISfcScript オブジェクトを削除します。 |
|
Serialize | インスタンスを XML にシリアル化します。 (SfcInstance から継承されています。) |
|
ToString | インスタンスの URN の文字列表記を返します。 (SfcInstance から継承されています。) |
|
UsesFacet | パラメーターが示すファセットが Condition に含まれているかどうかを示します。 |
|
Validate | mode パラメーターによる指定に従って Policy オブジェクトを検証します。 |
先頭に戻る
イベント
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック イベント") |
ConnectionProcessingFinished | 接続処理の完了時にアクティブになるイベントを表します。 |
|
ConnectionProcessingStarted | 接続処理の開始時にアクティブになるイベントを表します。 |
|
PolicyEvaluationFinished | ポリシー評価の完了時にアクティブになるイベントを表します。 |
|
PolicyEvaluationStarted | ポリシー評価の開始時にアクティブになるイベントを表します。 |
|
PropertyChanged | プロパティの変更に対する CLS 準拠のイベントです。 (SfcInstance から継承されています。) |
|
PropertyMetadataChanged | プロパティ メタデータの変更に対する CLS 準拠のイベントです。 (SfcInstance から継承されています。) |
|
TargetProcessed | ポリシー対象の処理時にアクティブになるイベントを表します。 |
先頭に戻る
フィールド
| 名前 | 説明 | |
|---|---|---|
.gif "パブリック フィールド") |
HelpLinkStringMaxLength | ヘルプ テキストへのリンクの最大長を指定します。 |
|
HelpTextStringMaxLength | ヘルプ テキストの最大長を指定します。 |
先頭に戻る
明示的なインターフェイスの実装
| 名前 | 説明 | |
|---|---|---|
.gif "明示的なインターフェイスの実装") .gif "プライベート メソッド") |
ISfcRenamable.Rename | key パラメーターが示す Policy のインスタンス名を変更します。 |
|
ISfcRenamable.ScriptRename | ポリシー内のスクリプトの名前を変更します。 |
|
ISfcValidate.Validate | Policy オブジェクトを検証します。 |
先頭に戻る
説明
ポリシーは個々のオブジェクトまたはオブジェクトの対象セットと条件との関係を表します。
対象は SQL Server のインスタンス上のエンティティで、 SQL Server のインスタンスか、そのコンポーネント (たとえばデータベースやテーブル) です。
条件はファセットとブール式との関係を表し、ファセットの状態を決定します。 ファセットは対象のディメンションです。 たとえば、対象は SQL Server のインスタンス、ファセットはデータベース メールで、式はそれがインスタンスにインストールされていることを示し、条件はデータベース メールがインストールされていることです。 したがって、指定した SQL Server インスタンスにデータベース メールがインストールされていることが、ポリシーになります。
ポリシーの評価モードによって、ポリシーがいつどのようにチェックされて実行されるかが決まります。
Policy オブジェクトを使用すると、ポリシーの以下の特性を管理できます。
条件
評価モード
スケジュール
XPath 式を使用した対象セットのフィルター
評価時のジョブ成功
評価時のジョブ失敗
ポリシー グループ
使用例
C#
Policy p = new Policy(ps, policyName);
p.AutomatedPolicyEvaluationMode = execMode;
p.Condition = condition.Name;
p.ScheduleUid = schedule.ScheduleUid;
if (execMode != AutomatedPolicyEvaluationMode.None) p.Enabled = true;
p.Create();
スレッド セーフ
この型の public static (Visual Basic では Shared) のメンバーはすべて、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。
関連項目
参照
Microsoft.SqlServer.Management.Dmf 名前空間