about_PSReadLine_Functions

Cikk
10/17/2023

Rövid leírás

A PSReadLine továbbfejlesztett parancssori szerkesztési felületet biztosít a PowerShell-konzolon.

Hosszú leírás

A PowerShell 7.3 a PSReadLine 2.2.6-os csomaggal szállít. Az aktuális verzió a PSReadLine 2.3.4. A PSReadLine jelenlegi verziója telepíthető és használható a Windows PowerShell 5.1-es és újabb verzióiban. Egyes funkciókhoz a PowerShell 7.2-s vagy újabb verzióját kell futtatnia.

Ez a cikk a PSReadLine 2.3.4 által biztosított függvényeket ismerteti. Ezek a függvények billentyűleütésekhez köthetők a könnyű hozzáférés és a meghívás érdekében.

A Microsoft.PowerShell.PSConsoleReadLine osztály használata

Az alábbi függvények a Microsoft.PowerShell.PSConsoleReadLine osztályban érhetők el.

Alapvető szerkesztési függvények

Megszakítás

Megszakítja az aktuális műveletet, például: növekményes előzménykeresés.

Emacs mód: Ctrl+g
Vi beszúrási mód: Ctrl+g
Vi parancs mód: <Ctrl+g>

AcceptAndGetNext

Próbálja meg végrehajtani az aktuális bemenetet. Ha végrehajtható (például AcceptLine), akkor a következő elemet az előzményből a következő alkalommal hívja meg, amikor a ReadLine meghívása történik.

Emacs mód: Ctrl+o

AcceptLine

Próbálja meg végrehajtani az aktuális bemenetet. Ha az aktuális bemenet hiányos (például hiányzik egy záró zárójel, szögletes zárójel vagy idézet), akkor a folytatási kérés megjelenik a következő sorban, és a PSReadLine megvárja, amíg a kulcsok szerkesztik az aktuális bemenetet.

Windows mód: Enter
Emacs mód: Enter
Vi beszúrási mód: Enter

AddLine

A folytatási kérés megjelenik a következő sorban, és a PSReadLine megvárja, amíg a kulcsok szerkesztik az aktuális bemenetet. Ez akkor is hasznos, ha egyetlen parancsként adja meg a többsoros bemenetet, még akkor is, ha egyetlen sor önmagában teljes bemenet.

Windows mód: Shift+Enter
Emacs mód: Shift+Enter
Vi beszúrási mód: Shift+Enter
Vi parancs mód: <Shift+Enter>

BackwardDeleteChar

Törölje a kurzor előtti karaktert.

Windows mód: Backspace, Ctrl+h
Emacs mód: Backspace, , Ctrl+BackspaceCtrl+h
Vi beszúrási mód: Backspace
Vi parancs mód: <X>, <d,h>

BackwardDeleteInput

A BackwardKillInputhoz hasonlóan a szöveg törlése pontról a bemenet elejére, de nem helyezi a törölt szöveget a kill-ringbe.

Windows mód: Ctrl+Home
Vi beszúrási mód: Ctrl+u, Ctrl+Home
Vi parancs mód: <Ctrl+u>, <Ctrl+Home>

BackwardDeleteLine

A BackwardKillLine-hoz hasonlóan a szöveg a ponttól a sor elejéig törlődik, de nem helyezi a törölt szöveget a kill-ringbe.

Vi parancs mód: <d,0>

BackwardDeleteWord

Törli az előző szót.

Vi parancs mód: <Ctrl+w>, <d,b>

BackwardKillInput

Törölje a szöveget a bevitel elejétől a kurzorig. A törölt szöveg a kill-ringbe kerül.

Emacs mód: Ctrl+u, Ctrl+x,Backspace

BackwardKillLine

Törölje a szöveget az aktuális logikai sor elejétől a kurzorig. A törölt szöveg a kill-ringbe kerül.

A függvény kötetlen.

BackwardKillWord

Törölje a bemenetet az aktuális szó elejétől a kurzorig. Ha a kurzor szavak között van, a bemenet az előző szó elejétől a kurzorig törlődik. A törölt szöveg a kill-ringbe kerül.

Windows mód: Ctrl+Backspace, Ctrl+w
Emacs mód: Alt+Backspace, Escape,Backspace
Vi beszúrási mód: Ctrl+Backspace
Vi parancs mód: <Ctrl+Backspace>

BackwardReplaceChar

Lecseréli a kurzor előtti karaktert.

Vi parancs mód: <c,h>

CancelLine

Szakítsa meg az aktuális bemenetet, hagyja a bemenetet a képernyőn, de visszakerül a gazdagépre, így a rendszer újra kiértékeli a kérdést.

Vi beszúrási mód: Ctrl+c
Vi parancs mód: <Ctrl+c>

Nagy kezdőbetű

Hozzáadva a PSReadLine 2.3.0-hoz

A következő szó első karakterét nagybetűssé, a többi karaktert pedig kisbetűssé alakíthatja.

Emacs mód: Alt+c, Escape,c

Másolás

Másolja a kijelölt régiót a rendszer vágólapjára. Ha nincs kijelölve régió, másolja ki a teljes sort.

Windows mód: Ctrl+C

CopyOrCancelLine

Ha a szöveg ki van jelölve, másolja a vágólapra, ellenkező esetben törölje a sort.

Windows mód: Ctrl+c
Emacs mód: Ctrl+c

Kivágás

Törölje a kijelölt régiót, amely törölt szöveget helyez a rendszer vágólapjára.

Windows mód: Ctrl+x

DeleteChar

Törölje a kurzor alatti karaktert.

Windows mód: Delete
Emacs mód: Delete
Vi beszúrási mód: Delete
Vi parancs mód: <Delete>, <x>, <d,l>, <d,Spacebar>

