VMware Orchestrator javascript to retrieve an Active Directory User object (AD:User) based on a string for the username

getADUserByName.js

// Here's a quick one-liner to get a user by name.  
// Inputs: username (string), adHost (AD:AdHost) - "adHost" host param optional. If not specified, only the default AD host is searched.  
// Output: user (AD:User)  
// Option 1: quick 1-liner  
user = ActiveDirectory.searchExactMatch("User", username, 1, adHost)[0];  
  
// Option 2: If you want a bit more error handling, try this:  
/* 
var users = ActiveDirectory.searchExactMatch("User" , UserID, 1, adHost); 
for each (usr in users){ 
    if (UserID.length == usr.accountName.length){ 
        var user = usr; 
        break; 
    } 
} 
if(user == null){ 
    throw "No matching user found: " + UserID; 
} 
*/
// If you wish to use this script as an action, you'll need to add the following as the last ine:
// return user;

Updated to include the optional parameter for AD Host