Windows Tools

DFSUtil Examples

Overview | Syntax | Examples | Related Tools Open Command Prompt

Example 1: Dfsutil /view

This example dumps the DFS configuration of the local computer for the fault-tolerant root "dfsft" in the a.com domain. Multiple servers back up the root and \apps shares (child nodes) in the \\a.com\dfsft DFS tree.

Type the following at the command prompt:

C:\UTILS>dfsutil /VIEW:\\NA-DC-01\dfsft

Output similar to the following displays:

Getting DomDfs metadata for DFSFT
Connecting to DC NA-DC-01.a.com
Volume information
Type is DomDfs
remoteServerName:[\\NA-DC-01\dfsft][\\NA-DC-01\dfsft][*]
 
\\A\dfsft	[(null)]
	\\NA-DC-01\dfsft
	\\ NA-DC-02\dfsft
 
\\A\dfsft\apps	[(null)]
	\\ NA-DC-01\apps
	\\ NA-DC-02\apps
 
Site information:
NA-DC-01
	Default-First-Site-Name
NA-DC-02
	Default-First-Site-Name
 
DFSUTIL completed successfully.


Example 2: Dfsutil /spcinfo

To display the information contained within the SPC table, type the following at the command prompt:

C:\UTILS>DFSUTIL /SPCINFO

Output similar to the following displays:

NtStatus=0x0, status=0x0
[*][SERVER5.a.com]
[*][A]
[*][a.com]
NtStatus=0x0, status=0x0
[+][A]
		[+SERVER3]
		[-SERVER4]
		[-SERVER2]
		[-SERVER6]
		[-SERVER5]
[+][a.com]
		[+SERVER5.a.com]
		[-SERVER3.a.com]
		[-SERVER4.a.com]
		[-SERVER6.a.com]
		[-SERVER2.a.com]


Example 3: Dfsutil /pktinfo

To show the client cache of the DFS namespace, type the following at the command prompt:

C:\UTILS>dfsutil /pktinfo

Output similar to the following displays:

--mup.sys--
3 entries...
Entry: \distfolders\release
ShortEntry: \distfolders\release
Expires in 0 seconds
UseCount: 7 Type:0x81 ( REFERRAL_SVC DFS )
   0:[\DISTFOLDERS\release][0x1]
 
Entry: \A\dfsft
ShortEntry: \A\dfsft
Expires in 0 seconds
UseCount: 0 Type:0x81 ( REFERRAL_SVC DFS )
   0:[\NA-DC-01\dfsft][0x0]
   1:[\NA-DC-01\dfsft][0x1]
 
Entry: \a.com\sysvol
ShortEntry: \a.com\sysvol
Expires in 0 seconds
UseCount: 0 Type:0x81 ( REFERRAL_SVC DFS )
   0:[\NA-DC-01.a.com\sysvol][0x0]
   1:[\NA-DC-01.a.com\sysvol][0x1]
 
 
DFSUTIL completed successfully.


Example 4: Dfsutil /pktflush

The example below:

  1. Displays the existing Partition Knowledge Table (PKT) for \\Distfolders\Release\Namer\Bnum\Vers by using the /pktinfo parameter.
  2. Flushes all client PKTs by using DFSFLUSHPKT ("EntryPath=[*]").
  3. Shows the empty PKT on the client by using the /pktinfo parameter.

To display the existing PKT, type the following at the command prompt:

C:\UTILS>dfsutil /pktinfo

Output similar the following displays:

--mup.sys--
NtStatus=0x0, status=0x0
2 entries...
Entry: \distfolders\release
ShortEntry: \distfolders\release
   0:[\DISTFOLDERS\release][0x1]
 
Entry: \distfolders\release\namer\bnum\vers
ShortEntry: \distfolders\release\namer\bnum\vers
   0:[\servxx1\namer.bnum.vers][0x1]
   1:[\ntold2\namer.bnum.vers][0x0]
   2:[\servxx3\namer.bnum.vers][0x0]
   3:[\servxx4\namer.bnum.vers][0x0]
   4:[\servxx2\namer.bnum.vers][0x0]

Now to flush the PKT cache, type the following at the command prompt:

C:\UTILS>dfsutil /pktflush

Output similar the following displays:

EntryPath=[*]

To redisplay the existing PKT, type the following at the command prompt:

C:\UTILS>dfsutil /pktinfo

Output similar the following displays:

--mup.sys--
NtStatus=0x0, status=0x0
0 entries...