Set-PSReadLineOption

참조

모듈:: PSReadLine

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

Syntax

Set-PSReadLineOption
   [-EditMode <EditMode>]
   [-ContinuationPrompt <string>]
   [-HistoryNoDuplicates]
   [-AddToHistoryHandler <Func[string,Object]>]
   [-CommandValidationHandler <Action[CommandAst]>]
   [-HistorySearchCursorMovesToEnd]
   [-MaximumHistoryCount <int>]
   [-MaximumKillRingCount <int>]
   [-ShowToolTips]
   [-ExtraPromptLineCount <int>]
   [-DingTone <int>]
   [-DingDuration <int>]
   [-BellStyle <BellStyle>]
   [-CompletionQueryItems <int>]
   [-WordDelimiters <string>]
   [-HistorySearchCaseSensitive]
   [-HistorySaveStyle <HistorySaveStyle>]
   [-HistorySavePath <string>]
   [-AnsiEscapeTimeout <int>]
   [-PromptText <string[]>]
   [-ViModeIndicator <ViModeStyle>]
   [-ViModeChangeHandler <scriptblock>]
   [-PredictionSource <PredictionSource>]
   [-PredictionViewStyle <PredictionViewStyle>]
   [-Colors <hashtable>]
   [-TerminateOrphanedConsoleApps]
   [<CommonParameters>]

Description

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

이 명령으로 설정된 옵션은 현재 세션에만 적용됩니다. 옵션을 유지하려면 프로필 스크립트에 추가합니다. 자세한 내용은 about_Profiles 및 셸 환경 사용자 지정을 참조하세요.

예제

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

다음은 회색 배경에 녹색 전경 텍스트가 있는 메모 토큰을 표시하도록 PSReadLine을 설정하는 예제입니다. 예제 에 사용된 이스케이프 시퀀스에서 32 는 전경색을 나타내고 47 은 배경색을 나타냅니다.

Set-PSReadLineOption -Colors @{ "Comment"="`e[32;47m" }

전경 텍스트 색만 설정하도록 선택할 수 있습니다. 예를 들어 주석 토큰의 밝은 녹색 전경 텍스트 색은 다음과 "Comment"="`e[92m"같습니다.

예제 2: 종 스타일 설정

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

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

참고 항목

이 기능은 플랫폼의 모든 호스트에서 작동하지 않을 수 있습니다.

예제 3: 여러 옵션 설정

Set-PSReadLineOption 는 해시 테이블을 사용하여 여러 옵션을 설정할 수 있습니다.

$PSReadLineOptions = @{
    EditMode = "Emacs"
    HistoryNoDuplicates = $true
    HistorySearchCursorMovesToEnd = $true
    Colors = @{
        "Command" = "#8181f7"
    }
}
Set-PSReadLineOption @PSReadLineOptions

해시 테이블은 $PSReadLineOptions 키와 값을 설정합니다. Set-PSReadLineOption는 키와 값을 @PSReadLineOptions 사용하여 PSReadLine 옵션을 업데이트합니다.

PowerShell 명령줄에서 해시 테이블 이름을 $PSReadLineOptions 입력하는 키와 값을 볼 수 있습니다.

예제 4: 여러 색 옵션 설정

이 예제에서는 단일 명령에서 두 개 이상의 색 값을 설정하는 방법을 보여줍니다.

Set-PSReadLineOption -Colors @{
  Command            = 'Magenta'
  Number             = 'DarkGray'
  Member             = 'DarkGray'
  Operator           = 'DarkGray'
  Type               = 'DarkGray'
  Variable           = 'DarkGreen'
  Parameter          = 'DarkGreen'
  ContinuationPrompt = 'DarkGray'
  Default            = 'DarkGray'
}

예제 5: 여러 형식의 색 값 설정

이 예제에서는 PSReadLine에 표시되는 토큰의 색을 설정하는 방법에 대한 세 가지 방법을 보여 줍니다.

