-
Notifications
You must be signed in to change notification settings - Fork 5
Configuring Windows branding
Configure OEM information and Registration. Set branding details such as manufacturer, model, support information, and logo displayed in System properties.
Important
This module requires installBehavior to be set to SYSTEM. All values are written to HKLM registry paths that are not accessible in USER context. If the configuration uses USER install behavior, the module logs an error and is skipped.
The windowsBranding module configures Windows device branding and OEM information by modifying registry values under HKLM. It writes values to two registry locations:
-
OEM Information - support provider name, support URL, trade-in URL, and recycling URL. These values are written to
HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\OEMInformationand appear in Settings > System > About under the OEM support section. -
Registration - registered owner and registered organization. These values are written to
HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersionand appear in legacy System properties (Win+Pause) and inwinver.
For each configured item, the module performs the following steps:
- Validates the property value is defined and not empty
- Applies the value to the corresponding registry location
Properties with an empty value are skipped and logged as a warning. This allows you to include only the properties you want to configure without affecting the others.
The following shows the windowsBranding configuration structure with both OEM information and registration properties.
{
"windowsBranding": {
"enabled": true,
"OEMInformationItems": {
"SupportProvider": "Contoso IT",
"SupportURL": "https://support.contoso.com",
"TradeinURL": "",
"RecycleURL": ""
},
"registrationItems": {
"RegisteredOwner": "",
"RegisteredOrganization": "Contoso"
}
}
}The following properties are supported in the windowsBranding section.
| Property | Description | Type | Required |
|---|---|---|---|
| windowsBranding | |||
| enabled | Enable or disable the module | Boolean | No |
| OEMInformationItems | |||
| SupportProvider | Support provider name displayed in Settings > System > About | String | No |
| SupportURL | URL for support information - opens when the user clicks the support link in About | String | No |
| TradeinURL | URL for trade-in information | String | No |
| RecycleURL | URL for recycling information | String | No |
| registrationItems | |||
| RegisteredOwner | Registered owner name displayed in winver and legacy System properties |
String | No |
| RegisteredOrganization | Registered organization name displayed in winver and legacy System properties |
String | No |
The commands below can be used to inspect or verify the registry values configured by this module.
Read the current OEM information from the registry.
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\OEMInformation" | Select-Object "SupportProvider", "SupportURL", "TradeinURL", "RecycleURL"Read the current registration values from the registry.
Get-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion" | Select-Object "RegisteredOwner", "RegisteredOrganization"The registered owner and organization values can also be verified visually by running winver from the Start menu or Run dialog.
winverFor more information, see the following resources.
- OEMInformation - Windows Hardware - Unattend reference for OEM information settings
Page revised: March 4, 2026
🦎 Windows gecko - Desired state configuration for Windows devices · Repository · License
Windows gecko wiki
Getting Started
Feature Modules
- Configuring Windows Apps
- Configuring Windows branding
- Configuring Windows Config
- Configuring Windows Features
- Configuring Windows Files
- Configuring Windows Groups
- Configuring Windows Registry
- Configuring Windows Run
- Configuring Windows Scheduled Tasks
- Configuring Windows Services
- Configuring Windows TCR
Contributing