MSCluster_Resource class

A dynamic WMI class that represents a cluster resource.

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

Syntax

[Dynamic, Provider("MS_CLUSTER_PROVIDER"), UUID("{C2862F9C-34DE-4b16-9EE3-099D078E9F59}"), AMENDMENT]
class MSCluster_Resource : MSCluster_LogicalElement
{
  string             Caption;
  datetime           InstallDate;
  string             Status;
  uint32             Flags;
  uint32             Characteristics;
  string             Name;
  string             Id;
  string             Description;
  uint32             IsAlivePollInterval;
  uint32             LooksAlivePollInterval;
  uint32             PendingTimeout;
  uint32             MonitorProcessId;
  boolean            PersistentState;
  uint32             RestartAction;
  uint32             RestartPeriod;
  uint32             RestartThreshold;
  uint32             EmbeddedFailureAction;
  uint32             RetryPeriodOnFailure;
  boolean            SeparateMonitor;
  string             Type;
  uint32             State;
  string             InternalState;
  uint32             ResourceClass;
  uint32             Subclass;
  MSCluster_Property PrivateProperties;
  string             CryptoCheckpoints[];
  string             RegistryCheckpoints[];
  boolean            QuorumCapable;
  boolean            LocalQuorumCapable;
  boolean            DeleteRequiresAllNodes;
  boolean            CoreResource;
  uint32             DeadlockTimeout;
  uint64             StatusInformation;
  uint64             LastOperationStatusCode;
  uint64             ResourceSpecificData1;
  uint64             ResourceSpecificData2;
  string             ResourceSpecificStatus;
  uint32             RestartDelay;
  boolean            IsClusterSharedVolume;
  string             RequiredDependencyTypes[];
  uint32             RequiredDependencyClasses[];
  string             OwnerGroup;
  string             OwnerNode;
};

Members

The MSCluster_Resource class has these types of members:

• Methods
• Properties

Methods

The MSCluster_Resource class has these methods.

Properties

The MSCluster_Resource class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

The Caption property is a short textual description (one-line string) of the object.

This property is inherited from CIM_ManagedSystemElement.

Characteristics

Data type: uint32

Access type: Read-only

Provides the characteristics of the object. The cluster defines characteristics only for resources. For a description of these characteristics, see CLUSCTL_RESOURCE_GET_CHARACTERISTICS.

**Windows Server 2008 R2 and Windows Server 2008: **

This property is read/write before Windows Server 2012.

This property is inherited from MSCluster_LogicalElement.

CoreResource

Data type: boolean

Access type: Read-only

If True, indicates that the resource is essential to the cluster and cannot be deleted.

CryptoCheckpoints

Data type: string array

Access type: Read-only

Provides a list of crypto checkpoints for the resource.

DeadlockTimeout

Data type: uint32

Access type: Read/write

Indicates the length of time to wait, in milliseconds, before declaring a deadlock in any call into a resource.

DeleteRequiresAllNodes

Data type: boolean

Access type: Read-only

If True, the resource cannot be deleted unless all nodes are active. Setting this property to True adds the CLUS_CHAR_DELETE_REQUIRES_ALL_NODES characteristic to the resource.

Description

Data type: string

Access type: Read/write

Qualifiers: Override (Description)

Provides access to the resource's Description property.

EmbeddedFailureAction

Data type: uint32

Access type: Read/write

The time, in milliseconds, that a resource should remain in a failed state before the Cluster service attempts to restart it.

**Windows Server 2008 R2 and Windows Server 2008: **

This property is not supported before Windows Server 2012.

Flags

Data type: uint32

Access type: Read-only

Provides access to the flags set for the object. The cluster defines flags only for resources. For a description of these flags, see CLUSCTL_RESOURCE_GET_FLAGS.

**Windows Server 2008 R2 and Windows Server 2008: **

This property is read/write before Windows Server 2012.

This property is inherited from MSCluster_LogicalElement.