DeleteCharOrExit

Törölje a kurzor alatti karaktert, vagy ha a sor üres, lépjen ki a folyamatból.

Emacs mód: Ctrl+d

DeleteEndOfBuffer

Törli a többsoros puffer végéig.

Vi parancs mód: <d,G>

DeleteEndOfWord

Törlés a szó végéig.

Vi parancs mód: <d,e>

DeleteLine

Törli a többsoros puffer aktuális logikai sorát, és engedélyezi a visszavonást.

Vi parancs mód: <d,d>, <d,_>

DeleteLineToFirstChar

Törli az aktuális logikai sor első nem üres karakterét egy többsoros pufferben.

Vi parancs mód: <d,^>

DeleteNextLines

Törli az aktuális és a következő n logikai sorokat egy többsoros pufferben.

Vi parancs mód: <d,j>

DeletePreviousLines

Törli az előző kért logikai sorokat és az aktuális logikai sort egy többsoros pufferben.

Vi parancs mód: <d,k>

DeleteRelativeLines

Törli a puffer elejétől a többsoros puffer aktuális logikai sorát.

A legtöbb Vi-parancshoz hasonlóan a <d,g,g> parancsot előre fel lehet használni egy numerikus argumentummal, amely egy abszolút sorszámot határoz meg, amely az aktuális sorszámmal együtt a törölni kívánt sortartományt alkotja. Ha nincs megadva, a numerikus argumentum alapértelmezés szerint 1, amely egy többsoros puffer első logikai sorára hivatkozik.

A többsoros sorból törölni kívánt sorok tényleges száma az aktuális logikai sorszám és a megadott numerikus argumentum közötti különbségként van kiszámítva, ami így negatív lehet. Ezért a metódusnév relatív része.

Vi parancs mód: <d,g,g>

DeleteToEnd

Törlés a sor végéig.

Vi parancs mód: <D>, <d,$>

DeleteWord

Törölje a következő szót.

Vi parancs mód: <d,w>

DowncaseWord

Hozzáadva a PSReadLine 2.3.0-hoz

A következő szó átalakítása kisbetűssé.

Emacs mód: Alt+l, Escape,l

ForwardDeleteInput

A KillLine-hoz hasonlóan a szöveg törlése a bemeneti ponttól a végéig, de nem helyezi a törölt szöveget a kill-ringbe.

Windows mód: Ctrl+End
Vi beszúrási mód: Ctrl+End
Vi parancs mód: <Ctrl+End>

ForwardDeleteLine

Törli a szöveget az aktuális logikai sor pontjától végéig, de nem helyezi a törölt szöveget a kill-ringbe.

A függvény kötetlen

InsertLineAbove

Az aktuális vonal felett új üres sor jön létre, függetlenül attól, hogy a kurzor hol található az aktuális sorban. A kurzor az új sor elejére kerül.

Windows mód: Ctrl+Enter

InsertLineBelow

Egy új üres sor jön létre az aktuális vonal alatt, függetlenül attól, hogy a kurzor hol található az aktuális sorban. A kurzor az új sor elejére kerül.

Windows mód: Shift+Ctrl+Enter

InvertCase

Invertálta az aktuális karakter esetét, és lépjen a következőre.

Vi parancs mód: <~>

KillLine

Törölje a bemenetet a kurzortól a bemenet végéig. A törölt szöveg a kill-ringbe kerül.

Emacs mód: Ctrl+k

KillRegion

A kurzor és a jel közötti szöveg megölése.

A függvény kötetlen.

KillWord

Törölje a kurzortól az aktuális szó végéig lévő bemenetet. Ha a kurzor szavak között van, a bevitel a kurzortól a következő szó végéig törlődik. A törölt szöveg a kill-ringbe kerül.

Windows mód: Alt+d, Ctrl+Delete
Emacs mód: Alt+d, Escape,d
Vi beszúrási mód: Ctrl+Delete
Vi parancs mód: <Ctrl+Delete>

Beillesztés

Szöveg beillesztése a rendszer vágólapjáról.

Windows mód: Ctrl+v, Shift+Insert
Vi beszúrási mód: Ctrl+v
Vi parancs mód: <Ctrl+v>

Fontos

A Beillesztés függvény használatakor a vágólap pufferének teljes tartalma beilleszthető a PSReadLine bemeneti pufferébe. A bemeneti puffer ezután át lesz adva a PowerShell-elemzőnek. A konzolalkalmazás jobb gombbal kattintásos beillesztési módszerével beillesztett bemenetet a rendszer egyszerre egy karakterrel másolja a bemeneti pufferbe. A bemeneti puffert a rendszer átadja az elemzőnek egy új vonal karakterének másolásakor. Ezért a bemenetet egyszerre egy sorban elemzi a rendszer. A beillesztési módszerek közötti különbség eltérő végrehajtási viselkedést eredményez.

Beillesztés a továbbiakban

Illessze be a vágólapot a kurzor után, és helyezze a kurzort a beillesztett szöveg végére.

Vi parancs mód:

PasteBefore

Illessze be a vágólapot a kurzor elé, és helyezze a kurzort a beillesztett szöveg végére.

Vi parancs mód:

PrependAndAccept

Előre írja be a "#" karaktert, és fogadja el a vonalat.

Vi parancs mód: <#>

Ismétlés

Visszavonás visszavonása.

Windows mód: Ctrl+y
Vi beszúrási mód: Ctrl+y
Vi parancs mód: <Ctrl+y>

RepeatLastCommand

Ismételje meg az utolsó szövegmódosítást.

Vi parancs mód: <.>

Cserediagram

Cserélje le az aktuális karaktert a következő beírt karakterkészletre.

