Share via

Domain (Standard 8 Module Reference)

  • Article

7/8/2014

Review the applicable Embedded Core modules and any examples for the Domain setting in Windows Embedded 8 Standard (Standard 8).

This setting contains a string that specifies the name of a domain.

Modules

The following table shows the modules that you can apply this setting to. In Image Configuration Editor (ICE), you can follow the corresponding path to set this setting for a module.

Module

Path

Setting Description

Windows 8 Application Launcher

Features/Branding/Windows 8 Application Launcher/UserSettings/User/Domain

Specifies the domain of the user account to configure.

Shell Launcher

Features/Shell/Shell Launcher/UserSettings/User/Domain

Specifies the domain of the user account to configure.

Deployment

Products/Embedded Core/Deployment/RunAsynchronous/RunAsynchronousCommand/Credentials/Domain

Specifies the domain of the account to use for authentication.

Deployment

Products/Embedded Core/Deployment/RunSynchronous/RunSynchronousCommand/Credentials/Domain

Specifies the domain of the account to use for authentication when accessing the Path if the command is on a network share.

Do not create an empty value for this setting.

PnpCustomizationsNonWinPE

Products/Embedded Core/PnpCustomizationsNonWinPE/DriverPaths/PathAndCredentials/Credentials/Domain

Specifies the domain name of the account to use to authenticate the Path.

If the account is not a domain account, then use the computer name instead of the domain name. For example, if a computer named SYSTEM1 is connected to the FABRIKAM domain, then you can specify credentials in one of the following ways:

  • FABRIKAM\User_Name and the account password. In this case, the value for this setting is FABRIKAM.
  • SYSTEM1\User_Name and the user name password on the SYSTEM1 computer. You can use any account on the computer. In this case, the value for this setting is SYSTEM1.

This value can be empty.

PnpCustomizationsWinPE

Products/Embedded Core/PnpCustomizationsWinPE/DriverPaths/PathAndCredentials/Credentials/Domain

Specifies the domain of the account to use to authenticate the Path. If the account is not a domain account, then use the device name instead of the domain name.

If the account is not a domain account, then use the device name instead of the domain name. For example, if a device named SYSTEM1 is connected to the FABRIKAM domain, then you can specify credentials in one of the following ways:

  • FABRIKAM\User_Name and the User_Name account password. In this case, to the value for this setting is FABRIKAM.
  • SYSTEM1\User_Name and the User_Name password on the SYSTEM1 device. You can use any account on the system. In this case, to the value for this setting is SYSTEM1.
    Do not create an empty value.

Setup

Products/Embedded Core/Setup/Catalog/Credentials/Domain

Specifies the name of the domain used to authenticate the device when the catalog is in a network location.

Setup

Products/Embedded Core/Setup/ImageInstall/DataImage/InstallFrom/Credentials/Domain

Specifies the name of the domain used for account authentication for the data image.

Setup

Products/Embedded Core/Setup/ImageInstall/OSImage/InstallFrom/Credentials/Domain

Specifies the name of the domain used when authenticating an account. This value cannot be empty.

This setting specifies the credentials for an IT professional or other authorized user to use when accessing a Windows image (.wim) file.

Setup

Products/Embedded Core/Setup/OemFolderPaths/PathAndCredentials/Credentials/Domain

Specifies the domain to use for authentication to an OEM folder that contains third-party files that you want to deploy to your image.

Setup

Products/Embedded Core/Setup/RunAsynchronous/RunAsynchronousCommand/Credentials/Domain

Specifies the name of the domain to use when authenticating access to the location that is specified by Path.

This value cannot be empty.

Setup

Products/Embedded Core/Setup/RunSynchronous/RunSynchronousCommand/Credentials/Domain

Specifies the name of the domain to use when authenticating an account.

Do not create an empty value for this setting.

Setup

Products/Embedded Core/Setup/WindowsDeploymentServices/Login/Credentials/Domain

Specifies the name of the domain for Windows Deployment Services login. This setting is not required if the domain was specified as a user principal name (UPN) in Username.

Do not create an empty value for this setting.

Shell-Setup

Products/Embedded Core/Shell-Setup/AutoLogon/Domain

Specifies the domain to which the computer is logging on automatically. This value can be empty.

Shell-Setup

Products/Embedded Core/Shell-Setup/UserAccounts/DomainAccounts/DomainAccountList/Domain

