Using the Windows Server 2008 DFSUTIL.EXE command line to manage DFS-Namespaces

Using the Windows Server 2008 DFSUTIL.EXE command line to manage DFS-Namespaces

  • Comments 2
  • Likes

The most common administration activities related to DFS-Namespaces can be performed using the “DFS Management” MMC. This will show up under “Administrative Tools” after you add the DFS role service in Server Manager. You can also add just the MMC for remote management of a DFS namespace server. You will find that in Server Manager, under Add Feature, Remote Server Administration Tools (RSAT), Role Administration Tools, File Services Tools.

Another way to manage DFS-N is to use DFSUTIL.EXE, which is a command line tool. There are plenty of options and you can perform pretty much any DFS-related activity, from creating a namespace to adding links to exporting the entire configuration to troubleshooting. This can be very handy for automating tasks by writing scripts or batch files. DFSUTIL.EXE is an in-box tool in Windows Server 2008 (as with the MMC, it is loaded with the DFS-Namespaces role service or with the RSAT for File Services Tools).

Please find below a table with a comprehensive list of the parameters and options available in DFSUTIL.EXE for Windows Server 2008. Please note that DFSUTIL.EXE had a different format for parameters in Windows Server 2003, but that old syntax still works in Windows Server 2008. The old syntax is listed in the last column, prefixed by “OLD:”. There is also an old DFSCMD.EXE, which still works, which is also mentioned prefixed by “OLD:”.

Parameters Description Usage and Exampes Subcommands, notes and old syntax
<None> Manages DFS Namespaces, servers and clients Dfsutil
Dfsutil /oldcli
Dfsutil /?
SUBCOMMANDS:
Root - Displays,creates,removes,imports,exports namespace roots.
Link - Displays, creates, removes, or moves folders (links).
Target - Displays,creates,modifies folder targets (link targets).
Property - Displays or modifies a folder target or namespace server.
Client - Displays or modifies client information or registry keys.
Server - Displays or modifies namespace configuration on the server.
Diag - Perform diagnostics or view dfsdirs/dfspath.
Domain - Displays all domain-based namespaces in a domain.
Cache - Displays or flushes the client cache.

NOTES:
* Use the Dfsutil /oldcli command to view the original Dfsutil syntax.
* Use the /? parameter after any command to display help for the command.
* Dfsutil commands use the original Distributed File System terminology, with updated DFS Namespaces terminology provided as explanation for most commands.
* If you specify at the end of a command an object (such as a namespace server) about which you want information, most commands will display the information without requiring further parameters or commands. For example, when using the Dfsutil Root command, you can append a namespace root to the command to view information about the root.
Root Displays information about the namespace root. Dfsutil Root commands support creating, removing, importing or exporting namespace roots. dfsutil root <\\server\share> [Verbose]

PARAMETERS:
<\\server\share>: UNC path to the namespace.
Verbose: Show additional information while the tool is executing.

EXAMPLES:
dfsutil root \\contoso.com\DomainNamespace1
dfsutil root \\srv1\StandaloneNameSpace2
SUBCOMMANDS:
AddDom - Creates a new domain-based namespace.
AddStd - Creates a new stand-alone namespace.
Remove - Removes the namespace.
Export - Exports the namespace configuration to a file.
Import - Imports the namespace from another namespace or a file.
ForceSync - Perform a Forced sync on the target of a namespace.

OLD: dfsutil /Root:<DfsName> /View [/Verbose]
Root
AddDom
Creates a new domain based DFS namespace. dfsutil root adddom <\\server\share> [<Version>] [<Comment>]

PARAMETERS:
<\\server\share>: UNC path to the namespace.
<Comment>: Specifies an adminstrator comment for the namespace.
<Version>: Version of the namespace, possible values are V1 or V2.
V1 - Creates a Windows 2000 Server mode namespace.
 V2 - Creates a Windows Server 2008 mode namespace.

EXAMPLES:
dfsutil root addDom \\srv1\DomainNameSpace1 "This is V2 namespace"
dfsutil root addDom \\srv2\DomainNameSpace2
dfsutil root addDom \\srv3\DomainNameSpace3 V1 "This is V1 Root"
NOTES:
1. To add new root targets, use "dfsutil target add" command.
2. Default setting for creation of new namespace is V2.

OLD: dfsutil /AddFtRoot /Server:<ServerName> /Share:<ShareName> /Comment:<Comment>
Root
AddStd
Creates a new stand-alone namespace. dfsutil root addstd <\\server\share> [<Comment>]

PARAMETERS:
<\\server\share>: UNC Path to the namespace on the namespace server.
<Comment>: Specifies an adminstrator comment for the namespace.

