# Sysprep_JoinDomain

> Adds information to unattend file about which domain the computer should join.

Source: https://docs.capaone.com/capainstaller/vb-scripting-library/osd-scripting-library/sysprep-functions-osd/sysprep-joindomain/  
Product: CapaInstaller — a separate CapaSystems product; do not apply this page to any other.

[VB Scripting Library](/capainstaller/vb-scripting-library/) > [OSD Scripting Library](/capainstaller/vb-scripting-library/osd-scripting-library/) > [Sysprep functions (OSD)](/capainstaller/vb-scripting-library/osd-scripting-library/sysprep-functions-osd/)

### Sysprep_JoinDomain(sDomainName,sDomainAdmin,sPassword,sMachineObjectOU)

Adds information to unattend file about which domain the computer should join.

### Arguments

| ARGUMENT         | DESCRIPTION                                                                                                                                                                 | TYPE   |
|:-----------------|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:-------|
| sDomainName      | Name of the domain to join                                                                                                                                                  | String |
| sDomainAdmin     | Account name in the target domain, that has the privileges to add a computer to the domain                                                                                  | String |
| sPassword        | Password for the user                                                                                                                                                       | String |
| sMachineObjectOU | Optional string for specifying the target Active Directory Organizational Unit (OU)  where the computer object is to be created. If no OU, a blank string must be specified | String |

### Return Type

Boolean, TRUE if function completed successfully.

#### Affected unattend sections

| UNATTEND FILE   | COMPONENT PATH / SECTION         | SETTINGS PASS   |
|:----------------|:---------------------------------|:----------------|
| Unattend.xml    | Microsoft-Windows-UnattendedJoin | Specialize      |
| Sysprep.inf     | Identification                   | N/A             |

### Remarks

Typpically used in the PreBootScript.wsf

### Example

The following example will join the computer to the domain "mydomain.local" using the "CapaJoin" account. The Computer object will be created in the "Test Computers OU".

**VBScript**

```vb
Private Function IncludeScript(sScriptFile)
 '...
End Function

'Begin
  bStatus=True
  If bStatus Then bStatus=IncludeScript("customlib.cis")
  If bStatus Then bStatus=IncludeLibrary("Capalib.cin")
  If bStatus Then bStatus=IncludeLibrary("Osdlib.cin")
  If bStatus Then bStatus=Job_Start("WS","Script Name","1.0","ScriptName.log","INSTALL")
  If bStatus Then bStatus=OSD_Initialize()

  If bStatus Then bStatus=Sysprep_JoinDomain("mydomain.local","capajoin","MySecretPassword","OU=Test Computers OU,DC=mydomain,DC=local")

  Job_End(bStatus)
'End main

```

### See Also

[Scripting Guidelines](/capainstaller/vb-scripting-library/scripting-guidelines/), [Sysprep_JoinWorkgroup](/capainstaller/vb-scripting-library/osd-scripting-library/sysprep-functions-osd/sysprep-joinworkgroup/) [Constants](/capainstaller/vb-scripting-library/addendum/constants/) [Package Property](/capainstaller/vb-scripting-library/addendum/package-property/) [Variables](/capainstaller/vb-scripting-library/addendum/variables/)