Set-PSReadLineOption (PSReadLine)

Set-PSReadLineOption

Modul:

PSReadLine

Testreszabja a parancssori szerkesztés viselkedését a PSReadLine alkalmazásban.

Szintaxis

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

Leírás

A Set-PSReadLineOption parancsmag testreszabja a PSReadLine modul viselkedését a parancssor szerkesztésekor. A PSReadLine beállításainak megtekintéséhez használja a Get-PSReadLineOption parancsot.

A parancs által beállított beállítások csak az aktuális munkamenetre vonatkoznak. A beállítások megőrzéséhez adja hozzá azokat egy profilszkripthez. További információkért lásd a about_Profiles és a shell-környezet testreszabása című részt.

Példák

1. példa: Állítsa be az előtér és a háttér színét

Ez a példa a PSReadLine beállítást úgy állítja be, hogy a Megjegyzés tokent szürke háttéren zöld előtérben jelenítse meg. A példában használt escape szekvenciában a 32 az előtér színét, a 47 pedig a háttérszínt jelöli.

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

Kiválaszthatja, hogy csak az előtér szövegének színét állítsa be. Például egy élénkzöld szövegszín a Megjegyzés tokenhez: "Comment"="`e[92m".

2. példa: Állítsa be a csengő stílusát

Ebben a példában a PSReadLine olyan hibákra vagy feltételekre reagál, amelyek felhasználói figyelmet igényelnek. A BellStyle úgy van beállítva, hogy 1221 Hz-es hangjelzést ad ki 60 ms-ig.

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

3. példa: Állítson be több lehetőséget

A Set-PSReadLineOption több beállítást is beállíthat egy hash táblával.

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

A $PSReadLineOptions hash tábla beállítja a kulcsokat és az értékeket. A Set-PSReadLineOption a @PSReadLineOptions kulcsokat és értékeket használja a PSReadLine beállítások frissítéséhez.

Megtekintheti a kulcsokat és értékeket, ha a PowerShell parancssorában beírja a hash tábla nevét, a $PSReadLineOptions.

4. példa: Állítson be több színbeállítást

Ez a példa bemutatja, hogyan lehet több színértéket beállítani egyetlen parancsban.

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

5. példa: Állítsa be a színértékeket több típushoz

Ez a példa három különböző módszert mutat be a PSReadLine-ben megjelenített tokenek színének beállítására.

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. példa: A ViModeChangeHandler segítségével jelenítse meg a Vi mód változásait

Ez a példa kurzormódosító VT escape-t bocsát ki válaszul a Vi mód megváltoztatására.

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

Az OnViModeChange funkció beállítja a kurzor beállításait a Vi módokhoz: beszúrás és parancs. A ViModeChangeHandler a Function: szolgáltató segítségével hivatkozik az OnViModeChange elemre, mint szkriptblokk objektumra.

További információért lásd: about_Providers.

7. példa: A HistoryHandler segítségével szűrheti az előzményekhez hozzáadott parancsokat

A következő példa bemutatja, hogyan használható az AddToHistoryHandler a git-parancsok előzményekbe mentésének megakadályozására.

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

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

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

A szkriptblokk a $false értéket adja vissza, ha a parancs a git karakterlánccal kezdődött. Ennek ugyanaz a hatása, mint a SkipAdding AddToHistory sor visszaadása. Ha a parancs nem a git karakterlánccal kezdődik, a kezelő a $true értéket adja vissza, és a PSReadLine elmenti a parancsot az előzményekbe.

8. példa: A CommandValidationHandler segítségével érvényesítse a parancsot a végrehajtás előtt

Ez a példa bemutatja, hogyan használható a CommandValidationHandler paraméter egy parancs érvényesítésének futtatásához, mielőtt az végrehajtásra kerülne. A példa kifejezetten ellenőrzi a git parancsot a cmt alparanccsal, és lecseréli a commit teljes névre. Így hozhat létre rövidített álneveket az alparancsokhoz.

# 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. példa: A PromptText paraméter használata

Elemzési hiba esetén a PSReadLine megváltoztatja a piros prompt egy részét. A PromptText paraméter jelzi a PSReadLine-nak, hogy a prompt karakterlánc része piros legyen.

Például a következő példa egy promptot hoz létre, amely tartalmazza az aktuális elérési utat, amelyet a nagyobb, mint karakter (>) és egy szóköz követ.

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

Az első karakterlánc a prompt karakterláncnak az a része, amelyet elemzési hiba esetén pirosra szeretne változtatni. A második karakterlánc egy alternatív karakterlánc, amely elemzési hiba esetén használható.

