Desired State Configuration

Article
04/09/2024

Since version 0.80, the PowerToys installer has been released on GitHub with Microsoft.PowerToys.Configure DSC resource that allows you to configure PowerToys using a Winget configuration file.

Installation

Prerequisites

PSDesiredStateConfiguration 2.0.7 or later: Refer to the PowerShell DSC documentation for installation instructions.
PowerShell 7.2 or higher.
WinGet version v1.6.2631 or later.

Download

Microsoft.PowerToys.Configure is installed with PowerToys. Depending on the installer type, it's installed as follows:

For the per-user install scope, the module is located in %USERPROFILE%\Documents\PowerShell\Modules\Microsoft.PowerToys.Configure.
For the machine-wide install scope, it's found in %ProgramFiles%\WindowsPowerShell\Modules\Microsoft.PowerToys.Configure.

Usage

You can invoke the resource directly using the following Powershell syntax:

Invoke-DscResource -Name PowerToysConfigure -Method Set -ModuleName Microsoft.PowerToys.Configure -Property @{ Awake = @{ Enabled = $false; Mode = "TIMED"; IntervalMinutes = "10" } }

However, creating a configuration.dsc.yaml file that contains the required settings in a simpler format is more convenient. Here's an example:

properties:
  resources:
    - resource: Microsoft.WinGet.DSC/WinGetPackage
      id: installPowerToys
      directives:
        description: Install PowerToys
        allowPrerelease: true
      settings:
        id: Microsoft.PowerToys
        source: winget

    - resource: Microsoft.PowerToys.Configure/PowerToysConfigure
      dependsOn:
        - installPowerToys
      directives:
        description: Configure PowerToys
      settings:
        ShortcutGuide:
          Enabled: false
          OverlayOpacity: 50
        FancyZones:
          Enabled: true
          FancyzonesEditorHotkey: "Shift+Ctrl+Alt+F"
        FileLocksmith:
          Enabled: false
  configurationVersion: 0.2.0

Use the following command to apply the configuration from the file:

winget configure .\configuration.dsc.yaml

This command installs the latest version of PowerToys and uses the PowerToysConfigure resource to apply settings for multiple PowerToys modules. More examples can be found in the PowerToys repo.

Available Configuration Settings by Module

AlwaysOnTop

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
Hotkey	KeyboardKeys	Customize the shortcut to pin or unpin an app window.	✅
FrameEnabled	Boolean	Show a border around the pinned window.	✅
FrameThickness	Int	Border thickness in pixels.	✅
FrameColor	String	Specify a color in a `#FFFFFFFF` format.	✅
FrameOpacity	Int	Border opacity in percentage.	✅
FrameAccentColor	Boolean	Use a custom FrameColor value.	✅
SoundEnabled	Boolean	Play a sound when pinning a window.	✅
DoNotActivateOnGameMode	Boolean	Disable activation shortcut when Game Mode is on.	✅
ExcludedApps	String	'\r'-separated list of executable names to exclude from pinning on top.	✅
RoundCornersEnabled	Boolean	Enable round corners.	✅

Awake

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
KeepDisplayOn	Boolean	This setting is only available when keeping the PC awake.	✅
Mode	AwakeMode	Possible values: PASSIVE, INDEFINITE, TIMED, EXPIRABLE.	✅
IntervalHours	UInt32	When using TIMED mode, specifies the number of hours.	✅
IntervalMinutes	UInt32	When using TIMED mode, specifies the number of minutes.	✅
ExpirationDateTime	DateTimeOffset	When using EXPIRABLE mode, specifies the date and time in a format parsable with `DateTimeOffset.TryParse`.	✅

ColorPicker

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to activate this module.	✅
CopiedColorRepresentation	String	The default color representation to be used. Example :"HEX".	✅
ActivationAction	ColorPickerActivationAction	Possible values: OpenEditor, OpenColorPickerAndThenEditor, OpenOnlyColorPicker.	✅
VisibleColorFormats	—	—	❌
ShowColorName	Boolean	This will show the name of the color when picking a color.	✅

Note

Configuring custom color formats through DSC is not yet supported.