Vi parancs mód: <c,l>, <c,Spacebar>

ReplaceCharInPlace

Cserélje le az aktuális karaktert csak egy karakterre.

Vi parancs mód: <r>

RevertLine

Visszaállítja az összes bemenetet az aktuális bemenetre.

Windows mód: Escape
Emacs mód: Alt+r, Escape,r

ShellBackwardKillWord

Törölje a bemenetet az aktuális szó elejétől a kurzorig. Ha a kurzor szavak között van, a bemenet az előző szó elejétől a kurzorig törlődik. A törölt szöveg a kill-ringbe kerül.

A függvény kötetlen.

ShellKillWord

A függvény kötetlen.

SwapCharacters

Cserélje le az aktuális karaktert és az előtte lévő karaktert.

Emacs mód: Ctrl+t
Vi beszúrási mód: Ctrl+t
Vi parancs mód: <Ctrl+t>

Visszavonás

Előző szerkesztés visszavonása.

Windows mód: Ctrl+z
Emacs mód: Ctrl+_, Ctrl+x,Ctrl+u
Vi beszúrási mód: Ctrl+z
Vi parancs mód: <Ctrl+z>,

Visszavonásall

A sor összes korábbi szerkesztésének visszavonása.

Vi parancs mód:

UnixWordRubout

Törölje a bemenetet az aktuális szó elejétől a kurzorig. Ha a kurzor szavak között van, a bemenet az előző szó elejétől a kurzorig törlődik. A törölt szöveg a kill-ringbe kerül.

Emacs mód: Ctrl+w

UpcaseWord

Hozzáadva a PSReadLine 2.3.0-hoz

A következő szó átalakítása nagybetűssé.

Emacs mód: Alt+u, Escape,u

ValidateAndAcceptLine

Emacs mód: Ctrl+m

ViAcceptLine

Fogadja el a sort, és váltson Beszúrás módra.

Vi parancs mód: <Enter>

ViAcceptLineOrExit

A DeleteCharOrExithez hasonlóan az Emacs módban is, de a karakter törlése helyett elfogadja a sort.

Vi beszúrási mód: Ctrl+d
Vi parancs mód: <Ctrl+d>

ViAppendLine

A rendszer új sort szúr be az aktuális sor alá.

Vi parancs mód: <o>

ViBackwardDeleteGlob

Törli az előző szót, és csak a szóközt használja elválasztó szóként.

Vi parancs mód: <d,B>

ViBackwardGlob

A kurzort visszalépteti az előző szó elejére, és csak a szóközt használja elválasztóként.

Vi parancs mód:

ViBackwardReplaceGlob

Törölje visszafelé az előző szó elejére, szóközzel elválasztva, és írja be a beszúrási módot.

Vi parancs mód: <c,B>

ViBackwardReplaceLine

Lecseréli a kurzortól balra és az elejéig vezető sort.

Vi parancs mód: <c,0>

ViBackwardReplaceLineToFirstChar

Lecseréli a kurzortól balra lévő sort, és egy karakter ki nem egészét a sor elejére.

Vi parancs mód: <c,^>

ViBackwardReplaceWord

Cserélje le az előző szót.

Vi parancs mód: <c,B>

ViDeleteBrace

Keresse meg a megfelelő zárójelet, zárójelet vagy szögletes zárójelet, és törölje a benne lévő összes tartalmat, beleértve a kapcsos zárójelet is.

Vi parancs mód: <d,%>

ViDeleteEndOfGlob

Törlés a szó végéig.

Vi parancs mód: <d,E>

ViDeleteGlob

Törölje a következő globot (szóközrel tagolt szó).

Vi parancs mód: <d,W>

ViDeleteToBeforeChar

A megadott karakterig törli a elemet.

Vi parancs mód: <d,t>

ViDeleteToBeforeCharBackward

A megadott karakterig törli a elemet.

Vi parancs mód: <d,T>

ViDeleteToChar

A megadott karakterig törli a elemet.

Vi parancs mód: <d,f>

ViDeleteToCharBackward

A megadott karakterig visszafelé töröl.

Vi parancs mód: <d,F>

ViInsertAtBegining

Váltson Beszúrás módra, és helyezze a kurzort a sor elejére.

Vi parancs mód:

ViInsertAtEnd

Váltson Beszúrás módra, és helyezze a kurzort a sor végére.

Vi parancs mód: <A>

ViInsertLine

A rendszer új sort szúr be az aktuális sor fölé.

Vi parancs mód: <O>

ViInsertWithAppend

Hozzáfűzés az aktuális vonal helyzetéből.

Vi parancs mód: <a>

ViInsertWithDelete

Törölje az aktuális karaktert, és váltson Beszúrás módra.

Vi parancs mód: <s>

ViJoinLines

Összekapcsolja az aktuális sort és a következő sort.

Vi parancs mód: <J>

ViReplaceBrace

Cserélje le az összes karaktert az aktuális zárójelkarakterek és az egyező partner között.

Vi parancs mód: <c,%>

ViReplaceEndOfGlob

Törölje a szó végéig, szóközzel elválasztva, és írja be a beszúrási módot.

Vi parancs mód: <c,E>

ViReplaceEndOfWord

Törölje a szó végéig, a szóközök és a közös elválasztójelek szerint, és adja meg a beszúrási módot.

Vi parancs mód: <c,E>

ViReplaceGlob

Törölje a következő szó elejére, szóközzel elválasztva, és írja be a beszúrási módot.

Vi parancs mód: <c,W>

ViReplaceLine

Törölje a teljes parancssort.

Vi parancs mód: <S>, <c,c>

ViReplaceToBeforeChar

Lecseréli a karaktert, amíg meg nem adja a karaktert.

