Sdílet prostřednictvím

Set-PSReadLineOption

  • Reference
Modul:
PSReadLine

Přizpůsobí chování úprav příkazového řádku v psReadLine.

Syntaxe

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

Rutina Set-PSReadLineOption při úpravě příkazového řádku přizpůsobí chování modulu PSReadLine . Chcete-li zobrazit nastavení PSReadLine , použijte Get-PSReadLineOption.

Možnosti nastavené tímto příkazem se vztahují pouze na aktuální relaci. Pokud chcete zachovat všechny možnosti, přidejte je do skriptu profilu. Další informace najdete v tématu about_Profiles a přizpůsobení prostředí.

Příklady

Příklad 1: Nastavení barev popředí a pozadí

Tento příklad nastaví PSReadLine tak, aby zobrazoval token Komentáře se zeleným textem popředí na šedém pozadí. V řídicí sekvenci použité v příkladu představuje 32 barvu popředí a 47 představuje barvu pozadí.

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

Můžete nastavit pouze barvu textu popředí. Například jasně zelená barva textu popředí pro token Komentáře : "Comment"="`e[92m".

Příklad 2: Nastavení stylu zvonku

V tomto příkladu psReadLine odpoví na chyby nebo podmínky, které vyžadují pozornost uživatele. BellStyle je nastaven tak, aby generovat zvukovou pípnutí při 1221 Hz pro 60 ms.

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

Poznámka:

Tato funkce nemusí fungovat ve všech hostitelích na platformách.

Příklad 3: Nastavení více možností

Set-PSReadLineOption může nastavit více možností s tabulkou hash.

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

Tabulka $PSReadLineOptions hash nastaví klíče a hodnoty. Set-PSReadLineOption používá klíče a hodnoty @PSReadLineOptions k aktualizaci možností PSReadLine .

Na příkazovém řádku PowerShellu můžete zobrazit klíče a hodnoty, které zadávají název $PSReadLineOptions tabulky hash.

Příklad 4: Nastavení více možností barev

Tento příklad ukazuje, jak nastavit více než jednu hodnotu barvy v jednom příkazu.

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

Příklad 5: Nastavení hodnot barev pro více typů

Tento příklad ukazuje tři různé metody, jak nastavit barvu tokenů zobrazených v 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"
}

Příklad 6: Zobrazení změn režimu Vi Pomocí ViModeChangeHandler

Tento příklad vygeneruje řídicí znak změny kurzoru VT v reakci na změnu režimu Vi .

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

Funkce OnViModeChange nastaví možnosti kurzoru pro režimy Vi : insert a command. ViModeChangeHandler používá Function: zprostředkovatele odkaz na OnViModeChange jako objekt bloku skriptu.

Další informace najdete v tématu about_Providers.

Příklad 7: Použití HistoryHandler k filtrování příkazů přidaných do historie

Následující příklad ukazuje, jak pomocí AddToHistoryHandler příkazu Git zabránit uložení příkazů Git do historie.

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

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

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

Skriptblock se vrátí $false , pokud příkaz začal s git. Má stejný účinek jako vrácení výčtu SkipAdding AddToHistory . Pokud příkaz nezačíná git, vrátí $true obslužná rutina příkaz a příkaz PSReadLine uloží do historie.

Příklad 8: Použití CommandValidationHandler k ověření příkazu před jeho spuštěním

Tento příklad ukazuje, jak pomocí parametru CommandValidationHandler spustit před spuštěním příkazu ověření. Příklad konkrétně zkontroluje příkaz git pod příkazem cmt a nahradí ho úplným názvem commit. Tímto způsobem můžete vytvořit zkratkové aliasy pro dílčí příkazy.

# 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

Příklad 9: Použití parametru PromptText

Pokud dojde k chybě analýzy, psReadLine změní část výzvy červeně. Parametr PromptText říká PSReadLine část řetězce výzvy, aby červeně.

Například následující příklad vytvoří výzvu, která obsahuje aktuální cestu následovanou znakem větší než (>) a mezerou.

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