EXAMPLES:
dfsutil root addstd \\srv1\StandaloneNamesapce1 "Standalone Root"
dfsutil root addstd \\srv2\StandaloneNamesapce2
OLD: dfsutil /AddStdRoot /Server:<ServerName> /Share:<ShareName> /Comment:<Comment>
Root
Remove
Deletes the namespace root. dfsutil root remove <\\server\share>

PARAMETERS:
<\\server\share>: UNC path to the namespace on the namespace server.

EXAMPLES:
dfsutil root remove \\contoso.com\DomainNamespace1
dfsutil root remove \\srv1\StandaloneNamespace2
OLD: dfsutil /RemStdRoot /Server:<ServerName> /Share:<ShareName>
OLD: dfsutil /RemFtRoot /Server:<ServerName> /Share:<ShareName>
OLD: dfsutil /RemFtRoot:<RootName> /Server:<ServerName> /Share:<ShareName>
Root
Export
Exports the namespace configuration information to a file. dfsutil root export <\\server\share> <filename> [Verbose] [DownLevel]

PARAMETERS:
<\\server\share>: UNC path to the namespace on the namespace server.
<filename>: Name of the file that will store the namespace configuration in XML file format.
Verbose: Displays detailed status of the export process.
Downlevel: Saves the export file as a text file that is compatible with the version of Dfsutil that is included with the Windows Server 2003 Support Tools.

EXAMPLES:
dfsutil root export \\contoso.com\DomainNamespace1 C:\dir1\a.txt downlevel
dfsutil root export \\srv1\StandaloneNamespace1 C:\dir1\docroot.xml
OLD: dfsutil /Root:<DfsName> /Export:<File> [/Verbose]
Root
Import
Imports folders, folder targets and configuration information for a namespace from a file or another namespace. dfsutil root import SUBCOMMANDS:
Set - Imports and overwrites the existing namespace.
Merge - Imports and merges with the existing namespace.
Compare - Compares the namespace with another namespace.
BlobSize - Displays the approximate AD DS blob size.
Root
Import
Set
Imports folders, folder targets and configuration information for a namespace from a file or another namespace and overwrites existing folders and folder targets. dfsutil root import set <\\srcserver\share>|<filename> <\\destserver\share> [NoBackup] [Verbose]

PARAMETERS:
<\\srcserver\share>: UNC path to the namespace from which you want to import the configuration.
<\\destserver\share> UNC path to the namespace to which you want to import the configuration.
<filename>: Name of the xml file from which you want to import the namespace configuration.
NoBackup: Does not create backup file to restore overwritten folders and folder targets.
Verbose: Displays detailed status of the import process.

EXAMPLES:
dfsutil root import set \\contoso.com\Namespace1\\contoso.com\Namespace2 NoBackup
dfsutil root import set C:\dir1\docroot.txt \\srv1\StandaloneNamespace1
OLD: dfsutil /Root:<DfsName> /Import:<File> /Set|Merge|Compare [/Verbose] [/NoBackup]
Root
Import
Merge
Imports folders, folder targets and configuration information for a namespace from a file and merges existing folders and folder targets. dfsutil root import merge <filename> <\\destserver\share> [NoBackup] [Verbose]

PARAMETERS:
<\\destserver\share> : UNC path to the namespace to which you want to import the configuration.
<filename> : Name of the xml file from which you want to import the namespace configuration.
NoBackup : Does not create backup file to restore overwritten folders and folder targets.
Verbose : Displays detailed status of the import process.

EXAMPLES:
dfsutil root import Merge C:\dir1\docroot.txt \\srv1\StandaloneNamespace1
OLD: dfsutil /Root:<DfsName> /Import:<File> /Set|Merge|Compare [/Verbose] [/NoBackup]
Root
Import
Compare
Compares a namespace on one server with the namespace configuration on another server or in a file. dfsutil root import compare <\\srcserver\share>|<filename> <\\destserver\share> [Verbose]

PARAMETERS:
<\\srcserver\share> : UNC path to the namespace on the first namespace server that you want to compare.
<\\destserver\share>: UNC path to the namespace on the second namespace server that you want to compare.
<filename> : Name of the XML file that contains the namespace configuration that you want to compare.
Verbose : Displays detailed status of the import process.

EXAMPLES:
dfsutil root import compare \\contoso.com\DomainNamespace1 \\contoso.com\DomainNamespace2
dfsutil root import compare C:\dir1\docroot.txt \\srv1\StandaloneNamespace1
OLD: dfsutil /Root:<DfsName> /ImportRoot:<MasterDfsName> /Mirror|Compare [/Verbose] [/NoBackup]
Root
Import
BlobSize
Displays the approximate size of Active Directory Domain Services (AD DS) Blob for the specified namespace import file. dfsutil root import blobsize <filename>

