****
*
*
*
*







*
*
                                      
*
*
Windows Server



    

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


Categories:


Tags:


Apr
07

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

 

http://blogs.technet.com/b/josebda/archive/2009/05/01/using-the-windows-server-2008-dfsutil-exe-command-line-to-manage-dfs-namespaces.aspx

 

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

 

 

 

 

 



No TrackBacks

TrackBack URL: http://www.skar.us/site/mt-tb.cgi/2998

Leave a comment








*
*

administrator
Author Bio          ★★★★★

Author Name:         administrator
Author Location:    India
Author Rank:          Writer
Author Status:        
The Green leave stands!!


*
*
*
*
****



*****



    Desktop
  • eBooks
  • Games
  • Softwares
  • Tools
  • Tweaks
  • Wallpapers
  • Warez
    PDA
  • Games
  • Tools
  • Wallpapers
    System Administration
  • dll Center
  • Scripts
  • Tools
  • .extensions database
  • Write-up
    more...
  • Download Database
  • Jobs
  • Lists
  • Polls
  • Glossary

01000011 01110010 01100001 01100011 01101011 01111010 01101000 01100001 01100011 01101011