CropAndLock

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ReparentHotkey	KeyboardKeys	Shortcut to crop an application's window into a cropped window.	✅
ThumbnailHotkey	KeyboardKeys	Shortcut to crop and create a thumbnail of another window.	✅

EnvironmentVariables

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
LaunchAdministrator	Boolean	Needs to be launched as administrator in order to make changes to the system environment variables.	✅

FancyZones

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
FancyzonesShiftDrag	Boolean	Hold Shift key to activate zones while dragging a window.	✅
FancyzonesMouseSwitch	Boolean	Use a non-primary mouse button to toggle zone activation.	✅
FancyzonesMouseMiddleClickSpanningMultipleZones	Boolean	Use middle-click mouse button to toggle multiple zones spanning.	✅
FancyzonesOverrideSnapHotkeys	Boolean	This overrides the Windows Snap shortcut (Win + arrow) to move windows between zones.	✅
FancyzonesMoveWindowsAcrossMonitors	Boolean	Move windows between zones across all monitors.	✅
FancyzonesMoveWindowsBasedOnPosition	Boolean	Move windows based on relative position or zone index.	✅
FancyzonesOverlappingZonesAlgorithm	Int	When multiple zones overlap algorithm index.	✅
FancyzonesDisplayOrWorkAreaChangeMoveWindows	Boolean	Keep windows in their zones when the screen resolution or work area changes.	✅
FancyzonesZoneSetChangeMoveWindows	Boolean	During zone layout changes, windows assigned to a zone will match new size/positions.	✅
FancyzonesAppLastZoneMoveWindows	Boolean	Move newly created windows to their last known zone.	✅
FancyzonesOpenWindowOnActiveMonitor	Boolean	Move newly created windows to the current active monitor (Experimental).	✅
FancyzonesRestoreSize	Boolean	Restore the original size of windows when unsnapping.	✅
FancyzonesQuickLayoutSwitch	Boolean	Enable quick layout switch.	✅
FancyzonesFlashZonesOnQuickSwitch	Boolean	Flash zones when switching layout.	✅
UseCursorposEditorStartupscreen	Boolean	Open editor on the display where the mouse point is.	✅
FancyzonesShowOnAllMonitors	Boolean	Show zones on all monitors while dragging a window.	✅
FancyzonesSpanZonesAcrossMonitors	Boolean	Allow zones to span across monitors.	✅
FancyzonesMakeDraggedWindowTransparent	Boolean	Make dragged window transparent.	✅
FancyzonesAllowChildWindowSnap	Boolean	Allow child windows snapping.	✅
FancyzonesDisableRoundCornersOnSnap	Boolean	Disable round corners when window is snapped.	✅
FancyzonesZoneHighlightColor	String	If not using FancyzonesSystemTheme, highlight color to use in `#FFFFFFFF` format.	✅
FancyzonesHighlightOpacity	Int	Zone opacity in percentage.	✅
FancyzonesEditorHotkey	KeyboardKeys	Customize the shortcut to activate this module.	✅
FancyzonesWindowSwitching	Boolean	Switch between windows in the current zone.	✅
FancyzonesNextTabHotkey	KeyboardKeys	Next window shortcut.	✅
FancyzonesPrevTabHotkey	KeyboardKeys	Previous window shortcut.	✅
FancyzonesExcludedApps	String	'\r'-separated list of executable names to exclude from snapping.	✅
FancyzonesBorderColor	String	If not using FancyzonesSystemTheme, border color to use in `#FFFFFFFF` format.	✅
FancyzonesInActiveColor	String	If not using FancyzonesSystemTheme, inactive color to use in `#FFFFFFFF` format.	✅
FancyzonesNumberColor	String	If not using FancyzonesSystemTheme, number color to use in `#FFFFFFFF` format.	✅
FancyzonesSystemTheme	Boolean	Use system theme for zone appearance.	✅
FancyzonesShowZoneNumber	Boolean	Show zone number.	✅

Note

Configuring layouts through DSC is not yet supported.

FileLocksmith

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ExtendedContextMenuOnly	Boolean	Show File Locksmith in extended context menu only or in default context menu as well.	✅

