Dfsutil Remarks
Applies To: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1, Windows Server 2003 with SP2
DfsUtil Remarks
DFSUtil Parameter Usage (Administration, Debugging/Monitoring, Troubleshooting/Disaster Recovery)
The following is an overview of when an administrator would typically use a specific DfsUtil parameters, as well as the parameters' general area of impact.
| Parameter | Use for Routine Administration | Use for Debugging And Monitoring | Use for Troubleshooting And Disaster Recovery | Impact: View (Passive) | Impact: Server Modification (Active) | Impact: Client Modification (Active) | |
|---|---|---|---|---|---|---|---|
AddStdRoot |
yes |
- |
- |
|
- |
DFS Namespace modification |
- |
CheckBlob |
- |
yes |
- |
|
Verify blob stored in a file |
- |
- |
Clean |
- |
- |
yes |
|
- |
DFS Namespace modification |
- |
DisplayBlob |
- |
yes |
- |
|
Display blob contents to standard output |
- |
- |
Export |
yes |
yes |
yes |
|
Save DFS namespace to a file |
- |
- |
ExportBlob |
- |
yes |
- |
|
Export blob to a file |
- |
- |
Import |
yes |
- |
yes |
|
- |
DFS Namespace modification |
- |
ImportRoot |
- |
- |
yes |
|
- |
DFS Namespace modification |
- |
Insite |
yes |
- |
- |
|
- |
DFS Operations, Client behavior |
- |
PKTFlush |
- |
- |
yes |
|
- |
- |
Client behavior |
PKTInfo |
- |
yes |
- |
|
Display target referrals and active target for a link (Client) |
- |
- |
PurgeMupCache |
- |
- |
yes |
|
- |
- |
Client behavior |
PurgeWin2kStaticSiteTable |
- |
- |
yes |
|
- |
DFS metadata site information |
- |
RemFtRoot |
yes |
- |
- |
|
- |
DFS Namespace modification |
- |
RemoveReparse |
- |
- |
- |
|
- |
DFS related directories on the server |
- |
AddFTRoot |
- |
- |
yes |
|
- |
DFS related directories on the server |
- |
RemStdRoot |
yes |
- |
- |
|
- |
DFS Namespace modification |
- |
RenameFtRoot |
yes |
- |
- |
|
- |
DFS Namespace modification |
- |
RootScalability |
yes |
- |
- |
|
- |
DFS Sensitivity |
- |
ShowWin2kStaticSiteTable |
yes |
yes |
yes |
|
Display Windows 2000 Server DFS site information when in mixed mode |
- |
- |
SiteCosting |
yes |
- |
- |
|
- |
DFS Operations, Client behavior |
- |
SiteName |
yes |
yes |
- |
|
View Site name of a computer |
- |
- |
SPCFlush |
- |
- |
yes |
|
- |
- |
Client behavior |
SPCInfo |
- |
yes |
- |
|
Display trusted domains and its DCs known on client |
- |
- |
UnmapFtRoot |
- |
- |
yes |
|
- |
DFS Namespace modification |
- |
UpdateWin2kStaticSiteTable |
yes |
- |
yes |
|
- |
DFS metadata site information |
- |
View |
- |
yes |
- |
|
View DFS Namespace |
- |
- |
ViewDfsDirs |
- |
yes |
yes |
|
Displays DFS related directories in a volume |
Displays DFS related directories in a volume |
- |
Output Description for /PktInfo
Current Partition Knowledge Table (PKT) information can be displayed by using the /pktinfo parameter. The following describes the type of output produced when /pktinfo is used. The description numbers correspond to the numbers in the sample output.
1. The initial entry specifies how many entries are included in the output.
2. Every entry has both a full (Entry) and a short (ShortEntry) name.
3. Expires or Time To Live (TTL) is the length of time a DFS client stores referral information from the PKT in its local cache. The DFS client requests new information from the PKT if the TTL expires or the client is restarted. The TTL is reset if the shared folder is accessed before it expires.
4. UseCount is the number of times it's used since got this referral. Type specifies the type of referral being made.
5. Each entry contains a sequentially numbered target list. A referral is a list of targets a DFS client receives from the PKT when a user attempts to access a root or a link in the namespace. Referrals are cached locally on the client for a time specified by time indicated in Expires. The referral information can tell you which target is active for your DFS client. The number after each target name indicates the state of the target. Attempts to access an inactive target will be referred to the currently active target.
State 0x21:inactive or not responding
State 0x31:responding and an active target
6. An ACTIVE target status indicates it is currently being accessed by the client. If access to this target fails, the client will try to access the next target in the list. In this entry, the client would try to access the 12th target, \dom-dc-12.dom.company.com\SysVol.
dfsutil /pktinfo
Microsoft(R) Windows(TM) Dfs Utility Version 4.0
Copyright (C) Microsoft Corporation 1991-2001. All Rights Reserved.
--mup.sys--
1.
4 entries...
2.
Entry: \dom.company.com\SysVol
ShortEntry: \dom.company.com\SysVol
3.
Expires in 3014020 seconds
4.
UseCount: Type:0x1 ( DFS )
5.
0:[\dom-dc-04.dom.company.com\SysVol] State:0x21 ( )
1:[\dom-dc-08.dom.company.com\SysVol] State:0x21 ( )
2:[\dom-dc-10.dom.company.com\SysVol] State:0x21 ( )
3:[\dom-dc-07.dom.company.com\SysVol] State:0x21 ( )
4:[\dom-dc-03.dom.company.com\SysVol] State:0x21 ( )
5:[\dom-dc-02.dom.company.com\SysVol] State:0x21 ( )
6:[\dom-dc-05.dom.company.com\SysVol] State:0x21 ( )
7:[\dom-dc-09.dom.company.com\SysVol] State:0x21 ( )
8:[\dom-dc-06.dom.company.com\SysVol] State:0x21 ( )
9:[\dom-dc-13.dom.company.com\SysVol] State:0x21 ( )
10:[\dom-dc-11.dom.company.com\SysVol] State:0x21 ( )
6.
11:[\dom-dc-01.dom.company.com\SysVol] State: 0x31 ( ACTIVE )
12:[\dom-dc-12.dom.company.com\SysVol] State:0x21 ( )
Entry: \dom.company.com\netlogon
ShortEntry: \dom.company.com\netlogon
Expires in 0 seconds
UseCount: 0 Type:0x1 ( DFS )
0:[\dom-dc-08.dom.company.com\netlogon] State:0x31 ( ACTIVE )
1:[\dom-dc-05.dom.company.com\netlogon] State:0x21 ( )
2:[\dom-dc-07.dom.company.com\netlogon] State:0x21 ( )
3:[\dom-dc-03.dom.company.com\netlogon] State:0x21 ( )
4:[\dom-dc-09.dom.company.com\netlogon] State:0x21 ( )
5:[\dom-dc-10.dom.company.com\netlogon] State:0x21 ( )
6:[\dom-dc-04.dom.company.com\netlogon] State:0x21 ( )
7:[\dom-dc-11.dom.company.com\netlogon] State:0x21 ( )
8:[\dom-dc-02.dom.company.com\netlogon] State:0x21 ( )
9:[\dom-dc-13.dom.company.com\netlogon] State:0x21 ( )
10:[\dom-dc-06.dom.company.com\netlogon] State:0x21 ( )
Entry: \dom\public
ShortEntry: \dom\public
Expires in 0 seconds
UseCount: 0 Type:0x81 ( REFERRAL_SVC DFS )
0:[\ntdsdfs2\Public] State:0x19 ( ACTIVE )
1:[\ntdsdfs1\Public] State:0x09 ( )
Entry: \dom\public\Desktop\Office2000
ShortEntry: \dom\public\Desktop\Office2000
Expires in 0 secondsUseCount: 0 Type:0x1 ( DFS )
0:[\imself-ia64-02\office2000] State:0x31 ( ACTIVE )
1:[\apzawsrv2ß\office2000] State:0x21 ( )
2:[\apzawsrv3\office2000] State:0x21 ( )
DfsUtil command completed successfully.
Output Description for /SpcInfo
SPC table information can be displayed by using the /spcinfo parameter. The following describes the type of output produced when /spcinfo is used. The description numbers correspond to the numbers in the sample output.
1. Entries beginning with [*] are not expanded, and are local to the domain.
2. Entries beginning with [+] are expanded into the DC list due to access.
3. Indented entries are expanded entries of the domain entry of the domain1.companydom.com domain.
4. Unexpanded domains which have not been accessed or required to expand by the client. The local client cache contains no further information about these domains. Only trusted domains are listed.
dfsutil /spcinfo
Microsoft(R) Windows(TM) Dfs Utility Version 4.0
Copyright (C) Microsoft Corporation 1991-2001. All Rights Reserved.
1.
[*] [domain1-dc-08.domain1.companydom.com]
[*][DOMAIN1]
[*][domain1.companydom.com]
2.
[+] [domain1.companydom.com]
3.
[-domain1-dc-05.domain1.companydom.com]
[-domain1-dc-13.domain1.companydom.com]
[-domain1-dc-04.domain1.companydom.com]
[-domain1-dc-rn.ntwksta.domain1.companydom.com]
[-domain1-dc-02.domain1.companydom.com]
[+][DOMAIN1]
[-DOMAIN1-DC-07]
[-NTDEV-DC-11]
[-NTDEV-DC-05]
[+NTDEV-DC-08]
4.
[-][stressdsdom.nttest.companydom.com]
[-][STRESSDSDOM]
[-][vbl03stressdom.nttest.companydom.com]
[-][VBL03STRESSDOM]
DfsUtil command completed successfully.
See Also
Concepts
Dfsutil Overview
Dfsutil Syntax
Dfsutil Examples
Alphabetical List of Tools
Topchk.cmd
Rsdir Overview
Rsdiag Overview
Iologsum Overview
Health_chk Overview
Ftonline Overview
Filever Overview
Efsinfo Overview
Dmdiag Overview
Dskprobe Overview
Diruse Overview
Connstat Overview
Cabarc Overview
Bitsadmin Overview