Vi parancs mód: <c,t>

ViReplaceToBeforeCharBackward

Lecseréli a karaktert, amíg meg nem adja a karaktert.

Vi parancs mód: <c,T>

ViReplaceToChar

A megadott karakterig törli a elemet.

Vi parancs mód: <c,f>

ViReplaceToCharBackward

Lecseréli a karaktert, amíg meg nem adja a karaktert.

Vi parancs mód: <c,F>

ViReplaceToEnd

Cserélje le a karaktereket a kurzor pozíciójától a sor végéig.

Vi parancs mód: <c,$>, <C>

ViReplaceUntilEsc

Cserélje le az aktuális karaktert, amíg meg nem adja a feloldójelet, vagy el nem fogadja a vonalat.

Vi parancs mód: <r>

ViReplaceWord

Cserélje le az aktuális szót.

Vi parancs mód: <c,W>

ViYankBeginningOfLine

A puffer elejétől a kurzorig.

Vi parancs mód: <y,0>

ViYankEndOfGlob

A kurzortól a WORD(ek) végéig húzva.

Vi parancs mód: <y,E>

ViYankEndOfWord

A kurzortól a szó(ok) végéig húzva.

Vi parancs mód: <y,e>

ViYankLeft

A kurzortól balra lévő yank karakter(ek)et.

Vi parancs mód: <y,h>

ViYankLine

Rántasd ki a teljes puffert.

Vi parancs mód: <y,y>

ViYankNextGlob

A kurzortól a következő WORD(ek) elejéig húzva.

Vi parancs mód: <y,W>

ViYankNextWord

A kurzor után rajzolja meg a szavakat.

Vi parancs mód: <y,w>

ViYankPercent

Egyező kapcsos kapcsos zárójelhez.

Vi parancs mód: <y,%>

ViYankPreviousGlob

A WORD(ek) kezdetétől a kurzorig.

Vi parancs mód: <y,B>

ViYankPreviousWord

A kurzor előtti szó(ok) húzása.

Vi parancs mód: <y,b>

ViYankRight

A kurzor alatt és a kurzortól jobbra lévő húzásjel(ek)

Vi parancs mód: <y,l>, <y,Spacebar>

ViYankToEndOfLine

A kurzortól a puffer végéig húzva.

Vi parancs mód: <y,$>

ViYankToFirstChar

Az első nem térbeli karaktertől a kurzorig.

Vi parancs mód: <y,^>

Jenki

Adja hozzá a legutóbb megölt szöveget a bemenethez.

Emacs mód: Ctrl+y

YankLastArg

Az előző előzménysor utolsó argumentumának kihúzása. Az argumentum első meghívásakor ugyanúgy viselkedik, mint a YankNthArg. Ha többször is meghívják, akkor az előzményeket végigvezeti, és az arg beállítja az irányt (negatívan megfordítja az irányt.)

Windows mód: Alt+.
Emacs mód: Alt+., Alt+_, Escape,., Escape,_

YankNthArg

Az előző előzménysor első argumentumát (a parancs után) rántassa ki. Egy argumentummal rántasd meg az n. argumentumot (0-tól kezdve), ha az argumentum negatív, akkor az utolsó argumentumtól induljon.

Emacs mód: Ctrl+Alt+y, Escape,Ctrl+y

YankPop

Ha az előző művelet Yank vagy YankPop volt, cserélje le a korábban megrántott szöveget a következő megölt szövegre a kill-ringből.

Emacs mód: Alt+y, Escape,y

Befejezési függvények

Kész

A kurzort körülvevő szöveg kitöltésének megkísérlése. Több lehetséges befejezés esetén a leghosszabb egyértelmű előtagot használja a rendszer a befejezéshez. Ha a leghosszabb egyértelmű befejezést próbálja befejezni, megjelenik a lehetséges befejezések listája.

Emacs mód: Tab

MenuComplete

Windows mód: Ctrl+@, Ctrl+Spacebar
Emacs mód: Ctrl+Spacebar

Lehetséges kiegészítések

A lehetséges befejezések listájának megjelenítése.

Emacs mód: Alt+=
Vi beszúrási mód: Ctrl+Spacebar
Vi parancs mód: <Ctrl+Spacebar>

TabCompleteNext

Próbálja meg befejezni a kurzort körülvevő szöveget a következő elérhető befejezéssel.

Windows mód: Tab
Vi parancs mód: <Tab>

TabCompletePrevious

Próbálja meg befejezni a kurzort körülvevő szöveget az előző elérhető befejezéssel.

Windows mód: Shift+Tab
Vi parancs mód: <Shift+Tab>

ViTabCompleteNext

Ha szükséges, befejezi az aktuális szerkesztési csoportot, és meghívja a TabCompleteNext parancsot.

Vi beszúrási mód: Tab

ViTabCompletePrevious

Ha szükséges, befejezi az aktuális szerkesztési csoportot, és meghívja a TabCompletePrevious parancsot.

Vi beszúrási mód: Shift+Tab

Kurzormozgatási függvények

Visszamenőleges feltöltő

Vigye a kurzort egy karakterre balra. Ez áthelyezheti a kurzort a többsoros bemenet előző sorára.

Windows mód: LeftArrow
Emacs mód: LeftArrow, Ctrl+b

Visszatekintőszó

Vigye vissza a kurzort az aktuális szó elejére, vagy ha a szavak között az előző szó elejére. A Word határait konfigurálható karakterkészlet határozza meg.

Windows mód: Ctrl+LeftArrow
Emacs mód: Alt+b, Escape,b
Vi beszúrási mód: Ctrl+LeftArrow
Vi parancs mód: <Ctrl+LeftArrow>

