Compartir a través de


Espacio de nombres Microsoft.SqlServer.Management.Dmf

The Microsoft.SqlServer.Management.Dmf namespace contains classes that represent the SQL Server policy-based management objects. 

The top-level instance is the PolicyStore class, which proves the connection to the instance of SQL Server. The other : Policy, Condition, PolicyGroupSubscription, PolicyCategory, Facets.

The DMF objects can be used to create and manage policies that control the behavior and configuration of an instance of SQL Server. All behavior and configurations are represented by facets. The Microsoft.SqlServer.Management.Facets namespace contains the objects that represent the repository of facets used when defining policies. Policies are used when defining a DAC package using the DAC objects. This enables you control policies when installing a database application structure stored in the DAC package onto an instance of SQL Server. The specified policies determine the instances of SQL Server in the SQL Fabric to which the DAC package can be deployed.

A policy is the result of applying a condition to one of more target object. The condition is a facet combined with a state of behavior, for example, Database Mail is the facet and whether it is installed or not is the state. So, specifying that Database Mail must be installed is a condition. You can create a target set of objects by applying a filter. Then, apply the condition to the target object set to make a policy.

The Microsoft.SqlServer.Management.Dmf namespace resides in the Microsoft.SqlServer.Dmf.dll file. Additionally, some supporting objects are in the Microsoft.SqlServer.DmfSqlClrWrapper.dll and Microsoft.SqlServer.Dmf.Adapters.dll files. You will have to import these files to access the classes in the Microsoft.SqlServer.Management.Dmf namespace.

By using the Microsoft.SqlServer.Management.Dmf namespace, you can do the following:

  • Create, read, update and delete policies, target objects, conditions, filters and subscriptions.

  • Script out the DMF objects associated with the connection.

  • Define a target object set by using a filter.

  • Extract the existing configuration state from an instance of SQL Server and create a policy.

  • Export and import DMF objects.

  • Assign a policy to a set of target objects.

  • Evaluate a policy.

  • Have target subscribe to policy.

Clases

  Clase Descripción
