Skip to content

Commit f5a4d40

Browse files
aaronparkeraaronparker
committed
Update code formating, text, page rendering
1 parent de0d083 commit f5a4d40

File tree

7 files changed

+126
-87
lines changed

7 files changed

+126
-87
lines changed

‎.vitepress/config.mts‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -13,6 +13,13 @@ export default defineConfig({
1313
},
1414
cleanUrls: true,
1515
// ignoreDeadLinks: true,
16+
markdown: {
17+
image: {
18+
// image lazy loading is disabled by default
19+
lazyLoading: true
20+
},
21+
toc: { level: [1, 2, 3] },
22+
},
1623

1724
themeConfig: {
1825
// https://vitepress.dev/reference/default-theme-config

‎docs/about.md‎

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,10 @@ To see the improved end-user experience, check out the [Results](https://stealth
1717

1818
Supporting Windows 10, Windows 11, and Windows Server 2016–2025, this tool works for both physical PCs and virtual machines (e.g., Azure Virtual Desktop, Windows 365). While primarily aimed at provisioning gold images for PCs or virtual desktops, it can also be applied to Windows Server infrastructure roles.
1919

20+
::: info
21+
Windows PowerShell only is supported - typically during operating system deployments, there should be no strict requirement for PowerShell 6 or above. While the solution will work OK on PowerShell 6+, no testing is done on those versions.
22+
:::
23+
2024
Windows Enterprise Defaults has been tested on Windows 10 (1809 and above), Windows 11, Windows Server 2016-2025. All scripts should work on any future versions of Windows; however, you should test thoroughly before deployment in production.
2125

2226
## Usage
@@ -28,9 +32,3 @@ The solution is intended for operating system deployment via various methods, in
2832
* Executed in a virtual machine image pipeline using [Azure Image Builder](https://docs.microsoft.com/en-us/azure/virtual-machines/image-builder-overview) or [Packer](https://www.packer.io/) when building a gold image
2933
* Imported into the Microsoft Deployment Toolkit as an application for use during Lite Touch deployments - [Create a New Application in the Deployment Workbench](https://docs.microsoft.com/en-us/mem/configmgr/mdt/use-the-mdt#CreateaNewApplicationintheDeploymentWorkbench)
3034
* Or even run manually on a Windows PC or virtual machine gold image if you're not using automation at all
31-
32-
## Supported PowerShell
33-
34-
::: info
35-
Windows PowerShell only is supported - typically during operating system deployments, there should be no strict requirement for PowerShell 6 or above. While the solution will work OK on PowerShell 6+, no testing is done on those versions.
36-
:::

‎docs/custom.md‎

Lines changed: 50 additions & 50 deletions
Original file line numberDiff line numberDiff line change
@@ -133,60 +133,60 @@ Importing a default Start menu is implemented with the following JSON; however,
133133

134134
For Windows 10 or Windows 11, the Start menu layout to import, is specified with the `Windows10` or `Windows11` property; while for Windows Server, the Start menu layout is specified by the presence or not of a specified Windows feature - in the example below a specific layout is imported is the Remote Desktop Session Host role is installed.
135135

136-
=== "Client"
136+
::: code-group
137137

138-
```json
139-
{
140-
"MinimumBuild": "10.0.14393",
141-
"StartMenu": {
142-
"Type": "Client",
143-
"Feature": "",
144-
"Windows10": [
145-
{
146-
"Source": "Windows10StartMenuLayout.xml",
147-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
148-
}
149-
],
150-
"Windows11": [
151-
{
152-
"Source": "Windows11StartMenuLayout.json",
153-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.json"
154-
},
155-
{
156-
"Source": "Windows11TaskbarLayout.xml",
157-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
158-
},
159-
{
160-
"Source": "Windows11Start.bin",
161-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Packages\\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\\LocalState\\start2.bin"
162-
}
163-
]
164-
}
138+
```json [User.Client.json]
139+
{
140+
"MinimumBuild": "10.0.14393",
141+
"StartMenu": {
142+
"Type": "Client",
143+
"Feature": "",
144+
"Windows10": [
145+
{
146+
"Source": "Windows10StartMenuLayout.xml",
147+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
148+
}
149+
],
150+
"Windows11": [
151+
{
152+
"Source": "Windows11StartMenuLayout.json",
153+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.json"
154+
},
155+
{
156+
"Source": "Windows11TaskbarLayout.xml",
157+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
158+
},
159+
{
160+
"Source": "Windows11Start.bin",
161+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Packages\\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\\LocalState\\start2.bin"
162+
}
163+
]
165164
}
166-
```
167-
168-
=== "Server"
165+
}
166+
```
169167

170-
```json
171-
{
172-
"StartMenu": {
173-
"Type": "Server",
174-
"Feature": "RDS-RD-Server",
175-
"Exists": [
176-
{
177-
"Source": "WindowsRDSStartMenuLayout.xml",
178-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
179-
}
180-
],
181-
"NotExists": [
182-
{
183-
"Source": "WindowsServerStartMenuLayout.xml",
184-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
185-
}
186-
]
187-
}
168+
```json [User.Server.json]
169+
{
170+
"StartMenu": {
171+
"Type": "Server",
172+
"Feature": "RDS-RD-Server",
173+
"Exists": [
174+
{
175+
"Source": "WindowsRDSStartMenuLayout.xml",
176+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
177+
}
178+
],
179+
"NotExists": [
180+
{
181+
"Source": "WindowsServerStartMenuLayout.xml",
182+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
183+
}
184+
]
188185
}
189-
```
186+
}
187+
```
188+
189+
:::
190190

191191
### Windows 11 Start menu
192192

‎docs/feature.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,11 @@ When `Install-Defaults.ps1` runs, it copies the project files to `C:\WINDOWS\Sys
1111

1212
When a feature upgrade completes (e.g. Windows 11 23H2 to Windows 11 24H2), `success.cmd` is executed. This will re-run `Install-Defaults.ps1` and explicitly run `Remove-AppxApps.ps1` in [targeted mode](https://stealthpuppy.com/defaults/appxapps/#targeted-package-list). This removes a set of AppX applications that are often reinstalled during a feature update.
1313

14-
```batch
14+
::: code-group
15+
```batch [success.cmd]
1516
@ECHO OFF
1617
SET SOURCE=C:\WINDOWS\System32\update\run\f38de27b-799e-4c30-8a01-bfdedc622944
1718
%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy Bypass -NoLogo -NonInteractive -WindowStyle Hidden -File "%SOURCE%\Remove-AppxApps.ps1" -Targeted
1819
%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe -ExecutionPolicy Bypass -NoLogo -NonInteractive -WindowStyle Hidden -File "%SOURCE%\Install-Defaults.ps1" -Path "%SOURCE%"
1920
```
21+
:::

‎docs/machine.md‎

Lines changed: 12 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,8 @@ Machine specific settings are implemented to configure the local Windows OS with
1515

1616
Enables the Windows Search and Audio services if the Remote Desktop Session Host role is enabled. This uses a specification in the JSON that will enable a list of services, if a specified Windows feature is enabled:
1717

18-
```json
18+
::: code-group
19+
```json [Machine.Server.json]
1920
"Services": {
2021
"Feature": "RDS-RD-Server",
2122
"Enable": [
@@ -24,12 +25,14 @@ Enables the Windows Search and Audio services if the Remote Desktop Session Host
2425
]
2526
}
2627
```
28+
:::
2729

2830
## Windows 10 and Windows 11
2931

3032
* Disables the following features that are not used on most end-user desktops: `Printing-XPSServices-Features`, `SMB1Protocol`, `WorkFolders-Client`, `FaxServicesClientPackage`, `WindowsMediaPlayer`. A set of features to disable can be listed in the JSON as shown below.
3133

32-
```json
34+
::: code-group
35+
```json [Machine.All.json]
3336
"Features": {
3437
"Disable": [
3538
"Printing-XPSServices-Features",
@@ -40,14 +43,16 @@ Enables the Windows Search and Audio services if the Remote Desktop Session Host
4043
]
4144
}
4245
```
46+
:::
4347

4448
::: warning
4549
WindowsMediaPlayer is included by default with the expectation that you are deploying an alternative, modern media player, such as VLC Player. Removal of the Windows Media Player may affect some media playback features.
4650
:::
4751

4852
Removes the following capabilities that are not used on most enterprise end-user desktops: `App.Support.QuickAssist~~~~0.0.1.0`, `Media.WindowsMediaPlayer~~~~0.0.12.0`, `XPS.Viewer~~~~0.0.1.0`. Capabilities to remove can be listed in the JSON as below:
4953

50-
```json
54+
::: code-group
55+
```json [Machine.All.json]
5156
"Capabilities": {
5257
"Remove": [
5358
"App.Support.QuickAssist~~~~0.0.1.0",
@@ -56,14 +61,16 @@ Removes the following capabilities that are not used on most enterprise end-user
5661
]
5762
}
5863
```
64+
:::
5965

6066
## Windows 10 19041 and above
6167

6268
Windows 10 2004 (10.0.19041) and above will include the following configuration changes:
6369

6470
Removes the following capabilities that are not used on most end-user desktops: `Microsoft.Windows.PowerShell.ISE~~~~0.0.1.0`, `Microsoft.Windows.WordPad~~~~0.0.1.0`, `Print.Fax.Scan~~~~0.0.1.0`, `Print.Management.Console~~~~0.0.1.0`. Capabilities to remove from a specific Windows build, or higher, can be listed in the JSON as below:
6571

66-
```json
72+
::: code-group
73+
```json [Build.All.json]
6774
{
6875
"MinimumBuild": "10.0.19041",
6976
"Capabilities": {
@@ -75,3 +82,4 @@ Removes the following capabilities that are not used on most end-user desktops:
7582
}
7683
}
7784
```
85+
:::

‎docs/profile.md‎

Lines changed: 47 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ layout: doc
55

66
Customising the default user profile is an important step in configuring the default environment that will user see at first sign-in.
77

8-
Configuring the default profile allows the administrator to reduce noise for the end-user while still allowing them to customise their environment afterwards. This is a better approach that enforcing settings via Group Policy and this will also work for Azure AD joined scenarios.
8+
Configuring the default profile allows the administrator to reduce noise for the end-user while still allowing them to customise their environment afterwards. This is a better approach that enforcing settings via Group Policy, and will work for Entra joined scenarios.
99

1010
The approach used by these scripts is to make changes directly to the default user profile found at `C:\Users\Default`. When users sign into Windows for the first time, their profile starts as a copy of the default profile, thus it will pick up the customisations.
1111

@@ -25,29 +25,54 @@ Imports a Start menu and taskbar layout (`Windows10StartMenuLayout.xml` or `Wind
2525

2626
These settings are imported into the default profile via direct file copies. The source file and destination are defined in the JSON sources as in the examples below. Here Windows 10 and Windows 11 default Start menu and taskbar layouts are defined in the included files and are copied to the specified destination.
2727

28-
```json
29-
"Windows10": [
30-
{
31-
"Source": "Windows10StartMenuLayout.xml",
32-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
33-
}
34-
],
35-
"Windows11": [
36-
{
37-
"Source": "Windows11StartMenuLayout.json",
38-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.json"
39-
},
40-
{
41-
"Source": "Windows11TaskbarLayout.xml",
42-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
43-
},
44-
{
45-
"Source": "Windows11Start.bin",
46-
"Destination": "C:\\Users\\Default\\AppData\\Local\\Packages\\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\\LocalState\\start.bin"
47-
}
48-
]
28+
::: code-group
29+
```json [User.Client.json]
30+
"StartMenu": {
31+
"Type": "Client",
32+
"Feature": "",
33+
"Windows10": [
34+
{
35+
"Source": "start\\Windows10StartMenuLayout.xml",
36+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
37+
}
38+
],
39+
"Windows11": [
40+
{
41+
"Source": "start\\Windows11StartMenuLayout.json",
42+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.json"
43+
},
44+
{
45+
"Source": "start\\Windows11TaskbarLayout.xml",
46+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
47+
},
48+
{
49+
"Source": "start\\Windows11Start.bin",
50+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Packages\\Microsoft.Windows.StartMenuExperienceHost_cw5n1h2txyewy\\LocalState\\start2.bin"
51+
}
52+
]
53+
}
4954
```
5055

56+
```json [User.Server.json]
57+
"StartMenu": {
58+
"Type": "Server",
59+
"Feature": "RDS-RD-Server",
60+
"Exists": [
61+
{
62+
"Source": "start\\WindowsRDSStartMenuLayout.xml",
63+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
64+
}
65+
],
66+
"NotExists": [
67+
{
68+
"Source": "start\\WindowsServerStartMenuLayout.xml",
69+
"Destination": "C:\\Users\\Default\\AppData\\Local\\Microsoft\\Windows\\Shell\\LayoutModification.xml"
70+
}
71+
]
72+
}
73+
```
74+
:::
75+
5176
## Virtual Machines
5277

5378
Imports registry settings in the default profile to support Windows running in a virtual machine, typically VDI scenarios. This includes disabling transparency effects, windows animations, and disabling background applications.

‎docs/registry.md‎

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
---
1+
---
22
layout: doc
33
---
44
# Registry Settings
@@ -47,7 +47,6 @@ layout: doc
4747
| HKLM: \Software \Policies \Microsoft \Windows \CloudContent | DisableWindowsConsumerFeatures | 1 | Disables the Microsoft Windows consumer features |
4848
| HKLM: \Software \Policies \Microsoft \Windows \CloudContent | DisableCloudOptimizedContent | 1 | Disables the customisation of the taskbar with additional shortcuts (e.g. new Outlook) |
4949

50-
5150
**Computer level settings for Windows client editions.**
5251

5352
| Minimum build | Maximum build | Type |
@@ -168,8 +167,8 @@ layout: doc
168167
| ---- | ---- | ----- | ---- |
169168
| HKCU: \Software \Microsoft \Windows \CurrentVersion \Explorer \Wallpapers | BackgroundType | 0 | Sets the desktop background type to a picture |
170169
| HKCU: \Software \Microsoft \Windows \CurrentVersion \DesktopSpotlight \Settings | EnabledState | 0 | Disables Windows spotlight |
171-
| HKCU: \Console \%%Startup | DelegationConsole | {2EACA947-7F5F-4CFA-BA87-8F7FBEEFBE69} | Sets Windows Terminal as the default terminal |
172-
| HKCU: \Console \%%Startup | DelegationTerminal | {E12CFF52-A866-4C77-9A90-F570A7AA2C6B} | Sets Windows Terminal as the default terminal |
170+
| HKCU: \Console \%%Startup | DelegationConsole | 2EACA947-7F5F-4CFA-BA87-8F7FBEEFBE69 | Sets Windows Terminal as the default terminal |
171+
| HKCU: \Console \%%Startup | DelegationTerminal | E12CFF52-A866-4C77-9A90-F570A7AA2C6B | Sets Windows Terminal as the default terminal |
173172

174173
## User.Server.json
175174

0 commit comments

Comments
 (0)