Win32_DFSTarget class

The Win32_DFSTarget WMI class represents a target of a Distributed file system (DFS) node.

The following syntax is simplified from Managed Object Format (MOF) code and includes all of the inherited properties. Properties are listed in alphabetic order, not MOF order.

Syntax

[dynamic, SupportsCreate, CreateBy("PutInstance"), SupportsDelete, DeleteBy("DeleteInstance"), SupportsUpdate, provider("DFSProvider"), AMENDMENT]
class Win32_DFSTarget : CIM_LogicalElement
{
  string       Caption;
  string       Description;
  datetime REF InstallDate;
  string       Name;
  string       Status;
  string       LinkName;
  string       ServerName;
  string       ShareName;
  uint32       State;
};

Members

The Win32_DFSTarget class has these types of members:

Properties

The Win32_DFSTarget class has these properties.

Caption

Data type: string

Access type: Read-only

Qualifiers: MaxLen (64)

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

Description

Data type: string

Access type: Read-only

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

InstallDate

Data type: datetime

Access type: Read-only

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.

LinkName

Data type: string

Access type: Read-only

Qualifiers: Key

Entry path of the node to which this target belongs.

Name

Data type: string

Access type: Read-only

Label by which the object is known. When subclassed, this property can be overridden to be a key property. This property is inherited from CIM_ManagedSystemElement.

ServerName

Data type: string

Access type: Read-only

Qualifiers: Key

Name of the server that the node references.

ShareName

Data type: string

Access type: Read-only

Qualifiers: Key

String representing the name of the share that the node references.

State

Data type: uint32

Access type: Read-only

Qualifiers: BitMap ("0", "1", "2"), BitValues ("Offline", "Online", "Active")

State of the target.

0

Offline

2

Online

4

Active

Status

Data type: string

Access type: Read-only

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")

Remarks

The Win32_DFSTarget class is derived from CIM_LogicalElement. You can only use this class on a DFS server. The WMI provider that implements the functionality of this class is installed when you install the file sharing server role.

Requirements

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

See also

CIM_LogicalElement

Operating System Classes