Set-PSReadLineOption -Colors @{
 # Use a ConsoleColor enum
 "Error" = [ConsoleColor]::DarkRed

 # 24 bit color escape sequence
 "String" = "$([char]0x1b)[38;5;100m"

 # RGB value
 "Command" = "#8181f7"
}

예제 6: ViModeChangeHandler를 사용하여 Vi 모드 변경 내용 표시

다음은 Vi 모드 변경에 대응하여 커서 변경 VT 이스케이프를 내보내는 예제입니다.

function OnViModeChange {
    if ($args[0] -eq 'Command') {
        # Set the cursor to a blinking block.
        Write-Host -NoNewLine "`e[1 q"
    } else {
        # Set the cursor to a blinking line.
        Write-Host -NoNewLine "`e[5 q"
    }
}
Set-PSReadLineOption -ViModeIndicator Script -ViModeChangeHandler $Function:OnViModeChange

OnViModeChange 함수는 Vi 모드에 대한 커서 옵션(삽입 및 명령)을 설정합니다. ViModeChangeHandler는 공급자를 Function: 사용하여 OnViModeChange를 스크립트 블록 개체로 참조합니다.

자세한 내용은 about_Providers 참조하세요.

예제 7: HistoryHandler를 사용하여 기록에 추가된 명령 필터링

다음 예제에서는 git 명령을 기록에 저장하지 않도록 하는 방법을 AddToHistoryHandler 보여 줍니다.

$ScriptBlock = {
    Param([string]$line)

    if ($line -match "^git") {
        return $false
    } else {
        return $true
    }
}

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

명령이 .로 git시작되면 scriptblock이 반환 $false 됩니다. 이는 AddToHistory 열거형을 반환하는 것과 SkipAdding동일한 효과를 줍니다. 명령이 시작 git되지 않으면 처리기가 반환 $true 되고 PSReadLine이 명령을 기록에 저장합니다.

예제 8: CommandValidationHandler를 사용하여 명령이 실행되기 전에 명령의 유효성을 검사합니다.

이 예제에서는 CommandValidationHandler 매개 변수를 사용하여 명령이 실행되기 전에 유효성 검사를 실행하는 방법을 보여줍니다. 이 예제에서는 명령에 대한 git 검사 하위 명령을 cmt 사용하여 전체 이름으로 commit바꿉니다. 이렇게 하면 하위 명령에 대한 약식 별칭을 만들 수 있습니다.

# Load the namespace so you can use the [CommandAst] object type
using namespace System.Management.Automation.Language

Set-PSReadLineOption -CommandValidationHandler {
    param([CommandAst]$CommandAst)

    switch ($CommandAst.GetCommandName()) {
        'git' {
            $gitCmd = $CommandAst.CommandElements[1].Extent
            switch ($gitCmd.Text) {
                'cmt' {
                    [Microsoft.PowerShell.PSConsoleReadLine]::Replace(
                        $gitCmd.StartOffset, $gitCmd.EndOffset - $gitCmd.StartOffset, 'commit')
                }
            }
        }
    }
}
# This checks the validation script when you hit enter
Set-PSReadLineKeyHandler -Chord Enter -Function ValidateAndAcceptLine

예제 9: PromptText 매개 변수 사용

구문 분석 오류가 발생하면 PSReadLine 은 프롬프트의 일부를 빨간색으로 변경합니다. PromptText 매개 변수는 PSReadLine에 프롬프트 문자열의 일부를 빨간색으로 만들도록 지시합니다.

예를 들어 다음 예제에서는 현재 경로와 보다 큰 문자(>) 및 공백이 포함된 프롬프트를 만듭니다.