FindMyMouse

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationMethod	Int	Activation method index.	✅
ActivationShortcut	HotkeySettings	Custom activation shortcut when using Custom for ActivationMethod.	✅
DoNotActivateOnGameMode	Boolean	Disable activation shortcut when Game Mode is on.	✅
BackgroundColor	String	Background color in `#FFFFFFFF` format.	✅
SpotlightColor	String	Spotlight color in `#FFFFFFFF` format.	✅
OverlayOpacity	Int	Overlay opacity in percentage.	✅
SpotlightRadius	Int	Spotlight radius in px.	✅
AnimationDurationMs	Int	Animation duration in milliseconds.	✅
SpotlightInitialZoom	Int	Spotlight zoom factor at animation start.	✅
ExcludedApps	String	'\r'-separated list of executable names to prevent module activation.	✅
ShakingMinimumDistance	Int	When using shake mouse ActivationMethod, the minimum distance for mouse shaking activation, for adjusting sensitivity.	✅
ShakingIntervalMs	Int	When using shake mouse ActivationMethod, the span of time during which we track mouse movement to detect shaking, for adjusting sensitivity.	✅
ShakingFactor	Int	When using shake mouse ActivationMethod, Shake factor in percentage.	✅

Hosts

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
LaunchAdministrator	Boolean	Needs to be opened as administrator in order to make changes to the system environment variables.	✅
ShowStartupWarning	Boolean	Show a warning at startup.	✅
LoopbackDuplicates	Boolean	Consider loopback addresses as duplicates.	✅
AdditionalLinesPosition	HostsAdditionalLinesPosition	Possible values: Top, Bottom.	✅
Encoding	HostsEncoding	Possible values: Utf8, Utf8Bom.	✅

ImageResizer

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ImageresizerSelectedSizeIndex	Int	Default size preset index.	✅
ImageresizerShrinkOnly	Boolean	Make pictures smaller but not larger.	✅
ImageresizerReplace	Boolean	Overwrite files.	✅
ImageresizerIgnoreOrientation	Boolean	Ignore the orientation of pictures.	✅
ImageresizerJpegQualityLevel	Int	JPEG quality level in percentage.	✅
ImageresizerPngInterlaceOption	Int	PNG interlacing option index.	✅
ImageresizerTiffCompressOption	Int	Tiff compression index.	✅
ImageresizerFileName	String	This format is used as the filename for resized images.	✅
ImageresizerSizes	—	—	❌
ImageresizerKeepDateModified	Boolean	Remove metadata that doesn't affect rendering.	✅
ImageresizerFallbackEncoder	String	Fallback encoder to use.	✅
ImageresizerCustomSize	—	—	❌

Note

Configuring custom sizes through DSC is not yet supported.

KeyboardManager

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActiveConfiguration	—	—	❌
KeyboardConfigurations	—	—	❌

Note

Configuring remappings through DSC is not yet supported.

MeasureTool

Measure Tool is the internal name for Screen Ruler.

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to bring up the command bar.	✅
ContinuousCapture	Boolean	Capture screen continuously during measuring.	✅
DrawFeetOnCross	Boolean	Adds feet to the end of cross lines.	✅
PerColorChannelEdgeDetection	Boolean	Enable a different edge detection algorithm.	✅
PixelTolerance	Int	Pixel Tolerance for edge detection.	✅
MeasureCrossColor	String	Line color in `#FFFFFFFF` format.	✅
DefaultMeasureStyle	Int	Default measure style index.	✅

MouseHighlighter

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to turn on or off this mode.	✅
LeftButtonClickColor	String	Primary button highlight color in `#FFFFFFFF` format.	✅
RightButtonClickColor	String	Secondary button highlight color in `#FFFFFFFF` format.	✅
AlwaysColor	String	Always highlight color in `#FFFFFFFF` format.	✅
HighlightRadius	Int	Highlight radius in pixels.	✅
HighlightFadeDelayMs	Int	Fade delay in milliseconds.	✅
HighlightFadeDurationMs	Int	Fade duration in milliseconds.	✅
AutoActivate	Boolean	Automatically activate on utility startup.	✅