PARAMETERS:
<filename> : Name of the XML file that stores the configuration of the namespace you want to analyze.

EXAMPLES:
dfsutil root import blobsize docroot.xml
OLD: dfsutil /Root:<DfsName> /Import:<File> /BlobSize
Root
ForceSync
To initiate a forced DFS metadata resync operation on the DFS root target of a specified domain-based namespace using the Windows Server 2008 mode or standalone DFS namespace ForceSync command can be used .This is not supported on Windows Server 2003 based Namespaces. dfsutil root forcesync <\\server\share>

PARAMETERS:
<\\server\share>: Server - Target of the namespace
Forcesync will be performed on this target. share - Target share.

EXAMPLES:
dfsutil root forcesync \\standaloneserver\StandaloneNamespace1
dfsutil root forcesync \\domainnamespaceserver\DomainNamespace2
NOTES:
Do not specify <\\domain\root>, use <\\roottarget\share>.
Link Displays the information about the link(folder) and link(folder) targets. Link commands are used to create a new link, delete a link or move the links. dfsutil link <DfsPath>

PARAMETERS:
<DfsPath>: UNC Path of DFS link.

EXAMPLES:
dfsutil link \\contoso.com\DomainNamespace1\link1
dfsutil link \\srv1\StandaloneNamespace1\link1
SUBCOMMANDS:
Add - Creates a new folder.
Remove - Removes the specified folder.
Move - Moves the folder to another location in the namespace.
Link
Add
Adds a folder (link) to the specified namespace. dfsutil link add <DfsPath> <\\server\sharepath> [Restore] [<Comment>]

PARAMETERS:
<DfsPath>: UNC Path of DFS link to be created.
<\\server\sharepath>: UNC Path to the share on the Target Server.
Restore: Option to restore a DFS link.
[<Comment>]: Comment for the Link

EXAMPLES:
dfsutil link add \\contoso.com\DomainNamespace1\link1 \\server\share "This is a new Link"
dfsutil link add \\srv1\StandaloneNamespace1\dir\link1 \\server\share
NOTES:
1. Folders can be created with the restore option . In this case, the folder target does not need to be a SMB path. Use this for namespace paths ( \\domain\namespace ), NFS shares or any folder target that you do not want to verify.
2. To add another folder target to an existing folder, use the command "Dfsutil Target Add".

OLD: dfsutil /AddLink /Path:<DfsPath> /Server:<LinkTargetServer> /Share:<TargetShare> /Comment:<Comment>
OLD: Dfscmd /add \\dfsname\dfsshare\path \\server\share\path [/restore]
Link
Remove
Deletes the folder (link) and any associated folder targets (link targets). dfsutil link remove <DfsPath>

PARAMETERS:
<DfsPath>: UNC Path of DFS link to remove.

EXAMPLES:
dfsutil link remove \\contoso.com\DomainNamespace1\link1
OLD: dfsutil /RemoveLink /Path:<DfsPath> /Server:<LinkTargetServer> /Share:<TargetShare>
OLD: Dfscmd /remove \\dfsname\dfsshare\path \\server\share\path
Link
Move
Moves a folder (link) to another location in the namespace. When you specify a folder that contains other folder, all subfolders are moved as well. If a folder already exists in the new location, you can use the Replace option to delete the existing folder and replace it with the folder you want to move. You cannot move folders between namespaces. dfsutil link move <OldDfsPath> <NewDfsPath> [Replace]

PARAMETERS:
<OldDfsPath>: The UNC path of the folder to move.
<NewDfsPath>: The UNC path of the new location in the namespace for the folder.
Replace: Replaces an existing folder with the folder that you are moving.

EXAMPLES:
Dfsutil Link Move \\contoso.com/namespace1/programs \\contoso.com\namespace1\tools
Dfsutil Link Move \\srv1\namespace1\docs \\srv1\namespace1/public/docs
OLD: Dfscmd /move \\dfsname\dfsshare\path1 \\dfsname\dfsshare\path2 [/force]
Target Displays information about the folder target (link target) or namespace server (root target). Target commands are used to add, remove or modify the properties of a folder target or namespace server. dfsutil target [<DfsPath>] <\\server\sharepath>

PARAMETERS:
<DfsPath>: UNC Path of DFS link.
<\\server\sharepath>: UNC Path to the share on the Target Server.

EXAMPLES:
dfsutil target \\contoso.com\DomainNamespace1\link1 \\mytargetserver\LinkTarget
dfsutil target \\mytargetserver\RootTarget
SUBCOMMANDS:
Add - Adds a new folder target.
Remove - Removes the folder target.

NOTES:
To view properties of root target do not specify <DfsPath>.

OLD: Dfscmd /view \\dfsname\dfsshare [/partial | /full | /batch || /batchrestore]

