Share via

Desired State Configuration

  • 아티클

버전 0.80부터 PowerToys 설치 프로그램은 구성 파일 받기를 사용하여 을(를) 구성할 수 있는 Microsoft.PowerToys.ConfigureDSC리소스가 포함된 Win구성 파일 가져오기를 사용하여 PowerToys을(를) 구성할 수 있도록 GitHub에서 릴리스되었습니다.

설치

필수 조건

다운로드

Microsoft.PowerToys. 구성이 PowerToys과(와) 함께 설치됩니다. 설치 관리자 유형에 따라 다음과 같이 설치됩니다.

  • 사용자별 설치 범위의 경우 모듈은 %USERPROFILE%\Documents\PowerShell\Modules\Microsoft.PowerToys.Configure에 있습니다.
  • 컴퓨터 전체 설치 범위의 경우 %ProgramFiles%\WindowsPowerShell\Modules\Microsoft.PowerToys.Configure에서 찾을 수 있습니다.

사용

다음 Powershell 구문을 사용하여 리소스를 직접 호출할 수 있습니다.

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

그러나 필요한 설정을 더 간단한 형식으로 포함하는 configuration.dsc.yaml 파일을 만드는 것이 더 편리합니다. 예를 들면 다음과 같습니다.

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

다음 명령을 사용하여 파일의 구성을 적용합니다.

winget configure .\configuration.dsc.yaml

이 명령은 PowerToys의 최신 버전을 설치하고 PowerToys구성 리소스를 사용하여 여러 PowerToys 모듈에 대한 설정을 적용합니다. PowerToys 리포지토리에서 더 많은 예제를 찾을 수 있습니다.

모듈별 사용 가능한 구성 설정

AlwaysOnTop

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
Hotkey KeyboardKeys 바로 가기를 사용자 지정하여 앱 창을 고정하거나 고정 해제합니다. ✅
FrameEnabled Boolean 고정된 창 주위에 테두리를 표시합니다. ✅
FrameThickness 정수 테두리 두께(픽셀 단위)입니다. ✅
FrameColor 문자열 #FFFFFFFF 서식으로 색을 지정합니다. ✅
FrameOpacity 정수 테두리 불투명도(백분율)입니다. ✅
FrameAccentColor Boolean 사용자 지정 FrameColor 값을 사용합니다. ✅
SoundEnabled Boolean 창을 고정할 때 소리를 재생합니다. ✅
DoNotActivateOnGameMode Boolean 게임 모드가 켜져 있을 때 활성화 바로 가기를 비활성화합니다. ✅
ExcludedApps 문자열 맨 위에 고정할 때 제외할 실행 파일 이름의 '\r'로 구분된 목록입니다. ✅
RoundCornersEnabled Boolean 둥근 모서리를 사용합니다. ✅

절전 모드 해제

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
KeepDisplayOn Boolean 이 설정은 PC를 절전 모드로 유지하는 경우에만 사용할 수 있습니다. ✅
모드 AwakeMode 가능한 값: PASSIVE, INDEFINITE, TIMED, EXPIRABLE. ✅
IntervalHours UInt32 TIMED 모드를 사용하는 경우 시간 수를 지정합니다. ✅
IntervalMinutes UInt32 TIMED 모드를 사용하는 경우 분 수를 지정합니다. ✅
ExpirationDateTime DateTimeOffset EXPIRABLE 모드를 사용하는 경우 DateTimeOffset.TryParse(으)로 구문 분석 가능한 형식으로 날짜와 시간을 지정합니다. ✅

ColorPicker

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 이 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅
CopiedColorRepresentation 문자열 사용할 기본 색 표현입니다. 예: "HEX". ✅
ActivationAction ColorPickerActivationAction 가능한 값: OpenEditor, OpenColorPickerAndThenEditor, OpenOnlyColorPicker. ✅
VisibleColorFormats — — ❌
ShowColorName Boolean 색을 선택할 때 색의 이름이 표시됩니다. ✅

참고 항목

DSC(으)로 사용자 지정 색 서식을 구성하는 것은 아직 지원되지 않습니다.