MouseJump

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to turn on or off this mode.	✅
ThumbnailSize	MouseJumpThumbnailSize	Thumbnail size.	✅

MousePointerCrosshairs

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to show/hide the crosshairs.	✅
CrosshairsColor	String	Crosshairs color in `#FFFFFFFF`.	✅
CrosshairsOpacity	Int	Crosshairs opacity in percentage.	✅
CrosshairsRadius	Int	Crosshairs center radius in pixels.	✅
CrosshairsThickness	Int	Crosshairs thickness in pixels.	✅
CrosshairsBorderColor	String	Crosshairs border color in `#FFFFFFFF` format.	✅
CrosshairsBorderSize	Int	Crosshairs border size in pixels.	✅
CrosshairsAutoHide	Boolean	Automatically hide crosshairs when the mouse pointer is hidden.	✅
CrosshairsIsFixedLengthEnabled	Boolean	Fix crosshairs length.	✅
CrosshairsFixedLength	Int	Crosshairs fixed length in pixels.	✅
AutoActivate	Boolean	Automatically activate on utility startup.	✅

MouseWithoutBorders

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ShowOriginalUI	Boolean	Show the original Mouse Without Borders UI.	✅
WrapMouse	Boolean	Move control back to the first machine when mouse moves past the last one.	✅
ShareClipboard	Boolean	If share clipboard stops working, Ctrl+Alt+Del then Esc may solve the problem.	✅
TransferFile	Boolean	If a file (<100MB) is copied, it will be transferred to the remote machine clipboard.	✅
HideMouseAtScreenEdge	Boolean	Hide mouse at the screen edge.	✅
DrawMouseCursor	Boolean	Mouse cursor may not be visible in Windows 10 and later versions of Windows when there is no physical mouse attached.	✅
ValidateRemoteMachineIP	Boolean	Reverse DNS lookup to validate machine IP Address.	✅
SameSubnetOnly	Boolean	Only connect to machines in the same intranet NNN.NNN.. (only works when both machines have IPv4 enabled).	✅
BlockScreenSaverOnOtherMachines	Boolean	Block screen saver on other machines.	✅
MoveMouseRelatively	Boolean	Use this option when remote machine's monitor settings are different, or remote machine has multiple monitors.	✅
BlockMouseAtScreenCorners	Boolean	Block mouse at screen corners to avoid accident machine-switch at screen corners.	✅
ShowClipboardAndNetworkStatusMessages	Boolean	Show clipboard and network status messages.	✅
EasyMouse	Int	Easy Mouse mode index.	✅
HotKeySwitchMachine	Int	Shortcut to switch between machines index.	✅
ToggleEasyMouseShortcut	HotkeySettings	Shortcut to toggle Easy Mouse.	✅
LockMachineShortcut	HotkeySettings	Shortcut to lock all machines.	✅
ReconnectShortcut	HotkeySettings	Shortcut to try reconnecting.	✅
Switch2AllPCShortcut	HotkeySettings	Shortcut to switch to multiple machine mode.	✅
Name2IP	String	IP address mapping.	✅

PastePlain

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to activate this module.	✅

Peek

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to activate this module.	✅
AlwaysRunNotElevated	Boolean	Always run not elevated, even when PowerToys is elevated.	✅
CloseAfterLosingFocus	Boolean	Automatically close the Peek window after it loses focus.	✅

PowerAccent

PowerAccent is the internal name for Quick Accent.

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationKey	PowerAccentActivationKey	Possible values: LeftRightArrow, Space, Both.	✅
DoNotActivateOnGameMode	Boolean	Disable activation shortcut when Game Mode is on.	✅
ToolbarPosition	String	Toolbar position index.	✅
InputTime	Int	Input time delay in milliseconds.	✅
SelectedLang	String	A character set to use.	✅
ExcludedApps	String	'\r'-separated list of executable names to prevent module activation if they're in a foreground.	✅
ShowUnicodeDescription	Boolean	Show the Unicode code and name of the currently selected character.	✅
SortByUsageFrequency	Boolean	Sort characters by usage frequency.	✅
StartSelectionFromTheLeft	Boolean	Start selection from the left.	✅

PowerLauncher