Specifies the name of the domain for a DomainAccountList. This domain is created and added to local security groups on the computer during installation.

Do not create an empty value for this setting.

UnattendedJoin

Products/Embedded Core/UnattendedJoin/Identification/Credentials/Domain

Specifies the domain used to authenticate an account during Standard 8 Setup. The domain name can be either a fully qualified DNS domain name or a NetBIOS domain name.

You must set a value in either Domain or Username, but you cannot set a value in both. Do not create an empty value for this setting.

JJ963132.note(en-us,WinEmbedded.81).gifNote:
Use either AccountData settings or Credentials settings to join an account to the domain. If values are entered for both Provisioning and Credentials settings, Provisioning will be used to join the account to the domain.

XML Example

The following XML examples show how to set Domain.

Data Image Install

The following XML example shows how to specify credentials to use when accessing a data image file specified by InstallFrom.

<InstallFrom>
    <Credentials>
        <Domain>FabrikamDomain</Domain>
        <Password>MyPassword</Password>
        <Username>MyUsername</Username>
    </Credentials>
</InstallFrom>

For an XML example that shows how to set the ImageInstall setting to install both an operating system image and a data image, see Setting the ImageInstall Setting XML Example.

Deployment Run Synchronous

The following XML example shows how to set synchronous commands

<RunSynchronous>
      <RunSynchronousCommand wcm:action="add">
         <Credentials>
            <Domain>MyDomain</Domain>
            <Password>MyPassword</Password>
            <Username>MyUsername</Username>
         </Credentials>
         <Description>MySynchCommand1</Description>
         <Order>1</Order>
         <Path>\\network\server\share\filename</Path>
         <WillReboot>OnRequest</WillReboot>
      </RunSynchronousCommand>
</RunSynchronous>

Deployment Run Aynchronous

The following XML example shows how to set asynchronous commands.

<RunAsynchronous>
    <RunAsynchronousCommand wcm:action="add">
        <Credentials>
            <Domain>MyDomain</Domain>
            <Password>MyPassword</Password>
            <Username>MyUsername</Username>
        </Credentials>
        <Description>AsynchCommand1</Description>
        <Order>1</Order>
        <Path>\\network\server\share\filename</Path>
    </RunAsynchronousCommand>
</RunAsynchronous>

Deployment Services

The following XML example shows how to set the domain, password, and user name used for Windows Deployment Services login.

<WindowsDeploymentServices>
    <Login>
        <Credentials>
           <Username>Administrator</Username>
           <Domain>MY-DOMAIN-NAME</Domain>
           <Password>********</Password>
        </Credentials>
    </Login>
</WindowsDeploymentServices>

For an example of a complete Windows Deployment Services deployment, see Complete Windows Deployment Services deployment XML Example.

For an example of a complete Windows Deployment Services deployment, see Complete Windows Deployment Services deployment XML Example.

OS Image Install

The following XML example shows how to specify credentials for an IT professional or other authorized user to use when accessing a Windows image (.wim) file.

<InstallFrom>
    <Credentials>
        <Domain>FabrikamDomain</Domain>
        <Password>MyPassword</Password>
        <Username>MyUsername</Username>
    </Credentials>
</InstallFrom>

For an XML example that shows how to set the ImageInstall setting to install both an OS image and a data image, see Setting the ImageInstall Setting XML Example.

PnpCustomizationsNonWinPE

The following XML example shows how to specify the UNC paths to an additional location for device drivers and the credentials used to access the path.

<DriverPaths>
<!-- First PathAndCredentials list item -->
   <PathAndCredentials wcm:action="add" wcm:keyValue="1">
      <Path>\\myFirstDriverPath\DriversFolder</Path>
      <Credentials>
         <Domain>MyDomain</Domain>
         <Username>MyUsername</Username>
         <Password>MyPassword</Password>
      </Credentials>
   </PathAndCredentials>
</DriverPaths>

PnpCustomizationsWinPE

The following XML example shows how to specify the UNC paths to an additional location for device drivers and the credentials used to access the path.

<DriverPaths>
<!-- First PathAndCredentials list item -->
   <PathAndCredentials wcm:action="add" wcm:keyValue="1">
      <Path>\\myFirstDriverPath\DriversFolder</Path>
      <Credentials>
         <Domain>MyDomain</Domain>
         <Username>MyUsername</Username>
         <Password>MyPassword</Password>
      </Credentials>
   </PathAndCredentials>
