Policy 클래스

The Policy object represents a Policy-Based Management policy. A policy represents the relationship between a target object and a condition.

상속 계층

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 유형에서 다음 멤버를 표시합니다.

생성자

  이름 설명
공용 메서드 Policy() Initializes a new instance of the Policy class.
공용 메서드 Policy(PolicyStore, String) Initializes a new instance of the Policy class.

맨 위로 이동

속성

  이름 설명
보호된 속성 AbstractIdentityKey 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
공용 속성 AutomatedPolicyEvaluationMode Gets or sets the evaluation mode.
공용 속성 CategoryId Gets the ID value that uniquely identifies the category that is associated with the policy.
공용 속성 Condition Gets or sets the condition.
공용 속성 CreateDate Gets the date and time when the policy was created.
공용 속성 CreatedBy Gets the policy store authentication credentials of the user who created the policy.
공용 속성 DateModified Gets the date and time when the policy was last modified.
공용 속성 Description Gets or sets the textual description of the policy.
공용 속성 Enabled Gets or set the Boolean value that specifies whether the policy is enabled.
공용 속성 EvaluationHistories Gets the evaluation histories collection.
공용 속성 HasScript Gets the Boolean value that specifies whether the policy has a script.
공용 속성 HelpLink Gets or sets a URN to additional help information for the policy.
공용 속성 HelpText Gets or sets the display name for the help text.
공용 속성 ID Gets the ID value that uniquely identifies the policy.
공용 속성 IdentityKey Gets the key that identifies the policy.
공용 속성 IsSystemObject Determines whether the Policy object is a Object.
공용 속성 Metadata Returns metadata about the instance and its domain. (SfcInstance에서 상속됨)
공용 속성 ModifiedBy Gets the policy store authentication credentials of the user who last modified the policy.
공용 속성 Name Gets the name of the Policy object.
공용 속성 ObjectSet Gets or sets the set of objects that are associated with the policy.
공용 속성 Parent Gets or sets the PolicyStore that is the parent of the policy object.
공용 속성 PolicyCategory Gets or sets the category that is associated with the policy.
공용 속성 Properties Returns a collection instance properties. (SfcInstance에서 상속됨)
공용 속성 RootCondition Gets or sets the name of the root condition for this policy.
공용 속성 ScheduleUid Gets or sets the Guid that identifies the SQL Server Agent schedule that checks on the policy.
보호된 속성 State Returns the state of the SfcInstance object. (SfcInstance에서 상속됨)
공용 속성 Urn Returns the uniform resource name of the SfcInstance object. (SfcInstance에서 상속됨)

맨 위로 이동

메서드

  이름 설명