PowerLaucher is the internal name for PowerToys Run.

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
OpenPowerLauncher	HotkeySettings	Customize the shortcut to activate the module.	✅
IgnoreHotkeysInFullscreen	Boolean	Ignore shortcuts in fullscreen mode.	✅
ClearInputOnLaunch	Boolean	Clear the previous query on open.	✅
TabSelectsContextButtons	Boolean	Tab through context buttons.	✅
Theme	Theme	Possible values: System, Light, Dark, HighContrastOne, HighContrastTwo, HighContrastBlack, HighContrastWhite.	✅
TitleFontSize	Int32	Text size in points.	✅
Position	StartupPosition	Possible values: Cursor, PrimaryMonitor, Focus.	✅
UseCentralizedKeyboardHook	Boolean	Use centralized keyboard hook.	✅
SearchQueryResultsWithDelay	Boolean	Input Smoothing.	✅
SearchInputDelay	Int32	Immediate plugins delay in milliseconds.	✅
SearchInputDelayFast	Int32	Background execution plugins delay in milliseconds.	✅
SearchClickedItemWeight	Int32	Selected item weight.	✅
SearchQueryTuningEnabled	Boolean	Results order tuning.	✅
SearchWaitForSlowResults	Boolean	Wait for slower plugin results before selecting top item in results.	✅
MaximumNumberOfResults	Int	Number of results shown before having to scroll.	✅
UsePinyin	Boolean	Use Pinyin.	✅
GenerateThumbnailsFromFiles	Boolean	Thumbnail generation for files is turned on.	✅
Plugins	explained in the next subsection	Thumbnail generation for files is turned on.	✅

PowerToys Run plugins

PowerToys Run plugins can be configured in the Plugins property. A sample can be found in the PowerToys repository.

These are the available properties to configure each plugin:

Name	Type	Description
Name	String	Name of the plugin we want to configure
Disabled	Boolean	The plugin should be disabled
IsGlobal	Boolean	The results for this plugin are shown in the global results
ActionKeyword	String	Configure the action keyword of the plugin
WeightBoost	Int	The weight modifier to help in ordering the results for this plugin

Note

Configuring additional properties of plugins through DSC is not yet supported.

PowerOcr

PowerOcr is the internal name for Text Extractor.

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
ActivationShortcut	HotkeySettings	Customize the shortcut to activate this module.	✅
PreferredLanguage	String	Should match the full name of one of the languages installed in the system. Example: "English (United States)".	✅

PowerPreview

Name	Type	Description	Available
EnableSvgPreview	Boolean	Scalable Vector Graphics Preview Handler Enabled state.	✅
SvgBackgroundColorMode	Int	Color mode index.	✅
SvgBackgroundSolidColor	String	When using Solid color SvgBackgroundColorMode, specifies the color in `#FFFFFFFF` format.	✅
SvgBackgroundCheckeredShade	Int	When using Checkered pattern SvgBackgroundColorMode, specifies the shade index.	✅
EnableSvgThumbnail	Boolean	Scalable Vector Graphics Thumbnail Generator Enabled state.	✅
EnableMdPreview	Boolean	Markdown Preview Handler Enabled state.	✅
EnableMonacoPreview	Boolean	Source code files Preview Handler Enabled state.	✅
EnableMonacoPreviewWordWrap	Boolean	Wrap text.	✅
MonacoPreviewTryFormat	Boolean	Try to format the source for preview.	✅
MonacoPreviewMaxFileSize	Int	Maximum file size to preview in KB.	✅
EnablePdfPreview	Boolean	Portable Document Format Preview Handler Enabled state.	✅
EnablePdfThumbnail	Boolean	Portable Document Format Thumbnail Generator Enabled state.	✅
EnableGcodePreview	Boolean	Geometric Code Preview Handler Enabled state.	✅
EnableGcodeThumbnail	Boolean	Geometric Code Thumbnail Generator Enabled state.	✅
EnableStlThumbnail	Boolean	Stereolithography Thumbnail Generator Enabled state.	✅
StlThumbnailColor	String	Thumbnail color in `#FFFFFFFF` format .	✅
EnableQoiPreview	Boolean	Quite OK Image Preview Handler Enabled state.	✅
EnableQoiThumbnail	Boolean	Quite OK Image Thumbnail Generator Enabled state.	✅

