Seit Version 0.80 wurde das PowerToys Installationsprogramm auf GitHub mit Microsoft.PowerToys.ConfigureDSC Ressource veröffentlicht, mit der Sie mithilfe einer Winget-Konfigurationsdatei konfigurieren PowerToys können.
Installation
Voraussetzungen
PSDesiredStateConfiguration 2.0.7 oder höher: Installationsanweisungen finden Sie in der PowerShell-DSC-Dokumentation.
Erstellen sie jedoch eine Konfiguration.dsc. Yaml-Datei , die die erforderlichen Einstellungen in einem einfacheren Format enthält, ist bequemer. Hier sehen Sie ein Beispiel:
Verwenden Sie den folgenden Befehl, um die Konfiguration aus der Datei zu übernehmen:
winget configure .\configuration.dsc.yaml
Dieser Befehl installiert die neueste Version und PowerToys verwendet die PowerToysConfigure-Ressource, um Einstellungen für mehrere PowerToys Module anzuwenden. Weitere Beispiele finden Sie im PowerToys-Repository.
Verfügbare Konfigurationseinstellungen nach Modul
AlwaysOnTop
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
Hotkey
KeyboardKeys
Passen Sie die Verknüpfung zum Anheften oder Aufheben des Anheftens eines Anwendungsfensters an.
✅
FrameEnabled
Boolean
Einen Rahmen um das angeheftete Fenster anzeigen.
✅
FrameThickness
Int
Dicke des Rahmens in Pixeln.
✅
FrameColor
String
Geben Sie eine Farbe im Format #FFFFFFFF an.
✅
FrameOpacity
Int
Deckkraft des Randes in Prozent.
✅
FrameAccentColor
Boolean
Verwenden Sie einen benutzerdefinierten FrameColor-Wert.
✅
SoundEnabled
Boolean
Abspielen eines Tons beim Anheften eines Fensters.
✅
DoNotActivateOnGameMode
Boolean
Deaktivieren Sie die Aktivierungsabkürzung, wenn der Spielmodus aktiviert ist.
✅
ExcludedApps
String
'\r'-getrennte Liste von Namen ausführbarer Dateien, die von der Anheftung an den Anfang ausgeschlossen werden sollen.
✅
RoundCornersEnabled
Boolean
Aktivieren Sie runde Ecken.
✅
Awake
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
KeepDisplayOn
Boolean
Diese Einstellung ist nur verfügbar, wenn der PC im Wachzustand ist.
Dadurch wird der Name der Farbe angezeigt, wenn Sie eine Farbe auswählen.
✅
Hinweis
Das Konfigurieren von benutzerdefinierten Farbformaten über DSC wird noch nicht unterstützt.
CropAndLock
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ReparentHotkey
KeyboardKeys
Verknüpfung zum Zuschneiden des Fensters einer Anwendung in ein beschnittenes Fenster.
✅
ThumbnailHotkey
KeyboardKeys
Shortcut zum Zuschneiden und Erstellen einer Miniaturansicht eines anderen Fensters.
✅
Umgebungsvariablen
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
LaunchAdministrator
Boolean
Muss als Administrator gestartet werden, um Änderungen an den Systemumgebungsvariablen vornehmen zu können.
✅
FancyZones
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
FancyzonesShiftDrag
Boolean
Halten Sie die Umschalttaste gedrückt, um beim Ziehen eines Fensters Zonen zu aktivieren.
✅
FancyzonesMouseSwitch
Boolean
Verwenden Sie eine andere als die primäre Maustaste, um die Zonenaktivierung umzuschalten.
✅
FancyzonesMouseMiddleClickSpanningMultipleZones
Boolean
Klicken Sie mit der mittleren Maustaste, um mehrere Zonen übergreifend zu schalten.
✅
FancyzonesOverrideSnapHotkeys
Boolean
Dadurch wird die Windows Ausrichtungsverknüpfung (Win +Pfeil) überschrieben, um zwischen Zonen zu wechseln windows .
✅
FancyzonesMoveWindowsAcrossMonitors
Boolean
Wechseln windows zwischen Zonen über alle Monitore hinweg.
✅
FancyzonesMoveWindowsBasedOnPosition
Boolean
Verschieben windows basierend auf relativer Position oder Zonenindex.
✅
FancyzonesOverlappingZonesAlgorithm
Int
Wenn mehrere Zonen den Algorithmusindex überlappen.
✅
FancyzonesDisplayOrWorkAreaChangeMoveWindows
Boolean
Behalten Sie windows ihre Zonen bei, wenn sich die Bildschirmauflösung oder der Arbeitsbereich ändert.
✅
FancyzonesZoneSetChangeMoveWindows
Boolean
Bei Zonenlayoutänderungen entspricht die windows Zuordnung einer Zone zu neuen Größen/Positionen.
✅
FancyzonesAppLastZoneMoveWindows
Boolean
Verschieben Sie neu erstellte windows Dateien in ihre letzte bekannte Zone.
✅
FancyzonesOpenWindowOnActiveMonitor
Boolean
Verschieben Sie neu erstellte windows Elemente auf den aktuellen aktiven Monitor (Experimental).
✅
FancyzonesRestoreSize
Boolean
Stellen Sie die originale Größe wieder windows her, wenn sie nicht wiederherstellen.
✅
FancyzonesQuickLayoutSwitch
Boolean
Aktivieren Sie den schnellen Layoutwechsel.
✅
FancyzonesFlashZonesOnQuickSwitch
Boolean
Blinkzonen beim Umschalten des Layouts.
✅
UseCursorposEditorStartupscreen
Boolean
Editor auf dem Display öffnen, auf dem sich der Mauszeiger befindet.
✅
FancyzonesShowOnAllMonitors
Boolean
Beim Ziehen eines Fensters Zonen auf allen Monitoren anzeigen.
✅
FancyzonesSpanZonesAcrossMonitors
Boolean
Erlauben Sie Zonen, die sich über mehrere Monitore erstrecken.
✅
FancyzonesMakeDraggedWindowTransparent
Boolean
Machen Sie das gezogene Fenster transparent.
✅
FancyzonesAllowChildWindowSnap
Boolean
windows Untergeordnetes Andocken zulassen.
✅
FancyzonesDisableRoundCornersOnSnap
Boolean
Deaktivieren Sie runde Ecken, wenn das Fenster gefangen wird.
✅
FancyzonesZoneHighlightColor
String
Wenn Sie nicht FancyzonesSystemTheme verwenden, markieren Sie die Farbe, die im Format #FFFFFFFF verwendet werden soll.
✅
FancyzonesHighlightOpacity
Int
Zonentransparenz in Prozent.
✅
FancyzonesEditorHotkey
KeyboardKeys
Passen Sie die Verknüpfung zur Aktivierung dieses Moduls an.
✅
FancyzonesWindowSwitching
Boolean
Wechseln zwischen windows der aktuellen Zone.
✅
FancyzonesNextTabHotkey
KeyboardKeys
Nächste Fensterverknüpfung.
✅
FancyzonesPrevTabHotkey
KeyboardKeys
Vorherige Fensterverknüpfung.
✅
FancyzonesExcludedApps
String
'\r'-getrennte Liste von Namen ausführbarer Dateien, die von der Erfassung ausgeschlossen werden sollen.
✅
FancyzonesBorderColor
String
Wenn kein FancyzonesSystemTheme verwendet wird, ist die Farbe des Rahmens im Format #FFFFFFFF zu verwenden.
✅
FancyzonesInActiveColor
String
Wenn Sie nicht FancyzonesSystemTheme verwenden, ist die inaktive Farbe im Format #FFFFFFFF zu verwenden.
✅
FancyzonesNumberColor
String
Wenn Sie nicht FancyzonesSystemTheme verwenden, geben Sie die zu verwendende Farbe im Format #FFFFFFFF an.
✅
FancyzonesSystemTheme
Boolean
Systemthema für das Aussehen der Zone verwenden.
✅
FancyzonesShowZoneNumber
Boolean
Zonennummer anzeigen.
✅
Hinweis
Die Konfiguration von Layouts über DSC wird noch nicht unterstützt.
FileLocksmith
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ExtendedContextMenuOnly
Boolean
File Locksmith nur im erweiterten Kontextmenü oder auch im Standard-Kontextmenü anzeigen.
✅
FindMyMouse
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationMethod
Int
Index der Aktivierungsmethode.
✅
ActivationShortcut
HotkeySettings
Benutzerdefinierte Aktivierungsverknüpfung bei Verwendung von Custom für ActivationMethod.
✅
DoNotActivateOnGameMode
Boolean
Deaktivieren Sie die Aktivierungsabkürzung, wenn der Spielmodus aktiviert ist.
✅
BackgroundColor
String
Hintergrundfarbe im Format #FFFFFFFF.
✅
SpotlightColor
String
Scheinwerferfarbe im Format #FFFFFFFF.
✅
OverlayOpacity
Int
Deckkraft der Überlagerung in Prozent.
✅
SpotlightRadius
Int
Radius des Scheinwerfers in px.
✅
AnimationDurationMs
Int
Dauer der Animation in Millisekunden.
✅
SpotlightInitialZoom
Int
Zoomfaktor des Scheinwerfers beim Start der Animation.
✅
ExcludedApps
String
'\r'-getrennte Liste von Namen ausführbarer Dateien, um die Aktivierung von Modulen zu verhindern.
✅
ShakingMinimumDistance
Int
Bei Verwendung von shake mouse ActivationMethod der Mindestabstand für die Aktivierung durch Schütteln der Maus, um die Empfindlichkeit anzupassen.
✅
ShakingIntervalMs
Int
Bei der Verwendung von shake mouse ActivationMethod die Zeitspanne, in der wir die Mausbewegung verfolgen, um das Schütteln zu erkennen und die Empfindlichkeit anzupassen.
✅
ShakingFactor
Int
Bei Verwendung von Shake Mouse ActivationMethod, Shake factor in Prozent.
✅
Hosts
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
LaunchAdministrator
Boolean
Muss als Administrator geöffnet werden, um Änderungen an den Systemumgebungsvariablen vornehmen zu können.
✅
ShowStartupWarning
Boolean
Beim Starten eine Warnung anzeigen.
✅
LoopbackDuplicates
Boolean
Betrachten Sie Loopback-Adressen als Duplikate.
✅
AdditionalLinesPosition
HostsAdditionalLinesPosition
Mögliche Werte: Oben, Unten.
✅
Codieren
HostsEncoding
Mögliche Werte: Utf8, Utf8Bom.
✅
ImageResizer
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ImageresizerSelectedSizeIndex
Int
Voreingestellter Index für die Größe.
✅
ImageresizerShrinkOnly
Boolean
Bilder kleiner, aber nicht größer machen.
✅
ImageresizerReplace
Boolean
Überschreiben von Dateien.
✅
ImageresizerIgnoreOrientation
Boolean
Ignorieren Sie die Ausrichtung der Bilder.
✅
ImageresizerJpegQualityLevel
Int
JPEG-Qualitätsstufe in Prozent.
✅
ImageresizerPngInterlaceOption
Int
Index der PNG-Interlacing-Option.
✅
ImageresizerTiffCompressOption
Int
Tiff-Kompressionsindex.
✅
ImageresizerFileName
String
Dieses Format wird als Dateiname für Bilder mit veränderter Größe verwendet.
✅
ImageresizerSizes
—
—
❌
ImageresizerKeepDateModified
Boolean
Entfernen Sie Metadaten, die keinen Einfluss auf das Rendering haben.
✅
ImageresizerFallbackEncoder
String
Zu verwendender Fallback-Encoder.
✅
ImageresizerCustomSize
—
—
❌
Hinweis
Das Konfigurieren von benutzerdefinierten Größen über DSC wird noch nicht unterstützt.
KeyboardManager
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActiveConfiguration
—
—
❌
KeyboardConfigurations
—
—
❌
Hinweis
Die Konfiguration von Neuzuordnungen über DSC wird noch nicht unterstützt.
MeasureTool
Measure Tool ist die interne Bezeichnung für Screen Ruler.
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationShortcut
HotkeySettings
Passen Sie die Tastenkombination an, um die Befehlsleiste aufzurufen.
✅
ContinuousCapture
Boolean
Erfassen Sie den Bildschirm kontinuierlich während der Messung.
✅
DrawFeetOnCross
Boolean
Fügt dem Ende von Querlinien einen Fuß hinzu.
✅
PerColorChannelEdgeDetection
Boolean
Aktivieren Sie einen anderen Algorithmus für die Kantenerkennung.
✅
PixelTolerance
Int
Pixel-Toleranz für die Kantenerkennung.
✅
MeasureCrossColor
String
Linienfarbe im Format #FFFFFFFF.
✅
DefaultMeasureStyle
Int
Standard-Maßnahmestil-Index.
✅
MouseHighlighter
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationShortcut
HotkeySettings
Passen Sie die Tastenkombination an, um diesen Modus zu aktivieren oder zu deaktivieren.
✅
LeftButtonClickColor
String
Hervorhebungsfarbe der primären Schaltfläche im Format #FFFFFFFF.
✅
RightButtonClickColor
String
Hervorhebungsfarbe der sekundären Taste im Format #FFFFFFFF.
✅
AlwaysColor
String
Markieren Sie immer Farbe im Format #FFFFFFFF.
✅
HighlightRadius
Int
Hervorhebungsradius in Pixel.
✅
HighlightFadeDelayMs
Int
Überblendungsverzögerung in Millisekunden.
✅
HighlightFadeDurationMs
Int
Überblenddauer in Millisekunden.
✅
AutoActivate
Boolean
Automatische Aktivierung beim Starten des Programms.
✅
MouseJump
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationShortcut
HotkeySettings
Passen Sie die Tastenkombination an, um diesen Modus zu aktivieren oder zu deaktivieren.
✅
ThumbnailSize
MouseJumpThumbnailSize
Größe der Vorschaubilder.
✅
MousePointerCrosshairs
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationShortcut
HotkeySettings
Passen Sie die Verknüpfung zum Ein- und Ausblenden des Fadenkreuzes an.
✅
CrosshairsColor
String
Fadenkreuzfarbe in #FFFFFFFF.
✅
CrosshairsOpacity
Int
Fadenkreuz-Deckkraft in Prozent.
✅
CrosshairsRadius
Int
Radius der Fadenkreuzmitte in Pixel.
✅
CrosshairsThickness
Int
Dicke des Fadenkreuzes in Pixel.
✅
CrosshairsBorderColor
String
Fadenkreuz-Rahmenfarbe im Format #FFFFFFFF.
✅
CrosshairsBorderSize
Int
Größe des Fadenkreuzrandes in Pixel.
✅
CrosshairsAutoHide
Boolean
Fadenkreuz automatisch ausblenden, wenn der Mauszeiger ausgeblendet ist.
✅
CrosshairsIsFixedLengthEnabled
Boolean
Fadenkreuzlänge fixieren.
✅
CrosshairsFixedLength
Int
Fadenkreuz feste Länge in Pixel.
✅
AutoActivate
Boolean
Automatische Aktivierung beim Starten des Programms.
✅
MouseWithoutBorders
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ShowOriginalUI
Boolean
Zeigen Sie die Original-Benutzeroberfläche von Maus ohne Grenzen an.
✅
WrapMouse
Boolean
Bewegen Sie die Steuerung zurück zur ersten Maschine, wenn die Maus die letzte Maschine passiert.
✅
ShareClipboard
Boolean
Wenn die gemeinsame Zwischenablage nicht mehr funktioniert, kann Strg+Alt+Entf und dann Esc das Problem lösen.
✅
TransferFile
Boolean
Wenn eine Datei (<100 MB) kopiert wird, wird sie in die Zwischenablage des entfernten Rechners übertragen.
✅
HideMouseAtScreenEdge
Boolean
Maus am Bildschirmrand ausblenden.
✅
DrawMouseCursor
Boolean
Der Mauszeiger ist in Windows 10 und späteren Versionen von Windows möglicherweise nicht sichtbar, wenn keine physische Maus angeschlossen ist.
✅
ValidateRemoteMachineIP
Boolean
Reverse DNS-Lookup zur Überprüfung der IP-Adresse des Rechners.
✅
SameSubnetOnly
Boolean
Verbinden Sie sich nur mit Rechnern im selben Intranet NNN.NNN.. (funktioniert nur, wenn auf beiden Rechnern IPv4 aktiviert ist).
✅
BlockScreenSaverOnOtherMachines
Boolean
Blockieren Sie den Bildschirmschoner auf anderen Rechnern.
✅
MoveMouseRelatively
Boolean
Verwenden Sie diese Option, wenn die Monitoreinstellungen des entfernten Rechners unterschiedlich sind oder der entfernte Rechner mehrere Monitore hat.
✅
BlockMouseAtScreenCorners
Boolean
Blockieren Sie die Maus an den Bildschirmecken, um ein versehentliches Umschalten der Maschine an den Bildschirmecken zu vermeiden.
✅
ShowClipboardAndNetworkStatusMessages
Boolean
Zwischenablage- und Netzwerkstatusmeldungen anzeigen.
✅
EasyMouse
Int
Index des einfachen Mausmodus.
✅
HotKeySwitchMachine
Int
Shortcut zum Umschalten zwischen Maschinenindex.
✅
ToggleEasyMouseShortcut
HotkeySettings
Tastenkombination zum Umschalten von Easy Mouse.
✅
LockMachineShortcut
HotkeySettings
Kurzbefehl zum Sperren aller Maschinen.
✅
ReconnectShortcut
HotkeySettings
Shortcut für den Versuch, die Verbindung wiederherzustellen.
✅
Switch2AllPCShortcut
HotkeySettings
Shortcut für den Wechsel in den Mehrmaschinenmodus.
✅
Name2IP
String
IP-Adressen-Zuordnung.
✅
PastePlain
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationShortcut
HotkeySettings
Passen Sie die Verknüpfung zur Aktivierung dieses Moduls an.
✅
Einsehen
Name
Typ
Beschreibung
Verfügbar
Aktiviert
Boolean
Der aktivierte Status für dieses Dienstprogramm.
✅
ActivationShortcut
HotkeySettings
Passen Sie die Verknüpfung zur Aktivierung dieses Moduls an.
✅
AlwaysRunNotElevated
Boolean
Führen Sie das Programm immer im nicht erweiterten Modus aus, auch wenn PowerToys im erweiterten Modus ist.
✅
CloseAfterLosingFocus
Boolean
Schließen Sie das Peek-Fenster automatisch, wenn es den Fokus verliert.
✅
PowerAccent
PowerAccent ist die interne Bezeichnung für Quick Accent.
Pfad zu dem Bild, das für das Kamera-Overlay verwendet wird.
✅
ToolbarHide
String
Wann die Symbolleiste ausgeblendet werden soll: „Nie“, „Wenn sowohl Kamera als auch Mikrofon stummgeschaltet sind“, „Wenn sowohl Kamera als auch Mikrofon stummgeschaltet sind“, „Nach Timeout“.
Zeigt eine Warnung bei Funktionsproblemen an, wenn es zusammen mit höherwertigen Anwendungen ausgeführt wird.
✅
Thema
String
Thema, das für die Anwendung „Settings“ (Einstellungen) verwendet wird: „System“, „dunkel“, „hell“.
✅
ShowNewUpdatesToastNotification
Boolean
Eine Toast-Benachrichtigung anzeigen, wenn ein neues PowerToys Update verfügbar ist.
✅
AutoDownloadUpdates
Boolean
Wenn neue Updates von PowerToys automatisch im Hintergrund heruntergeladen werden sollen.
✅
ShowWhatsNewAfterUpdates
Boolean
Nach der Aktualisierung von PowerToys öffnen Sie den Bildschirm „Was ist neu“.
✅
EnableExperimentation
Boolean
Entscheiden Sie sich für experimentelle Features.
✅
Contributing
Lesen Sie den Abschnitt Relevante devdocs in der Entwicklerdokumentation, um mit der Arbeit am Modul DSC zu beginnen.
Zusammenarbeit auf GitHub
Die Quelle für diesen Inhalt finden Sie auf GitHub, wo Sie auch Issues und Pull Requests erstellen und überprüfen können. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.