Group

  • Article

Applies To: Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Vista

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

See Also

Concepts

LocalAccount