Replace the List of Domain Name Providers - Windows Server Essentials

Applies To: Windows Server 2012 R2 Essentials

To replace the list of domain name providers that is displayed in the Set Up Domain Name Wizard, completing the following tasks:

  • Create the referral service files

  • Add an entry to the registry on the reference computer

Create the referral service files

The Referral Service Administration Tool creates a set of files that are used to define the list of domain name providers that are displayed in the Set Up Domain Name Wizard. An XML formatted file is created for each worldwide region and contains information for the domain name providers that you specify in the tool. The files that are created by the tool must be located in a folder that can be accessed through a secure link (HTTPS) that you manage on the Internet.

To create the referral files

  1. Open the Referral Service Administration Tool.

  2. Click Add.

  3. In the Add a Domain Name Provider dialog box, enter the name of the domain name provider.

  4. Add the top-level domains that are supported by the domain name provider. You do this by clicking Add, entering the top-level domain identifier, and then selecting the supported regions. You can select All Regions.

  5. Enter the description of the domain name provider.

  6. Add the URLs for all websites that are associated with the domain name provider.

  7. If a logo is available for the domain name provider, add the logo by clicking Change Logo.

  8. Click Save.

  9. Repeat steps 2 through 8 for each domain name provider that you want to list in the wizard.

  10. After you add all of the domain name providers, choose the folder where the referral files will be located. Keep in mind when choosing a folder that the referral files must be accessed through an HTTPS link.

  11. Click Generate Files to File System.

Add an entry to the registry on the reference computer

A registry entry must be added to specify where the operating system can find the referral service files.

To add a key to the registry

  1. On the reference computer, click Start, enter regedit, and then press Enter.

  2. In the left pane, expand HKEY_LOCAL_MACHINE, expand SOFTWARE, expand Microsoft, expand Windows Server, expand Domain Managers, and then expand Providers.

  3. Right-click the E423C85D-6B1F-4583-95E0-449D8263BAC4 key, and then click String Value.

  4. Type ReferralServerHttpsUri for the name of the string, and then press Enter.

  5. Right-click the new ReferralServerHttpsUri string in the right pane, and then click Modify.

  6. Type the HTTPS URL that is used to access the referral files that you created in Create the referral service files, and then click OK.

Important

A slash (/) is required at the end of the URL.

Domain name status issues

If you add domain name providers and use an application programming interface (API) in the SDK to set the Unknown, Failed, and CertificateRequestNotSubmitted statuses for the certificate, the customer will receives an incorrect message and configuration result. This is because the cases are handled by exceptions rather than returning a status.

The following domain statuses are failures and should be reported as an error:

  • Failed

  • PendingCustomerInterventionRequired

  • PurchaseFailed

  • DomainNotFound

  • InRenewalCustomerInterventionRequired

  • RenewalFailed

The following domain statuses are successful and should be reported as a success:

  • Ready

  • Pending

  • InRenewal

See Also

Concepts

Preparing the Image for Deployment - Windows Server Essentials
Testing the Customer Experience - Windows Server Essentials

Other Resources

Windows Server Solutions SDK
Windows Deployment Tools Technical Reference