A szavak határait meghatározó karakterek a PSConsoleReadLineOptions objektum WordDelimiters tulajdonságában vannak konfigurálva. A WordDelimiters tulajdonság megtekintéséhez vagy módosításához lásd: Get-PSReadLineOption és Set-PSReadLineOption.

BeginningOfLine

Ha a bemenet több sorból áll, lépjen az aktuális sor elejére, vagy ha már a sor elején van, lépjen a bemenet elejére. Ha a bemenetnek egyetlen sora van, lépjen a bemenet elejére.

Windows mód: Home
Emacs mód: Home, Ctrl+a
Vi beszúrási mód: Home
Vi parancs mód: <Home>

EndOfLine

Ha a bemenet több vonallal rendelkezik, lépjen az aktuális sor végére, vagy ha már a sor végén, lépjen a bemenet végére. Ha a bemenetnek egyetlen sora van, lépjen a bemenet végére.

Windows mód: End
Emacs mód: End, Ctrl+e
Vi beszúrási mód: End

ForwardChar

Vigye a kurzort jobbra egy karakterre. Ez áthelyezheti a kurzort a többsoros bemenet következő sorára.

Windows mód: RightArrow
Emacs mód: RightArrow, Ctrl+f

ForwardWord

Vigye a kurzort az aktuális szó végére, vagy ha szavak között, a következő szó végére. A Word határait konfigurálható karakterkészlet határozza meg.

Emacs mód: Alt+f, Escape,f

GotoBrace

Lépjen a megfelelő zárójelre, zárójelre vagy szögletes zárójelre.

Windows mód: Ctrl+]
Vi beszúrási mód: Ctrl+]
Vi parancs mód: <Ctrl+]>

GotoColumn

Ugrás az arg által jelzett oszlopra.

Vi parancs mód: <|>

GotoFirstNonBlankOfLine

Vigye a kurzort a sor első nem üres karakterére.

Vi parancs mód: <^>, <_>

MoveToEndOfLine

Vigye a kurzort a bemenet végére.

Vi parancs mód: <End>, <$>

MoveToFirstLine

Ugrás egy többsoros parancs első sorára.

Vi parancs mód: <g,g>

MoveToLastLine

Ugrás egy többsoros parancs utolsó sorára.

Vi parancs mód: <G>

NextLine

Vigye a kurzort a következő sorba.

A függvény kötetlen.

NextWord

Vigye a kurzort előre a következő szó elejére. A Word határait konfigurálható karakterkészlet határozza meg.

Windows mód: Ctrl+RightArrow
Vi beszúrási mód: Ctrl+RightArrow
Vi parancs mód: <Ctrl+RightArrow>

NextWordEnd

Vigye a kurzort az aktuális szó végére, vagy ha szavak között, a következő szó végére. A Word határait konfigurálható karakterkészlet határozza meg.

Vi parancs mód: <e>

Előző vonal

Vigye a kurzort az előző sorba.

A függvény kötetlen.

ShellBackwardWord

Vigye vissza a kurzort az aktuális szó elejére, vagy ha a szavak között az előző szó elejére. A Word határait PowerShell-jogkivonatok határozzák meg.

A függvény kötetlen.

ShellForwardWord

Vigye a kurzort előre a következő szó elejére. A Word határait PowerShell-jogkivonatok határozzák meg.

A függvény kötetlen.

ShellNextWord

Vigye a kurzort az aktuális szó végére, vagy ha szavak között, a következő szó végére. A Word határait PowerShell-jogkivonatok határozzák meg.

A függvény kötetlen.

ViBackwardChar

Vigye a kurzort egy karaktert balra a Vi szerkesztési módban. Ez áthelyezheti a kurzort a többsoros bemenet előző sorára.

Vi beszúrási mód: LeftArrow
Vi parancs mód: <LeftArrow>, , <Backspace><h>

ViBackwardWord

Vigye vissza a kurzort az aktuális szó elejére, vagy ha a szavak között az előző szó elejére. A Word határait konfigurálható karakterkészlet határozza meg.

Vi parancs mód:

ViEndOfGlob

Vigye a kurzort a szó végére, a szóközzel elválasztva.

Vi parancs mód: <E>

ViEndOfPreviousGlob

Az előző szó végére lép, és csak a szóközt használja szóelválasztóként.

A függvény kötetlen.

ViForwardChar

Vigye a kurzort egy karakterre jobbra a Vi szerkesztési módban. Ez áthelyezheti a kurzort a többsoros bemenet következő sorára.

Vi beszúrási mód: RightArrow
Vi parancs mód: <RightArrow>, , <Spacebar><l>

ViGotoBrace

Hasonló a GotoBrace-hez, de tokenalapú helyett karakteralapú.

Vi parancs mód: <%>

ViNextGlob

A következő szóra lép, és csak a szóközt használja szóelválasztóként.

Vi parancs mód: <W>

ViNextWord

Vigye a kurzort előre a következő szó elejére. A Word határait konfigurálható karakterkészlet határozza meg.

Vi parancs mód: <w>

Előzményfüggvények

BeginningOfHistory

Ugrás az előzmények első elemére.

Emacs mód: Alt+<

ClearHistory

Törli az előzményeket a PSReadLine-ban. Ez nem befolyásolja a PowerShell előzményeit.

Windows mód: Alt+F7

EndOfHistory

Ugrás az előzmények utolsó elemére (az aktuális bemenetre).

Emacs mód: Alt+>

ForwardSearchHistory

Növekményes előrekeresés végrehajtása az előzmények között.

Windows mód: Ctrl+s
Emacs mód: Ctrl+s
Vi beszúrási mód: Ctrl+s
Vi parancs mód: <Ctrl+s>

HistorySearchBackward