První řetězec je část řetězce výzvy, kterou chcete v případě chyby analýzy zčervenat. Druhý řetězec je alternativní řetězec, který se použije, když dojde k chybě analýzy.

Parametry

-AddToHistoryHandler

Určuje ScriptBlock , který určuje, jak se příkazy přidají do historie PSReadLine .

ScriptBlock obdrží příkazový řádek jako vstup.

ScripBlock by měl vrátit člen AddToHistoryOption výčtu, název řetězce jednoho z těchto členů nebo logickou hodnotu. Následující seznam popisuje možné hodnoty a jejich účinky.

  • MemoryAndFile - Přidejte příkaz do souboru historie a aktuální relace.
  • MemoryOnly - Přidejte příkaz do historie pouze pro aktuální relaci.
  • SkipAdding – Nepřidávejte příkaz do souboru historie pro aktuální relaci.
  • $false - Stejné jako v případě, že hodnota byla SkipAdding.
  • $true - Stejné jako v případě, že hodnota byla MemoryAndFile.
Typ:Func<T,TResult>[System.String,System.Object]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-AnsiEscapeTimeout

Tato možnost je specifická pro Windows při přesměrování vstupu, například při spuštění pod tmux nebo screen.

Při přesměrování vstupu ve Windows se mnoho klíčů odesílá jako posloupnost znaků začínající řídicím znakem. Není možné rozlišovat mezi jedním řídicím znakem následovaným více znaky a platnou řídicí sekvencí.

Předpokladem je, že terminál může znaky odesílat rychleji než typ uživatele. PSReadLine počká na tento časový limit a teprve potom skončí, že obdržel úplnou řídicí sekvenci.

Pokud se při psaní zobrazí náhodné nebo neočekávané znaky, můžete tento časový limit upravit.

Typ:Int32
Position:Named
Default value:100
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-BellStyle

Určuje, jak PSReadLine reaguje na různé chybové a nejednoznačné podmínky.

Platné hodnoty jsou následující:

  • Zvuk: Krátká pípnutí.
  • Vizuál: Text krátce bliká.
  • Žádné: Žádná zpětná vazba.
Typ:BellStyle
Position:Named
Default value:Audible
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Colors

Parametr Colors určuje různé barvy používané psReadLine.

Argument je tabulka hash, kde klíče určují prvky a hodnoty určují barvu. Další informace najdete v tématu about_Hash_Tables.