CropAndLock

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ReparentHotkey KeyboardKeys 애플리케이션의 창을 잘린 창으로 자르는 바로 가기입니다. ✅
ThumbnailHotkey KeyboardKeys 다른 창의 썸네일을 자르고 생성하는 바로 가기입니다. ✅

환경변수

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
LaunchAdministrator Boolean 시스템 환경 변수를 변경하려면 관리자 권한으로 실행해야 합니다. ✅

FancyZones

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
FancyzonesShiftDrag Boolean Shift 키를 누른 채로 창을 끌어와서 영역을 활성화합니다. ✅
FancyzonesMouseSwitch Boolean 비기본 마우스 단추를 사용하여 영역 활성화를 전환합니다. ✅
FancyzonesMouseMiddleClickSpanningMultipleZones Boolean 가운데 마우스 클릭 단추를 사용하여 여러 영역에 걸쳐 토글합니다. ✅
FancyzonesOverrideSnapHotkeys Boolean 이렇게 하면 Windows 스냅 바로 가기(Win+ 화살표)를 재정의하여 영역 간에 창을 이동합니다. ✅
FancyzonesMoveWindowsAcrossMonitors Boolean 모든 모니터의 영역 간 창을 이동합니다. ✅
FancyzonesMoveWindowsBasedOnPosition Boolean 상대적 위치 또는 영역 인덱스를 기준으로 창을 이동합니다. ✅
FancyzonesOverlappingZonesAlgorithm 정수 여러 영역이 알고리즘 인덱스와 겹치는 경우. ✅
FancyzonesDisplayOrWorkAreaChangeMoveWindows Boolean 화면 해상도나 작업 영역이 변경되어도 창을 해당 영역에 유지합니다. ✅
FancyzonesZoneSetChangeMoveWindows Boolean 영역 레이아웃 변경 시, 영역에 할당되어 있던 창을 새 크기/위치에 맞게 변경합니다. ✅
FancyzonesAppLastZoneMoveWindows Boolean 새로 만든 창을 마지막으로 알려진 영역으로 이동합니다. ✅
FancyzonesOpenWindowOnActiveMonitor Boolean 새로 만든 창을 현재 활성 모니터로 이동(실험적)합니다. ✅
FancyzonesRestoreSize Boolean 맞추기를 해제할 때 창의 원래 크기를 복원합니다. ✅
FancyzonesQuickLayoutSwitch Boolean 빠른 레이아웃 전환을 사용합니다. ✅
FancyzonesFlashZonesOnQuickSwitch Boolean 레이아웃 전환 시 영역을 플래시합니다. ✅
UseCursorposEditorStartupscreen Boolean 마우스 포인트가 있는 디스플레이에서 편집기를 엽니다. ✅
FancyzonesShowOnAllMonitors Boolean 창을 끄는 동안 모든 모니터에 영역을 표시합니다. ✅
FancyzonesSpanZonesAcrossMonitors Boolean 여러 모니터에 걸쳐 영역을 확장할 수 있도록 허용합니다. ✅
FancyzonesMakeDraggedWindowTransparent Boolean 끌어온 창을 투명하게 만듭니다. ✅
FancyzonesAllowChildWindowSnap Boolean 자식 팝업 창 맞춤을 허용합니다. ✅
FancyzonesDisableRoundCornersOnSnap Boolean 창을 맞출 때 둥근 모서리를 사용하지 않습니다. ✅
FancyzonesZoneHighlightColor 문자열 FancyzonesSystemTheme을 사용하지 않는 경우 #FFFFFFFF 서식에 사용할 색을 강조 표시합니다. ✅
FancyzonesHighlightOpacity 정수 영역 불투명도(백분율)입니다. ✅
FancyzonesEditorHotkey KeyboardKeys 이 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅
FancyzonesWindowSwitching Boolean 현재 영역의 창 간을 전환합니다. ✅
FancyzonesNextTabHotkey KeyboardKeys 다음 창 바로 가기. ✅
FancyzonesPrevTabHotkey KeyboardKeys 이전 창 바로 가기. ✅
FancyzonesExcludedApps 문자열 스냅에서 제외할 실행 파일 이름을 '\r'로 구분된 목록으로 입력합니다. ✅
FancyzonesBorderColor 문자열 FancyzonesSystemTheme을 사용하지 않는 경우 #FFFFFFFF 서식에 사용할 테두리 색을 입력합니다. ✅
FancyzonesInActiveColor 문자열 FancyzonesSystemTheme을 사용하지 않는 경우 #FFFFFFFF 서식에 사용할 색을 비활성화합니다. ✅
FancyzonesNumberColor 문자열 FancyzonesSystemTheme을 사용하지 않는 경우 #FFFFFFFF 서식에 사용할 색의 번호를 매깁니다. ✅
FancyzonesSystemTheme Boolean 영역 모양에 시스템 테마를 사용합니다. ✅
FancyzonesShowZoneNumber Boolean 영역 번호 표시. ✅

