Set-PSReadlineOption

구문

OptionsSet

Set-PSReadlineOption
    [-EditMode <EditMode>]
    [-ContinuationPrompt <String>]
    [-ContinuationPromptForegroundColor <ConsoleColor>]
    [-ContinuationPromptBackgroundColor <ConsoleColor>]
    [-EmphasisForegroundColor <ConsoleColor>]
    [-EmphasisBackgroundColor <ConsoleColor>]
    [-ErrorForegroundColor <ConsoleColor>]
    [-ErrorBackgroundColor <ConsoleColor>]
    [-HistoryNoDuplicates]
    [-AddToHistoryHandler <Func[string,bool]>]
    [-CommandValidationHandler <Action[CommandAst]>]
    [-HistorySearchCursorMovesToEnd]
    [-MaximumHistoryCount <Int32>]
    [-MaximumKillRingCount <Int32>]
    [-ResetTokenColors]
    [-ShowToolTips]
    [-ExtraPromptLineCount <Int32>]
    [-DingTone <Int32>]
    [-DingDuration <Int32>]
    [-BellStyle <BellStyle>]
    [-CompletionQueryItems <Int32>]
    [-WordDelimiters <String>]
    [-HistorySearchCaseSensitive]
    [-HistorySaveStyle <HistorySaveStyle>]
    [-HistorySavePath <String>]
    [<CommonParameters>]

ColorSet

Set-PSReadlineOption
    [-TokenKind] <TokenClassification>
    [[-ForegroundColor] <ConsoleColor>]
    [[-BackgroundColor] <ConsoleColor>]
    [<CommonParameters>]

Description

예제

예제 1: 전경색 및 배경색 설정

Set-PSReadlineOption -TokenKind Comment -ForegroundColor Green -BackgroundColor Gray

예제 2: 종 스타일 설정

Set-PSReadlineOption -BellStyle Audible -DingTone 1221 -DingDuration 60

매개 변수

-AddToHistoryHandler

PSReadline 기록에 추가되는 명령을 제어하는 ScriptBlock을 지정합니다.

ScriptBlock 명령줄을 입력으로 받습니다. ScriptBlock$True반환하면 명령줄이 기록에 추가됩니다.

매개 변수 속성

매개 변수 집합

-BackgroundColor

TokenKind 매개 변수로 지정된 토큰의 배경색을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

• 검정
• 진한 파란색
• 다크그린
• 다크시안
• 어둡게
• 다크마젠타
• 다크옐로우
• 회색
• 다크그레이
• 파랑
• 녹색
• 청록색
• 빨간색
• 자홍색
• 노란색
• 흰색

매개 변수 속성

매개 변수 집합

-BellStyle

PSReadline이 다양한 오류 및 모호한 조건에 응답하는 방법을 지정합니다.

유효한 값은 다음과 같습니다.

• 가청: 짧은 경고음.
• Visual: 텍스트가 잠시 깜박입니다.
• 없음: 피드백이 없습니다.

매개 변수 속성

매개 변수 집합

-CommandValidationHandler

ValidateAndAcceptLine호출되는 ScriptBlock 지정합니다. 예외가 throw되면 유효성 검사가 실패하고 오류가 보고됩니다.

예외를 throw하기 전에 유효성 검사 처리기는 오류 지점에 커서를 배치하여 보다 쉽게 해결할 수 있습니다. 유효성 검사 처리기는 일반적인 입력 체계 오류를 수정하는 등 명령줄을 변경할 수도 있습니다.

ValidateAndAcceptLine 작동하지 않는 명령으로 기록이 복잡해지지 않도록 하는 데 사용됩니다.

매개 변수 속성

매개 변수 집합

-CompletionQueryItems

프롬프트 없이 표시되는 최대 완료 항목 수를 지정합니다.

표시할 항목 수가 이 값보다 크면 PSReadline 은 완료 항목을 표시하기 전에 예/아니요 메시지를 표시합니다.

매개 변수 속성

매개 변수 집합

-ContinuationPrompt

여러 줄 입력을 입력할 때 후속 줄의 시작 부분에 표시되는 문자열을 지정합니다. 기본값은 double greater-than sign(>>)입니다. 빈 문자열이 유효합니다.

매개 변수 속성

매개 변수 집합

-ContinuationPromptBackgroundColor

연속 프롬프트의 배경색을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-ContinuationPromptForegroundColor

연속 프롬프트의 전경색을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-DingDuration

BellStyle 가청설정된 경우 경고음의 지속 기간을 지정합니다.

매개 변수 속성

매개 변수 집합

-DingTone

BellStyle 가청설정된 경우 경고음의 Hertz(Hz)의 톤을 지정합니다.

매개 변수 속성

매개 변수 집합

-EditMode

명령줄 편집 모드를 지정합니다. 이 매개 변수를 사용하면 Set-PSReadlineKeyHandler설정된 모든 키 바인딩이 다시 설정됩니다.

유효한 값은 다음과 같습니다.

• Windows: 키 바인딩은 PowerShell, cmd 및 Visual Studio를 에뮬레이트합니다.
• Emacs: 키 바인딩은 Bash 또는 Emacs를 에뮬레이트합니다.
• Vi: 키 바인딩은 Vi를 에뮬레이트합니다.