function prompt { "PS $pwd> " }`
Set-PSReadLineOption -PromptText '> ' # change the '>' character red
Set-PSReadLineOption -PromptText '> ', 'X ' # replace the '>' character with a red 'X'

첫 번째 문자열은 구문 분석 오류가 있을 때 빨간색으로 만들려는 프롬프트 문자열의 부분입니다. 두 번째 문자열은 구문 분석 오류가 있을 때 사용할 대체 문자열입니다.

매개 변수

-AddToHistoryHandler

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

ScriptBlock은 명령줄을 입력으로 받습니다.

ScripBlock은 AddToHistoryOption 열거형의 멤버, 해당 멤버 중 하나의 문자열 이름 또는 부울 값을 반환해야 합니다. 아래 목록에서는 가능한 값과 해당 효과에 대해 설명합니다.

MemoryAndFile - 기록 파일 및 현재 세션에 명령을 추가합니다.
MemoryOnly - 현재 세션의 기록에만 명령을 추가합니다.
SkipAdding - 현재 세션의 기록 파일에 명령을 추가하지 마세요.
$false - 값 SkipAdding이 .인 경우와 같습니다.
$true - 값 MemoryAndFile이 .인 경우와 같습니다.

Type:	Func<T,TResult>[System.String,System.Object]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AnsiEscapeTimeout

이 옵션은 입력이 리디렉션될 때(예: 아래 또는 screen아래에서 tmux 실행될 때) Windows에만 적용됩니다.

Windows에서 리디렉션된 입력을 사용하면 많은 키가 이스케이프 문자로 시작하는 문자 시퀀스로 전송됩니다. 단일 이스케이프 문자 뒤에 더 많은 문자와 유효한 이스케이프 시퀀스를 구분하는 것은 불가능합니다.

터미널에서 사용자 유형보다 더 빠르게 문자를 보낼 수 있다고 가정합니다. PSReadLine 은 이 시간 제한을 기다린 후 전체 이스케이프 시퀀스를 받았다는 결론을 내립니다.

입력할 때 임의 또는 예기치 않은 문자가 표시되면 이 시간 제한을 조정할 수 있습니다.

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-BellStyle

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

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

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

Type:	BellStyle
Position:	Named
Default value:	Audible
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Colors

Colors 매개 변수는 PSReadLine에서 사용하는 다양한 색을 지정합니다.

인수는 키가 요소를 지정하고 값이 색을 지정하는 해시 테이블입니다. 자세한 내용은 about_Hash_Tables 참조하세요.

색은 ConsoleColor의 값(예[ConsoleColor]::Red: 유효한 ANSI 이스케이프 시퀀스)일 수 있습니다. 유효한 이스케이프 시퀀스는 터미널에 따라 달라집니다. PowerShell 5.0에서 빨간색 텍스트의 예제 이스케이프 시퀀스는 다음과 같습니다 $([char]0x1b)[91m. PowerShell 6 이상에서는 동일한 이스케이프 시퀀스가 있습니다 `e[91m. 다음 형식을 포함하여 다른 이스케이프 시퀀스를 지정할 수 있습니다.

PSReadLine 2.2.0에서 사용자 지정을 ListView 지원하기 위해 두 가지 색 설정이 추가되었습니다.

ListPredictionColor - 선행 > 문자 및 후행 원본 이름(예: [History].)에 대한 색을 설정합니다. 기본적으로 전경색으로 사용됩니다 DarkYellow .
ListPredictionSelectedColor - 목록 항목이 선택되었음을 나타내는 색을 설정합니다. 기본적으로 배경색으로 사용됩니다 DarkBlack .
256 색
24비트 색
전경, 배경 또는 둘 다
역, 굵게

ANSI 색 코드에 대한 자세한 내용은 Wikipedia 문서 ANSI 이스케이프 코드를 참조하세요.

유효한 키는 다음과 같습니다.

ContinuationPrompt: 연속 프롬프트의 색입니다.
강조: 강조 색입니다. 예를 들어 기록을 검색할 때 일치하는 텍스트입니다.
오류: 오류 색입니다. 예를 들어 프롬프트에서
선택 영역: 메뉴 선택 영역 또는 선택한 텍스트를 강조 표시할 색입니다.
기본값: 기본 토큰 색입니다.
주석: 주석 토큰 색입니다.
키워드: 키워드(keyword) 토큰 색입니다.
문자열: 문자열 토큰 색입니다.
연산자: 연산자 토큰 색입니다.
변수: 변수 토큰 색입니다.
명령: 명령 토큰 색입니다.
매개 변수: 매개 변수 토큰 색입니다.
형식: 형식 토큰 색입니다.
숫자: 숫자 토큰 색입니다.
멤버: 멤버 이름 토큰 색입니다.
InlinePrediction: 예측 제안의 인라인 보기 색입니다.
ListPrediction: 선행 > 문자 및 예측 원본 이름의 색입니다.
ListPredictionSelected: 목록 보기에서 선택한 예측의 색입니다.

Type:	Hashtable
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CommandValidationHandler

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

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

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

Type:	Action<T>[CommandAst]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-CompletionQueryItems

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

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

Type:	Int32
Position:	Named
Default value:	100
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ContinuationPrompt

여러 줄 입력을 입력할 때 후속 줄의 시작 부분에 표시되는 문자열을 지정합니다. 기본값은 두 배 더 큰 기호(>>)입니다. 빈 문자열이 유효합니다.

Type:	String
Position:	Named
Default value:	>>
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DingDuration

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

Type:	Int32
Position:	Named
Default value:	50ms
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DingTone

BellStyle이 가청으로 설정된 경우 비프음의 Hertz(Hz)로 톤을 지정합니다.

Type:	Int32
Position:	Named
Default value:	1221
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-EditMode

명령줄 편집 모드를 지정합니다. 이 매개 변수를 Set-PSReadLineKeyHandler사용하면 .

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

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

현재 구성된 EditMode에 대한 키 바인딩을 확인하는 데 사용합니다Get-PSReadLineKeyHandler.

Type:	EditMode
Position:	Named
Default value:	Windows
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ExtraPromptLineCount

추가 줄 수를 지정합니다.

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

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

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HistoryNoDuplicates

이 옵션은 회수 동작을 제어합니다. 중복 명령은 여전히 기록 파일에 추가됩니다. 이 옵션을 설정하면 명령을 회수할 때 가장 최근 호출만 표시됩니다. 반복 명령은 회수 중에 순서를 유지하기 위해 기록에 추가됩니다. 그러나 일반적으로 기록을 회수하거나 검색할 때 명령을 여러 번 보고 싶지는 않습니다.

기본적으로 전역 PSConsoleReadLineOptions 개체의 HistoryNoDuplicates 속성은 .로 True설정됩니다. 속성 값을 변경하려면 SwitchParameter의 값을 다음과 -HistoryNoDuplicates:$False같이 지정해야 합니다. SwitchParameter-HistoryNoDuplicates만 사용하여 다시 True 설정할 수 있습니다.

다음 명령을 사용하여 속성 값을 직접 설정할 수 있습니다.

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HistorySavePath

기록이 저장되는 파일의 경로를 지정합니다. Windows 또는 비 Windows 플랫폼을 실행하는 컴퓨터는 파일을 다른 위치에 저장합니다. 파일 이름은 변수 $($Host.Name)_history.txt에 저장됩니다(예 ConsoleHost_history.txt: .).

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

Windows

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

비 Windows

$env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
$HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt

Type:	String
Position:	Named
Default value:	A file named $($Host.Name)_history.txt in $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine on Windows and $env:XDG_DATA_HOME/powershell/PSReadLine or $HOME/.local/share/powershell/PSReadLine on non-Windows platforms
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HistorySaveStyle

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

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

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

참고 항목

HistorySaveStyle을 SaveNothing 설정한 다음, 동일한 세션의 뒷부분으로 SaveIncrementally 설정하면 PSReadLine은 세션에서 이전에 실행한 모든 명령을 저장합니다.

Type:	HistorySaveStyle
Position:	Named
Default value:	SaveIncrementally
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HistorySearchCaseSensitive

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

기본적으로 전역 PSConsoleReadLineOptions 개체의 HistorySearchCaseSensitive 속성은 .로 False설정됩니다. 이 SwitchParameter 를 사용하면 속성 값이 .로 설정됩니다 True. 속성 값을 다시 변경하려면 다음과 -HistorySearchCaseSensitive:$False같이 SwitchParameter 값을 지정해야 합니다.

다음 명령을 사용하여 속성 값을 직접 설정할 수 있습니다.

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-HistorySearchCursorMovesToEnd

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

기본적으로 전역 PSConsoleReadLineOptions 개체의 HistorySearchCursorMovesToEnd 속성은 .로 False설정됩니다. 이 SwitchParameter 를 사용하여 속성 값을 .로 True설정합니다. 속성 값을 다시 변경하려면 다음과 -HistorySearchCursorMovesToEnd:$False같이 SwitchParameter 값을 지정해야 합니다.

다음 명령을 사용하여 속성 값을 직접 설정할 수 있습니다.

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumHistoryCount

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

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

Type:	Int32
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MaximumKillRingCount

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

Type:	Int32
Position:	Named
Default value:	10
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PredictionSource

예측 제안을 가져올 PSReadLine의 원본을 지정합니다.

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

없음 - 예측 IntelliSense 기능(기본값)을 사용하지 않도록 설정합니다.
기록 - 예측 IntelliSense 기능을 사용하도록 설정하고 PSReadLine 기록을 유일한 원본으로 사용합니다.
플러그 인 - 예측 IntelliSense 기능을 사용하도록 설정하고 플러그 인(CommandPrediction)을 유일한 원본으로 사용합니다. 이 값은 PSReadLine 2.2.0에 추가되었습니다.
HistoryAndPlugin - 예측 IntelliSense 기능을 사용하도록 설정하고 기록과 플러그 인을 모두 원본으로 사용합니다. 이 값은 PSReadLine 2.2.0에 추가되었습니다.

Type:	Microsoft.PowerShell.PredictionSource
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PredictionViewStyle

예측 텍스트 표시의 스타일을 설정합니다. 기본값은 InlineView입니다.

InlineView - 물고기 껍질과 zsh에서와 유사, 기존의 스타일. (기본값)
ListView - 제안이 드롭다운 목록에서 렌더링되고 사용자는 UpArrow 및 DownArrow를 사용하여 선택할 수 있습니다.

이 매개 변수는 PSReadLine 2.2.0에 추가되었습니다.

Type:	Microsoft.PowerShell.PredictionViewStyle
Position:	Named
Default value:	InlineView
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PromptText

이 매개 변수는 PromptText 속성의 값을 설정합니다. 기본값은 "> "입니다.

PSReadLine 은 프롬프트 함수를 분석하여 프롬프트의 일부 색만 변경하는 방법을 결정합니다. 이 분석은 100% 신뢰할 수 없습니다. PSReadLine이 예기치 않은 방법으로 프롬프트를 변경하는 경우 이 옵션을 사용합니다. 후행 공백을 포함합니다.

이 매개 변수의 값은 단일 문자열 또는 두 문자열의 배열일 수 있습니다. 첫 번째 문자열은 구문 분석 오류가 있을 때 빨간색으로 변경하려는 프롬프트 문자열의 부분입니다. 두 번째 문자열은 구문 분석 오류가 있을 때 사용할 대체 문자열입니다.

Type:	String[]
Position:	Named
Default value:	>
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ShowToolTips

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

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

이 매개 변수 및 옵션은 PSReadLine 2.3.4에 추가되었습니다.

기본적으로 전역 PSConsoleReadLineOptions 개체의 ShowTool팁 속성은 .로 True설정됩니다. 이 SwitchParameter 를 사용하면 속성 값이 .로 설정됩니다 True. 속성 값을 변경하려면 SwitchParameter의 값을 다음과 -ShowToolTips:$False같이 지정해야 합니다.

다음 명령을 사용하여 속성 값을 직접 설정할 수 있습니다.

(Get-PSReadLineOption).ShowToolTips = $False

Type:	SwitchParameter
Position:	Named
Default value:	True
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TerminateOrphanedConsoleApps

이 매개 변수는 TerminateOrphanedConsoleApps 옵션을 .로 $true설정합니다.

Windows에서 Ctrl+c를 눌러 프로세스를 종료하면 콘솔에 연결된 각 프로세스는 활성 셸이 아닌 종료 신호를 받습니다. 경우에 따라 셸에서 자식 프로세스의 일부 큰 트리를 시작한 경우(예를 들어 빌드 시스템을 상상해 보십시오) 일부 프로세스가 종료되어 여러 프로세스가 동시에 콘솔 입력을 사용하려고 할 수 있습니다.

TerminateOrphanedConsoleApps 옵션을 설정하면 $truePSReadLine은 현재 콘솔에 연결된 프로세스 목록을 기록합니다. 그 후 PSReadLine이 실행될 때마다 콘솔에 연결된 프로세스의 새 목록이 표시되고 원래 목록에 없는 프로세스 목록이 종료됩니다.

이 매개 변수 및 옵션은 PSReadLine 2.3.4에 추가되었습니다.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ViModeChangeHandler

ViModeIndicator가 설정된 Script경우 제공된 스크립트 블록은 모드가 변경될 때마다 호출됩니다. 스크립트 블록에는 형식 ViMode의 인수 하나가 제공됩니다.

이 매개 변수는 PowerShell 7에서 도입되었습니다.

Type:	ScriptBlock
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ViModeIndicator

이 옵션은 현재 Vi 모드에 대한 시각적 표시기를 설정합니다. 삽입 모드 또는 명령 모드입니다.

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

없음: 표시기가 없습니다.
프롬프트: 프롬프트 색이 변경되었습니다.
커서: 커서의 크기가 변경됩니다.
스크립트: 사용자가 지정한 텍스트가 인쇄됩니다.

Type:	ViModeStyle
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-WordDelimiters

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

Type:	String
Position:	Named
Default value:	;:,.[]{}()/\\|^&*-=+'"---
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

Set-PSReadLineOption

Syntax

Description

예제

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

예제 2: 종 스타일 설정

예제 3: 여러 옵션 설정

예제 4: 여러 색 옵션 설정

예제 5: 여러 형식의 색 값 설정

예제 6: ViModeChangeHandler를 사용하여 Vi 모드 변경 내용 표시

예제 7: HistoryHandler를 사용하여 기록에 추가된 명령 필터링

예제 8: CommandValidationHandler를 사용하여 명령이 실행되기 전에 명령의 유효성을 검사합니다.

예제 9: PromptText 매개 변수 사용

매개 변수

-AddToHistoryHandler

-AnsiEscapeTimeout

-BellStyle

-Colors

-CommandValidationHandler

-CompletionQueryItems

-ContinuationPrompt

-DingDuration

-DingTone

-EditMode

-ExtraPromptLineCount

-HistoryNoDuplicates

-HistorySavePath

-HistorySaveStyle

-HistorySearchCaseSensitive

-HistorySearchCursorMovesToEnd

-MaximumHistoryCount

-MaximumKillRingCount

-PredictionSource

-PredictionViewStyle

-PromptText

-ShowToolTips

-TerminateOrphanedConsoleApps

-ViModeChangeHandler

-ViModeIndicator

-WordDelimiters

입력

출력

관련 링크

피드백

추가 리소스