Share via

Group

  • Article

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

auditSystem

oobeSystem

Parent Hierarchy

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

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