Table of contents
TOC
Collapse the table of content
Expand the table of content

Name

Last Updated: 12/12/2016

Name specifies the user name for a LocalAccount to be created during installation.

Values

Name

Specifies the name of a LocalAccount. Name is a string with a maximum length of 256 characters.

Do not use any of the following characters: "/[]:|<>+=;,?*%@

Do not use the name "NONE", this is a restricted username.

This string type does not support empty elements. Do not create an empty value for this setting.

Some Unicode characters such as emoji appear as with the placeholder character: ? (question mark) in command prompts, but appear correctly in other locations such as File Explorer.

Users who sign-in with a Microsoft account will frequently see that their underlying profile path does not match their firstname / lastname. When this happens, you will see an account in the form: username_001.

Valid Configuration Passes

auditSystem

oobeSystem

Parent Hierarchy

Microsoft-Windows-Shell-Setup | UserAccounts | LocalAccounts | LocalAccount | Name

Applies To

For a list of the supported Windows editions and architectures that this component supports, see Microsoft-Windows-Shell-Setup.

XML Example

The following XML output shows how to set UserAccounts.

<UserAccounts>
   <LocalAccounts>
      <LocalAccount wcm:action="add">
         <Password>
            <Value>cAB3AFAAYQBzAHMAdwBvAHIAZAA</Value>
            <PlainText>false</PlainText>
         </Password>
         <Description>Test account</Description>
         <DisplayName>Admin/Power User Account</DisplayName>
         <Group>Administrators;Power Users</Group>
         <Name>Test1</Name>
      </LocalAccount>
      <LocalAccount wcm:action="add">
         <Password>
            <Value>cABhAHMAcwB3AG8AcgBkAFAAYQBzAHMAdwBvAHIAZAA=</Value>
            <PlainText>false</PlainText>
         </Password>
         <Description>For testing</Description>
         <DisplayName>Admin Account</DisplayName>
         <Group>Administrators</Group>
         <Name>Test2</Name>
      </LocalAccount>
   </LocalAccounts>
</UserAccounts>

LocalAccount

Send comments about this topic to Microsoft

© 2017 Microsoft