참고 항목

레이아웃 구성 DSC은(는) 아직 지원되지 않습니다.

FileLocksmith

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ExtendedContextMenuOnly Boolean 확장 컨텍스트 메뉴에만 파일 잠금 장치를 표시하거나 기본 컨텍스트 메뉴에도 표시합니다. ✅

FindMyMouse

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationMethod 정수 활성화 메서드 인덱스. ✅
ActivationShortcut HotkeySettings Custom for ActivationMethod를 사용하는 경우 사용자 지정 활성화 바로 가기. ✅
DoNotActivateOnGameMode Boolean 게임 모드가 켜져 있을 때 활성화 바로 가기를 비활성화합니다. ✅
BackgroundColor 문자열 #FFFFFFFF 서식의 배경 색. ✅
SpotlightColor 문자열 #FFFFFFFF 서식의 스포트라이트 색. ✅
OverlayOpacity 정수 오버레이 불투명도를 백분율로 설정합니다. ✅
SpotlightRadius 정수 스포트라이트 반경(px). ✅
AnimationDurationMs 정수 애니메이션 기간(밀리초). ✅
SpotlightInitialZoom 정수 애니메이션 시작 시 스포트라이트 확대/축소 비율. ✅
ExcludedApps 문자열 '\r'로 구분된 실행 파일 이름 목록을 사용하여 모듈 활성화를 방지합니다. ✅
ShakingMinimumDistance 정수 마우스 흔들기 ActivationMethod를 사용하는 경우 감도를 조정하기 위해 마우스 흔들림 활성화를 위한 최소 거리입니다. ✅
ShakingIntervalMs 정수 마우스 흔들기 ActivationMethod를 사용하는 경우 감도를 조정하기 위해 흔들림 감지용으로 마우스 움직임을 추적하는 시간 범위입니다. ✅
ShakingFactor 정수 마우스 흔들기 ActivationMethod를 사용하는 경우 흔들림 계수를 백분율로 표시합니다. ✅

호스트

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
LaunchAdministrator Boolean 시스템 환경 변수를 변경하려면 관리자 권한으로 열어야 합니다. ✅
ShowStartupWarning Boolean 시작 시 경고를 표시합니다. ✅
LoopbackDuplicates Boolean 루프백 주소를 중복으로 간주합니다. ✅
AdditionalLinesPosition HostsAdditionalLinesPosition 가능한 값: 상단, 하단. ✅
인코딩 HostsEncoding 가능한 값: Utf8, Utf8Bom. ✅

ImageResizer

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ImageresizerSelectedSizeIndex 정수 기본 크기 사전 설정 인덱스입니다. ✅
ImageresizerShrinkOnly Boolean 사진을 작게 만들되 크게 만들지 마세요. ✅
ImageresizerReplace Boolean 파일을 덮어씁니다. ✅
ImageresizerIgnoreOrientation Boolean 그림의 방향을 무시합니다. ✅
ImageresizerJpegQualityLevel 정수 JPEG 품질 수준(백분율)입니다. ✅
ImageresizerPngInterlaceOption 정수 PNG 인터레이스 옵션 인덱스. ✅
ImageresizerTiffCompressOption 정수 Tiff 압축 인덱스. ✅
ImageresizerFileName 문자열 이 형식은 크기가 조정된 이미지의 파일 이름으로 사용됩니다. ✅
ImageresizerSizes — — ❌
ImageresizerKeepDateModified Boolean 렌더링에 영향을 주지 않는 메타데이터를 제거합니다. ✅
ImageresizerFallbackEncoder 문자열 사용할 대체 인코더. ✅
ImageresizerCustomSize — — ❌