매개 변수 속성

매개 변수 집합

-EmphasisBackgroundColor

강조 표시에 사용되는 배경색(예: 검색 텍스트 강조 표시)을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-EmphasisForegroundColor

강조 표시에 사용되는 전경색(예: 검색 텍스트 강조 표시)을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-ErrorBackgroundColor

오류에 사용되는 배경색을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-ErrorForegroundColor

오류에 사용되는 전경색을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-ExtraPromptLineCount

추가 줄 수를 지정합니다.

프롬프트가 둘 이상의 줄에 걸쳐 있는 경우 이 매개 변수의 값을 지정합니다. PSReadline이 일부 출력을 표시한 후 프롬프트를 표시할 때 추가 줄을 사용할 수 있도록 하려면 이 옵션을 사용합니다. 예를 들어 PSReadline 은 완성 목록을 반환합니다.

이 옵션은 이전 버전의 PSReadline보다 덜 필요하지만 함수를 사용할 때 InvokePrompt 유용합니다.

매개 변수 속성

매개 변수 집합

-ForegroundColor

TokenKind 매개 변수로 지정된 토큰의 전경색을 지정합니다.

허용되는 값은 BackgroundColor 매개 변수와 동일합니다.

매개 변수 속성

매개 변수 집합

-HistoryNoDuplicates

이 옵션은 회수 동작을 제어합니다. 중복 명령은 여전히 기록 파일에 추가됩니다. 이 옵션을 설정하면 명령을 회수할 때 가장 최근 호출만 표시됩니다.

반복 명령은 회수 중에 순서를 유지하기 위해 기록에 추가됩니다. 그러나 일반적으로 기록을 회수하거나 검색할 때 명령을 여러 번 보고 싶지는 않습니다.

매개 변수 속성

매개 변수 집합

-HistorySavePath

기록이 저장되는 파일의 경로를 지정합니다. 파일 이름은 변수 $($host.Name)_history.txt저장됩니다(예: ConsoleHost_history.txt).

이 매개 변수를 사용하지 않는 경우 기본 경로는 다음과 같습니다.

$env:APPDATA\Microsoft\Windows\PowerShell\PSReadline\$($host.Name)_history.txt

매개 변수 속성

매개 변수 집합

-HistorySaveStyle

PSReadline이 기록을 저장하는 방법을 지정합니다.

유효한 값은 다음과 같습니다.

• SaveIncrementally: 각 명령이 실행된 후 기록을 저장하고 PowerShell의 여러 인스턴스에서 공유합니다.
• SaveAtExit: PowerShell이 종료되면 기록 파일을 추가합니다.
• SaveNothing: 기록 파일을 사용하지 마세요.

매개 변수 속성

매개 변수 집합

-HistorySearchCaseSensitive

ReverseSearchHistory 또는 HistorySearchBackward같은 함수에서 기록 검색이 대/소문자를 구분하지 않도록 지정합니다.

매개 변수 속성

매개 변수 집합

-HistorySearchCursorMovesToEnd

검색을 사용하여 기록에서 로드하는 명령의 끝으로 커서가 이동했음을 나타냅니다. 이 매개 변수가 $False설정되면 커서는 위쪽 또는 아래쪽 화살표를 누를 때의 위치에 유지됩니다.

이 옵션을 해제하려면 다음 명령 중 하나를 실행할 수 있습니다.

Set-PSReadlineOption -HistorySearchCursorMovesToEnd:$False

(Get-PSReadlineOption).HistorySearchCursorMovesToEnd = $False

매개 변수 속성

매개 변수 집합

-MaximumHistoryCount

PSReadline 기록에 저장할 최대 명령 수를 지정합니다.

PSReadline 기록은 PowerShell 기록과 별개입니다.

매개 변수 속성

매개 변수 집합

-MaximumKillRingCount

kill 링에 저장된 최대 항목 수를 지정합니다.

매개 변수 속성

매개 변수 집합

-ResetTokenColors

이 cmdlet은 토큰 색을 기본 설정으로 복원한다는 것을 나타냅니다.

매개 변수 속성

매개 변수 집합

-ShowToolTips

가능한 완성을 표시하면 완료 목록에 도구 설명이 표시됩니다.

이 옵션은 기본적으로 사용하도록 설정됩니다. 이 옵션은 이전 버전의 PSReadline에서 기본적으로 사용하도록 설정되지 않았습니다. 사용하지 않도록 설정하려면 이 옵션을 $False.

매개 변수 속성

매개 변수 집합

-TokenKind

ForegroundColor 및 backgroundColor 매개 변수를 토큰 색 옵션을 설정할 때 토큰을 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

• 없음
• 주석
• 키워드
• 문자열
• 오퍼레이터
• 변수
• 명령어
• 매개 변수
• 유형
• 숫자
• 회원

매개 변수 속성

매개 변수 집합

-WordDelimiters

ForwardWord 또는 KillWord같은 함수의 단어를 구분하는 문자를 지정합니다.

매개 변수 속성

매개 변수 집합

CommonParameters

입력

None

출력

None

관련 링크

• about_PSReadline
• Get-PSReadlineKeyHandler
• Get-PSReadlineOption
• Remove-PSReadlineKeyHandler
• Set-PSReadlineKeyHandler