Enable or Disable Referrals and Client Failback

Updated: October 16, 2013

Applies To: Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2

A referral is an ordered list of servers that a client computer receives from a domain controller or namespace server when the user accesses a namespace root or DFS folder with targets. After the computer receives the referral, the computer attempts to access the first server in the list. If the server is not available, the client computer attempts to access the next server. If a server becomes unavailable, you can configure clients to fail back to the preferred server after it becomes available.

The following sections provide information about how to enable or disable referrals or enable client fail back.

Enable or disable referrals

By disabling a namespace server’s or folder target’s referral, you can prevent users from being directed to that namespace server or folder target. This is useful if you need to temporarily take a server offline for maintenance.

Tip

To enable or disable referrals by using Windows PowerShell, use the Set-DfsnRootTarget –State or Set-DfsnServerConfiguration cmdlets, which were introduced in Windows Server 2012.

To enable or disable referrals

  • To enable or disable referrals to a folder target, use the following steps:

    1. In the DFS Management console tree, under the Namespaces node, click a folder with targets, and then click the Folder Targets tab in the details pane.

    2. Right-click the folder target, and then click either Disable Folder Target or Enable Folder Target .

  • To enable or disable referrals to a namespace server, use the following steps:

    1. In the DFS Management console tree, select the appropriate namespace and then click the Namespace Servers tab.

    2. Right-click the appropriate namespace server and then click either Disable Namespace Server or Enable Namespace Server .

Enable client fail back

If a target becomes unavailable, you can configure clients to fail back to the target after it is restored. For fail back to work, client computers must meet the requirements listed in the following topic: Review DFS Namespaces Client Requirements.

Tip

To enable client fail back on a namespace root by using Windows PowerSHell, use the Set-DfsnRoot cmdlet. To enable client fail back on a DFS folder, use the Set-DfsnFolder cmdlet.

To enable client failback for a namespace root

  1. Click Start , point to Administrative Tools , and then click DFS Management .

  2. In the console tree, under the Namespaces node, right-click a namespace, and then click Properties .

  3. On the Referrals tab, select the Clients fail back to preferred targets check box.

Folders with targets inherit client failback settings from the namespace root. If client failback is disabled on the namespace root, you can use the following procedure to enable the client to fail back on a folder with targets.

To enable client fail back for a folder with targets

  1. Click Start , point to Administrative Tools , and then click DFS Management .

  2. In the console tree, under the Namespaces node, right-click a folder with targets, and then click Properties .

  3. On the Referrals tab, click the Clients fail back to preferred targets check box.

Additional references