Target
Add
Adds a folder target (link target) to an existing folder (link), or a namespace server (root target) to an existing namespace root. dfsutil target add [<DfsPath>] <\\server\sharepath> [Restore]

PARAMETERS:
<DfsPath>: UNC Path of DFS Link.
<\\server\sharepath>: UNC Path to the share on the Target Server.
Restore: Restore option is used when link target is non-SMB path.

EXAMPLES:
dfsutil target add \\contoso.com\DomainNamespace1\link1 \\mytargetserver\LinkTarget
dfsutil target add \\mytargetserver\RootTarget
NOTES:
1. To add new namespace servers to an existing namespace root, omit <DfsPath>.
2. To create new namespace, use the "Dfsutil Root" command with the Adddom or Addstd parameters.
3. Folder targets can be created with the restore option. In this case,the folder target does not need to be a SMB path. Use this for namespace paths ( \\domain\namespace ), NFS shares or any folder target that you do not want to verify.

OLD: Dfscmd /map \\dfsname\dfsshare\path \\server\share\path [comment] [/restore]
Target
Remove
Deletes a folder target (link target) from a folder (link), or a namespace server (root target) from a namespace. dfsutil target remove [<DfsPath>] <\\server\sharepath>

PARAMETERS:
<DfsPath>: DfsPath of a LinkTarget.
<\\server\sharepath>: server is Link or Root Target Server and share is Target Share

EXAMPLES:
Dfsutil Target Remove \\contoso.com\namespace1\programs \\srv2\apps
Dfsutil Target Remove \\srv1\namespaceshare
NOTES:
1. To delete a root target (namespace server) do not specify <DfsPath>. If the namespace server is the only namespace server in the namespace, then the namespace will be deleted.
2. To remove all the namespace servers, use the "Dfsutil Root Remove" command.

OLD: Dfscmd /unmap \\dfsname\dfsshare\path
Property Displays or modifies the properties of a folder target (link target) or namespace server (root target). dfsutil property SUBCOMMANDS:
Sitecosting - Displays or modifies site costing for a namespace.
RootScalability - Displays or modifies the namsespace polling mode.
ABDE - Enable/Disable/View ABDE property of a Namespace.
Insite - Displays or modifies the in-site property.
TargetfailBack - Displays or modifies client fail back.
ACL - Set/Get Security Information on the folder.
State - Displays or modifies a folder target or namespace server.
TTL - Displays or changes client referral caching.
PriorityRank - Displays or changes the ordering method (priority rank).
PriorityClass - Displays or changes the target priority.
Comment - Set/View the comment for DFS namesapace or DFS link.
Property
Sitecosting
Displays whether site costing is enabled, and enables or disables it on the specified namespace. Enable site costing to force clients to evaluate inter-site link costs and choose the lowest cost folder target. Site costing is disabled by default. dfsutil property sitecosting <DfsPath>

PARAMETERS:
<DfsPath>: Displays whether site costing is enabled on the specified namespace.

EXAMPLES:
dfsutil property sitecosting enable \\contoso.com\DomainNamespace1
dfsutil property sitecosting enable \\srv1\StandaloneNamespace1
SUBCOMMANDS:
Enable - Enable this property on the namespace.
Disable - Disable this property on the namespace.

NOTES:
1) The path specified must be a namespace root, not a folder.
2) This feature is only supported on servers Windows Server 2003 or Windows Server 2008.
3) Domain Controller (DC) site costing is controlled separately on each DC using the following registry key:HKLM\System\CurrentControlSet\Services\Dfs\Parameters\SiteCostedReferrals DWORD 1 or 0

OLD: dfsutil /Root:<DfsName> /SiteCosting /Enable|Disable|Display [/Verbose]
Property
RootScalability
RootScalability is an expert-only command to increase performance of large deployments of DFS namespaces. When set, network traffic among DFS root servers is kept to a minimum. In addition, there will be less traffic between the primary DC and DFS servers.The drawback is that users may see outdated information from dfs servers at times. dfsutil property rootscalability <DfsPath>

PARAMETERS:
<DfsPath>: Path of a root.

EXAMPLES:
dfsutil property RootScalability \\contoso.com\DomainNamespace1
SUBCOMMANDS:
Enable - Enable this property on the namespace.
Disable - Disable this property on the namespace.

NOTES:
1) The path specified must be a root, not a link.
2) This has no effect on standalone roots.
3) This feature is only supported on Windows Server 2003 and higher.
4) When RootScalability is enabled, it is not uncommon to see an event log message such as, "DFS could not access its private data from the DS...". While this error may still indicate a problem in DS connectivity, typically this occurs because the nearest DC has outdated DFS information (expected behavior when RootScalability is enabled).

