This documentation is archived and is not being maintained.

Group

Group specifies the name of an existing local security group to which a new LocalAccount will be added during installation. You can add a user to multiple groups, by entering multiple group names separated by semicolons.

The Microsoft-Windows-Shell-Setup component recognizes the following English group names and sets the appropriate localized group name, regardless of the default language of the Windows image:

  • AccountOperators
  • Administrators
  • BackupOperators
  • CryptoOperators
  • DCOMUsers
  • Guests
  • IUsers
  • NetworkConfigurationOperators
  • PerfLoggingUsers
  • PerfMonitoringUsers
  • PowerUsers
  • PrintOperators
  • RemoteDesktopUsers
  • Replicator
  • SystemOperators
  • Users

Specify the account names and group names, by using language-neutral names. The language-neutral account and group names are specified in English, for example, Administrators, Power Users, and Guest. This is required because the shell account settings are processed before a default user interface (UI) language is applied to the computer.

Values

 

Group_name

Specifies the existing local security group for the local account. More than one group can be specified (separated by semicolons). Group_name is a string with a maximum length of 256 characters.

This string type supports empty elements.

Valid Passes

Parent Hierarchy

Applies To

For the 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>

See Also

Concepts

LocalAccount

Show: