Using vicfg-authconfig for Active Directory Configuration
vSphere 5.0 is tightly integrated with Active Directory. Active Directory provides authentication for all local services and for remote access through the vSphere Web Services SDK, vSphere Client, PowerCLI, and vSphere CLI. You can configure Active Directory settings with the vSphere Client, as discussed in the vCenter Server and Host Management documentation, or use vicfg-autconfig.
vicfg-authconfig allows you to remotely configure Active Directory settings on ESXi hosts. You can list supported and active authentication mechanisms, list the current domain, and join or part from an Active Directory domain. Before you run the command on an ESXi host, you must prepare the host.
To prepare ESXi hosts for Active Directory Integration
1
The ESXi system’s time zone is always set to UTC.
2
You can run vicfg-authconfig to add the host to the domain. A user who runs vicfg-authconfig to configure Active Directory settings must have the appropriate Active Directory permissions, and must have administrative privileges on the ESXi host. You can run the command directly against the host or against a vCenter Server system, specifying the host with --vihost.
To set up Active Directory
1
Install the ESXi host, as explained in the vSphere Installation and Setup documentation.
2
3
4
ping <ESX_hostname>
5
Run vicfg-authcofig to add the host to the Active Directory domain.
vicfg-authconfig --server=<ESXi Server IP Address>
--username=<ESXi Server Admin Username>
--password=<ESXi Server Admin User's Password>
--authscheme AD --joindomain <AD Domain Name>
--adusername=<Active Directory Administrator User Name>
--adpassword=<Active Directory Administrator User's Password>
The system prompts for user names and passwords if you do not specify them on the command line. Passwords are not echoed to the screen.
6
Check that a Successfully Joined <Domain Name> message appears.
7
vicfg-authconfig --server XXX.XXX.XXX.XXX --authscheme AD -c
You are prompted for a user name and password for the ESXi system.