Barvy mohou být buď hodnota z ConsoleColor, nebo [ConsoleColor]::Redplatnou řídicí sekvenci ANSI. Platné řídicí sekvence závisí na terminálu. V PowerShellu 5.0 je $([char]0x1b)[91mpříkladem řídicí sekvence pro červený text . V PowerShellu 6 a novějším je `e[91mstejná řídicí sekvence . Můžete zadat další řídicí sekvence, včetně následujících typů:

Byla přidána dvě nastavení barev pro podporu přizpůsobení ListView v PSReadLine 2.2.0:

  • ListPredictionColor – nastavte barvu pro počáteční > znak a koncový název zdroje, například [History]. Ve výchozím nastavení se používá DarkYellow jako barva popředí.

  • ListPredictionSelectedColor – nastavit barvu pro označení položky seznamu je vybrána. Ve výchozím nastavení se používá DarkBlack jako barva pozadí.

  • 256 barev

  • 24bitová barva

  • Popředí, pozadí nebo obojí

  • Inverzní, tučné

Další informace o kódech barev ANSI naleznete v článku ANSI řídicí kód ANSI na Wikipedii.

Mezi platné klíče patří:

  • ContinuationPrompt: Barva výzvy k pokračování.
  • Zdůraznění: Barva zvýraznění. Například odpovídající text při hledání historie.
  • Chyba: Barva chyby. Například v příkazovém řádku.
  • Výběr: Barva, která zvýrazní výběr nabídky nebo vybraný text.
  • Výchozí hodnota: Výchozí barva tokenu.
  • Komentář: Barva tokenu komentáře.
  • Klíčové slovo: Barva tokenu klíčového slova.
  • Řetězec: Barva tokenu řetězce.
  • Operátor: Barva tokenu operátoru.
  • Proměnná: Barva tokenu proměnné.
  • Příkaz: Barva tokenu příkazu.
  • Parametr: Barva tokenu parametru.
  • Typ: Barva tokenu typu.
  • Číslo: Barva číselného tokenu.
  • Člen: Barva tokenu názvu člena.
  • InlinePrediction: Barva vloženého zobrazení prediktivního návrhu.
  • ListPrediction: Barva úvodního > znaku a názvu zdroje předpovědi.
  • ListPredictionSelected: Barva vybrané předpovědi v zobrazení seznamu.
Typ:Hashtable
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CommandValidationHandler

Určuje ScriptBlock , který je volána z ValidateAndAcceptLine. Pokud dojde k vyvolání výjimky, ověření selže a zobrazí se chyba.

Před vyvolání výjimky může obslužná rutina ověření umístit kurzor na místo chyby, aby se usnadnila oprava. Obslužná rutina ověřování může také změnit příkazový řádek tak, aby opravil běžné typografické chyby.

Funkce ValidateAndAcceptLine se používá k tomu, abyste se vyhnuli nepotřebným funkcím historie pomocí příkazů, které nefungují.

Typ:Action<T>[CommandAst]
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-CompletionQueryItems

Určuje maximální počet položek dokončení, které se zobrazí bez výzvy.

Pokud je počet zobrazených položek větší než tato hodnota, před zobrazením položek dokončení zobrazí příkaz PSReadLine výzvu ano/ne .

Typ:Int32
Position:Named
Default value:100
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ContinuationPrompt

Určuje řetězec zobrazený na začátku následujících řádků při zadání víceřádkového vstupu. Výchozí hodnota je dvojitá znaménka větší než (>>). Prázdný řetězec je platný.

Typ:String
Position:Named
Default value:>>
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DingDuration

Určuje dobu trvání pípnutí, pokud je BellStyle nastaven na Audible.

Typ:Int32
Position:Named
Default value:50ms
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DingTone

Určuje tón v Hertzu (Hz) pípnutí, když je BellStyle nastaven na Audible.

Typ:Int32
Position:Named
Default value:1221
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-EditMode

Určuje režim úprav příkazového řádku. Použití tohoto parametru resetuje všechny klíčové vazby nastavené pomocí Set-PSReadLineKeyHandler.

Platné hodnoty jsou následující:

  • Windows: Klávesové vazby emulují PowerShell, cmd a Visual Studio.
  • Emacs: Klíčové vazby emulují Bash nebo Emacs.
  • Vi: Klíčové vazby emulují Vi.

Slouží Get-PSReadLineKeyHandler k zobrazení klíčových vazeb pro aktuálně nakonfigurované EditMode.

Typ:EditMode
Position:Named
Default value:Windows
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ExtraPromptLineCount

Určuje počet řádků navíc.

Pokud výzva pokrývá více než jeden řádek, zadejte hodnotu pro tento parametr. Tuto možnost použijte, pokud chcete, aby byly k dispozici další řádky, když PSReadLine zobrazí výzvu po zobrazení nějakého výstupu. Například PSReadLine vrátí seznam dokončení.

Tato možnost je potřebná méně než v předchozích verzích PSReadLine, ale je užitečná při InvokePrompt použití funkce.

Typ:Int32
Position:Named
Default value:0
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HistoryNoDuplicates

Tato možnost řídí chování odvolání. Duplicitní příkazy se stále přidávají do souboru historie. Pokud je tato možnost nastavená, zobrazí se při odvolání příkazů pouze nejnovější vyvolání. Opakované příkazy se přidají do historie, aby se zachovalo pořadí během odvolání. Příkaz ale obvykle nechcete při odvolání nebo prohledávání historie zobrazit několikrát.

Ve výchozím nastavení , HistoryNoDuplicates vlastnost globální PSConsoleReadLineOptions objektu je nastavena na True. Chcete-li změnit hodnotu vlastnosti, je nutné zadat hodnotu SwitchParameter následujícím způsobem: -HistoryNoDuplicates:$False. Můžete se vrátit True zpět pomocí PřepínačeParameter, -HistoryNoDuplicates.

Pomocí následujícího příkazu můžete hodnotu vlastnosti nastavit přímo:

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HistorySavePath

Určuje cestu k souboru, do kterého je uložena historie. Počítače s platformami Windows nebo jiné platformy než Windows ukládají soubor do různých umístění. Název souboru je uložen v proměnné $($Host.Name)_history.txt, například ConsoleHost_history.txt.

Pokud tento parametr nepoužíváte, výchozí cesta je následující:

Windows

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

jiné než Windows

  • $env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
  • $HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt
Typ: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
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HistorySaveStyle

Určuje, jak PSReadLine ukládá historii.

Platné hodnoty jsou následující:

  • SaveIncrementally: Uložte historii po spuštění každého příkazu a sdílení napříč několika instancemi PowerShellu.
  • SaveAtExit: Soubor historie připojení při ukončení PowerShellu
  • SaveNothing: Nepoužívejte soubor historie.

Poznámka:

Pokud nastavíte HistorySaveStyle SaveNothing a pak ji nastavíte na SaveIncrementally později ve stejné relaci, PSReadLine uloží všechny příkazy dříve spuštěné v relaci.

Typ:HistorySaveStyle
Position:Named
Default value:SaveIncrementally
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HistorySearchCaseSensitive

Určuje, že vyhledávání historie v funkcích, jako je ReverseSearchHistory nebo HistorySearchBackward, rozlišují malá a velká písmena.

Ve výchozím nastavení, HistorySearchCaseSensitive vlastnost globální PSConsoleReadLineOptions objektu je nastavena na False. Pomocí tohoto SwitchParameter nastaví hodnotu vlastnosti na True. Chcete-li změnit hodnotu vlastnosti zpět, je nutné zadat hodnotu SwitchParameter následujícím způsobem: -HistorySearchCaseSensitive:$False.

Pomocí následujícího příkazu můžete hodnotu vlastnosti nastavit přímo:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-HistorySearchCursorMovesToEnd

Označuje, že kurzor se přesune na konec příkazů, které načítáte z historie pomocí vyhledávání. Pokud je tento parametr nastavený na $False, kurzor zůstane na pozici, ve které byl při stisknutí šipky nahoru nebo dolů.

Ve výchozím nastavení, HistorySearchCursorMovesToEnd vlastnost globální PSConsoleReadLineOptions objektu je nastavena na False. Pomocí tohoto SwitchParameter nastavte hodnotu vlastnosti na True. Chcete-li změnit hodnotu vlastnosti zpět, je nutné zadat hodnotu SwitchParameter následujícím způsobem: -HistorySearchCursorMovesToEnd:$False.

Pomocí následujícího příkazu můžete hodnotu vlastnosti nastavit přímo:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaximumHistoryCount

Určuje maximální počet příkazů, které se mají uložit v historii PSReadLine .

Historie PSReadLine je oddělená od historie PowerShellu.

Typ:Int32
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-MaximumKillRingCount

Určuje maximální počet položek uložených v okruhu kill.

Typ:Int32
Position:Named
Default value:10
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PredictionSource

Určuje zdroj psReadLine pro získání prediktivních návrhů.

Platné hodnoty jsou:

  • Žádné – zakažte prediktivní funkci IntelliSense (výchozí).
  • Historie – povolte prediktivní funkci IntelliSense a jako jediný zdroj používejte historii PSReadLine.
  • Modul plug-in – povolte prediktivní funkci IntelliSense a jako jediný zdroj používejte moduly plug-in (CommandPrediction). Tato hodnota byla přidána v PSReadLine 2.2.0
  • HistoryAndPlugin – povolte prediktivní funkci IntelliSense a jako zdroje používejte historii i modul plug-in. Tato hodnota byla přidána v PSReadLine 2.2.0
Typ:Microsoft.PowerShell.PredictionSource
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PredictionViewStyle

Nastaví styl zobrazení prediktivního textu. Výchozí hodnota je InlineView.

  • InlineView – styl jako dnes, podobný jako v rybím shellu a zsh. (výchozí)
  • ListView – návrhy se vykreslují v rozevíracím seznamu a uživatelé můžou vybrat pomocí funkce UpArrow a DownArrow.

Tento parametr byl přidán do PSReadLine 2.2.0.

Typ:Microsoft.PowerShell.PredictionViewStyle
Position:Named
Default value:InlineView
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-PromptText

Tento parametr nastaví hodnotu PromptText vlastnost. Výchozí hodnota je "> ".

PSReadLine analyzuje funkci výzvy, aby určila, jak změnit pouze barvu části výzvy. Tato analýza není 100% spolehlivá. Tuto možnost použijte, pokud psReadLine mění výzvu neočekávanými způsoby. Zahrňte všechny koncové prázdné znaky.

Hodnota tohoto parametru může být jeden řetězec nebo pole dvou řetězců. První řetězec je část řetězce výzvy, kterou chcete změnit na červenou, když dojde k chybě analýzy. Druhý řetězec je alternativní řetězec, který se použije, když dojde k chybě analýzy.

Typ:String[]
Position:Named
Default value:>
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ShowToolTips

Při zobrazování možných dokončení se popisy zobrazují v seznamu dokončení.

Tato možnost je ve výchozím nastavení povolená. Tato možnost nebyla ve výchozím nastavení povolena v předchozích verzích PSReadLine. Chcete-li tuto možnost zakázat, nastavte tuto možnost na $Falsehodnotu .

Tento parametr a možnost byly přidány v PSReadLine 2.3.4.

Ve výchozím nastavení je ShowToolTips vlastnost globální PSConsoleReadLineOptions objektu nastavena na True. Pomocí tohoto SwitchParameter nastaví hodnotu vlastnosti na True. Chcete-li změnit hodnotu vlastnosti, je nutné zadat hodnotu SwitchParameter následujícím způsobem: -ShowToolTips:$False.

Pomocí následujícího příkazu můžete hodnotu vlastnosti nastavit přímo:

(Get-PSReadLineOption).ShowToolTips = $False

Typ:SwitchParameter
Position:Named
Default value:True
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-TerminateOrphanedConsoleApps

Tento parametr nastaví možnost TerminateOrphanedConsoleApps na $true.

Když ve Windows stisknete klávesu Ctrl+c a ukončíte proces, každý proces připojený ke konzole obdrží signál ukončení, na rozdíl od aktivního prostředí. Někdy, když prostředí spustilo nějaký velký strom podřízených procesů (představte si například, že systém sestavení) některé procesy mohou ukončit a současně opustit více procesů, které se snaží využívat vstup konzoly.

Při nastavení TerminateOrphanedConsoleApps na $true, PSReadLine zaznamenává seznam procesů, které jsou aktuálně připojeny ke konzole. Po každém spuštění PSReadLine se pak zobrazí nový seznam procesů připojených ke konzole a ukončí ty, které nejsou v původním seznamu.

Tento parametr a možnost byly přidány v PSReadLine 2.3.4.

Typ:SwitchParameter
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ViModeChangeHandler

Pokud je ViModeIndicator nastaven na Script, bude blok skriptu vyvolán při každé změně režimu. Blok skriptu je k dispozici jeden argument typu ViMode.

Tento parametr byl představen v PowerShellu 7.

Typ:ScriptBlock
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ViModeIndicator

Tato možnost nastaví vizuální indikátor pro aktuální režim Vi . Režim vložení nebo režim příkazů.

Platné hodnoty jsou následující:

  • Žádné: Neexistuje žádný indikátor.
  • Výzva: Barva výzvy se změní.
  • Kurzor: Kurzor změní velikost.
  • Skript: Text zadaný uživatelem se vytiskne.
Typ:ViModeStyle
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WordDelimiters

Určuje znaky, které odděluje slova pro funkce, jako je ForwardWord nebo KillWord.

Typ:String
Position:Named
Default value:;:,.[]{}()/\|^&*-=+'"---
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Do této rutiny nemůžete roušit objekty.

Výstupy

None

Tato rutina nevrátí žádný výstup.