Host Active Directory Authentication Join Domain With CAM Task
Adds the host to an Active Directory domain through CAM service.
If the HostAuthenticationStoreInfo.enabled property is True
(accessed through the info
property), the host has joined a domain. The vSphere API will throw the InvalidState
fault if you try to add a host to a domain when the host has already joined a domain.
Required privileges: Host.Config.AuthenticationStore
The unique identifier for the managed object to which the method attaches; the serialized managed object reference for a request has the form moType/moId
, in this case HostActiveDirectoryAuthentication/{moId}
.
The vSphere release schema. The current specification covers vSphere 8.0.2.0 APIs.
{
"domainName": "string",
"camServer": "string"
}
Name of the domain to be joined.
Name of server providing the CAM service.
OK
{
"_typeName": "string",
"type": "string",
"value": "string"
}
InvalidState: if the host has already joined a domain.
BlockedByFirewall: if ports needed by the join operation are blocked by the firewall.
HostConfigFault: if the host configuration prevents the join operation from succeeding.
DomainNotFound: if the domain controller for domainName
cannot be reached.
InvalidHostName: if the domain part of the host's FQDN doesn't match the domain being joined.
ClockSkew: if the clocks of the host and the domain controller differ by more than the allowed amount of time.
InvalidCAMServer: if camServer is not a valid IP address, or if camServer is not accessible.
InvalidCAMCertificate: if the certificate of the given CAM server cannot be verified.
CAMServerRefusedConnection: if the specified CAM server is not reachable, or if the server denied access.
ActiveDirectoryFault: for any problem that is not handled with a more specific fault.
TaskInProgress: if the HostActiveDirectoryAuthentication object is busy.
{
"_typeName": "string",
"faultCause": "MethodFault Object",
"faultMessage": [
{
"_typeName": "string",
"key": "string",
"arg": [
{
"_typeName": "string",
"key": "string",
"value": {
"_typeName": "string"
}
}
],
"message": "string"
}
]
}