Paraméterek

-AddToHistoryHandler

Megad egy ScriptBlock-ot, amely szabályozza, hogy a parancsok hogyan kerüljenek a PSReadLine előzményei közé.

A ScriptBlock parancssort kap bemenetként.

A ScripBlock-nak vissza kell adnia az AddToHistoryOption enum egy tagját, az egyik tag karakterláncnevét vagy logikai értéket. Az alábbi lista ismerteti a lehetséges értékeket és azok hatásait.

• MemoryAndFile - Adja hozzá a parancsot az előzményfájlhoz és az aktuális munkamenethez.
• Csak memória - Csak az aktuális munkamenethez adja hozzá a parancsot az előzményekhez.
• SkipAdding - Ne adja hozzá a parancsot az aktuális munkamenet előzményfájljához.
• $false - Ugyanaz, mintha az érték SkipAdding lenne.
• $true - Ugyanaz, mintha az érték MemoryAndFile lenne.

Típus:

Func[System.String,System.Object]

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-AnsiEscapeTimeout

Ez a beállítás a Windowsra jellemző, amikor a bevitel át van irányítva, például amikor a tmux vagy a screen alatt fut.

A Windows átirányított bevitelével sok billentyűt a rendszer az escape karakterrel kezdődő karaktersorozatként küld el. Lehetetlen különbséget tenni egyetlen escape karakter után több karakter és egy érvényes escape szekvencia között.

A feltételezés az, hogy a terminál gyorsabban tudja elküldeni a karaktereket, mint a felhasználó gépel. A PSReadLine megvárja ezt az időtúllépést, mielőtt azt a következtetést vonja le, hogy teljes kilépési szekvenciát kapott.

Ha véletlenszerű vagy váratlan karaktereket lát gépelés közben, módosíthatja ezt az időtúllépést.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

100

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-BellStyle

Meghatározza, hogy a PSReadLine hogyan reagál a különféle hibákra és kétértelmű feltételekre.

Az érvényes értékek a következők:

• Halló: Rövid hangjelzés.
• Vizuális: A szöveg röviden felvillan.
• Nincs: Nincs visszajelzés.

Típus:

BellStyle

Pozíció:

Elnevezett

Alapértelmezett érték:

Hallható

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-Colors

A Colors paraméter a PSReadLine által használt különböző színeket határozza meg.

Az argumentum egy hash tábla, ahol a kulcsok az elemeket, az értékek pedig a színt adják meg. További információért lásd: about_Hash_Tables.

