Compartilhar via


Classe Policy

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

Hierarquia de herança

System. . :: . .Object
  Microsoft.SqlServer.Management.Sdk.Sfc. . :: . .SfcInstance
    Microsoft.SqlServer.Management.Dmf..::..Policy

Namespace:  Microsoft.SqlServer.Management.Dmf
Assembly:  Microsoft.SqlServer.Dmf (em Microsoft.SqlServer.Dmf.dll)

Sintaxe

'Declaração
<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
'Uso
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

O tipo Policy expõe os membros a seguir.

Construtores

  Nome Descrição
Método público Policy() () () () Initializes a new instance of the Policy class.
Método público Policy(PolicyStore, String) Initializes a new instance of the Policy class.

Início

Propriedades

  Nome Descrição
Propriedade protegida AbstractIdentityKey Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Propriedade pública AutomatedPolicyEvaluationMode Gets or sets the evaluation mode.
Propriedade pública CategoryId Gets the ID value that uniquely identifies the category that is associated with the policy.
Propriedade pública Condition Gets or sets the condition.
Propriedade pública CreateDate Gets the date and time when the policy was created.
Propriedade pública CreatedBy Gets the policy store authentication credentials of the user who created the policy.
Propriedade pública DateModified Gets the date and time when the policy was last modified.
Propriedade pública Description Gets or sets the textual description of the policy.
Propriedade pública Enabled Gets or set the Boolean value that specifies whether the policy is enabled.
Propriedade pública EvaluationHistories Gets the evaluation histories collection.
Propriedade pública HasScript Gets the Boolean value that specifies whether the policy has a script.
Propriedade pública HelpLink Gets or sets a URN to additional help information for the policy.
Propriedade pública HelpText Gets or sets the display name for the help text.
Propriedade pública ID Gets the ID value that uniquely identifies the policy.
Propriedade pública IdentityKey Gets the key that identifies the policy.
Propriedade pública IsSystemObject Determines whether the Policy object is a Object.
Propriedade pública Metadata Returns metadata about the instance and its domain. (Herdado de SfcInstance.)
Propriedade pública ModifiedBy Gets the policy store authentication credentials of the user who last modified the policy.
Propriedade pública Name Gets the name of the Policy object.
Propriedade pública ObjectSet Gets or sets the set of objects that are associated with the policy.
Propriedade pública Parent Gets or sets the PolicyStore that is the parent of the policy object.
Propriedade pública PolicyCategory Gets or sets the category that is associated with the policy.
Propriedade pública Properties Returns a collection instance properties. (Herdado de SfcInstance.)
Propriedade protegida PropertyStorageProvider Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Propriedade pública RootCondition Gets or sets the name of the root condition for this policy.
Propriedade pública ScheduleUid Gets or sets the Guid that identifies the SQL Server Agent schedule that checks on the policy.
Propriedade protegida State Returns the state of the SfcInstance object. (Herdado de SfcInstance.)
Propriedade pública Urn Returns the uniform resource name of the SfcInstance object. (Herdado de SfcInstance.)

Início

Métodos

  Nome Descrição
