Skip to main content
AtlasOS includes several standalone utility scripts for system configuration and management. These scripts are located in AtlasModules/Scripts/.

RunAsTI.cmd

Purpose: Elevates scripts to TrustedInstaller/SYSTEM privileges Location: Scripts/RunAsTI.cmd

Features

  • Innovative HKCU load without reg load/unload
  • Sets ownership privileges, high priority, and Explorer support
  • Falls back to SYSTEM if TrustedInstaller unavailable
  • Accepts special characters in paths
  • Handles UAC prompts with error detection

Usage

Interactive Mode:
Prompts for program path. Direct Execution:
In Scripts:

Error Codes

  • 0 - Success
  • 1 - Elevation failed (unknown error)
  • 2 - UAC prompt declined

fileAssoc.cmd

Purpose: Configures file associations for web browsers and 7-Zip Location: Scripts/fileAssoc.cmd

Features

  • Sets default web browser associations
  • Configures 7-Zip file associations if installed
  • Bypasses User Choice Protection Driver (UCPD)
  • Applies settings to all user profiles

Usage

Supported Browsers:
  • Microsoft Edge (default if no argument)
  • Brave
  • LibreWolf
  • Firefox
  • Google Chrome
Examples:

File Associations

Base Associations:
  • .url → InternetShortcut
Browser Associations:
  • HTTP/HTTPS protocols
  • .htm, .html, .shtml files
  • .pdf files
7-Zip Associations (if installed):
  • Archives: .7z, .zip, .rar, .tar, .gz, .bz2, .xz
  • Disk images: .iso, .wim, .vhd, .vhdx
  • Package formats: .cab, .deb, .rpm
  • And many more…

Implementation Details

Creates a temporary PowerShell executable with random name to bypass UCPD:

taskbarPins.ps1

Purpose: Configures Windows taskbar pinned applications Location: Scripts/taskbarPins.ps1

Features

  • Sets browser and File Explorer as taskbar pins
  • Supports multiple browsers
  • Configures for all user profiles
  • Applies changes immediately (restarts Explorer)

Usage

Supported Browsers:
  • Brave
  • Firefox
  • LibreWolf
  • Google Chrome
  • Microsoft Edge (default)
Examples:

Default Pins

  1. Browser (Edge if installed, otherwise File Explorer)
  2. File Explorer

Registry Data

The script uses pre-encoded registry binary data for:
  • Favorites - Pin locations and order
  • FavoritesResolve - Pin resolution data

packageInstall.ps1

Purpose: Installs Windows CBS (Component-Based Servicing) packages Location: Scripts/packageInstall.ps1

Features

  • Installs/uninstalls Windows packages online
  • Validates package signatures
  • Creates repair source for SFC/DISM
  • Supports Safe Mode fallback
  • Automated restart handling

Usage

Install Packages:
Uninstall Packages:
Combined:
Options:

Requirements

  • Must run as TrustedInstaller/SYSTEM
  • Packages must be signed with Windows test certificate
  • CAB files must match system architecture (amd64/arm64)

Examples

Interactive Installation:
Automated Installation:
Safe Mode Fallback:

Repair Source

Automatically creates repair source at:
Configures registry:
This fixes RestoreHealth/SFC “Sources” errors.

newUsers.ps1

Purpose: Configures settings for new user accounts Location: Scripts/newUsers.ps1

Features

  • Configures Windows 11 context menu
  • Sets File Explorer options
  • Applies Atlas theme
  • Sets lockscreen wallpaper
  • Configures visual effects
  • Sets taskbar pins
  • Logs out user automatically

Usage

Note: Typically called automatically during user account creation.

Configured Settings

  • Old context menu (Windows 11)
  • Disabled Gallery in File Explorer
  • Atlas dark theme (Windows 11)
  • Custom lockscreen wallpaper
  • Disabled Network in navigation pane
  • Disabled automatic folder discovery
  • Atlas visual effects profile
  • Browser-specific taskbar pins

installToolbox.ps1

Purpose: Downloads and installs Atlas Toolbox Location: Scripts/installToolbox.ps1

Features

  • Checks for existing installation
  • Downloads latest release from GitHub
  • Silent installation with desktop icon

Usage

Installation Path: C:\Program Files\Atlas Toolbox Source: https://github.com/Atlas-OS/atlas-toolbox/releases/latest

Other Utility Scripts

edgeCheck.cmd

Purpose: Checks if Microsoft Edge is installed

indexConf.cmd

Purpose: Configures Windows Search indexing

newUsers.cmd

Purpose: Batch wrapper for newUsers.ps1

serviceWarning.cmd

Purpose: Displays warning about service modifications

setSvc.cmd

Purpose: Configures Windows service startup types

settingsPages.cmd

Purpose: Shows/hides Windows Settings pages Usage:

toggleDev.cmd

Purpose: Toggles developer mode

wingetCheck.cmd

Purpose: Checks if Windows Package Manager (winget) is installed

Script Wrappers

Location: Scripts/ScriptWrappers/ These scripts provide convenient wrappers for common operations:
  • ConfigVBS.ps1 - Configure Virtualization Based Security
  • DebloatSendToContextMenu.ps1 - Remove Send To context menu items
  • DefaultPowerSaving.ps1 - Set default power-saving profile
  • DisableFileSharing.ps1 - Disable file sharing
  • DisablePowerSaving.ps1 - Disable power-saving features
  • EnableFileSharing.ps1 - Enable file sharing
  • InstallSoftware.ps1 - Install software packages
  • RemoveEdge.ps1 - Remove Microsoft Edge
  • TelemetryComponents.ps1 - Configure telemetry components
  • ToggleDefender.ps1 - Toggle Windows Defender
  • UpdateDrivers.ps1 - Update system drivers

Common Usage Patterns

Running with Elevation

Silent Execution

Error Handling

Checking Prerequisites

See Also