Cserélje le az aktuális bemenetet a PSReadLine előzményeinek "előző" elemére, amely megfelel a kezdő és a bemenet és a kurzor közötti karaktereknek.

Windows mód: F8

HistorySearchForward

Cserélje le az aktuális bemenetet a PSReadLine előzményeinek következő elemére, amely megfelel a kezdő és a bemenet és a kurzor közötti karaktereknek.

Windows mód: Shift+F8

NextHistory

Cserélje le az aktuális bemenetet a PSReadLine előzményeinek következő elemére.

Windows mód: DownArrow
Emacs mód: DownArrow, Ctrl+n
Vi beszúrási mód: DownArrow
Vi parancs mód: <DownArrow>, , <j><+>

PreviousHistory

Cserélje le az aktuális bemenetet a PSReadLine előzményeinek "előző" elemére.

Windows mód: UpArrow
Emacs mód: UpArrow, Ctrl+p
Vi beszúrási mód: UpArrow
Vi parancs mód: <UpArrow>, , <k><->

ReverseSearchHistory

Növekményes visszamenőleges keresést hajt végre az előzmények között.

Windows mód: Ctrl+r
Emacs mód: Ctrl+r
Vi beszúrási mód: Ctrl+r
Vi parancs mód: <Ctrl+r>

ViSearchHistoryBackward

Keresési sztringet kér, és keresést kezdeményez az AcceptLine-ra.

Vi parancs mód: </>

Egyéb függvények

CaptureScreen

Interaktív képernyőrögzítés indítása – felfelé/lefelé mutató nyilak kijelölik a vonalakat, szövegként és HTML-fájlként beírják a vágólapra kijelölt szöveget.

A függvény kötetlen.

ClearScreen

Törölje a képernyőt, és rajzolja meg az aktuális sort a képernyő tetején.

Windows mód: Ctrl+l
Emacs mód: Ctrl+l
Vi beszúrási mód: Ctrl+l
Vi parancs mód: <Ctrl+l>

DigitArgument

Új számjegy argumentum indítása más függvények számára való továbbításhoz. Ezt használhatja szorzóként a következő függvényhez, amelyet egy billentyűnyomás hív meg. A billentyű lenyomásával <Alt+1><Alt+0> például a számjegy-argumentum értéke 10 lesz. Ezután a # billentyű lenyomásával 10 # karaktert (##########) küld a bemeneti sorba. Hasonlóképpen használhatja ezt más műveletekkel is, például <Delete> vagy Left-Arrow.

Windows mód: Alt+0, Alt+1, Alt+2, Alt+3Alt+4, Alt+5, Alt+6, Alt+7, Alt+8, , Alt+9,Alt+-
Emacs mód: Alt+0, Alt+1, Alt+2, Alt+3, Alt+4, Alt+5Alt+6, Alt+7, Alt+8, , Alt+9,Alt+-
Vi parancsmód: <0>, <1>, <2>, <3>, <4>, <5><6>, <7>, , , <8><9>

InvokePrompt

Törli az aktuális kérést, és meghívja a parancssori függvényt, hogy visszajátssza a kérést. Az állapotot módosító egyéni kulcskezelők számára hasznos. Módosítsa például az aktuális könyvtárat.

A függvény kötetlen.

ScrollDisplayDown

Görgessen le egy képernyővel lejjebb.

Windows mód: PageDown
Emacs mód: PageDown

ScrollDisplayDownLine

Görgessen le egy sort a kijelzőn.

Windows mód: Ctrl+PageDown
Emacs mód: Ctrl+PageDown

ScrollDisplayToCursor

Görgessen a képernyőt a kurzorhoz.

Emacs mód: Ctrl+End

ScrollDisplayTop

Görgessen a képernyő tetejére.

Emacs mód: Ctrl+Home

ScrollDisplayUp

Görgessen fel egy képernyővel feljebb.

Windows mód: PageUp
Emacs mód: PageUp

ScrollDisplayUpLine

Görgessen fel egy sorra a megjelenítéshez.

Windows mód: Ctrl+PageUp
Emacs mód: Ctrl+PageUp

ShowCommandHelp

A teljes parancsmag súgóját jeleníti meg. Ha a kurzor egy teljesen kibontott paraméter végén van, a <F1> kulcspozíciók lenyomása a súgó megjelenítéséhez a paraméter helyén történik.

A súgó egy másik képernyőpufferen jelenik meg a Microsoft.PowerShell.Pager pager használatával. Amikor kilép a lapozóból, a rendszer az eredeti képernyő eredeti kurzorpozíciójára tér vissza. Ez a lapozó csak modern terminálalkalmazásokban, például a Windows Terminalban működik.

Windows mód: F1
Emacs mód: F1
Vi beszúrási mód: F1
Vi parancs mód: <F1>

ShowKeyBindings

Az összes kötött kulcs megjelenítése.

Windows mód: Ctrl+Alt+?
Emacs mód: Ctrl+Alt+?
Vi beszúrási mód: Ctrl+Alt+?

ShowParameterHelp

Dinamikus segítséget nyújt a paraméterekhez úgy, hogy az aktuális parancssor alatt jelenik meg, például MenuComplete. A kurzornak a teljes mértékben kibontott paraméternév végén kell lennie, amikor lenyomja a <Alt+h> billentyűt.

Windows mód: Alt+h
Emacs mód: Alt+h
Vi beszúrási mód: Alt+h
Vi parancs mód: <Alt+h>

ViCommandMode

Váltson az aktuális működési módra a Vi-Insert-ről a Vi-Command parancsra.

Vi beszúrási mód: Escape

ViDigitArgumentInChord

Indítson el egy új számjegyargumentumot, amely más függvényeknek a vi valamelyik akkordjában ad át.