</DriverPaths>

Setup Run Synchronous Command

The following XML example shows how to configure commands to run synchronously.

<RunSynchronous>
    <!-- First synchronous command to execute -->
    <RunSynchronousCommand>
         <Order>1</Order>
         <Path>\\MyNetworkShare\MyApplication.exe</Path>
         <Description>DescriptionOfMyApplication</Description>
         <Credentials>
            <Domain>FabrikamDomain</Domain>
            <UserName>MyUserName</UserName>
            <Password>MyPassword</Password>
         </Credentials>
    </RunSynchronousCommand>
<!-- Second synchronous command to execute -->
    <RunSynchronousCommand>
         <Order>2</Order>
         <Path>C:\AnotherApplication.exe</Path>
         <Description>DescriptionOfMyApplication</Description>
    </RunSynchronousCommand>
</RunSynchronous>

Setup Run Asynchronous Command

The following XML example shows how to configure commands to run asynchronously.

<RunAsynchronous>
      <RunAsynchronousCommand>
         <Order>1</Order>
         <Path>\\MyNetworkShare\MyApplication.exe</Path>
         <Description>DescriptionOfMyApplication</Description>
         <Credentials>
            <Domain>FabrikamDomain</Domain>
            <UserName>MyUserName</UserName>
            <Password>MyPassword</Password>
         </Credentials>
      </RunAsynchronousCommand>
      <RunAsynchronousCommand>
         <Order>2</Order>
         <Path>C:\AnotherApplication.exe</Path>
         <Description>DescriptionOfMyApplication</Description>
      </RunAsynchronousCommand>
</RunAsynchronous>

Shell Launcher

The following XML example shows how to configure Shell Launcher for a user account.

<UserSettings>
    <User wcm:action="add">
        <AccountName>MyAccount</AccountName>
        <Domain>MyDomain</Domain>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
        <Key>1</Key>
        <Shell>cmd.exe</Shell>
    </User>
</UserSettings>

Shell Setup

The following XML example shows how to set automatic logon.

<AutoLogon>
      <Password>
         <Value>MyPassword</Value>
      </Password>
      <Domain>FabrikamDomain</Domain>
      <Enabled>true</Enabled>
      <LogonCount>2</LogonCount>
      <Username>MyUserName</Username>
</AutoLogon>

UnattendedJoin

The following XML example shows how to use the Credentials settings to specify the domain, the user name, and the password used to join a domain during Windows Embedded 8 Standard (Standard 8) Setup.

<Identification>
   <Credentials>
      <Domain>fabrikam.com</Domain>
      <Password>MyPassword</Password>
      <Username>MyUserName</Username>
   </Credentials>
   <JoinDomain>fabrikam.com</JoinDomain>
   <MachinePassword>ComputerPassword</MachinePassword>
</Identification>

Domain Accounts

The following XML example shows how to set domain accounts.

<UserAccounts>
      <DomainAccounts>
         <DomainAccountList wcm:action="add">
            <DomainAccount wcm:action="add">
               <Name>account1</Name>
               <Group>Fabrikam\Group1</Group>
            </DomainAccount>
            <DomainAccount wcm:action="add">
               <Name>account2</Name>
               <Group>Fabrikam\Group2</Group>
            </DomainAccount wcm:action="add">
            <Domain>domain1</Domain>
         </DomainAccountList>
         <DomainAccountList wcm:action="add">
            <DomainAccount wcm:action="add">
               <Name>account3</Name>
               <Group>Fabrikam\Group2</Group>
            </DomainAccount wcm:action="add">
            <Domain>domain2</Domain>
        </DomainAccountList>
      </DomainAccounts>
</UserAccounts>

Windows 8 Application Launcher

The following XML example shows how to configure Windows 8 Application Launcher for a user account.

<UserSettings>
    <User wcm:action="add">
        <AccountName>MyAccount</AccountName>
        <DefaultReturnCodeAction>0</DefaultReturnCodeAction>
        <Domain>MyDomain</Domain>
        <Key>1</Key>
        <AppUserModelId>MyPackageFamilyName_CompanyID!AppName</AppUserModelId >
    </User>
</UserSettings>

See Also

Concepts

Embedded Core Settings