OLD: dfsutil /Root:<DfsName> /RootScalability /Enable|Disable|Display [/Verbose]
Property
ABDE
ABDE command is a quick way to check if Access Based Directory Enumeration is enabled or disabled on the NameSpace. This is the property of domain-based namespace using the Windows Server 2008 mode or Standalone Namespaces in Windows Server 2008. dfsutil property abde <DfsPath>

PARAMETERS:
<DfsPath>: UNC path to the DFS namesapace.

EXAMPLES:
dfsutil property ABDE \\contoso.com\DomainNamespace1
dfsutil property ABDE \\srv1\StandaloneNamespace1
SUBCOMMANDS:
Enable - Enable this property on the namespace.
Disable - Disable this property on the namespace.

NOTES:
When Access Based Directory Enumeration is enabled, the users can view their directories only if they have permissions. Links will have Security Descriptors associated with them. The users can view the links only for which they have permissions in the Security Descriptor.
Property
Insite
Insite can be used to make sure clients access only those replicas that are in the same site as the client. It can also be used to disable such behavior. dfsutil property insite <DfsPath>

PARAMETERS:
<DfsPath>: UNC path of a DFS namespace or DFS link.

EXAMPLES:
dfsutil property Insite \\contoso.com\DomainNamespace1
dfsutil property Insite \\srv1\StandaloneNamespace1
SUBCOMMANDS:
Enable - Enable this property on the namespace or link.
Disable - Disable this property on the namespace or link.

NOTES:
1) The path specified may be a root or a link.
2) Access of Domain Controllers may be site-sensitive as well. That, however, is a DC specific property that must be enabled/disabled in the registry of relevant DC(s): HKLM\System\CurrentControlSet\Services\Dfs\Parameters\InsiteReferrals: DWORD 1 or 0

OLD: dfsutil /Path:<DfsPath> /InSite /Enable|Disable|Display [/Verbose]
Property
TargetfailBack
Displays TargetfailBack property of root or link TargetFailback is an expert-only command to make sure clients failback to target servers that are closer to them after having failed over to a target that's potentially out of site. dfsutil property targetfailback <DfsPath>

PARAMETERS:
<DfsPath>: UNC path of a DFS namesapace or DFS link.

EXAMPLES:
dfsutil property TargetfailBack \\contoso.com\DomainNamespace1
dfsutil property TargetfailBack \\srv1\StandaloneNamespace1
SUBCOMMANDS:
Enable - Enable this property on the namespace or link.
Disable - Disable this property on the namespace or link.

NOTES:
1) The path specified may be a root or a link.
2) This feature is only supported on Windows Server 2003 SP1 and higher.
3) The clients must be running a newer operating system to take advantage of this feature.
4) You may also enable/disable TargetFailback on SYSVOL/NETLOGON paths. That, however, is a DC specific property that must be set/reset in the registry of relevant DC(s): HKLM\System\CurrentControlSet\Services\Dfs\Parameters\SysvolNetlogonTargetFailback: DWORD 1 or 0

OLD: dfsutil /Path:<DfsPath> /TargetFailback /Enable|Disable|Display [/Verbose]
Property
ACL
ACL command is a quick way to set or get the ACLs on the link. dfsutil property acl <DfsPath> [ShowSDDL]

PARAMETERS:
<DfsPath>: UNC Path of DFS link.
ShowSddl: Option to display SDDL.

EXAMPLES:
dfsutil property ACL \\contoso.com\DomainNamespace1\link1
dfsutil property ACL \\standaloneserver\Namespace1\link1 showsddl
SUBCOMMANDS:
Grant - Grant permissions for a user or group(trustee).
Deny - Deny Permissions for user or group(trustee).
Revoke - Revoke granted permissions for user or group.
Set - Set Security Information on the folder from SDDL input.
Reset - Remove the Security Descriptor associated with the folder.
Control - Set Security control Information on the folder.
Property
State
Displays State of Root/RootTarget or Link/Link target dfsutil property state <DfsPath> [<\\server\share>]

PARAMETERS:
<DfsPath>: UNC path of a DFS namesapace or DFS link.
<\\server\share>: server is Target Server and share is share on Target Server.

EXAMPLES:
dfsutil property State \\contoso.com\DomainNamespace1\link1 \\server\share
dfsutil property State \\namespaceserver\Namespace2
SUBCOMMANDS:
Online - Set state of root target or folder target to Online.
Offline - Set state of root target or folder target to Offline.

NOTES:
1. In case of the Windows Server 2003, the state of the DFS namespace root or root target can not be changed to online or offline. But the state of the link and the link targets can be changed.
2. In Windows 2000 Server and Windows Server 2008 the state of the DFS namespace root and root target can be changed to offline or online.

