Win32_DFSNode class
The Win32_DFSNode WMI class represents a root or junction node of a domain-based or stand-alone Distributed file system (DFS). The DFS root is also represented by this class because the root is also a node. Each link has one or more targets or actual share paths for the storage defined by the Win32_DFSTarget class.
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, provider("DFSProvider"), SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), SupportsUpdate, AMENDMENT]
class Win32_DFSNode : CIM_LogicalElement
{
string Caption;
datetime REF InstallDate;
string Status;
string Name;
boolean Root;
uint32 State;
string Description;
uint32 Timeout;
};
Members
The Win32_DFSNode class has these types of members:
Methods
The Win32_DFSNode class has these methods.
| Method | Description |
|---|---|
| Create | Creates a new instance of the Win32_DFSNode class. |
Properties
The Win32_DFSNode 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/write
-
Qualifiers: Override ("The Description indicates a comment describing the node.")
TBD
-
-
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.
-
-
Name
-
Identifier for the DFS node. It is the same as the entry path of a node, based on the Universal Naming Convention (UNC). It can take one of the following two forms:
\\\\DfsServerName\\ShareName\\PathToLink
\\\\DomainName\\FtDfsName\\PathToLink
where
DfsServerName is the name of a server that hosts the DFS root volume.
ShareName is the name of the share published on the host server.
PathToLink is the path to the physical share.
DomainName is the name of the domain that hosts the DFS root volume.
FtDfsName is the name of the fault-tolerant DFS root published.
PathToLink is the path to the physical share.
This property overrides the Name property in CIM_ManagedSystemElement.
-
Root
-
-
Data type: boolean
-
Access type: Read-only
Indicates whether the node is a DFS root or a link. A value of TRUE indicates that the node is a root.
-
-
State
-
-
Data type: uint32
-
Access type: Read-only
Status of the node.
-
-
Ok (0)
-
Inconsistent (1)
-
Online (2)
-
Offline (3)
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")
Timeout
-
Data type: uint32
-
Access type: Read/write
-
Qualifiers: Units ("seconds")
Time, in seconds, that the client caches the referral of this link.
Remarks
The Win32_DFSNode class is derived from CIM_LogicalElement, which derives from the CIM_ManagedSystemElement class.
Examples
While Impersonation works with a DFS root server, Delegation is required for all other DC's in a domain-based DFS. The following PowerShell describes how to set delegation.
Get-WmiObject Win32_DFSNode -computer <dns-domain-name> -impersonation delegate
Requirements
| Minimum supported client |
Windows Vista |
| Minimum supported server |
Windows Server 2008 |
| Namespace |
Root\CIMV2 |
| MOF |
|
| DLL |
|