PowerRename

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
MRUEnabled	Boolean	Enable auto-complete for the search & replace fields.	✅
MaxMRUSize	Int	Maximum number of recently used items to remember.	✅
ExtendedContextMenuOnly	Boolean	Show PowerRename in extended context menu only or in default context menu as well.	✅
UseBoostLib	Boolean	Use Boost Library.	✅

RegistryPreview

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
DefaultRegApp	Boolean	Make Registry Preview default app for opening .reg files.	✅

ShortcutGuide

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
OpenShortcutGuide	HotkeySettings	Customize the shortcut to activate this module.	✅
OverlayOpacity	Int	Background opacity in percentage.	✅
UseLegacyPressWinKeyBehavior	Boolean	If ShortcutGuide should be activated by pressing the Windows key.	✅
PressTimeForGlobalWindowsShortcuts	Int	Press duration before showing global Windows shortcuts in milliseconds.	✅
PressTimeForTaskbarIconShortcuts	Int	Press duration before showing taskbar icon shortcuts in milliseconds.	✅
Theme	String	Theme index.	✅
DisabledApps	String	Turns off Shortcut Guide when these applications have focus.	✅

VideoConference

Name	Type	Description	Available
Enabled	Boolean	The enabled state for this utility.	✅
MuteCameraAndMicrophoneHotkey	KeyboardKeys	Shortcut for muting the camera and microphone.	✅
MuteMicrophoneHotkey	KeyboardKeys	Shortcut for muting the microphone.	✅
PushToTalkMicrophoneHotkey	KeyboardKeys	Shortcut for push to talk.	✅
PushToReverseEnabled	Boolean	If enabled, allows both push to talk and push to mute, depending on microphone state.	✅
MuteCameraHotkey	KeyboardKeys	Shortcut for muting the camera.	✅
SelectedCamera	String	Device name.	✅
SelectedMicrophone	String	Device name or [All].	✅
ToolbarPosition	String	Toolbar position option: "Top center", "Bottom center", "Top right corner", "Top left corner", "Bottom right corner", "Bottom left corner".	✅
ToolbarMonitor	String	Toolbar monitor option: "Main monitor", "All monitors".	✅
CameraOverlayImagePath	String	Path to the image used for the camera overlay.	✅
ToolbarHide	String	When to hide the toolbar: "Never", "When both camera and microphone are unmuted", "When both camera and microphone are muted", "After timeout".	✅
StartupAction	String	Startup action: "Nothing", "Unmute", "Mute".	✅

GeneralSettings

Name	Type	Description	Available
Startup	Boolean	PowerToys is automatically enabled at startup.	✅
EnableWarningsElevatedApps	Boolean	Show a warning for functionality issues when running alongside elevated applications.	✅
Theme	String	What theme to use for the Settings application: "system", "dark", "light".	✅
ShowNewUpdatesToastNotification	Boolean	Show a toast notification when a new PowerToys update is available.	✅
AutoDownloadUpdates	Boolean	If new updates of PowerToys should be automatically downloaded in the background.	✅
ShowWhatsNewAfterUpdates	Boolean	After updating PowerToys, open the "What's new" screen.	✅
EnableExperimentation	Boolean	Opt-in into experimental features.	✅

Contributing

Refer to the relevant devdocs section in the developer documentation to start working on the DSC module.

Share via

Desired State Configuration

Installation

Prerequisites

Download

Usage

Available Configuration Settings by Module

AlwaysOnTop

Awake

ColorPicker

CropAndLock

EnvironmentVariables

FancyZones

FileLocksmith

FindMyMouse

Hosts

ImageResizer

KeyboardManager

MeasureTool

MouseHighlighter

MouseJump

MousePointerCrosshairs

MouseWithoutBorders

PastePlain

Peek

PowerAccent

PowerLauncher

PowerToys Run plugins

PowerOcr

PowerPreview

PowerRename

RegistryPreview

ShortcutGuide

VideoConference

GeneralSettings

Contributing

Additional resources