Compartilhar via


CIM_NetworkService class

This is an abstract base class, derived from the Service class. It is deprecated in version 2.7 with the recommendation that the Service class be subclassed instead. Distinguishing between services that modify traffic versus supporting basic communication has not proved useful.

Important  The DMTF (Distributed Management Task Force) CIM (Common Information Model) classes are the parent classes upon which WMI classes are built. WMI currently supports only the CIM 2.x version schemas.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties.

Syntax

class CIM_NetworkService : CIM_Service
{
  string   SystemName;
  string   SystemCreationClassName;
  string   Status;
  string   StartMode;
  boolean  Started;
  string   Name;
  datetime InstallDate;
  string   Description;
  string   CreationClassName;
  string   Caption;
  string   Keywords;
  string   ServiceURL;
  string   StartupConditions;
  string   StartupParameters;
};

Members

The CIM_NetworkService class has these types of members:

  • Properties

Properties

The CIM_NetworkService class has these properties.

Caption

Data type: string

Access type: Read-only

Short textual description of the object. This property is inherited from CIM_ManagedSystemElement.

CreationClassName

Data type: string

Access type: Read-only

Name of the class or subclass used in the creation of an instance. When used with other key properties of the class, this property allows all instances of the class and its subclasses to be uniquely identified.

Description

Data type: string

Access type: Read-only

Textual description of the object. This property is inherited from CIM_ManagedSystemElement.

InstallDate

Data type: datetime

Access type: Read-only

Date and time that the object was installed. This property does not require a value to indicate that the object is installed. This property is inherited from CIM_ManagedSystemElement.

Keywords

Data type: string

Access type: Read-only

This is a free-form array of strings that provide descriptive words and phrases that can be used in queries. Currently, this property has not been implemented because it is not standard. Also, if this were a necessary query construct, then it would be required higher in the inheritance hierarchy. The latter has not proven necessary. Therefore, the property is deprecated.

Name

Data type: string

Access type: Read-only

Unique identifier for the service that also provides an indication of the functionality that is managed. For more information, see the object Description property. This property is inherited from CIM_ManagedSystemElement.

ServiceURL

Data type: string

Access type: Read-only

This is a URL that provides the protocol, network location, and other service-specific information required to access the service. It is deprecated with the recommendation that ServiceAccessURI be instantiated instead. This new class correctly positions the semantics of the service access, and clarifies the format of the information.

Started

Data type: boolean

Access type: Read-only

If TRUE, the service has started.

StartMode

Data type: string

Access type: Read-only

Indicates whether the service is automatically started (for example, by an operating system) or only started upon request.

Values include the following:

"Automatic"

"Manual"

StartupConditions

Data type: string

Access type: Read-only

This is a free-form array of strings that specify any specific preconditions that must be met for this service to start correctly. It was expected that subclasses would refine the inherited StartService() method to suit their specific requirements. Currently, this refinement has not been required. Also, the property is not useful because it is not standard. If this were a necessary construct, then it would be required higher in the inheritance hierarchy (on Service). The latter has not proven true. Therefore, the property is deprecated.

StartupParameters

Data type: string

Access type: Read-only

This is a free-form array of strings that specify any specific parameters that must be supplied to the StartService() method for this service to start correctly. It was expected that subclasses would refine the inherited StartService() methods to suit their specific requirements. Currently, this refinement has not been necessary. If indeed the method were refined, then its parameters would more formally convey this information. Therefore, the property is deprecated.

Status

Data type: string

Access type: Read-only

Current status of the object. This property is inherited from CIM_ManagedSystemElement.

Values include the following:

"OK"

"Error"

"Degraded"

"Unknown"

"Pred Fail"

"Starting"

"Stopping"

"Service"

"Stressed"

"NonRecover"

"No Contact"

"Lost Comm"

SystemCreationClassName

Data type: string

Access type: Read-only

Scoping system's creation class name.

SystemName

Data type: string

Access type: Read-only

Name of the system that hosts the service.

Requirements

Namespace

Root\CIMV2

See also

CIM_Service