Bewerken

Share via


System.Management.Instrumentation Namespace

Provides the classes necessary for instrumenting applications for management and exposing their management information and events through WMI to potential consumers. Consumers such as Microsoft Application Center or Microsoft Operations Manager can then manage your application easily, and monitoring and configuring of your application is available for administrator scripts or other applications, both managed as well as unmanaged. Instrumentation of your application is easy to achieve using the InstrumentationClass custom attribute on classes you wish to expose, or using the provided BaseEvent and Instance base classes and the Instrumentation helper class.

Classes

BaseEvent

Represents classes derived from BaseEvent that are known to be management event classes. These derived classes inherit an implementation of IEvent that allows events to be fired through the Fire() method.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

DefaultManagementInstaller

Installs an instrumented assembly. To use this default project installer, simply derive a class from DefaultManagementInstaller inside the assembly. No methods need to be overridden.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

DefaultManagementProjectInstaller

Installs an instrumented assembly. To use this default project installer, derive a class from DefaultManagementProjectInstaller inside the assembly. No methods need to be overridden.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

IgnoreMemberAttribute

Causes the associated member of an instrumented class to be ignored by management instrumentation.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

Instance

Represents derived classes known to be management instrumentation instance classes. These derived classes inherit an implementation of IInstance that allows instances to be published through the Published property.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

InstanceNotFoundException

The exception thrown to indicate that no instances are returned by a provider.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

Instrumentation

Provides helper functions for exposing events and data for management. There is a single instance of this class per application domain.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

InstrumentationBaseException

Represents the base provider-related exception.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

InstrumentationClassAttribute

Specifies that a class provides event or instance instrumentation.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

InstrumentationException

Represents a provider-related exception.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

InstrumentationManager

Provides methods that manage the lifetime and the model used for decoupled providers.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

InstrumentedAttribute

Specifies that this assembly provides management instrumentation. This attribute should appear one time per assembly.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagedCommonProvider

The class is used internally by the WMI.NET Provider Extensions infrastructure.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagedNameAttribute

Allows an instrumented class, or member of an instrumented class, to present an alternate name through management instrumentation.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementBindAttribute

The ManagementBind attribute indicates that a method is used to return the instance of a WMI class associated with a specific key value.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementCommitAttribute

The ManagementCommit attribute marks a method that is called when it is necessary to update a set of read-write properties in one, atomic operation.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementConfigurationAttribute

The ManagementConfiguration attribute indicates that a property or field represents a read-write WMI property.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementCreateAttribute

The ManagementCreateAttribute is used to indicate that a method creates a new instance of a managed entity.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementEntityAttribute

The ManagementEntity attribute indicates that a class provides management information exposed through a WMI provider.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementEnumeratorAttribute

The ManagementEnumerator attribute marks a method that returns all the instances of a WMI class.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementInstaller

Installs instrumented assemblies. Include an instance of this installer class in the project installer for an assembly that includes instrumentation.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementKeyAttribute

The ManagementKey attribute identifies the key properties of a WMI class.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementMemberAttribute

This class is used by the WMI.NET Provider Extensions framework. It is the base class for all the management attributes that can be applied to members.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementNameAttribute

The ManagementName attribute is used to override names exposed through a WMI class.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementNewInstanceAttribute

The base class for management attributes that have only run-time functionality and no schema representation. The management attribute classes ManagementBindAttribute, ManagementCreateAttribute and ManagementEnumeratorAttribute are all derived from this class.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementProbeAttribute

The ManagementProbe attribute indicates that a property or field represents a read-only WMI property.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementQualifierAttribute

The ManagementQualifier attribute contains additional WMI provider-related information about an associated WMI class, instance, property, field or method.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementReferenceAttribute

The ManagementReferenceAttribute marks a class member, property or method parameter as a reference to another management object or class.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementRemoveAttribute

The ManagementRemoveAttribute is used to indicate that a method cleans up an instance of a managed entity.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementTaskAttribute

The ManagementTask attribute indicates that the target method implements a WMI method.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

WmiConfigurationAttribute

The WmiConfiguration attribute indicates that an assembly contains code that implements a WMI provider by using the WMI.NET Provider Extensions model. The attribute accepts parameters that establish the high-level configuration of the implemented WMI provider.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

WmiProviderInstallationException

Represents an exception to throw when WMI provider installation fails.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

Interfaces

IEvent

Specifies a source of a management instrumentation event. Objects that implement this interface are known to be sources of management instrumentation events. Classes that do not derive from BaseEvent should implement this interface instead.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

IInstance

Specifies a source of a management instrumentation instance. Objects that implement this interface are known to be sources of management instrumentation instances. Classes that do not derive from Instance should implement this interface instead.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

Enums

InstrumentationType

Specifies the type of instrumentation provided by a class.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementConfigurationType

Represents the possible commit behaviors of a read/write property. It is used as the value of a parameter of the ManagementConfigurationAttribute attribute.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementHostingModel

Defines values that specify the hosting model for the provider.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.

ManagementQualifierFlavors

Qualifier flavors that can be used with WMI provider extensions.

Note: the WMI .NET libraries are now considered in final state, and no further development, enhancements, or updates will be available for non-security related issues affecting these libraries. The MI APIs should be used for all new development.