Método público Alter Updates any Policy object property changes on the instance of SQL Server.
Método protegido AlterImpl Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido CheckObjectCreated Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido CheckObjectState Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público Create Creates management policy item.
Método protegido CreateIdentityKey Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido CreateImpl Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público Discover Discovers conditions in the ObjectSet and adds them to the ISfcDependencyDiscoveryObjectSink identified by the sink parameter. (Substitui SfcInstance. . :: . .Discover(ISfcDependencyDiscoveryObjectSink).)
Método público Drop Removes the policy from the instance of SQL Server.
Método protegido DropImpl Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público Equals (Herdado de Object.)
Método público Evaluate(AdHocPolicyEvaluationMode, array<ISfcConnection> [] () [] []) Evaluates the Policy object and applies policy to the data in identified by the targetConnections parameter.
Método público Evaluate(AdHocPolicyEvaluationMode, array<Object> [] () [] []) Immediately executes the policy against the specified target objects by using the specified evaluation mode.
Método público Evaluate(AdHocPolicyEvaluationMode, SfcQueryExpression, array<ISfcConnection> [] () [] []) Evaluates the Policy object and applies policy to the data in identified by the targetConnections parameter.
Método protegido Finalize (Herdado de Object.)
Método protegido GetChildCollection Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público GetDomain Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público GetHashCode (Herdado de Object.)
Método públicoMembro estático GetObjectFactory Gets the object factory for the object.
Método público GetPropertySet Returns the set of properties for the SfcInstance object. (Herdado de SfcInstance.)
Método público GetType (Herdado de Object.)
Método protegido GetTypeMetadataImpl Indicates the domains that override by returning the right TypeMetadata class directly. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido InitializeUIPropertyState Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido MarkForDropImpl Returns a value that indicates the existing objects to be dropped. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido MarkRootAsConnected Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido MemberwiseClone (Herdado de Object.)
Método protegido MoveImpl Indicates the new parent object to move in an instance. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido OnPropertyMetadataChanges Invoked whenever the effective value of any SfcInstance metadata is updated. (Herdado de SfcInstance.)
Método protegido OnPropertyValueChanges Invoked whenever the effective value of any SfcInstance property is updated. (Herdado de SfcInstance.)
Método protegido PostAlter Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido PostCreate Indicates the default implementor that creates the execution result. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido PostDrop Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido PostMove Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido PostRename Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público ProduceConfigureScript Gets the condition of a Policy object.
Método público Refresh Refreshes the object's properties by reading them from the server. (Herdado de SfcInstance.)
Método público Rename Renames the policy.
Método protegido RenameImpl Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método protegido ResetKey Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público ScriptAlter Alters the script that is used to create the policy.
Método público ScriptAlterWithObjectSet Alters a previously created ISfcScript object of the Policy object.
Método público ScriptCreate Creates a script that is used to create the policy.
Método público ScriptCreateWithDependencies Creates the ISfcScript object of the Policy object.
Método público ScriptCreateWithObjectSet Creates the ISfcScript object of the ObjectSet.
Método público ScriptDrop Drops the script that is used to create the policy.
Método público ScriptDropWithObjectSet Drops the ISfcScript object of the ObjectSet.
Método público Serialize Serializes the instance to XML. (Herdado de SfcInstance.)
Método público ToString Returns a string representation of the instance Urn. (Herdado de SfcInstance.)
Método protegido UpdateUIPropertyState Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público UsesFacet Determines whether the facet identified by the parameter is contained by the Condition.
Método protegido Validate() () () () Indicates the basic child object's validation. Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Método público Validate(String) Validates a Policy object as specified by the mode parameter.

Início

Eventos

  Nome Descrição
Evento público ConnectionProcessingFinished Represents the event activated when connection processing completes.
Evento público ConnectionProcessingStarted Represents the event activated when connection processing begins.
Evento público PolicyEvaluationFinished Represents the event activated when policy evaluation completes.
Evento público PolicyEvaluationStarted Represents the event activated when policy evaluation begins.
Evento protegido propertyChanged Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Evento público PropertyChanged CLS-compliant event for property changes. (Herdado de SfcInstance.)
Evento protegido propertyMetadataChanged Não referencie esse membro diretamente no código. Ele dá suporte à infraestrutura do SQL Server. (Herdado de SfcInstance.)
Evento público PropertyMetadataChanged CLS-compliant event for property metadata changes. (Herdado de SfcInstance.)
Evento público TargetProcessed Represents the event activated when policy target is processed.

Início

Campos

  Nome Descrição
Campo públicoMembro estático HelpLinkStringMaxLength Specifies the maximum length of the link to help text.
Campo públicoMembro estático HelpTextStringMaxLength Specifies the maximum length of the help text.

Início

Implementações de interfaces explícitas

  Nome Descrição
Implementações de interfaces explícitasMétodo privado ISfcRenamable. . :: . .Rename Renames the instance of Policy identified by the key parameter.
Implementações de interfaces explícitasMétodo privado ISfcRenamable. . :: . .ScriptRename Renames a script in the policy.
Implementações de interfaces explícitasMétodo privado ISfcValidate. . :: . .Validate Validates a Policy object.

Início

Comentários

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

Exemplos

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

Segurança de thread

Qualquer membro público static (Shared no Visual Basic) desse tipo é seguro para threads. Não há garantia de que qualquer membro de instância seja seguro para threads.