참고 항목

DSC을(를) 통해 사용자 지정 크기를 구성하는 것은 아직 지원되지 않습니다.

KeyboardManager

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActiveConfiguration — — ❌
KeyboardConfigurations — — ❌

참고 항목

다시 매핑 구성 DSC은(는) 아직 지원되지 않습니다.

MeasureTool

측정 도구는 화면 눈금자의 내부 이름입니다.

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 바로 가기를 사용자 지정하여 명령줄을 불러올 수 있습니다. ✅
ContinuousCapture Boolean 측정하는 동안 지속적으로 화면을 캡처합니다. ✅
DrawFeetOnCross Boolean 십자선 끝에 발을 추가합니다. ✅
PerColorChannelEdgeDetection Boolean 다른 엣지 감지 알고리즘을 사용하도록 설정합니다. ✅
PixelTolerance 정수 에지 검색에 대한 픽셀 허용 오차. ✅
MeasureCrossColor 문자열 선 색(#FFFFFFFF 서식). ✅
DefaultMeasureStyle 정수 기본 측정값 스타일 인덱스. ✅

MouseHighlighter

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 바로 가기를 사용자 지정하여 이 모드를 켜거나 끕니다. ✅
LeftButtonClickColor 문자열 기본 단추는 #FFFFFFFF 서식으로 색을 강조 표시합니다. ✅
RightButtonClickColor 문자열 보조 단추는 #FFFFFFFF 서식으로 색을 강조 표시합니다. ✅
AlwaysColor 문자열 항상 색을 #FFFFFFFF 서식으로 강조 표시합니다. ✅
HighlightRadius 정수 반경을 픽셀 단위로 강조 표시합니다. ✅
HighlightFadeDelayMs 정수 페이드 지연 시간(밀리초). ✅
HighlightFadeDurationMs 정수 페이드 지속 시간(밀리초). ✅
AutoActivate Boolean 유틸리티 시작 시 자동으로 활성화됩니다. ✅

MouseJump

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 바로 가기를 사용자 지정하여 이 모드를 켜거나 끕니다. ✅
ThumbnailSize MouseJumpThumbnailSize 썸네일 크기. ✅

MousePointerCrosshairs

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 십자선을 표시/숨기도록 바로 가기를 사용자 지정합니다. ✅
CrosshairsColor 문자열 #FFFFFFFF의 십자선 색. ✅
CrosshairsOpacity 정수 십자선 불투명도(백분율). ✅
CrosshairsRadius 정수 십자선 중심 반경(픽셀). ✅
CrosshairsThickness 정수 십자선 두께(픽셀). ✅
CrosshairsBorderColor 문자열 #FFFFFFFF 서식의 십자선 테두리 색. ✅
CrosshairsBorderSize 정수 십자선 테두리 크기(픽셀). ✅
CrosshairsAutoHide Boolean 마우스 포인터가 숨겨지면 자동으로 십자선을 숨깁니다. ✅
CrosshairsIsFixedLengthEnabled Boolean 십자선 길이 수정. ✅
CrosshairsFixedLength 정수 십자선 고정 길이(픽셀). ✅
AutoActivate Boolean 유틸리티 시작 시 자동으로 활성화됩니다. ✅

MouseWithoutBorders

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ShowOriginalUI Boolean 테두리 UI 없이 원래 마우스를 표시합니다. ✅
WrapMouse Boolean 마우스가 마지막 컴퓨터를 지나면 제어권을 첫 번째 컴퓨터로 다시 이동합니다. ✅
ShareClipboard Boolean 공유 클립보드가 작동하지 않는 경우 Ctrl+Alt+Del 키를 누른 다음, Esc 키를 누르면 문제가 해결될 수 있습니다. ✅
TransferFile Boolean 파일(<100MB)이 복사되면 원격 컴퓨터 클립보드로 전송됩니다. ✅
HideMouseAtScreenEdge Boolean 화면 가장자리에서 마우스를 숨깁니다. ✅
DrawMouseCursor Boolean 마우스 커서는 실제 마우스가 연결되지 않은 경우 Windows의 Windows 10 이상 버전에서 표시되지 않을 수 있습니다. ✅
ValidateRemoteMachineIP Boolean 역방향 DNS 조회를 통해 컴퓨터 IP 주소의 유효성을 검사합니다. ✅
SameSubnetOnly Boolean 동일한 인트라넷 NNN.NNN의 머신에만 연결합니다(두 컴퓨터 모두 IPv4를 사용하도록 설정한 경우에만 작동). ✅
BlockScreenSaverOnOtherMachines Boolean 다른 컴퓨터의 화면 보호기를 차단합니다. ✅
MoveMouseRelatively Boolean 원격 컴퓨터의 모니터 설정이 다르거나 원격 컴퓨터에 여러 대의 모니터가 있는 경우 이 옵션을 사용합니다. ✅
BlockMouseAtScreenCorners Boolean 화면 모서리에서 마우스를 차단하여 화면 모서리에서 기계 전환 사고를 방지합니다. ✅
ShowClipboardAndNetworkStatusMessages Boolean 클립보드 및 네트워크 상태 메시지를 표시합니다. ✅
EasyMouse 정수 쉬운 마우스 모드 인덱스. ✅
HotKeySwitchMachine 정수 컴퓨터 인덱스 간에 전환하는 바로 가기. ✅
ToggleEasyMouseShortcut HotkeySettings 간편한 마우스를 토글하는 바로 가기. ✅
LockMachineShortcut HotkeySettings 모든 컴퓨터를 잠그는 바로 가기. ✅
ReconnectShortcut HotkeySettings 다시 연결하기 위한 바로 가기. ✅
Switch2AllPCShortcut HotkeySettings 여러 컴퓨터 모드로 전환하는 바로 가기. ✅
Name2IP 문자열 IP 주소 매핑. ✅

PastePlain

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 이 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅

피킹

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 이 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅
AlwaysRunNotElevated Boolean PowerToys이(가) 상승된 경우에도 항상 관리자 권한으로 실행되지 않습니다. ✅
CloseAfterLosingFocus Boolean 포커스가 끊어지면 Peek 창을 자동으로 닫습니다. ✅

PowerAccent

PowerAccent는 빠른 강조의 내부 이름입니다.

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationKey PowerAccentActivationKey 가능한 값: LeftRightArrow, Space, Both. ✅
DoNotActivateOnGameMode Boolean 게임 모드가 켜져 있을 때 활성화 바로 가기를 비활성화합니다. ✅
ToolbarPosition 문자열 도구 모음 위치 인덱스. ✅
InputTime 정수 입력 시간 지연 시간(밀리초). ✅
SelectedLang 문자열 사용할 문자 집합. ✅
ExcludedApps 문자열 '\r'로 구분된 실행 파일 이름 목록을 사용하여 모듈이 포그라운드에 있는 경우 모듈이 활성화되지 않도록 합니다. ✅
ShowUnicodeDescription Boolean 현재 선택된 문자의 유니코드 코드와 이름을 표시합니다. ✅
SortByUsageFrequency Boolean 사용 빈도별로 문자를 정렬합니다. ✅
StartSelectionFromTheLeft Boolean 왼쪽에서 선택을 시작합니다. ✅

PowerLauncher

PowerLaucher는 PowerToys Run의 내부 이름입니다.

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
OpenPowerLauncher HotkeySettings 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅
IgnoreHotkeysInFullscreen Boolean 전체 화면 모드에서 바로 가기를 무시합니다. ✅
ClearInputOnLaunch Boolean 이전 쿼리가 열려 있으면 지웁니다. ✅
TabSelectsContextButtons Boolean 상황에 맞는 단추를 통한 탭입니다. ✅
Theme Theme 가능한 값: System, Light, Dark, HighContrastOne, HighContrastTwo, HighContrastBlack, HighContrastWhite. ✅
TitleFontSize Int32 텍스트 크기(포인트). ✅
Position StartupPosition 가능한 값: Cursor, PrimaryMonitor, Focus. ✅
UseCentralizedKeyboardHook Boolean 중앙 집중식 키보드 후크를 사용합니다. ✅
SearchQueryResultsWithDelay Boolean 입력 다듬기. ✅
SearchInputDelay Int32 즉각적인 플러그인 지연(밀리초). ✅
SearchInputDelayFast Int32 백그라운드 실행 플러그인 지연 시간(밀리초). ✅
SearchClickedItemWeight Int32 선택한 항목 가중치. ✅
SearchQueryTuningEnabled Boolean 결과 순서 튜닝. ✅
SearchWaitForSlowResults Boolean 결과에서 상위 항목을 선택하기 전에 느린 플러그 인 결과를 기다립니다. ✅
MaximumNumberOfResults 정수 스크롤하기 전에 표시되는 결과의 수입니다. ✅
UsePinyin Boolean Pinyin을 사용합니다. ✅
GenerateThumbnailsFromFiles Boolean 파일의 썸네일 그림 생성이 켜져 있습니다. ✅
플러그 인 다음 하위 섹션에서 설명함 파일의 썸네일 그림 생성이 켜져 있습니다. ✅

PowerToys Run 플러그인

PowerToys Run 플러그인은 Plugin 속성에서 구성할 수 있습니다. 샘플은 PowerToys 리포지토리에서 찾을 수 있습니다.

다음은 각 플러그인을 구성하는 데 사용할 수 있는 속성입니다.

속성 형식 Description
이름 문자열 구성하려는 플러그인의 이름
사용 안 함 Boolean 플러그인을 사용하지 않도록 설정해야 합니다.
IsGlobal Boolean 이 플러그인에 대한 결과는 전역 결과에 표시됩니다.
ActionKeyword 문자열 플러그인의 작업 키워드 구성
WeightBoost 정수 이 플러그인의 결과를 정렬하는 데 도움이 되는 가중치 수정자

참고 항목

DSC을(를) 통해 플러그인의 추가 속성을 구성하는 것은 아직 지원되지 않습니다.

PowerOcr

PowerOcr는 텍스트 추출기 내부 이름입니다.

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
ActivationShortcut HotkeySettings 이 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅
PreferredLanguage 문자열 시스템에 설치된 언어 중 하나의 전체 이름과 일치해야 합니다. 예: "영어(미국)". ✅

PowerPreview

속성 형식 설명 사용 가능
EnableSvgPreview Boolean 확장 가능한 벡터 그래픽 미리보기 핸들러 활성화 상태입니다. ✅
SvgBackgroundColorMode 정수 색 모드 인덱스. ✅
SvgBackgroundSolidColor 문자열 단색 SvgBackgroundColorMode를 사용하는 경우 #FFFFFFFF 서식으로 색을 지정합니다. ✅
SvgBackgroundCheckeredShade 정수 체크 무늬 SvgBackgroundColorMode를 사용하는 경우 음영 인덱스를 지정합니다. ✅
EnableSvgThumbnail Boolean 확장 가능한 벡터 그래픽 축소판 그림 생성기 사용 상태입니다. ✅
EnableMdPreview Boolean Markdown Preview 처리기 사용 상태입니다. ✅
EnableMonacoPreview Boolean 소스 코드 파일 미리 보기 처리기 사용 상태입니다. ✅
EnableMonacoPreviewWordWrap Boolean 텍스트 줄 바꿈. ✅
MonacoPreviewTryFormat Boolean 미리 보기용 원본의 서식을 지정해 보세요. ✅
MonacoPreviewMaxFileSize 정수 미리 볼 최대 파일 크기(KB)입니다. ✅
EnablePdfPreview Boolean 이식 가능한 문서 형식 미리 보기 처리기 사용 상태입니다. ✅
EnablePdfThumbnail Boolean 이식 가능한 문서 형식 썸네일 그림 생성기 사용 상태입니다. ✅
EnableGcodePreview Boolean 기하학적 코드 미리 보기 처리기 사용 상태. ✅
EnableGcodeThumbnail Boolean 기하학적 코드 썸네일 그림 생성기 사용 상태입니다. ✅
EnableStlThumbnail Boolean 스테레오리토그래피 썸네일 생성기 사용 상태. ✅
StlThumbnailColor 문자열 #FFFFFFFF 서식의 썸네일 색. ✅
EnableQoiPreview Boolean 꽤 양호 이미지 미리 보기 처리기 사용 상태. ✅
EnableQoiThumbnail Boolean 꽤 양호 이미지 썸네일 생성기 사용 상태. ✅

PowerRename

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
MRUEnabled Boolean 검색 & 바꾸기 필드에 자동 완성 사용. ✅
MaxMRUSize 정수 기억해야 할 최근 사용한 항목의 최대 수입니다. ✅
ExtendedContextMenuOnly Boolean 확장된 상황에 맞는 메뉴에만 또는 기본 상황에 맞는 메뉴에도 PowerRename을 표시합니다. ✅
UseBoostLib Boolean Boost 라이브러리 사용. ✅

RegistryPreview

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
DefaultRegApp Boolean 레지스트리 미리 보기를 .reg 파일을 여는 기본 앱으로 설정합니다. ✅

ShortcutGuide

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
OpenShortcutGuide HotkeySettings 이 모듈을 활성화하려면 바로 가기를 사용자 지정합니다. ✅
OverlayOpacity 정수 배경 불투명도(백분율). ✅
UseLegacyPressWinKeyBehavior Boolean Windows 키를 눌러 ShortcutGuide를 활성화해야 하는 경우. ✅
PressTimeForGlobalWindows바로 가기 정수 전역 Windows 바로 가기를 표시하기 전에 기간을 밀리초 단위로 누릅니다. ✅
PressTimeForTaskbarIconShortcuts 정수 작업 표시줄 아이콘 바로 가기를 표시하기 전에 지속 시간을 밀리초 단위로 누릅니다. ✅
Theme 문자열 테마 인덱스. ✅
DisabledApps 문자열 이러한 애플리케이션에 초점이 있는 경우 바로 가기 안내를 끕니다. ✅

VideoConference

속성 형식 설명 사용 가능
활성화 부울 이 유틸리티의 사용 상태입니다. ✅
MuteCameraAndMicrophoneHotkey KeyboardKeys 카메라와 마이크를 음소거하기 위한 바로 가기. ✅
MuteMicrophoneHotkey KeyboardKeys 마이크 음소거를 위한 바로 가기. ✅
PushToTalkMicrophoneHotkey KeyboardKeys 푸시하여 대화할 수 있는 바로 가기. ✅
PushToReverseEnabled Boolean 사용하도록 설정하면 마이크 상태에 따라 푸시에서 통화 및 푸시를 모두 음소거할 수 있습니다. ✅
MuteCameraHotkey KeyboardKeys 카메라를 음소거하기 위한 바로 가기. ✅
SelectedCamera 문자열 디바이스 이름. ✅
SelectedMicrophone 문자열 디바이스 이름 또는 [All]. ✅
ToolbarPosition 문자열 도구 모음 위치 옵션: "Top center", "Bottom center", "Top right corner", "Top left corner", "Bottom right corner", "Bottom left corner". ✅
ToolbarMonitor 문자열 도구 모음 모니터 옵션: "Main monitor", "All monitors". ✅
CameraOverlayImagePath 문자열 카메라 오버레이에 사용되는 이미지의 경로입니다. ✅
ToolbarHide 문자열 도구 모음을 숨기는 경우: "Never", "When both camera and microphone are unmuted", "When both camera and microphone are muted", "After timeout". ✅
StartupAction 문자열 시작 작업: "Nothing", "Unmute", "Mute". ✅

GeneralSettings

속성 형식 설명 사용 가능
Startup 클래스 Boolean PowerToys은(는) 시작 시 자동으로 사용하도록 설정됩니다. ✅
EnableWarningsElevatedApps Boolean 상승된 애플리케이션과 함께 실행할 때 기능 문제에 대한 경고를 표시합니다. ✅
Theme 문자열 설정 애플리케이션에 사용할 테마: "system", "dark", "light". ✅
ShowNewUpdatesToastNotification Boolean 새 PowerToys 업데이트를 사용할 수 있는 경우 알림 메시지를 표시합니다. ✅
AutoDownloadUpdates Boolean PowerToys의 새 업데이트를 백그라운드에서 자동으로 다운로드해야 하는 경우. ✅
ShowWhatsNewAfterUpdates Boolean PowerToys을(를) 업데이트 한 후 "What's new" 화면을 엽니다. ✅
EnableExperimentation Boolean 실험적 기능에 옵트인합니다. ✅

참여

DSC 모듈 작업을 시작하려면 개발자 설명서의 관련 devdocs 섹션을 참조하세요.