OLD: dfsutil /Path:<DfsPath> /State /Server:<RootOrLinkTargetServer> /Share:<TargetShare>
Property
TTL
Displays the Timeout value of root or link. dfsutil property ttl <DfsPath>

PARAMETERS:
<DfsPath>: UNC path of a DFS namesapace or DFS link.

EXAMPLES:
dfsutil property ttl \\contoso.com\DomainNamespace1
SUBCOMMANDS:
Set - Set this property of DFS namesapace or DFS link.

OLD: dfsutil /Enable|Disable|Display [/Verbose] /Path:<DfsPath> {/TTL:<Timeout> /Set}|{/TTL /Display} [/Verbose]
Property
PriorityRank
TargetPriorityRank is a useful way to control client accesses to dfs target servers. dfsutil property priorityrank <DfsPath> <\\server\share> [Verbose]

PARAMETERS:
<DfsPath>: UNC path of a DFS namesapace or DFS link.
<\\server\share>: server is Target Server and share is share on Target Server.
Verbose: Show additional information while the tool is executing

EXAMPLES:
dfsutil property PriorityRank \\contoso.com\DomainNamespace1 \\srv1\DomainNameSpace1
SUBCOMMANDS:
Set - Set this property of the root or link target.

OLD: dfsutil /Path:<DfsPath> /TargetPriority /Server:<TargetServerName> /Share:<TargetShare> [/Display] [/Set] [/PriorityRank:<Rank> [/PriorityClass:<SiteCostNormal|GlobalHigh|SiteCostHigh|Site
CostLow|GlobalLow>] [/Verbose]
Property
PriorityClass
TargetPriorityClass is a useful way to control client accesses to DFS target servers. dfsutil property priorityclass <DfsPath> <\\server\share> [Verbose]

PARAMETERS:
<DfsPath>: UNC path of a DFS namesapace or DFS link.
<\\server\share>: server is Target Server and share is share on Target Server.
Verbose: Show additional information while the tool is executing

EXAMPLES:
dfsutil property PriorityClass \\contoso.com\DomainNamespace1 \\srv1\DomainNameSpace1
SUBCOMMANDS:
Set - Set this property of the root or link  target.

NOTES:
1) The Path can be a Domain based or a Standalone DFS path. It must lead to
a root or a link.
2) TargetPriority can be used in conjuction with site costing, insite and the like.
3) GlobalPriorityClass will take precedence over the site cost. The default behavior is SiteCostNormalPriorityClass.

