Dfsdiag TestReferral

  • Article

 

Applies To: Windows Server 2012, Windows 8

Checks Distributed File System (DFS) referrals by performing the following tests:

  • When you use the DFSPath parameter without arguments, this command validates that the referral list includes all trusted domains.

  • When you specify a domain, the command performs a health check of domain controllers (Dfsdiag /testdcs) and tests the site associations and domain cache of the local host.

  • When you specify a domain and \SYSVOL or \NETLOGON, in addition to performing the same health checks as when you specify a domain, the command checks that the Time To Live (TTL) of SYSVOL or NETLOGON referrals match the default value of 900 seconds.

  • When you specify a namespace root, in addition to performing the same health checks as when you specify a domain, the command performs a DFS configuration check (Dfsdiag /TestDFSConfig) and a namespace integrity check (Dfsdiag /TestDFSIntegrity).

  • When you specify a DFS folder (link), in addition to performing the same health checks as when you specify a namespace root, the command validates the site configuration for folder targets (Dfsdiag /testsites) and validates the site association of the local host.

For examples of how this command can be used, see <?Comment LV: Do we really need this link here? The topic is not very long. 2010-08-24T15:47:00Z Id='0?>Examples<?CommentEnd Id='0' ?>.

Syntax

DFSDiag /TestReferral /DFSPath:<DFS path for getting referrals> [/Full]

Parameters

Parameter

Description

/DFSPath:<Path for getting referrals>

This DFS path can be one of the following:

  • (blank): Tests trusted domains.

  • \\Domain: Domain controller referrals.

  • \\Domain\SYSVOL: SYSVOL referrals.

  • \\Domain\NETLOGON: NETLOGON referrals.

  • \\<Domain or server>\<Namespace Root>: Namespace root referrals.

  • \\<Domain or server>\<Namespace root>\<DFS folder>: DFS folder (link) referrals.

/Full

Applied only to Domain and Root referrals. Verifies the consistency of site association information between the registry and Active Directory Domain Services (AD DS).

Examples

To TBD, type:

DFSDiag /TestReferral /DFSPath:\\Contoso.com\MyNamespace

To TBD, type:

DFSDiag /TestReferral /DFSPath:

Additional references