공용 메서드 Alter Updates any Policy object property changes on the instance of SQL Server.
공용 메서드 Create Creates management policy item.
보호된 메서드 CreateIdentityKey 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
공용 메서드 Discover Discovers conditions in the ObjectSet and adds them to the ISfcDependencyDiscoveryObjectSink identified by the sink parameter. (SfcInstance.Discover(ISfcDependencyDiscoveryObjectSink)을(를) 재정의함)
공용 메서드 Drop Removes the policy from the instance of SQL Server.
공용 메서드 Equals (Object에서 상속됨)
공용 메서드 Evaluate(AdHocPolicyEvaluationMode, array<ISfcConnection[]) Evaluates the Policy object and applies policy to the data in identified by the targetConnections parameter.
공용 메서드 Evaluate(AdHocPolicyEvaluationMode, array<Object[]) Immediately executes the policy against the specified target objects by using the specified evaluation mode.
공용 메서드 Evaluate(AdHocPolicyEvaluationMode, SfcQueryExpression, array<ISfcConnection[]) Evaluates the Policy object and applies policy to the data in identified by the targetConnections parameter.
보호된 메서드 GetChildCollection 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
공용 메서드 GetDomain 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
공용 메서드 GetHashCode (Object에서 상속됨)
공용 메서드정적 멤버 GetObjectFactory Gets the object factory for the object.
공용 메서드 GetPropertySet Returns the set of properties for the SfcInstance object. (SfcInstance에서 상속됨)
공용 메서드 GetType (Object에서 상속됨)
보호된 메서드 GetTypeMetadataImpl Indicates the domains that override by returning the right TypeMetadata class directly. 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
보호된 메서드 InitializeUIPropertyState 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
보호된 메서드 OnPropertyMetadataChanges Invoked whenever the effective value of any SfcInstance metadata is updated. (SfcInstance에서 상속됨)
보호된 메서드 OnPropertyValueChanges Invoked whenever the effective value of any SfcInstance property is updated. (SfcInstance에서 상속됨)
공용 메서드 ProduceConfigureScript Gets the condition of a Policy object.
공용 메서드 Refresh Refreshes the object's properties by reading them from the server. (SfcInstance에서 상속됨)
공용 메서드 Rename Renames the policy.
보호된 메서드 ResetKey 코드에서 직접 이 멤버를 참조하면 안 됩니다. 이 방법은 SQL Server 인프라를 지원합니다. (SfcInstance에서 상속됨)
공용 메서드 ScriptAlter Alters the script that is used to create the policy.
공용 메서드 ScriptAlterWithObjectSet Alters a previously created ISfcScript object of the Policy object.
공용 메서드 ScriptCreate Creates a script that is used to create the policy.
공용 메서드 ScriptCreateWithDependencies Creates the ISfcScript object of the Policy object.
공용 메서드 ScriptCreateWithObjectSet Creates the ISfcScript object of the ObjectSet.
공용 메서드 ScriptDrop Drops the script that is used to create the policy.
공용 메서드 ScriptDropWithObjectSet Drops the ISfcScript object of the ObjectSet.
공용 메서드 Serialize Serializes the instance to XML. (SfcInstance에서 상속됨)
공용 메서드 ToString Returns a string representation of the instance Urn. (SfcInstance에서 상속됨)
공용 메서드 UsesFacet Determines whether the facet identified by the parameter is contained by the Condition.
공용 메서드 Validate Validates a Policy object as specified by the mode parameter.

맨 위로 이동

이벤트

  이름 설명
공용 이벤트 ConnectionProcessingFinished Represents the event activated when connection processing completes.
공용 이벤트 ConnectionProcessingStarted Represents the event activated when connection processing begins.
공용 이벤트 PolicyEvaluationFinished Represents the event activated when policy evaluation completes.
공용 이벤트 PolicyEvaluationStarted Represents the event activated when policy evaluation begins.
공용 이벤트 PropertyChanged CLS-compliant event for property changes. (SfcInstance에서 상속됨)
공용 이벤트 PropertyMetadataChanged CLS-compliant event for property metadata changes. (SfcInstance에서 상속됨)
공용 이벤트 TargetProcessed Represents the event activated when policy target is processed.

맨 위로 이동

필드

  이름 설명
공용 필드정적 멤버 HelpLinkStringMaxLength Specifies the maximum length of the link to help text.
공용 필드정적 멤버 HelpTextStringMaxLength Specifies the maximum length of the help text.

맨 위로 이동

명시적 인터페이스 구현

  이름 설명
명시적 인터페이스 구현전용 메서드 ISfcRenamable.Rename Renames the instance of Policy identified by the key parameter.
명시적 인터페이스 구현전용 메서드 ISfcRenamable.ScriptRename Renames a script in the policy.
명시적 인터페이스 구현전용 메서드 ISfcValidate.Validate Validates a Policy object.

맨 위로 이동

주의

A policy represents the relationship between an individual object or a target set of objects and a condition.

A target is an entity on an instance of SQL Server. It could be the instance of SQL Server, or a component of it, such as a database or a table.

A condition is a relationship between a facet and a Boolean expression that determine the state of the facet. A facet is a dimension of a target. For example, the target could be an instance of SQL Server, the facet is Database Mail, the expression specifies that it is installed on the instance and the condition is that Database Mail is installed. Thus, the policy is that Database Mail is installed on the specified instance of SQL Server.

The evaluation mode of the policy determines how and when the policy is checked and enforced.

Using the Policy object, you can manage the following characteristics of a policy:

  • Condition

  • Evaluation mode

  • Schedule

  • Target set filter using XPath expression

  • A job on evaluation success

  • A job on evaluation failure

  • A policy group

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

스레드 보안

이 유형의 모든 공용 static(Visual Basic에서는 Shared) 멤버는 스레드로부터 안전합니다. 인스턴스 멤버는 스레드로부터의 안전성이 보장되지 않습니다.

참고 항목

참조

Microsoft.SqlServer.Management.Dmf 네임스페이스

관련 자료

사용자, 역할 및 로그인 관리