A függvény kötetlen.

ViEditVisually

Szerkessze a parancssort egy szövegszerkesztőben, amelyet $env:EDITOR az or $env:VISUAL.

Emacs mód: Ctrl+x,Ctrl+e
Vi parancs mód: <v>

ViExit

Kilép a rendszerhéjból.

A függvény kötetlen.

ViInsertMode

Váltson beszúrási módra.

Vi parancs mód:

WhatIsKey

Olvassa el a kulcsot, és mondja el, mihez van kötve a kulcs.

Windows mód: Alt+?
Emacs mód: Alt+?

Előrejelzési függvények

AcceptNextSuggestionWord

Fogadja el a beágyazott vagy a kijelölt javaslat következő szavát

A függvény kötetlen.

AcceptSuggestion

Ha nézetstílusként használja InlineView az előrejelzést, fogadja el az aktuális beágyazott javaslatot.

A függvény kötetlen.

NextSuggestion

Ha nézetstílusként használja ListView az előrejelzést, keresse meg a következő javaslatot a listában.

A függvény kötetlen.

PreviousSuggestion

Ha nézetstílusként használja ListView az előrejelzést, keresse meg a lista előző javaslatát.

A függvény kötetlen.

ShowFullPredictionTooltip

Az aktuálisan kijelölt listaelem elemleírásának megjelenítése a teljes nézetben.

Windows mód: F4
Emacs mód: F4
Vi beszúrási mód: F4

SwitchPredictionView

Állítsa be a nézetstílust az előrejelzéshez az és ListViewa közöttInlineView.

Windows mód: F2
Emacs mód: F2
Vi beszúrási mód: F2

Search függvények

CharacterSearch

Olvassa el a karaktert, és keresse meg a karakter következő előfordulását. Ha argumentum van megadva, keressen előre (vagy vissza, ha negatív) az n. előfordulásra.

Windows mód: F3
Emacs mód: Ctrl+]
Vi beszúrási mód: F3
Vi parancs mód: <F3>

CharacterSearchBackward

Olvasson fel egy karaktert, és keressen visszafelé a karakter következő előfordulására. Ha argumentum van megadva, keressen visszafelé (vagy előre, ha negatív) az n. előfordulásra.

Windows mód: Shift+F3
Emacs mód: Ctrl+Alt+]
Vi beszúrási mód: Shift+F3
Vi parancs mód: <Shift+F3>

RepeatLastCharSearch

Ismételje meg az utolsó rögzített karakterkeresést.

Vi parancs mód: <;>

RepeatLastCharSearchBackwards

Ismételje meg az utolsó rögzített karakterkeresést, de ellenkező irányban.

Vi parancs mód: <,>

RepeatSearch

Ismételje meg az utolsó keresést a korábbiakhoz hasonló irányban.

Vi parancs mód: <n>

RepeatSearchBackward

Ismételje meg az utolsó keresést a korábbiakhoz hasonló irányban.

Vi parancs mód: <N>

Keresési díj

Olvassa el a következő karaktert, majd keresse meg, továbblépve.

Vi parancs mód: <f>

SearchCharBackward

Olvassa el a következő karaktert, majd keresse meg visszafelé.

Vi parancs mód: <F>

SearchCharBackwardWithBackoff

Olvassa el a következő karaktert, majd keresse meg, lépjen vissza, majd lépjen vissza egy karakterből.

Vi parancs mód: <T>

SearchCharWithBackoff

Olvassa el a következő karaktert, majd keresse meg, haladjon előre, majd lépjen vissza egy karakterből.

Vi parancs mód: <t>

SearchForward

Keresési sztringet kér, és keresést kezdeményez az AcceptLine-ra.

Vi parancs mód: <?>

Kijelölési függvények

ExchangePointAndMark

A kurzor a jel helyére kerül, és a kurzor helyére kerül.

Emacs mód: Ctrl+x,Ctrl+x

SelectAll

Jelölje ki a teljes sort.

Windows mód: Ctrl+a

SelectBackwardChar

Módosítsa az aktuális kijelölést úgy, hogy az az előző karaktert is tartalmazza.

Windows mód: Shift+LeftArrow
Emacs mód: Shift+LeftArrow

SelectBackwardsLine

Állítsa be az aktuális kijelölést úgy, hogy a kurzortól a sor elejéig szerepeljen.

Windows mód: Shift+Home
Emacs mód: Shift+Home

SelectBackwardWord

Módosítsa az aktuális kijelölést úgy, hogy az az előző szót is tartalmazza.

Windows mód: Shift+Ctrl+LeftArrow
Emacs mód: Alt+B

SelectCommandArgument

A parancsargumentumok vizuális kijelölése. Az argumentumok kijelölése hatóköre egy szkriptblokkon belül van. A kurzor pozíciója alapján a legbelső szkriptblokktól a legszélső szkriptblokkig keres, és leáll, amikor egy szkriptblokk hatókörében található argumentumokat talál.

Ez a függvény a DigitArgument függvényt tiszteli. A pozitív vagy negatív argumentumértékeket az aktuálisan kijelölt argumentumból, illetve az aktuális kurzor pozíciójából származó előre vagy hátra eltolásként kezeli, ha nincs kijelölve argumentum.

Windows mód: Alt+a
Emacs mód: Alt+a

SelectForwardChar

Módosítsa az aktuális kijelölést úgy, hogy a következő karaktert is tartalmazza.

Windows mód: Shift+RightArrow
Emacs mód: Shift+RightArrow

SelectForwardWord

Állítsa be az aktuális kijelölést úgy, hogy a Következő szó szerepeljen a ForwardWord használatával.

Emacs mód: Alt+F

SelectLine

