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.
Note: 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,