Set-PSReadLineOption

모듈:

PSReadLine Module

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

구문

Default (기본값)

Set-PSReadLineOption
    [-EditMode <EditMode>]
    [-ContinuationPrompt <String>]
    [-HistoryNoDuplicates]
    [-AddToHistoryHandler <System.Func`2[System.String,System.Object]>]
    [-CommandValidationHandler <System.Action`1[System.Management.Automation.Language.CommandAst]>]
    [-HistorySearchCursorMovesToEnd]
    [-MaximumHistoryCount <Int32>]
    [-MaximumKillRingCount <Int32>]
    [-ShowToolTips]
    [-ExtraPromptLineCount <Int32>]
    [-DingTone <Int32>]
    [-DingDuration <Int32>]
    [-BellStyle <BellStyle>]
    [-CompletionQueryItems <Int32>]
    [-WordDelimiters <String>]
    [-HistorySearchCaseSensitive]
    [-HistorySaveStyle <HistorySaveStyle>]
    [-HistorySavePath <String>]
    [-AnsiEscapeTimeout <Int32>]
    [-PromptText <String[]>]
    [-ViModeIndicator <ViModeStyle>]
    [-ViModeChangeHandler <ScriptBlock>]
    [-PredictionSource <PredictionSource>]
    [-PredictionViewStyle <PredictionViewStyle>]
    [-Colors <Hashtable>]
    [<CommonParameters>]

Description

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

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

예제

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

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

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

전경 텍스트 색상만 설정하도록 선택할 수 있습니다. 예를 들어, Comment 토큰의 밝은 녹색 전경 텍스트 색상은 다음과 같습니다 "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

명령이 .로 $false시작되면 scriptblock이 반환 git 됩니다. 이는 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이 .인 경우와 같습니다.

매개 변수 속성

형식:	Func<T,TResult>[System.String,System.Object]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-AnsiEscapeTimeout

이 옵션은 입력이 리디렉션되는 경우(예: 또는 tmux에서 실행되는 screen 경우) Windows에만 해당됩니다.

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

터미널이 사용자가 입력하는 것보다 더 빠르게 문자를 보낼 수 있다고 가정합니다. PSReadLine 은 완전한 이스케이프 시퀀스를 받았다고 결론을 내리기 전에 이 시간 제한을 기다립니다.

입력할 때 임의의 문자나 예기치 않은 문자가 표시되면 이 시간 초과를 조정할 수 있습니다.

매개 변수 속성

형식:	Int32
Default value:	100
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-BellStyle

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

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

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

매개 변수 속성

형식:	BellStyle
Default value:	Audible
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Colors

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

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

색은 예를 들어 [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: 연속 프롬프트의 색입니다.
• 강조: 강조 색상입니다. 예를 들어, 기록을 검색할 때 일치하는 텍스트입니다.
• 오류: 오류 색상입니다. 예를 들어 프롬프트에서.
• 선택: 메뉴 선택 또는 선택한 텍스트를 강조 표시하는 색상입니다.
• 기본값: 기본 토큰 색상입니다.
• 주석: 주석 토큰 색상입니다.
• 키워드: 키워드 토큰 색상입니다.
• String: 문자열 토큰 색상입니다.
• 연산자: 연산자 토큰 색상입니다.
• 변수: 변수 토큰 색상입니다.
• 명령: 명령 토큰 색상입니다.
• Parameter: 매개 변수 토큰 색상입니다.
• Type: 유형 토큰 색상입니다.
• 숫자: 숫자 토큰 색상입니다.
• Member: 멤버 이름 토큰 색상입니다.
• InlinePrediction: 예측 제안의 인라인 보기 색입니다.
• ListPrediction: 선행 > 문자 및 예측 원본 이름의 색입니다.
• ListPredictionSelected: 목록 보기에서 선택한 예측의 색입니다.

매개 변수 속성

형식:	Hashtable
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CommandValidationHandler

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

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

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

매개 변수 속성

형식:	Action<T>[CommandAst]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-CompletionQueryItems

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

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

매개 변수 속성

형식:	Int32
Default value:	100
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ContinuationPrompt

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

매개 변수 속성

형식:	String
Default value:	>>
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DingDuration

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

매개 변수 속성

형식:	Int32
Default value:	50ms
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-DingTone

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

매개 변수 속성

형식:	Int32
Default value:	1221
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-EditMode

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

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

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

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

매개 변수 속성

형식:	EditMode
Default value:	Windows
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ExtraPromptLineCount

추가 줄 수를 지정합니다.

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

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

매개 변수 속성

형식:	Int32
Default value:	0
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HistoryNoDuplicates

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

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

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

(Get-PSReadLineOption).HistoryNoDuplicates = $False

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	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

매개 변수 속성

형식:	String
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
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HistorySaveStyle

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

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

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

비고

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

매개 변수 속성

형식:	HistorySaveStyle
Default value:	SaveIncrementally
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HistorySearchCaseSensitive

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

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

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

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-HistorySearchCursorMovesToEnd

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

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

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

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaximumHistoryCount

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

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

매개 변수 속성

형식:	Int32
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-MaximumKillRingCount

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

매개 변수 속성

형식:	Int32
Default value:	10
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PredictionSource

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

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

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

매개 변수 속성

형식:	Microsoft.PowerShell.PredictionSource
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PredictionViewStyle

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

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

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

매개 변수 속성

형식:	Microsoft.PowerShell.PredictionViewStyle
Default value:	InlineView
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-PromptText

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

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

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

매개 변수 속성

형식:	String[]
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ShowToolTips

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

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

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

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

(Get-PSReadLineOption).ShowToolTips = $False

매개 변수 속성

형식:	SwitchParameter
Default value:	True
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ViModeChangeHandler

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

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

매개 변수 속성

형식:	ScriptBlock
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ViModeIndicator

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

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

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

매개 변수 속성

형식:	ViModeStyle
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WordDelimiters

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

매개 변수 속성

형식:	String
Default value:	;:,.[]{}()/\|^&*-=+'"---
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

출력

None

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

관련 링크

• PSReadLine에 대하여
• Get-PSReadLineKeyHandler
• PSReadLine 옵션 가져오기
• PSReadLine 키 핸들러 제거
• Set-PSReadLine키 핸들러 설정