Join Domain activity

  • Release version: Washingtondc
  • Updated February 1, 2024
  • 1 minute to read

    • The Join Domain activity joins a Windows computer to a domain.

    If the computer is already a member of a domain, this activity completes without modifying the computer. Joining a domain requires a username and password. This user must have domain administration privileges or privileges to join a computer to the domain.

    Note:
    This activity replaces a Powershell activity by the same name available in releases prior to Geneva. If you have a workflow created in a previous version that uses the deprecated activity, your workflow will continue to work normally after upgrading to Geneva. However, all new workflows must use the custom version of this activity. This activity was built with the PowerShell activity designer, which gives workflow administrators the ability to store input and output variables in the databus.

    Input variables

    Table 1. Join Domain input variables
    Variables Description
    Hostname Hostname or IP address of the Windows server that is joining the domain.
    Domain Name of the domain to join.
    Domain_user The name of a user who has domain administration privileges or privileges to join a computer to the domain.
    Domain_user_password The password for the user who has domain administration privileges or privileges to join a computer to the domain.

    Output variables

    Table 2. Join Domain output variables
    Variables Description
    result Either success or failure.
    errorMessage The executionResult.errorMessages from the Activity designer parsing sources. If this variable is not null, the operation has failed.

    Conditions

    Table 3. Join Domain conditions
    Condition Description
    Success The activity succeeded in joining the computer to the domain.
    Failure The activity failed to join the computer to the domain.