Állítsa be az aktuális kijelölést úgy, hogy a kurzortól a sor végéig szerepeljen.

Windows mód: Shift+End
Emacs mód: Shift+End

SelectNextWord

Módosítsa az aktuális kijelölést úgy, hogy a következő szót is belefoglalja.

Windows mód: Shift+Ctrl+RightArrow

SelectShellBackwardWord

Módosítsa az aktuális kijelölést úgy, hogy az tartalmazza az előző szót a ShellBackwardWord használatával.

A függvény kötetlen.

SelectShellForwardWord

Módosítsa az aktuális kijelölést úgy, hogy belefoglalja a következő szót a ShellForwardWord használatával.

A függvény kötetlen.

SelectShellNextWord

Módosítsa az aktuális kijelölést úgy, hogy a következő szót is belefoglalja a ShellNextWord használatával.

A függvény kötetlen.

Beállításjel

Jelölje meg a kurzor aktuális helyét egy későbbi szerkesztési parancsban való használatra.

Emacs mód: Ctrl+@

Egyéni kulcskötés támogatási API-k

Az alábbi függvények nyilvánosak a Microsoft.PowerShell.PSConsoleReadLine-ban, de nem lehet közvetlenül kulcshoz kötni. A legtöbb hasznos az egyéni kulcskötésekben.

void AddToHistory(string command)

Adjon hozzá egy parancssort az előzményekhez anélkül, hogy végrehajtanák.

void ClearKillRing()

Ürítse ki a gyűrűt. Ezt többnyire teszteléshez használják.

void Delete(int start, int length)

A hosszkarakterek törlése az elejétől kezdve. Ez a művelet támogatja a visszavonást/ismétlést.

void Ding()

Hajtsa végre a Ding-műveletet a felhasználó preferenciája alapján.

void GetBufferState([ref] string input, [ref] int cursor)
void GetBufferState([ref] Ast ast, [ref] Token[] tokens,
  [ref] ParseError[] parseErrors, [ref] int cursor)

Ez a két függvény hasznos információkat kér le a bemeneti puffer aktuális állapotáról. Az elsőt gyakrabban használják egyszerű esetekben. A másodikat akkor használja a rendszer, ha a kötés valami fejlettebbet tesz az Asttel.

IEnumerable[Microsoft.PowerShell.KeyHandler]
  GetKeyHandlers(bool includeBound, bool includeUnbound)

IEnumerable[Microsoft.PowerShell.KeyHandler]
  GetKeyHandlers(string[] Chord)

Ezt a két függvényt használja a Get-PSReadLineKeyHandlerrendszer. Az első az összes kulcskötés lekérésére szolgál. A második az adott kulcskötések lekérésére szolgál.

Microsoft.PowerShell.PSConsoleReadLineOptions GetOptions()

Ezt a függvényt a Get-PSReadLineOption használja, és valószínűleg nem túl hasznos egyéni kulcskötésekben.

void GetSelectionState([ref] int start, [ref] int length)

Ha nincs kijelölés a parancssorban, a függvény -1 értéket ad vissza mind a kezdő, mind a hossz tekintetében. Ha a parancssorban van egy kijelölés, a rendszer visszaadja a kijelölés kezdetét és hosszát.

void Insert(char c)
void Insert(string s)

Szúrjon be egy karaktert vagy sztringet a kurzorhoz. Ez a művelet támogatja a visszavonást/ismétlést.

string ReadLine(runspace remoteRunspace,
  System.Management.Automation.EngineIntrinsics engineIntrinsics)

Ez a PSReadLine fő belépési pontja. Nem támogatja a rekurziót, ezért nem hasznos egyéni kulcskötésekben.

void RemoveKeyHandler(string[] key)

Ezt a függvényt a Remove-PSReadLineKeyHandler használja, és valószínűleg nem túl hasznos egyéni kulcskötésekben.

void Replace(int start, int length, string replacement)

Cserélje le a bemenetet. Ez a művelet támogatja a visszavonást/ismétlést. Ez előnyben részesíti a Törlés és a Beszúrás parancsot, mivel a visszavonás egyetlen műveletként van kezelve.

void SetCursorPosition(int cursor)

Vigye a kurzort a megadott eltolásra. A kurzor mozgása nincs nyomon követve a visszavonáshoz.

void SetOptions(Microsoft.PowerShell.SetPSReadLineOption options)

Ez a függvény egy segédmetódus, amelyet a parancsmag Set-PSReadLineOptionhasznál, de hasznos lehet egy egyéni kulcskötésnél, amely ideiglenesen módosítani szeretne egy beállítást.

bool TryGetArgAsInt(System.Object arg, [ref] int numericArg,
  int defaultNumericArg)

Ez a segédmetódus a DigitArgumentnek eleget tevő egyéni kötésekhez használható. Egy tipikus hívás a következőképpen néz ki:

[int]$numericArg = 0
[Microsoft.PowerShell.PSConsoleReadLine]::TryGetArgAsInt($arg,
  [ref]$numericArg, 1)

Jegyzetek

Az OnIdle-esemény viselkedése

Ha a PSReadLine használatban van, az OnIdle esemény akkor aktiválódik, amikor ReadKey() túllépi az időkorlátot (nincs gépelés 300 ms-ben). Az esemény jelezhető, miközben a felhasználó a parancssor szerkesztésének közepén van, például a felhasználó súgót olvas a használni kívánt paraméter kiválasztásához.

A PSReadLine 2.2.0-beta4 verziótól kezdve az OnIdle viselkedése úgy változott, hogy csak időtúllépés esetén ReadKey() jelezzen az eseményt, és az aktuális szerkesztőpuffer üres.

Kapcsolódó információk

about_PSReadLine