Clase pública AdapterAlreadyExistsException The AdapterAlreadyExistsException class is an exception that is raised when an attempt is made to retrieve a collection that is not available.
Clase pública AdapterWrongNumberOfArgumentsException The AdapterWrongNumberOfArgumentsException class is an exception that is raised when the adapter receives the wrong number of arguments.
Clase pública AssemblyAlreadyRegisteredException The AssemblyAlreadyRegistered class is an exception that is raised when an the adapter receives the wrong number of arguments.
Clase pública BadEventDataException The BadEventDataException class is an exception that is raised when the event data is incorrect.
Clase pública BadExpressionTreeException The BadExpressionTreeException class is an exception that is raised when the expression tree is incorrect.
Clase pública Condition The Condition object represents a policy-based management condition.
Clase pública Condition. . :: . .Key The Condition..::..Key class represents the key that identifies the Condition class.
Clase pública ConditionCollection The ConditionCollection class represents a collection of Condition objects that represent all the conditions in the policy store.
Clase pública ConditionExtender The ConditionExtender class is an exception that is raised when the expression tree is incorrect.
Clase pública ConflictingPropertyValuesException The ConflictingPropertyValuesException class is an exception that is raised when property values conflict.
Clase pública ConnectionEvaluationHistory The ConnectionEvaluationHistory object represents information about parent policy evaluation that is stored in the system catalogs.
Clase pública ConnectionEvaluationHistory. . :: . .Key The ConnectionEvaluationHistory..::..Key class represents the key that is used to identify the ConnectionEvaluationHistory class.
Clase pública ConnectionEvaluationHistoryCollection The ConnectionEvaluationHistoryCollection class represents a collection of ConnectionEvaluationHistory objects that represent all the connection evaluation histories that are in the evaluation history.
Clase pública ConversionNotSupportedException The ConversionNotSupportedException class is an exception that is raised when an unsupported conversion is attempted on a type.
Clase pública DmfException The DmfException class represents a generic policy-based management exception.
Clase pública EvaluationDetail The EvaluationDetail object represents the evaluation information that is stored in the system catalogs about the parent policy for a given target.
Clase pública EvaluationDetail. . :: . .Key The EvaluationDetail..::..Key class represents the key that is used to identify the EvaluationDetail class.
Clase pública EvaluationDetailCollection The EvaluationDetailCollection class represents a collection of EvaluationDetail objects that represent all the detail rows that are in the evaluation.
Clase pública EvaluationFactory Represents the evaluation factory in policy-based management services.
Clase pública EvaluationHistory The EvaluationHistory object represents information about parent policy evaluation that is stored in the system catalogs.
Clase pública EvaluationHistory. . :: . .Key The EvaluationHistory..::..Key class represents the key that identifies the EvaluationHistory class.
Clase pública EvaluationHistoryCollection The EvaluationHistoryCollection class represents a collection of EvaluationHistory objects that represent all evaluation histories that are in the policy store.
Clase pública ExpressionNode The ExpressionNode object represents a policy-based management expression node. The expression node describes part of an expression, such as a constant value, an operator, or a function.
Clase pública ExpressionNodeAttribute The ExpressionNodeAttribute object represents an attribute of a policy-based management expression node.
Clase pública ExpressionNodeChildren The ExpressionNodeChildren object represents the child expression nodes that are dependent on an expression node.
Clase pública ExpressionNodeConfigurationException The ExpressionNodeConfigurationException class is an exception that is raised when the adapter receives the wrong number of arguments.
Clase pública ExpressionNodeConstant The ExpressionNodeConstant object represents an constant value that is used in an expression.
Clase pública ExpressionNodeFunction The ExpressionNodeFunction object represents part of a policy-based management expression that is a function.
Clase pública ExpressionNodeGroup The ExpressionNodeGroup object represents an expression node that is a group.
Clase pública ExpressionNodeNotConfigurableException The ExpressionNodeNotConfigurableException class is an exception that is raised when the expression node cannot be configured.
Clase pública ExpressionNodeNotConfigurableOperatorException The ExpressionNodeNotConfigurableOperatorException class is an exception that is raised if the operator cannot configure the expression node.
Clase pública ExpressionNodeOperator The ExpressionNodeOperator object represents an expression node that is an operator.
Clase pública ExpressionSerializationException The ExpressionSerializationException class is an exception that is raised when an the adapter receives the wrong number of arguments.
Clase pública ExpressionTypeMistmatchException The ExpressionTypeMismatchException class is an exception that is raised when the types in the expression do not match.
Clase pública FacetInfo The FacetInfo object represents facet information. A facet represents a logical dimension of a target object and is used, together with a local expression, to build a condition.
Clase pública FacetInfoCollection The FacetInfoCollection class represents a collection of FacetInfo objects that represent all facets on the instance of SQL Server.
Clase pública FailedOperationException The FailedOperationException class is an exception that is raised when a policy-based management operation fails.
Clase pública FunctionBadDatePartException The FunctionBadDatePartException class is an exception that is raised when the date that is supplied to the function is not the correct format.
Clase pública FunctionNoServerException The FunctionNoServerException class is an exception that is raised when the server is not recognized.
Clase pública FunctionNotASmoObjectException The FunctionNotASmoObjectException class is an exception that is raised when the function encounters an unsupported object.
Clase pública FunctionTooManyColumnsException The FunctionTooManyColumnsException class is an exception that is raised when the function has too many columns.
Clase pública FunctionWrongArgumentsNumberException The FunctionWrongArgumentsNumberException class is an exception that is raised when the function receives the incorrect number of arguments.
Clase pública FunctionWrongArgumentTypeException The FunctionWrongArgumentTypeException class is an exception that is raised when the function receives an argument that is the incorrect type.
Clase pública FunctionWrongReturnTypeException The FunctionWrongReturnTypeException class is an exception that is raised when the specified return type is not the same as the type that is returned by the function.
Clase pública InvalidInOperatorException The InvalidInOperatorException class is an exception that is raised when the operator is not valid.
Clase pública InvalidOperandException The InvalidOperandException class is an exception that is raised when an operand is encountered that is not valid.
Clase pública MissingJobScheduleException The MissingJobScheduleException class is an exception that is raised when there in no job schedule.
Clase pública MissingObjectException The MissingObjectException class is an exception that is raised when a specified object is missing.
Clase pública MissingPropertyException The MissingPropertyException class is an exception that is raised when a specified property is missing.
Clase pública MissingTypeFacetAssociationException The MissingTypeFacetAssociationException class is an exception that is raised when a specified association between a facet and a type is missing.
Clase pública NonConfigurableReadOnlyPropertyException The NonConfigurableReadOnlyPropertyException class is an exception that is raised when there is an attempt to configure a read-only property.
Clase pública NonRetrievablePropertyException The NonRetrievablePropertyException class is an exception that is raised when a property cannot be retrieved.
Clase pública NoTargetSetEnabledException The NoTargetSetEnabledException class is an exception that is raised when the target set has not been enabled.
Clase pública NullFacetException The NullFacetException class is an exception that is raised when the facet is not set.
Clase pública ObjectAlreadyExistsException The ObjectAlreadyExistsException class is an exception that is raised when an attempt to create an object that already exists is made.
Clase pública ObjectSet The ObjectSet object represents a policy-based management set of objects.
Clase pública ObjectSet. . :: . .Key The ObjectSet..::..Key class represents the key that identifies the ObjectSet class.
Clase pública ObjectSetCollection The ObjectSetCollection class represents a collection of ObjectSet objects that represent all the object sets in the policy store.
Clase pública ObjectValidationException The ObjectValidationException class is an exception that is raised when an object encounters an error during validation.
Clase pública OperatorNotApplicableException The OperatorNotApplicableException class is an exception that is raised when an operator does not have the appropriate permissions.
Clase pública Policy The Policy object represents a Policy-Based Management policy. A policy represents the relationship between a target object and a condition.
Clase pública Policy. . :: . .ConnectionProcessingFinishedEventArgs Represents the arguments that are passed to the event handler when the connection processing is finished.
Clase pública Policy. . :: . .ConnectionProcessingStartedEventArgs Represents the arguments that are passed to the event handler when the connection processing has started.
Clase pública Policy. . :: . .Key The Policy..::..Key class represents the key that identifies each instance of the Policy class.
Clase pública Policy. . :: . .PolicyEvaluationFinishedEventArgs Represents the arguments that are passed to the event handler when the evaluation of a policy finishes.
Clase pública Policy. . :: . .TargetProcessedEventArgs Represents the arguments that are passed to the event handler when the target is processed.
Clase pública PolicyCategory Represents a category that classifies policies in SQL Server Policy-Based Management. Policy Categories are used to group policies together to which target objects can subscribe.
Clase pública PolicyCategory. . :: . .Key The PolicyCategory..::..Key class represents the key that identifies the PolicyCategory class.
Clase pública PolicyCategoryCollection The PolicyCategoryCollection class represents a collection of PolicyCategory objects that represent all policy categories in the policy store.
Clase pública PolicyCategoryInformation Contains information about the policy category in policy-based management services.
Clase pública PolicyCategorySubscription The PolicyCategorySubscription object represents a subscription to a particular policy category.
Clase pública PolicyCategorySubscription. . :: . .Key The PolicyCategorySubscription..::..Key class represents the key that identifies the PolicyCategorySubscription class.
Clase pública PolicyCategorySubscriptionCollection The PolicyCategorySubscriptionCollection class represents a collection of PolicyCategorySubscription objects that represent all policy category subscriptions that are in the policy store.
Clase pública PolicyCollection The PolicyCollection class represents a collection of Policy objects that represent all policies in the policy store.
Clase pública PolicyEvaluationException The PolicyEvaluationException class is an exception that is raised when an error occurs during the evaluation of a policy.
Clase pública PolicyEvaluationResultsWriter Represents the XML writer that records the policy evaluation history in Policy-Based Management.
Clase pública PolicyEvaluationWrapper Represents a wrapper class for the policy evaluation.
Clase pública PolicyExtender Contains additional functionality for the Policy object.
Clase pública PolicyStore The PolicyStore type is the root of the DMF object model.
Clase pública PolicyStore. . :: . .Key The PolicyStore..::..Key class represents the key that identifies each instance of the PolicyStore class.
Clase pública PolicyStoreUpgradeSession Represents a policy store upgrade session.
Clase pública PostConfigurationActionAttribute Represents a set post configuration action attributes.
Clase pública RestartPendingException The RestartPendingException class represents the exception that is raised when a system restart is pending.
Clase pública RestartPendingException< (Of < ( <'T> ) > ) > The RestartPendingException class is an exception that is raised when an error occurs when a system restart is pending.
Clase pública StringPropertyTooLongException The StringPropertyTooLongException class is an exception that is raised when the string that is assigned to a property is too long.
Clase pública TargetEvaluation Represents the target evaluation in policy-based management services.
Clase pública TargetSet The TargetSet object represents a policy-based Management target set that holds information about levels, the condition for each level, and the target types.
Clase pública TargetSet. . :: . .Key The TargetSet..::..Key class represents the key that identifies the TargetSet class.
Clase pública TargetSetCollection The TargetSetCollectionCollection class represents a collection of TargetSet objects that represent all the policies in the policy store.
Clase pública TargetSetCountMismatchException The TargetSetCountMismatchException class is an exception that is raised when the target set and facet counts do not match.
Clase pública TargetSetLevel Represents the target set level in policy-based management services.
Clase pública TargetSetLevel. . :: . .Key The TargetSetLevel..::..Key class represents the key that identifies the TargetSetLevel class.
Clase pública TargetSetLevelCollection The TargetSetLevelCollection class represents a collection of TargetSetLevel objects that represent all target set levels in the target set.
Clase pública TypeConversionException The TypeConversionException class is an exception that is raised when a type conversion error occurs.
Clase pública UnsupportedObjectTypeException The UnsupportedObjectTypeException class is an exception that is raised when an error occurs when the policy encounters an unsupported object.
Clase pública UnsupportedTargetSetForFacetException The UnsupportedTargetSetForFacetException class is an exception that is raised when an error occurs when the target set is not supported by the facet.
Clase pública UnsupportedTypeException The UnsupportedTypeException class is an exception that is raised when an unsupported type is encountered.
Clase pública Utils Represents a utility class that is used in policy-based management services.

Delegados

  Delegado Descripción
Delegado público Policy. . :: . .ConnectionProcessingFinishedEventHandler The Policy..::..ConnectionProcessingFinishedEventHandler class represents the event handler that handles the event that occurs when the processing of the connection has finished.
Delegado público Policy. . :: . .ConnectionProcessingStartedEventHandler The Policy..::..ConnectionProcessingStartedEventHandler class represents the event handler that handles the event that occurs when the processing of a connection has started.
Delegado público Policy. . :: . .PolicyEvaluationFinishedEventHandler Representa los argumentos que se pasan al controlador de eventos cuando finaliza la evaluación de una directiva.
Delegado público Policy. . :: . .PolicyEvaluationStartedEventHandler The PolicyEvaluationStartedEventHandler class represents the event handler that handles the event that occurs when the evaluation of a policy has started.
Delegado público Policy. . :: . .TargetProcessedEventHandler The TargetProcessedEventHandler class represents the event handler that handles the event that occurs when the target has been processed.

Enumeraciones

  Enumeración Descripción
Enumeración pública AdHocPolicyEvaluationMode The AdHocPolicyEvaluationMode enumeration contains values that specify the method that is used to evaluate the policy.
Enumeración pública AutomatedPolicyEvaluationMode The AutomatedPolicyEvaluationMode enumeration contains values that specify the Policy-Based Management automated policy evaluation modes.
Enumeración pública DmfExceptionType The DmfExceptionType enumeration contains values that are used to specify the policy-based management exception types.
Enumeración pública ExpressionNodeFunction. . :: . .Function The ExpressionNodeFunction..::..Function enumeration contains values that represent the different types of supported functions.
Enumeración pública ExpressionNodeType The ExpressionNodeType enumeration contains values that specify the type of expression node.
Enumeración pública ExpressionSerializationException. . :: . .ReaderActionType Represents the reader action type that is associated with the serialization. No haga referencia directamente a este miembro en el código. Admite la infraestructura de SQL Server.
Enumeración pública ImportPolicyEnabledState La enumeración ImportPolicyEnabledState contiene valores que se utilizan para especificar el estado de la directiva de importación.
Enumeración pública NameConditionType The NameConditionType enumeration contains values that are used to specify the condition that is used in a policy.
Enumeración pública OperatorType The OperatorType enumeration contains values that are used to specify the type of operator.
Enumeración pública PolicyEffectiveState The PolicyEffectiveState enumeration contains values that are used to specify the effectiveness of the policy.
Enumeración pública PolicyHealthState The PolicyHealthState enumeration contains values that specify the health state of the policy.
Enumeración pública PolicyStore. . :: . .EnumerationMode Specifies the enumeration mode for the PolicyStore object.
Enumeración pública PostConfigurationAction The PostConfigurationAction enumeration contains values that specify the action to take after configuration finishes.
Enumeración pública TypeClass The TypeClass enumeration contains values that describe the different class types.