Id

Data type: string

Access type: Read-only

The Id of the resource.

**Windows Server 2008 R2 and Windows Server 2008: **

This property is not supported before Windows Server 2012.

InstallDate

Data type: datetime

Access type: Read-only

Qualifiers: MappingStrings ("MIF.DMTF|ComponentID|001.5")

A datetime value indicating when the object was installed. A lack of a value does not indicate that the object is not installed.

This property is inherited from CIM_ManagedSystemElement.

InternalState

Data type: string

Access type: Read-only

This property is not supported.

**Windows Server 2008: **

The current internal state of the resource.

IsAlivePollInterval

Data type: uint32

Access type: Read/write

Qualifiers: Units ("Milliseconds")

Provides access to the resource's IsAlivePollInterval property, which is the recommended interval in milliseconds at which the Cluster Service should poll the resource to determine whether it is operational. If the property is set to 0xFFFFFFFF, the Cluster Service uses the IsAlivePollInterval property for the resource type associated with the resource.

IsClusterSharedVolume

Data type: boolean

Access type: Read-only

Specifies if the resource is a cluster shared volume resource.

**Windows Server 2008: **

This property is not supported before Windows Server 2008 R2.

LastOperationStatusCode

Data type: uint64

Access type: Read-only

The last application-specific error code returned by the Resource DLL during a cluster operation.

**Windows Server 2008 R2 and Windows Server 2008: **

This property is not supported before Windows Server 2012.

LocalQuorumCapable

Data type: boolean

Access type: Read-only

The resource can be selected as the quorum resource in clusters configured using the -localquorum switch.

LooksAlivePollInterval

Data type: uint32

Access type: Read/write

Qualifiers: Units ("Milliseconds")

Provides access to the resource's LooksAlivePollInterval property, which is the recommended interval in milliseconds at which the Cluster Service should poll the resource to determine whether it appears operational. If the property is set to 0xFFFFFFFF, the Cluster Service uses the LooksAlivePollInterval property for the resource type associated with the resource.

MonitorProcessId

Data type: uint32

Access type: Read-only

Provides the process ID of the resource host service that is currently hosting the resource.

**Windows Server 2012 R2, Windows Server 2012, Windows Server 2008 R2 and Windows Server 2008: **

This property was read-write prior to Windows Server 2016.

Name

Data type: string

Access type: Read-only

Qualifiers: Override (Name), Key

Provides the name of the resource.

OwnerGroup

Data type: string

Access type: Read-only

The resource group which the resource belongs to.

**Windows Server 2008 R2 and Windows Server 2008: **

This method is not supported before Windows Server 2012.

OwnerNode

Data type: string

Access type: Read-only

The node hosting the resource.

**Windows Server 2008 R2 and Windows Server 2008: **

This method is not supported before Windows Server 2012.

PendingTimeout

Data type: uint32

Access type: Read/write

Provides access to the resource's PendingTimeout property. If a resource cannot be brought online or taken offline in the number of milliseconds specified by the PendingTimeout property, the resource is forcibly terminated.

PersistentState

Data type: boolean

Access type: Read/write

Provides access to the resource's PersistentState property, which specifies whether the resource should be brought online or left offline when the Cluster Service is started.

PrivateProperties

Data type: MSCluster_Property

Access type: Read/write

Provides access to the private properties of the resource.

QuorumCapable

Data type: boolean

Access type: Read-only

The resource can be selected as the quorum resource for the cluster.

RegistryCheckpoints

Data type: string array

Access type: Read-only

Provides a list of registry checkpoints for the resource.

RequiredDependencyClasses

Data type: uint32 array

Access type: Read-only

The resource classes which the resource must depend on.

The possible values are.

Unknown (0)

Storage (1)

Network (2)

User (32768)

**Windows Server 2008 R2 and Windows Server 2008: **

This property is not supported before Windows Server 2012.

Requirements