Set-PSReadLineOption

참조

모듈:: PSReadLine

PSReadLine명령줄 편집 동작을 사용자 지정합니다.

구문

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>]

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

Description

Set-PSReadLineOption cmdlet은 명령줄을 편집할 때 PSReadLine 모듈의 동작을 사용자 지정합니다. PSReadLine 설정을 보려면 Get-PSReadLineOption사용합니다.

예제

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

다음은 PSReadLine 설정하여 회색 배경에 녹색 전경 텍스트가 있는 주석 토큰을 표시하는 예제입니다.

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

예제 2: 종 스타일 설정

이 예제에서 PSReadLine 사용자의 주의가 필요한 오류 또는 조건에 응답합니다. BellStyle 60ms에 대해 1221Hz에서 가청 경고음을 내보내도록 설정되어 있습니다.

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

매개 변수

-AddToHistoryHandler

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

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

형식:	Func[String, Boolean]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BackgroundColor

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

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

검정
DarkBlue
DarkGreen
DarkCyan
어둡게
DarkMagenta
DarkYellow
회색
DarkGray
파랑
녹색
청록색
빨강
자홍색
황색
하얀

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	2
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-BellStyle

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

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

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

형식:	BellStyle
허용되는 값:	None, Visual, Audible
Position:	Named
Default value:	Audible
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CommandValidationHandler

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

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

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

형식:	Action[CommandAst]
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-CompletionQueryItems

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

표시할 항목 수가 이 값보다 큰 경우 PSReadLine 완료 항목을 표시하기 전에 예/아니요 메시지를 표시합니다.

형식:	Int32
Position:	Named
Default value:	100
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContinuationPrompt

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

형식:	String
Position:	Named
Default value:	>>
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContinuationPromptBackgroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ContinuationPromptForegroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DingDuration

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

형식:	Int32
Position:	Named
Default value:	50ms
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-DingTone

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

형식:	Int32
Position:	Named
Default value:	1221
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EditMode

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

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

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

형식:	EditMode
허용되는 값:	Windows, Emacs, Vi
Position:	Named
Default value:	Windows
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EmphasisBackgroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-EmphasisForegroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ErrorBackgroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ErrorForegroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ExtraPromptLineCount

추가 줄 수를 지정합니다.

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

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

형식:	Int32
Position:	Named
Default value:	0
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ForegroundColor

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

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

형식:	ConsoleColor
허용되는 값:	Black, DarkBlue, DarkGreen, DarkCyan, DarkRed, DarkMagenta, DarkYellow, Gray, DarkGray, Blue, Green, Cyan, Red, Magenta, Yellow, White
Position:	1
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HistoryNoDuplicates

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

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

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HistorySavePath

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

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

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

형식:	String
Position:	Named
Default value:	$env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\$($host.Name)_history.txt
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HistorySaveStyle

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

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

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

형식:	HistorySaveStyle
허용되는 값:	SaveIncrementally, SaveAtExit, SaveNothing
Position:	Named
Default value:	SaveIncrementally
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HistorySearchCaseSensitive

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

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-HistorySearchCursorMovesToEnd

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

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

Set-PSReadLineOption -HistorySearchCursorMovesToEnd:$False

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

형식:	SwitchParameter
Position:	Named
Default value:	False
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaximumHistoryCount

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

PSReadLine 기록은 PowerShell 기록과는 별개입니다.

형식:	Int32
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-MaximumKillRingCount

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

형식:	Int32
Position:	Named
Default value:	10
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ResetTokenColors

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

형식:	SwitchParameter
Position:	Named
Default value:	None
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-ShowToolTips

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

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

형식:	SwitchParameter
Position:	Named
Default value:	True
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-TokenKind

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

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

없음
주석
키워드
문자열
연산자
변수
명령
매개 변수
형
수
구성원

형식:	TokenClassification
허용되는 값:	None, Comment, Keyword, String, Operator, Variable, Command, Parameter, Type, Number, Member
Position:	0
Default value:	None
필수:	True
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

-WordDelimiters

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

형식:	String
Position:	Named
Default value:	;:,.[]{}()/\\|^&*-=+-—―
필수:	False
파이프라인 입력 허용:	False
와일드카드 문자 허용:	False

입력

None

Set-PSReadLineOption위해 파이프라인 아래로 개체를 보낼 수 없습니다.

출력

None

Set-PSReadLineOption 출력을 생성하지 않습니다.

다음을 통해 공유

Set-PSReadLineOption

구문

Description

예제

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

예제 2: 종 스타일 설정

매개 변수

-AddToHistoryHandler

-BackgroundColor

-BellStyle

-CommandValidationHandler

-CompletionQueryItems

-ContinuationPrompt

-ContinuationPromptBackgroundColor

-ContinuationPromptForegroundColor

-DingDuration

-DingTone

-EditMode

-EmphasisBackgroundColor

-EmphasisForegroundColor

-ErrorBackgroundColor

-ErrorForegroundColor

-ExtraPromptLineCount

-ForegroundColor

-HistoryNoDuplicates

-HistorySavePath

-HistorySaveStyle

-HistorySearchCaseSensitive

-HistorySearchCursorMovesToEnd

-MaximumHistoryCount

-MaximumKillRingCount

-ResetTokenColors

-ShowToolTips

-TokenKind

-WordDelimiters

입력

출력

추가 리소스

다음을 통해 공유

Set-PSReadLineOption

구문

Description

예제

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

예제 2: 종 스타일 설정

매개 변수

-AddToHistoryHandler

-BackgroundColor

-BellStyle

-CommandValidationHandler

-CompletionQueryItems

-ContinuationPrompt

-ContinuationPromptBackgroundColor

-ContinuationPromptForegroundColor

-DingDuration

-DingTone

-EditMode

-EmphasisBackgroundColor

-EmphasisForegroundColor

-ErrorBackgroundColor

-ErrorForegroundColor

-ExtraPromptLineCount

-ForegroundColor

-HistoryNoDuplicates

-HistorySavePath

-HistorySaveStyle

-HistorySearchCaseSensitive

-HistorySearchCursorMovesToEnd

-MaximumHistoryCount

-MaximumKillRingCount

-ResetTokenColors

-ShowToolTips

-TokenKind

-WordDelimiters

입력

출력

관련 링크

추가 리소스