OLD: dfsutil /Path:<DfsPath> /TargetPriority /Server:<TargetServerName> /Share:<TargetShare> [/Display] [/Set] [/PriorityRank:<Rank> [/PriorityClass:<SiteCostNormal|GlobalHigh|SiteCostHigh|Site
CostLow|GlobalLow>] [/Verbose]
Property
Comment
Sets or displays the administrator comment for a namespace or link (folder). dfsutil property comment <DfsPath>

PARAMETERS:
<DfsPath>: UNC Path of DFS Root or DFS link

EXAMPLES:
dfsutil property comment \\contoso.com\DomainNamespace1\link1
dfsutil property comment \\srv1\StandaloneNamespace1
SUBCOMMANDS:
Set - Set this property for DFS namesapace or DFS link.
Client Client commands are used to modify or view the client registry keys or display the siteinformation. dfsutil client SUBCOMMANDS:
Registry - Set/Reset/View registry keys.
SiteInfo - View the Siteinformation.
Property - Displays or modifies local machine's cache information.
Client
Registry
Registry commands can modify or display client registry keys or display siteinformation. dfsutil client registry SUBCOMMANDS:
ProviderCacheTimeout - Set/View the ProviderCacheTimeoutInMinutes key.
DfsDcNameDelay - Set/Reset/View the DfsDcNameDelay key.
Client
Registry
ProviderCacheTimeout
ProviderCacheTimeout specifies the length of time that a multiple UNC provider (MUP) cache entry is held until it is reevaluated. dfsutil client registry providercachetimeout <Client>

PARAMETERS:
<Client> : client whose registry key ProviderCacheTimeoutInMinutes has to be displayed.
SUBCOMMANDS:
Set - Set the ProviderCacheTimeoutInMinutes key.

OLD: dfsutil /ProviderCacheTimeoutInMinutes[:<Value>] /Server:<Name> /Display|/Set
Client
Registry
DfsDcNameDelay
Display or modify the registry key DfsDcNameDelay in the client. dfsutil client registry dfsdcnamedelay <Client>

PARAMETERS:
<Client> : client whose registry key DfsDcNameDelay has to be displayed.
SUBCOMMANDS:
Set - Set the DfsDcNameDelay key.
Reset - Reset the DfsDcNameDelay key.

OLD: dfsutil /DfsDcNameDelay[:<Value>] /Server:<Name> /Display|/Set
Client
SiteInfo
Display the site information assosciated with the client. dfsutil client siteinfo <MachineName>|<IpAddress>

PARAMETERS:
<MachineName>: Machine Name of the client whose site information has to be displayed.
<IpAddress>: IpAddress of the client whose site information has to be displayed.
OLD: dfsutil /SiteName:<MachineName or IpAddress>
Client
Property
Displays or modifies local machine's cached information. dfsutil client property SUBCOMMANDS:
State - Set/View state of target for the dfs namespace or link.
Client
Property
State

Displays or modifies target state of a dfs namespace or link. Only the local machine's cached information is displayed or modified.

dfsutil client property state <dfspath> SUBCOMMANDS:
Active - Set active target for the dfs namespace or link.
Server Displays all the roots hosted on the server. Server command can also be used to modify the registry keys in the server. dfsutil server <Server>

PARAMETERS:
<Server>: Server on which the roots are hosted.
SUBCOMMANDS:
Registry Set/Reset/View registry keys of server.

OLD: dfsutil /Server:<MachineName> /View
Server
Registry
Registry commands can modify or display the registry keys on the server. dfsutil server registry  SUBCOMMANDS:
DfsDnsConfig Set/Reset/View DfsDnsConfig key in server registry.
LdapTimeoutValue Set/View LdapTimeoutValueInSeconds key in the registry.
SyncInterval Set/View SyncIntervalinSeconds key in server registry.
SiteCostedReferrals Set/Reset/View SiteCostedReferrals key in the registry.
InsiteReferrals Set/Reset/View InsiteReferrals key in server registry.
PreferLogonDC Set/Reset/View PreferLogonDC key in server registry.
Server
Registry
DfsDnsConfig
Modifies or displays the registry key DfsDnsConfig in the server. dfsutil server registry dfsdnsconfig <Server>

PARAMETERS:
<Server> : The server whose registry key DfsDnsConfig has to be displayed.
SUBCOMMANDS:
Set Set DfsDnsConfig key in server registry.
Reset Reset DfsDnsConfig key in server registry.

NOTE:
DfsDnsConfig when set to 1, specifies that this server will use fully qualified domain
names (FQDN) in referrals. When set to 0 (the default), specifies that this
server will use NetBIOS names in referrals.

OLD: dfsutil /DfsDnsConfig[:<Value>] /Server:<Name> /Display|/Set
Server
Registry
LdapTimeoutValue
Modifies or displays the registry key LdapTimeoutValueInSeconds in the server. This is the time-out value (in seconds) for DFS LDAP calls. dfsutil server registry ldaptimeoutvalue <Server>

PARAMETERS:
<Server> : The server whose registry key LdapTimeoutValueInSeconds has to  be displayed.
<value> : The default value is 30 seconds, the minimum value is 3 seconds  and the maximum value is 300 seconds (5 minutes).
SUBCOMMANDS:
Set - Set LdapTimeoutValueInSeconds key in server registry.

OLD: dfsutil /LdapTimeoutValueInSeconds[:<Value>] /Server:<Name> /Display|/Set
Server
Registry
SyncInterval
This key specifies how often domain-based root servers and domain controllers poll the primary domain controller (PDC) emulator master to obtain updated DFS metadata. dfsutil server registry syncinterval <Server>

PARAMETERS:
<Server> : The server whose registry key SyncIntervalinSeconds has to be displayed.
SUBCOMMANDS:
Set Set SyncIntervalinSeconds key in server registry.

OLD: dfsutil /SyncIntervalinSeconds[:<Value>] /Server:<Name> /Display|/Set
Server
Registry
SiteCostedReferrals
When set to 0 (the default), SYSVOL and NETLOGON referrals contain domain controllers in the client’s site listed first in random order, followed by a random list of domain controllers. When set to 1, SYSVOL and NETLOGON referrals sort domain controllers in order of lowest cost. Domain controllers in the clients site are at the top of the referral list, followed by domain controllers sorted by lowest cost. dfsutil server registry sitecostedreferrals <Server>

PARAMETERS:
<Server> : The server whose registry key SiteCostedReferrals has to be displayed.
SUBCOMMANDS:
Set - Set SiteCostedReferrals key in server registry.
Reset - Reset SiteCostedReferrals key in server registry.

OLD: dfsutil /SiteCostedReferrals[:<Value>] /Server:<Name> /Display|/Set
Server
Registry
InsiteReferrals
If this registry key is set, the server the provides referrals which are in the same site as that of the client. dfsutil server registry insitereferrals <Server> SUBCOMMANDS:
Set - Set InsiteReferrals key in server registry.
Reset - Reset InsiteReferrals key in server registry.

OLD: dfsutil /InsiteReferrals[:<Value>] /Server:<Name> /Display|/Set
Server
Registry
PreferLogonDC
When PreferLogonDc registry key is set, the logon server will be put on the top of the referral list. dfsutil server registry preferlogondc <Server>
 
SUBCOMMANDS:
Set Set PreferLogonDC key in server registry.
Reset Reset PreferLogonDC key in server registry.

OLD: dfsutil /PreferLogonDC[:<Value>] /Server:<Name> /Display|/Set
Diag Diag is used to perform diagnostics on DFS Namespace. dfsutil diag SUBCOMMANDS:
UnMapDomRoot - Delete obsolete references to Domain based root target.
Clean - Remove reference to obsolete root from host machine.
Viewdfsdirs - List/Remove all DFS reparse directories in a volume.
Viewdfspath - Resolve a DfsPath to a destination UNC path.
Diag
UnMapDomRoot
UnMapDomRoot deletes DFS references to an obsolete domain based root target. This is a special problem repair command. dfsutil diag unmapdomroot <\\domain\root> <\\rootreplica/share> [Verbose]

PARAMETERS:
<\\domain\root>: DfsName containing domain name and root name.
<\\roottargetserver\RootTargetShare>: RootTargetServer - Name of the root
target server to unmap. Should be exactly as it appears in DFS target info.
RootTargetShare - Name of the root Target share to unmap
Verbose: Show additional information while the tool is executing

EXAMPLES:
dfsutil diag unmapdomroot \\contoso.com\RootName \\myroottarget\RootTargetShare
 
Diag
Clean
Clean is a special problem repair command to remove a reference to an obsolete root from a host machine. These changes will be done in the given system's registry. dfsutil diag clean <\\server\share> [Verbose]

PARAMETERS:
<\\server\share>: server - Name of the system hosting the root to be cleaned
share - Name of the Domain based or Standalone root to remove.
Verbose: Show additional information while the tool is executing

EXAMPLES:
dfsutil diag clean \\mytargetserver\ShareName
OLD: dfsutil /Clean /Server:<ServerName> /Share:<ShareName>
Diag
Viewdfsdirs
ViewDfsDirs lists all existing DFS reparse directories in a volume. Those directories can also be deleted using the optional argument RemoveReparse. dfsutil diag viewdfsdirs <drive> [removereparse] [Verbose]

PARAMETERS:
<drive>: Drive letter of the volume to scan (with colon at the end).
RemoveReparse: Remove all reparse directories as they are listed.
Verbose: Show additional information while the tool is executing
NOTES:
1 - The volume drive letter must contain a colon at the end.
2 - This command will always enumerate dfs reparse points starting at the root of the volume. It is not possible to specify a directory below the root of the volume as a starting point

OLD: dfsutil /ViewDfsDirs:<VolumeName> [/RemoveReparse] [/Verbose]
Diag
Viewdfspath
ViewDfsPath can be used to resolve a DfsPath to a destination UNC path. The DfsPath can be a domain based/standalone DFS Namespace or even path to the link. This command is supported only in Windows Vista or above. dfsutil diag viewdfspath <DfsPath>

PARAMETERS:
<DfsPath>: Path of DFS root or link to be resolved.

EXAMPLES:
dfsutil diag ViewDfsPath \\domain\docs (will be resolved as \\servername\share)
dfsutil diag ViewDfsPath \\domain\docs\link1 (will be resolved as \\linktarget\share)
OLD: dfsutil /DisplayDfsPath:<DfsPath>
Domain Domain command is a quick way to view all namespaces in the domain. dfsutil domain <domain> OLD: dfsutil /Domain:<DomainName> /View
Cache Cache commands are used to display or flush the client cache. dfsutil cache  SUBCOMMANDS:
Domain - View/Flush the Domain cache.
Referral - View/Flush the Referral cache.
Provider - View/Flush the Provider cache.
Cache
Domain
Domain commands are used to display or flush the domain cache. dfsutil cache domain SUBCOMMANDS:
Flush - Flush the Domain cache.

OLD: dfsutil /SpcInfo
OLD: dfsutil /SpcFlush
Cache
Referral
Referral commands are used to display or flush the Referral cache. dfsutil cache referral [<Level>] SUBCOMMANDS:
Flush - Flush the Referral cache.

OLD: dfsutil /PktInfo
OLD: dfsutil /PktFlush
Cache
Provider
Provider commands are used to display or flush the provider cache. dfsutil cache provider SUBCOMMANDS:
Flush - Flush the Provider cache.

OLD: dfsutil /PurgeMupCache
OLD: dfsutil /DisplayMupCache
Your comment has been posted.   Close
Thank you, your comment requires moderation so it may take a while to appear.   Close
Leave a Comment