UserName/DisplayName/AccountDescription feature in TechIDAgent piece of TechIDManager

Starting with TechIDAgent version 2.0, you can now set the following technician account attributes per domain via the command line:

User Name

Display Name

Account Description

As of version 3.177, you can also set:

Phone Number

Email Address

---

Available Variables:

These values can be used to define account details:

1. first – First name from TechIDClient (not assured to be unique among techs)
2. last – Last name from TechIDClient (not assured to be unique among techs)
3. user – User name from TechIDClient (assured to be unique among techs)
4. company – UserNameAddon from TechIDPortal (shared between everyone in the company)
5. firstinitial – First letter of the First name from TechIDClient (not assured to be unique among techs)
6. lastinitial – First letter of the Last name from TechIDClient (not assured to be unique among techs)
7. phone – Phone number from TechIDClient (not assured to be unique among techs)
8. email – Email from TechIDClient (not assured to be unique among techs)
9. blank – nothing. Use to prevent a value from being set.

---

Command Line Usage

Variables must be wrapped in curly braces {}.

Plain text outside the braces will appear as-is.

Use “reset” after an option to restore its default.

In PowerShell, wrap the entire command in double quotes (“”) to prevent errors. Use the command:

TechIDAgent.exe show

…to verify your configuration.

---

Example Scenarios

Company: SuperTechs

Employees:

1.

John Blaze

• User Name: Tech1
• First Name: John
• Last Name: Blaze

2.

Eric Burgin

• User Name: Eric
• First Name: Eric
• Last Name: Burgin

3.

Ethan Bailey

• User Name: Master
• First Name: Ethan
• Last Name: Bailey

---

Example 1: Safe Unique Naming

TechIDAgent.exe username "admin-{user}.{company}"

Creates:

• admin-Tech1.SuperTechs
• admin-Eric.SuperTechs
• admin-Master.SuperTechs

✅ Unique and safe.

---

Example 2: Risky- May Cause Collision

TechIDAgent.exe username "{firstinitial}{lastinitial}.{company}"

Would try to create:

• JB.SuperTechs
• EB.SuperTechs
• EB.SuperTechs

❌Collision error: Both Eric and Ethan result in EB.SuperTechs

Result: The TechIDAgent does nothing until the error is fixed. Users won’t get created and passwords won’t get rotated.

---

Example 3: High Collision Risk

TechIDAgent.exe username "{first}"

Would create or take over:

• John
• Eric
• Ethan

⚠️ Very high chance of name collisions. Not recommended.

A high likelihood to overlap with existing and future users on the network, so we recommend against it.

---

Important Notes

• This applies to username, displayname, and accountdescription.
• To include spaces in Display Name or Account Description, wrap the string in quotes.
• On Domain Controllers, changes will update existing managed accounts.
• On non-domain computers, account names remain as originally created. Deleted accounts will be recreated using current parameters.