A színek lehetnek a ConsoleColor értékei, például [ConsoleColor]::Red, vagy egy érvényes ANSI escape-szekvencia. Az érvényes escape szekvenciák a termináltól függenek. A PowerShell 5.0-s verziójában a piros szövegre egy példa menekülési sorozat: $ ([char]0x1b)[91m. A PowerShell 6 és újabb verzióiban ugyanaz az escape szekvencia az `e[91m. Megadhat más escape szekvenciákat, beleértve a következő típusokat:

Két színbeállítás került hozzáadásra a ListView testreszabásához a PSReadLine 2.2.0-ban:

• ListPredictionColor - szín beállítása a kezdő > karakterhez és a záró forrásnévhez, például [Előzmények]. Alapértelmezés szerint a DarkYellow színt használja előtérként.

• ListPredictionSelectedColor - állítsa be a színt a listaelem kijelölésének jelzésére. Alapértelmezés szerint a DarkBlack-t használja háttérszínként.

• 256 szín

• 24 bites szín

• Előtér, háttér vagy mindkettő

• Inverz, félkövér

Az ANSI színkódokkal kapcsolatos további információkért tekintse meg a Wikipédia ANSI escape code című cikkét.

Az érvényes kulcsok a következők:

• ContinuationPrompt: A folytatási prompt színe.
• Kiemelés: A kiemelés színe. Például a megfelelő szöveg az előzmények keresése során.
• Hiba: A hiba színe. Például a promptban.
• Kiválasztás: A menüválasztás vagy a kiválasztott szöveg kiemelésére szolgáló szín.
• Alapértelmezett: A token alapértelmezett színe.
• Megjegyzés: A megjegyzés token színe.
• Kulcsszó: A kulcsszótoken színe.
• Karakterlánc: A karakterlánc token színe.
• Operátor: Az operátor token színe.
• Változó: A változó token színe.
• Parancs: A parancstoken színe.
• Paraméter: A paraméter-token színe.
• Típus: A típustoken színe.
• Szám: A számtoken színe.
• Tag: A tagnév-token színe.
• InlinePrediction: A prediktív javaslat szövegközi nézetének színe.
• ListPrediction: A bevezető > karakter és a predikciós forrásnév színe.
• ListPredictionSelected: A kiválasztott előrejelzés színe listanézetben.

Típus:

Hashtable

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-CommandValidationHandler

Megad egy ScriptBlock-ot, amelyet a ValidateAndAcceptLine-ből hívnak meg. Kivétel esetén az érvényesítés meghiúsul, és a hiba bejelentésre kerül.

Mielőtt kivételt dobna, az érvényesítéskezelő a kurzort a hiba helyére helyezheti, hogy megkönnyítse a javítást. Az érvényesítéskezelő módosíthatja a parancssort is a gyakori tipográfiai hibák javítása érdekében.

A ValidateAndAcceptLine segítségével elkerülhető, hogy az előzményeket olyan parancsokkal zsúfolja össze, amelyek nem működnek.

Típus:

Művelet[CommandAst]

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-CompletionQueryItems

Meghatározza a felszólítás nélkül megjelenített befejezett tételek maximális számát.

Ha a megjelenítendő elemek száma nagyobb ennél az értéknél, a PSReadLine rákérdez az igen/nem kérdésre a befejezett elemek megjelenítése előtt.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

100

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-ContinuationPrompt

Megadja a következő sorok elején megjelenő karakterláncot többsoros bevitel esetén. Az alapértelmezés a dupla nagyobb jel (>>). Egy üres karakterlánc érvényes.

Típus:

String

Pozíció:

Elnevezett

Alapértelmezett érték:

>>

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-DingDuration

Megadja a sípolás időtartamát, ha a BellStyle beállítása Audible.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

50 ms

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-DingTone

Hertzben (Hz) adja meg a hangjelzés hangját, ha a BellStyle beállítása Hallható.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

1221

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-EditMode

Meghatározza a parancssori szerkesztési módot. Ennek a paraméternek a használata visszaállítja a Set-PSReadLineKeyHandler által beállított összes kulcs-összerendelést.

Az érvényes értékek a következők:

• Windows: A kulcs-összerendelések a PowerShellt, a cmd-t és a Visual Studio-t emulálják.
• Emacs: A billentyűösszerendelések a Bash vagy az Emacs rendszert emulálják.
• Vi: A kulcs-összerendelések a Vi-t emulálják.

A Get-PSReadLineKeyHandler használatával megtekintheti a jelenleg konfigurált EditMode kulcs-összerendeléseit.

Típus:

EditMode

Pozíció:

Elnevezett

Alapértelmezett érték:

Windows

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-ExtraPromptLineCount

Meghatározza az extra sorok számát.

Ha a prompt egynél több sort ölel fel, adjon meg egy értéket ennek a paraméternek. Használja ezt a beállítást, ha azt szeretné, hogy további sorok álljanak rendelkezésre, amikor a PSReadLine megjeleníti a promptot, miután valamilyen kimenetet mutatott. Például a PSReadLine a befejezések listáját adja vissza.

Erre a lehetőségre kevésbé van szükség, mint a PSReadLine korábbi verzióiban, de hasznos, ha az InvokePrompt funkciót használják.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

0

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-HistoryNoDuplicates

Ez az opció szabályozza a visszahívási viselkedést. A duplikált parancsok továbbra is hozzáadódnak az előzményfájlhoz. Ha ez az opció be van állítva, csak a legutóbbi hívás jelenik meg a parancsok előhívásakor. Az ismétlődő parancsok hozzáadódnak az előzményekhez, hogy megőrizzék a sorrendet a visszahívás során. Általában azonban nem akarja többször látni a parancsot, amikor előhívja vagy keresi az előzményeket.

Alapértelmezés szerint a globális PSConsoleReadLineOptions objektum HistoryNoDuplicates tulajdonsága True értékre van állítva. A tulajdonság értékének módosításához meg kell adnia a SwitchParameter értékét az alábbiak szerint: -HistoryNoDuplicates:$False. Visszaállíthatja az True értéket a SwitchParameter, -HistoryNoDuplicates használatával.

A következő paranccsal közvetlenül beállíthatja a tulajdonság értékét:

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-HistorySavePath

Megadja annak a fájlnak az elérési útját, ahová az előzményeket menti. A Windows vagy nem Windows platformot futtató számítógépek különböző helyeken tárolják a fájlt. A fájlnév a $ ($Host.Name)_history.txt változóban van tárolva, például ConsoleHost_history.txt.

Ha nem használja ezt a paramétert, az alapértelmezett elérési út a következő:

Windows

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

nem Windows

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

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

Típus:

String

Pozíció:

Elnevezett

Alapértelmezett érték:

$ ($Host.Name)_history.txt nevű fájl a $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine fájlban Windows rendszeren és $env:XDG_DATA_HOME/powershell/PSReadLine vagy $HOME/.local/share/powershell/ PSReadLine nem Windows platformokon

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-HistorySaveStyle

Meghatározza, hogy a PSReadLine hogyan mentse az előzményeket.

Az érvényes értékek a következők:

• SaveIncrementally: Az előzmények mentése az egyes parancsok végrehajtása után, és megosztása a PowerShell több példánya között.
• SaveAtExit: Előzményfájl hozzáfűzése, amikor a PowerShell kilép.
• SaveNothing: Ne használjon előzményfájlt.

Típus:

HistorySaveStyle

Pozíció:

Elnevezett

Alapértelmezett érték:

SaveIncrementally

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-HistorySearchCaseSensitive

Megadja, hogy az előzmények keresése megkülönbözteti a kis- és nagybetűket az olyan funkciókban, mint a ReverseSearchHistory vagy a HistorySearchBackward.

Alapértelmezés szerint a globális PSConsoleReadLineOptions objektum HistorySearchCaseSensitive tulajdonsága False értékre van állítva. A SwitchParameter használatával a tulajdonság értékét True értékre állítja. A tulajdonság értékének visszaállításához meg kell adnia a SwitchParameter értékét az alábbiak szerint: -HistorySearchCaseSensitive:$False.

A következő paranccsal közvetlenül beállíthatja a tulajdonság értékét:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-HistorySearchCursorMovesToEnd

Azt jelzi, hogy a kurzor az előzményekből kereséssel betöltött parancsok végére ugrik. Ha ez a paraméter $False értékre van állítva, a kurzor a felfelé vagy lefelé mutató nyilak megnyomásakor volt.

Alapértelmezés szerint a globális PSConsoleReadLineOptions objektum HistorySearchCursorMovesToEnd tulajdonsága False értékre van állítva. Ezzel a SwitchParameterrel állítsa a tulajdonság értékét True értékre. A tulajdonság értékének visszaállításához meg kell adnia a SwitchParameter értékét az alábbiak szerint: -HistorySearchCursorMovesToEnd:$False.

A következő paranccsal közvetlenül beállíthatja a tulajdonság értékét:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

False

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-MaximumHistoryCount

Meghatározza a PSReadLine előzményekbe menthető parancsok maximális számát.

A PSReadLine előzmények elkülönülnek a PowerShell előzményeitől.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-MaximumKillRingCount

Meghatározza a kill ringben tárolt elemek maximális számát.

Típus:

Int32

Pozíció:

Elnevezett

Alapértelmezett érték:

10

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-PredictionSource

Megadja a PSReadLine forrását, hogy prediktív javaslatokat kapjon.

Az érvényes értékek a következők:

• Nincs - tiltsa le a prediktív IntelliSense funkciót (alapértelmezett).
• Előzmények - engedélyezze a prediktív IntelliSense funkciót, és használja a PSReadLine előzményeket egyetlen forrásként.
• Plugin - engedélyezze a prediktív IntelliSense funkciót, és használja a beépülő modulokat (CommandPrediction) egyetlen forrásként. Ez az érték a PSReadLine 2.2.0-ban lett hozzáadva
• HistoryAndPlugin - engedélyezze a prediktív IntelliSense funkciót, és használja az előzményeket és a bővítményt forrásként. Ez az érték a PSReadLine 2.2.0-ban lett hozzáadva

Típus:

Microsoft.PowerShell.PredictionSource

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-PredictionViewStyle

Beállítja a prediktív szöveg megjelenítési stílusát. Az alapértelmezett az InlineView.

• InlineView - a ma létező stílus, hasonlóan a halhéjhoz és a zsh-hez. (alapértelmezett)
• Listanézet - a javaslatok legördülő listában jelennek meg, és a felhasználók a UpArrow és DownArrow segítségével választhatnak.

Ez a paraméter a PSReadLine 2.2.0-ban lett hozzáadva

Típus:

Microsoft.PowerShell.PredictionViewStyle

Pozíció:

Elnevezett

Alapértelmezett érték:

InlineView

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-PromptText

Ez a paraméter a PromptText tulajdonság értékét állítja be. Az alapértelmezett érték a "> ".

A PSReadLine elemzi a prompt funkciót, hogy meghatározza, hogyan módosíthatja csak a prompt egy részének színét. Ez az elemzés nem 100%-ban megbízható. Használja ezt a lehetőséget, ha a PSReadLine váratlan módon módosítja az üzenetet. Tegyen bele minden záró szóközt.

Ennek a paraméternek az értéke lehet egyetlen karakterlánc vagy két karakterláncból álló tömb. Az első karakterlánc a prompt karakterlánc azon része, amelyet elemzési hiba esetén pirosra szeretne változtatni. A második karakterlánc egy alternatív karakterlánc, amely elemzési hiba esetén használható.

Típus:

String[]

Pozíció:

Elnevezett

Alapértelmezett érték:

>

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-ShowToolTips

A lehetséges befejezések megjelenítésekor az eszköztippek megjelennek a befejezések listájában.

Ez az opció alapértelmezés szerint engedélyezve van. Ez a lehetőség alapértelmezés szerint nem volt engedélyezve a PSReadLine korábbi verzióiban. A letiltáshoz állítsa ezt az opciót $False értékre.

Ez a paraméter és az opció a PSReadLine 2.3.4-ben lett hozzáadva.

Alapértelmezés szerint a globális PSConsoleReadLineOptions objektum ShowToolTips tulajdonsága True értékre van állítva. A SwitchParameter használatával a tulajdonság értékét True értékre állítja. A tulajdonság értékének módosításához meg kell adnia a SwitchParameter értékét az alábbiak szerint: -ShowToolTips:$False.

A következő paranccsal közvetlenül beállíthatja a tulajdonság értékét:

(Get-PSReadLineOption).ShowToolTips = $False

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

True

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-TerminateOrphanedConsoleApps

Ez a paraméter a TerminateOrphanedConsoleApps beállítást $true értékre állítja.

Windows rendszeren, amikor lenyomja a Ctrl+c gombot egy folyamat leállításához, a konzolhoz csatolt minden folyamat befejezési jelet kap, nem csak az aktív héjjal. Néha, amikor egy shell elindított egy nagy fát az utódfolyamatokból (képzeljünk el például egy összeállítási rendszert), egyes folyamatok kiléphetnek, így több folyamat egyidejűleg próbálja felhasználni a konzol bemenetét.

Ha a TerminateOrphanedConsoleApps lehetőséget $true értékre állítja, a PSReadLine rögzíti a konzolhoz jelenleg csatolt folyamatok listáját. Ezt követően, amikor a PSReadLine fut, új listát kap a konzolhoz csatolt folyamatokról, és leállítja azokat, amelyek nem szerepelnek az eredeti listában.

Ez a paraméter és az opció a PSReadLine 2.3.4-ben lett hozzáadva.

Típus:

SwitchParameter

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-ViModeChangeHandler

Ha a ViModeIndicator Script értékre van állítva, a rendszer minden módváltáskor meghívja a megadott szkriptblokkot. A szkriptblokk egy ViMode típusú argumentumot tartalmaz.

Ezt a paramétert a PowerShell 7-ben vezették be.

Típus:

ScriptBlock

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-ViModeIndicator

Ez az opció beállítja az aktuális Vi mód vizuális jelzőjét. Vagy beszúrási mód vagy parancs mód.

Az érvényes értékek a következők:

• Nincs: Nincs jelző.
• Prompt: A felszólítás színe megváltozik.
• Kurzor: A kurzor mérete megváltozik.
• Szkript: a felhasználó által megadott szöveg kerül kinyomtatásra.

Típus:

ViModeStyle

Pozíció:

Elnevezett

Alapértelmezett érték:

None

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

-WordDelimiters

Megadja azokat a karaktereket, amelyek elhatárolják a szavakat az olyan funkciókhoz, mint a ForwardWord vagy a KillWord.

Típus:

String

Pozíció:

Elnevezett

Alapértelmezett érték:

;:,.[]{}()/\|^&*-=+'"---

Kívánt:

False

Csővezeték bevitel elfogadása:

False

Helyettesítő karakterek elfogadása:

False

Bemenetek

Nincs

Ehhez a parancsmaghoz nem lehet objektumokat vezetni.

Kimenetek

Nincs

Ez a parancsmag nem ad vissza kimenetet.