ONTAP 9.14.1 commands

vserver cifs domain preferred-dc add

Add to a list of preferred domain controllers

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.


The vserver cifs domain preferred-dc add command adds one or more domain controllers to be used in preference to all others by the specified Vserver for interactions with the specified domain. If a list already exists for the specified domain, the new list is merged with the existing list. This command is not supported for workgroup CIFS servers.

Each Vserver discovers domain controllers and attempts to sort them internally based on real-world performance. Therefore it should not be necessary to create a preferred list of domain controllers under most circumstances.


-vserver <vserver name> - Vserver

This parameter specifies the name of the Vserver for which you want to add preferred domain controllers.

-domain <TextNoCase> - Fully Qualified Domain Name

This parameter specifies the fully-qualified name of the domain that the domain controllers belong to.

-preferred-dc <InetAddress>,…​ - Preferred Domain Controllers

This parameter specifies a comma-delimited list of IP addresses for domain controllers that belong to the domain specified in the -domain parameter.

[-skip-config-validation <true>] - Skip Configuration Validation

Use this parameter to skip the Preferred-DC configuration validation.

The hosts specified with the -DC-servers parameter are validated to verify that each of the DC servers are reachable, and is providing NETLOGON services.

The validation fails if there is no valid Preferred-DC server.


The following example adds two domain controllers ( and to the preferred list used by Vserver vs1 when connecting to the example.com domain:

cluster1::> vserver cifs domain preferred-dc add -vserver vs1 -domain example.com -preferred-dc,
Top of Page