Skip to content

Latest commit

 

History

History
405 lines (236 loc) · 11 KB

cim-clusteringservice.md

File metadata and controls

405 lines (236 loc) · 11 KB
description ms.assetid ms.tgt_platform title ms.topic ms.date topic_type api_name api_type api_location
The CIM\_ClusteringService class represents the functionality provided by a cluster. For example, failover functionality can be modeled as a service of a failover cluster.
550e3be3-c1e2-4714-b702-49cb1213c65b
multiple
CIM_ClusteringService class
reference
05/31/2018
APIRef
kbSyntax
CIM_ClusteringService
CIM_ClusteringService.Caption
CIM_ClusteringService.Description
CIM_ClusteringService.InstallDate
CIM_ClusteringService.Status
CIM_ClusteringService.CreationClassName
CIM_ClusteringService.Name
CIM_ClusteringService.Started
CIM_ClusteringService.StartMode
CIM_ClusteringService.SystemCreationClassName
CIM_ClusteringService.SystemName
DllExport
CIMWin32.dll

CIM_ClusteringService class

The CIM_ClusteringService class represents the functionality provided by a cluster. For example, failover functionality can be modeled as a service of a failover cluster.

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 inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[Abstract, UUID("{debac832-6b54-4add-8a62-8d3861b97b1d}"), AMENDMENT]
class CIM_ClusteringService : CIM_Service
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  string   CreationClassName;
  string   Name;
  boolean  Started;
  string   StartMode;
  string   SystemCreationClassName;
  string   SystemName;
};

Members

The CIM_ClusteringService class has these types of members:

Methods

The CIM_ClusteringService class has these methods.

Method Description
AddNode Class method that brings a new computer system into a cluster. Not implemented by WMI.
EvictNode Class method that removes a computer system from a cluster. Not implemented by WMI.
StartService Class method that attempts to place the service into its startup state. Not implemented by WMI.
StopService Class method that places the service in the stopped state. Not implemented by WMI.

Properties

The CIM_ClusteringService class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64), DisplayName ("Caption")

A short textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

CreationClassName

Data type: string

Access type: Read-only

Qualifiers: CIM_Key, DisplayName ("Class Name")

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.

This property is inherited from CIM_Service.

Description

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Description")

A textual description of the object.

This property is inherited from CIM_ManagedSystemElement.

InstallDate

Data type: datetime

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5"), DisplayName ("Install Date")

Indicates when the object was installed. Lack of a value does not indicate that the object is not installed.

This property is inherited from CIM_ManagedSystemElement.

Name

Data type: string

Access type: Read-only

Qualifiers: Key

The Name property uniquely identifies the service and provides an indication of the functionality that is managed. This functionality is described in more detail in the object's Description property.

This property is inherited from CIM_Service.

Started

Data type: boolean

Access type: Read-only

Qualifiers: DisplayName ("Started")

If TRUE, the service has started.

This property is inherited from CIM_Service.

StartMode

Data type: string

Access type: Read-only

Qualifiers: DisplayName ("Start Mode")

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

This property is inherited from CIM_Service.

Automatic ("Automatic")

Manual ("Manual")

Status

Data type: string

Access type: Read-only

Qualifiers: MaxLen (10), DisplayName ("Status")

String that indicates the current status of the object. Operational and non-operational status can be defined. Operational status can include "OK", "Degraded", and "Pred Fail". "Pred Fail" indicates that an element is functioning properly, but is predicting a failure (for example, a SMART-enabled hard disk drive).

Non-operational status can include "Error", "Starting", "Stopping", and "Service". "Service" can apply during disk mirror-resilvering, reloading a user permissions list, or other administrative work. Not all such work is online, but the managed element is neither "OK" nor in one of the other states.

This property is inherited from CIM_ManagedSystemElement.

Values include the following:

OK ("OK")

Error ("Error")

Degraded ("Degraded")

Unknown ("Unknown")

Pred Fail ("Pred Fail")

Starting ("Starting")

Stopping ("Stopping")

Service ("Service")

Stressed ("Stressed")

NonRecover ("NonRecover")

No Contact ("No Contact")

Lost Comm ("Lost Comm")

SystemCreationClassName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_System.CreationClassName"), CIM_Key, DisplayName ("System Class Name")

Scoping system's creation class name.

This property is inherited from CIM_Service.

SystemName

Data type: string

Access type: Read-only

Qualifiers: Propagated ("CIM_System.Name"), CIM_Key, DisplayName ("System Name")

Name of the system that hosts the service.

This property is inherited from CIM_Service.

Remarks

The CIM_ClusteringService class is derived from CIM_Service.

WMI does not implement this class.

This documentation is derived from the CIM class descriptions published by the DMTF. Microsoft may have made changes to correct minor errors, conform to Microsoft SDK documentation standards, or provide more information.

Requirements

Requirement Value
Minimum supported client
Windows Vista
Minimum supported server
Windows Server 2008
Namespace
Root\CIMV2
MOF
CIMWin32.mof
DLL
CIMWin32.dll

See also

CIM_Service