Set-PSReadLineOption
Passt das Verhalten der Befehlszeilenbearbeitung in PSReadLine an.
Syntax
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>]
Beschreibung
Das Set-PSReadLineOption
Cmdlet passt das Verhalten des PSReadLine-Moduls beim Bearbeiten der Befehlszeile an. Verwenden Sie Get-PSReadLineOption
zum Anzeigen der PSReadLine-Einstellungen .
Die von diesem Befehl festgelegten Optionen gelten nur für die aktuelle Sitzung. Um optionen beizubehalten, fügen Sie sie einem Profilskript hinzu. Weitere Informationen finden Sie unter about_Profiles und Anpassen der Shellumgebung.
Beispiele
Beispiel 1: Festlegen von Vordergrund- und Hintergrundfarben
In diesem Beispiel wird PSReadLine so festgelegt, dass das Kommentartoken mit grünem Vordergrundtext auf einem grauen Hintergrund angezeigt wird. In der im Beispiel verwendeten Escapesequenz stellt 32 die Vordergrundfarbe dar und 47 die Hintergrundfarbe.
Set-PSReadLineOption -Colors @{ "Comment"="`e[32;47m" }
Sie können festlegen, dass nur eine Vordergrundtextfarbe festgelegt werden soll. Beispiel: eine hellgrüne Vordergrundtextfarbe für das Kommentartoken : "Comment"="`e[92m"
.
Beispiel 2: Festlegen des Glockenstils
In diesem Beispiel reagiert PSReadLine auf Fehler oder Bedingungen, die die Aufmerksamkeit des Benutzers erfordern. Der BellStyle wird so eingestellt, dass bei 1221 Hz für 60 ms ein hörbarer Signalton ausgegeben wird.
Set-PSReadLineOption -BellStyle Audible -DingTone 1221 -DingDuration 60
Hinweis
Dieses Feature funktioniert möglicherweise nicht auf allen Hosts auf Plattformen.
Beispiel 3: Festlegen mehrerer Optionen
Set-PSReadLineOption
kann mehrere Optionen mit einer Hashtabelle festlegen.
$PSReadLineOptions = @{
EditMode = "Emacs"
HistoryNoDuplicates = $true
HistorySearchCursorMovesToEnd = $true
Colors = @{
"Command" = "#8181f7"
}
}
Set-PSReadLineOption @PSReadLineOptions
Die $PSReadLineOptions
Hashtabelle legt die Schlüssel und Werte fest. Set-PSReadLineOption
verwendet die Schlüssel und Werte zum @PSReadLineOptions
Aktualisieren der PSReadLine-Optionen .
Sie können die Schlüssel und Werte, die den Namen der Hashtabelle eingeben, $PSReadLineOptions
in der PowerShell-Befehlszeile anzeigen.
Beispiel 4: Festlegen mehrerer Farboptionen
In diesem Beispiel wird gezeigt, wie Sie mehrere Farbwerte in einem einzigen Befehl festlegen.
Set-PSReadLineOption -Colors @{
Command = 'Magenta'
Number = 'DarkGray'
Member = 'DarkGray'
Operator = 'DarkGray'
Type = 'DarkGray'
Variable = 'DarkGreen'
Parameter = 'DarkGreen'
ContinuationPrompt = 'DarkGray'
Default = 'DarkGray'
}
Beispiel 5: Festlegen von Farbwerten für mehrere Typen
Dieses Beispiel zeigt drei verschiedene Methoden zum Festlegen der Farbe von Token, die in PSReadLine angezeigt werden.
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"
}
Beispiel 6: Verwenden von ViModeChangeHandler zum Anzeigen von Vi-Modusänderungen
In diesem Beispiel wird ein Cursoränderungs-VT-Escape als Reaktion auf eine Änderung des Vi-Modus ausgegeben.
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
Die OnViModeChange-Funktion legt die Cursoroptionen für die Vi-Modi fest: Einfügen und Befehl.
ViModeChangeHandler verwendet den Function:
Anbieter, um auf OnViModeChange als Skriptblockobjekt zu verweisen.
Weitere Informationen finden Sie unter about_Providers.
Beispiel 7: Verwenden des Verlaufshandlers zum Filtern von Befehlen, die dem Verlauf hinzugefügt wurden
Das folgende Beispiel zeigt, wie Sie das AddToHistoryHandler
Speichern von Git-Befehlen im Verlauf verhindern.
$ScriptBlock = {
Param([string]$line)
if ($line -match "^git") {
return $false
} else {
return $true
}
}
Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock
Der Scriptblock gibt zurück $false
, wenn der Befehl mit git
. Dies hat die gleiche Wirkung wie das Zurückgeben der SkipAdding
AddToHistory-Enumeration . Wenn der Befehl nicht beginnt git
, gibt der Handler den Befehl zurück $true
und PSReadLine speichert den Befehl im Verlauf.
Beispiel 8: Verwenden von CommandValidationHandler zum Überprüfen eines Befehls vor der Ausführung
In diesem Beispiel wird gezeigt, wie Sie den CommandValidationHandler-Parameter verwenden, um einen Überprüfungsbefehl auszuführen, bevor er ausgeführt wird. Im Beispiel wird speziell nach dem Befehl git
mit dem Unterbefehl cmt
gesucht und durch den vollständigen Namen commit
ersetzt. Auf diese Weise können Sie Kurzhandalias für Unterbefehle erstellen.
# 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
Beispiel 9: Verwenden des PromptText-Parameters
Wenn ein Analysefehler auftritt, ändert PSReadLine einen Teil der Eingabeaufforderung rot. Der PromptText-Parameter weist PSReadLine den Teil der Aufforderungszeichenfolge an, rot zu machen.
Im folgenden Beispiel wird beispielsweise eine Eingabeaufforderung erstellt, die den aktuellen Pfad enthält, gefolgt von dem Größer-als-Zeichen (>
) und einem Leerzeichen.
function prompt { "PS $pwd> " }`
Set-PSReadLineOption -PromptText '> ' # change the '>' character red
Set-PSReadLineOption -PromptText '> ', 'X ' # replace the '>' character with a red 'X'
Die erste Zeichenfolge ist der Teil der Eingabeaufforderungszeichenfolge, den Sie rot machen möchten, wenn ein Analysefehler auftritt. Die zweite Zeichenfolge ist eine alternative Zeichenfolge, die verwendet werden soll, wenn ein Analysefehler auftritt.
Parameter
-AddToHistoryHandler
Gibt einen ScriptBlock an, der steuert, wie Befehle zum PSReadLine-Verlauf hinzugefügt werden.
ScriptBlock empfängt die Befehlszeile als Eingabe.
ScripBlock sollte ein Element der AddToHistoryOption-Enumeration, den Zeichenfolgennamen eines dieser Member oder einen booleschen Wert zurückgeben. In der folgenden Liste werden die möglichen Werte und deren Auswirkungen beschrieben.
MemoryAndFile
– Fügen Sie den Befehl der Verlaufsdatei und der aktuellen Sitzung hinzu.MemoryOnly
– Fügen Sie den Befehl nur für die aktuelle Sitzung zum Verlauf hinzu.SkipAdding
– Fügen Sie den Befehl nicht zur Verlaufsdatei für die aktuelle Sitzung hinzu.$false
- Identisch mit der Angabe des WertsSkipAdding
.$true
- Identisch mit der Angabe des WertsMemoryAndFile
.
Type: | Func<T,TResult>[System.String,System.Object] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AnsiEscapeTimeout
Diese Option ist spezifisch für Windows, wenn die Eingabe umgeleitet wird, z. B. bei Ausführung unter tmux
oder screen
.
Bei umgeleiteten Eingaben unter Windows werden viele Tasten als Abfolge von Zeichen gesendet, die mit dem Escapezeichen beginnen. Es ist unmöglich, zwischen einem einzelnen Escapezeichen zu unterscheiden, gefolgt von weiteren Zeichen und einer gültigen Escapesequenz.
Es wird davon ausgegangen, dass das Terminal die Zeichen schneller senden kann als ein Benutzer. PSReadLine wartet auf dieses Timeout, bevor sie zu dem Schluss kommt, dass sie eine vollständige Escapesequenz erhalten hat.
Wenn beim Eingeben zufällige oder unerwartete Zeichen angezeigt werden, können Sie dieses Timeout anpassen.
Type: | Int32 |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-BellStyle
Gibt an, wie PSReadLine auf verschiedene Fehler- und mehrdeutige Bedingungen reagiert.
Die folgenden Werte sind gültig:
- Hörbar: Kurzer Signalton.
- Visual: Text blinkt kurz.
- Keine: Kein Feedback.
Type: | BellStyle |
Position: | Named |
Default value: | Audible |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Colors
Der Parameter Colors gibt verschiedene Farben an, die von PSReadLine verwendet werden.
Das Argument ist eine Hashtabelle, in der die Schlüssel die Elemente und die Werte die Farbe angeben. Weitere Informationen finden Sie unter about_Hash_Tables.
Farben können entweder ein Wert aus ConsoleColor sein, z [ConsoleColor]::Red
. B. oder eine gültige ANSI-Escapesequenz. Gültige Escapesequenzen hängen vom Terminal ab. In PowerShell 5.0 ist $([char]0x1b)[91m
eine Beispiel-Escapesequenz für roten Text . In PowerShell 6 und höher ist `e[91m
die gleiche Escapesequenz . Sie können andere Escapesequenzen angeben, einschließlich der folgenden Typen:
Zur Unterstützung der Anpassung der ListView
in PSReadLine 2.2.0 hinzugefügten Farbeinstellungen wurden zwei Farbeinstellungen hinzugefügt:
ListPredictionColor - Festlegen der Farbe für das führende
>
Zeichen und den nachgestellten Quellnamen, z[History]
. B. . Standardmäßig wird sie als Vordergrundfarbe verwendetDarkYellow
.ListPredictionSelectedColor – Festlegen der Farbe für die Angabe, dass ein Listenelement ausgewählt ist. Standardmäßig wird sie als Hintergrundfarbe verwendet
DarkBlack
.256 Farbe
24-Bit-Farbe
Vordergrund, Hintergrund oder beides
Umgekehrt, fett
Weitere Informationen zu ANSI-Farbcodes finden Sie im Wikipedia-Artikel ANSI-Escapecode.
Zu den gültigen Schlüsseln gehören:
- ContinuationPrompt: Die Farbe der Fortsetzungsaufforderung.
- Hervorhebung: Die Hervorhebungsfarbe. Beispiel: der übereinstimmende Text beim Durchsuchen des Verlaufs.
- Fehler: Die Fehlerfarbe. Beispiel: in der Eingabeaufforderung.
- Auswahl: Die Farbe zum Hervorheben der Menüauswahl oder des markierten Texts.
- Standard: Die Standardtokenfarbe.
- Kommentar: Die Farbe des Kommentartokens.
- Schlüsselwort: Die Schlüsselwort (keyword) Tokenfarbe.
- Zeichenfolge: Die Zeichenfolgentokenfarbe.
- Operator: Die Operatortokenfarbe.
- Variable: Die Farbe des Variablentokens.
- Befehl: Die Befehlstokenfarbe.
- Parameter: Die Parametertokenfarbe.
- Typ: Die Typtokenfarbe.
- Zahl: Die Farbe des Zahlentokens.
- Member: Die Farbe des Membernamentokens.
- InlinePrediction: Die Farbe für die Inlineansicht des Vorhersagevorschlags.
- ListPrediction: Die Farbe für den Namen der führenden
>
Zeichen- und Vorhersagequelle. - ListPredictionSelected: Die Farbe für die ausgewählte Vorhersage in der Listenansicht.
Type: | Hashtable |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CommandValidationHandler
Gibt einen ScriptBlock an, der von ValidateAndAcceptLine aufgerufen wird. Wenn eine Ausnahme ausgelöst wird, schlägt die Überprüfung fehl, und der Fehler wird gemeldet.
Vor dem Auslösen einer Ausnahme kann der Überprüfungshandler den Cursor an den Punkt des Fehlers setzen, um die Behebung zu vereinfachen. Ein Überprüfungshandler kann auch die Befehlszeile ändern, um häufige typografische Fehler zu beheben.
ValidateAndAcceptLine wird verwendet, um zu vermeiden, dass Der Verlauf mit Befehlen überladen wird, die nicht funktionieren können.
Type: | Action<T>[CommandAst] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-CompletionQueryItems
Gibt die maximale Anzahl von Abschlusselementen an, die ohne Aufforderung angezeigt werden.
Wenn die Anzahl der anzuzeigenden Elemente größer als dieser Wert ist, fordert PSReadLine "ja/nein" auf, bevor die Abschlusselemente angezeigt werden.
Type: | Int32 |
Position: | Named |
Default value: | 100 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ContinuationPrompt
Gibt die Zeichenfolge an, die am Anfang der nachfolgenden Zeilen angezeigt wird, wenn mehrzeilige Eingaben eingegeben werden. Der Standardwert ist doppelt größer als zeichen (>>
). Eine leere Zeichenfolge ist gültig.
Type: | String |
Position: | Named |
Default value: | >> |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DingDuration
Gibt die Dauer des Signaltons an, wenn BellStyle auf "Audible" festgelegt ist.
Type: | Int32 |
Position: | Named |
Default value: | 50ms |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DingTone
Gibt den Ton in Hertz (Hz) des Signaltons an, wenn BellStyle auf "Audible" festgelegt ist.
Type: | Int32 |
Position: | Named |
Default value: | 1221 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EditMode
Gibt den Befehlszeilenbearbeitungsmodus an. Mit diesem Parameter werden alle von diesem Parameter festgelegten Tastenbindungen zurückgesetzt.Set-PSReadLineKeyHandler
Die folgenden Werte sind gültig:
- Windows: Schlüsselbindungen emulieren PowerShell, cmd und Visual Studio.
- Emacs: Schlüsselbindungen emulieren Bash oder Emacs.
- Vi: Schlüsselbindungen emulieren Vi.
Wird verwendet Get-PSReadLineKeyHandler
, um die Schlüsselbindungen für den aktuell konfigurierten EditMode anzuzeigen.
Type: | EditMode |
Position: | Named |
Default value: | Windows |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ExtraPromptLineCount
Gibt die Anzahl der zusätzlichen Zeilen an.
Wenn sich die Eingabeaufforderung über mehrere Zeilen erstreckt, geben Sie einen Wert für diesen Parameter an. Verwenden Sie diese Option, wenn zusätzliche Zeilen verfügbar sein sollen, wenn PSReadLine die Eingabeaufforderung anzeigt, nachdem eine Ausgabe angezeigt wurde. Beispielsweise gibt PSReadLine eine Liste der Fertigstellungen zurück.
Diese Option ist weniger als in früheren Versionen von PSReadLine erforderlich, ist aber nützlich, wenn die InvokePrompt
Funktion verwendet wird.
Type: | Int32 |
Position: | Named |
Default value: | 0 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistoryNoDuplicates
Diese Option steuert das Rückrufverhalten. Der Verlaufsdatei werden weiterhin doppelte Befehle hinzugefügt. Wenn diese Option festgelegt ist, wird beim Abrufen von Befehlen nur der letzte Aufruf angezeigt. Wiederholte Befehle werden dem Verlauf hinzugefügt, um die Sortierung während des Rückrufs beizubehalten. Normalerweise möchten Sie den Befehl jedoch nicht mehrmals anzeigen, wenn Sie den Verlauf zurückrufen oder durchsuchen.
Standardmäßig ist die HistoryNoDuplicates-Eigenschaft des globalen PSConsoleReadLineOptions-Objekts auf festgelegt True
. Um den Eigenschaftswert zu ändern, müssen Sie den Wert des SwitchParameter wie folgt angeben: -HistoryNoDuplicates:$False
Sie können mit nur dem SwitchParameter-Steuerelement -HistoryNoDuplicates
auf "Zurück" zurückgesetzt True
werden.
Mit dem folgenden Befehl können Sie den Eigenschaftswert direkt festlegen:
(Get-PSReadLineOption).HistoryNoDuplicates = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySavePath
Gibt den Pfad zu der Datei an, in der der Verlauf gespeichert wird. Computer, auf denen Windows- oder Nicht-Windows-Plattformen ausgeführt werden, speichern die Datei an verschiedenen Speicherorten. Der Dateiname wird in einer Variablen $($Host.Name)_history.txt
gespeichert, z. B ConsoleHost_history.txt
. .
Wenn Sie diesen Parameter nicht verwenden, lautet der Standardpfad wie folgt:
Windows
$env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\$($Host.Name)_history.txt
Nicht-Windows
$env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
$HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt
Type: | String |
Position: | Named |
Default value: | A file named $($Host.Name)_history.txt in $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine on Windows and $env:XDG_DATA_HOME/powershell/PSReadLine or $HOME/.local/share/powershell/PSReadLine on non-Windows platforms |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySaveStyle
Gibt an, wie PSReadLine den Verlauf speichert.
Gültige Werte sind:
SaveIncrementally
: Speichern des Verlaufs, nachdem jeder Befehl ausgeführt und für mehrere Instanzen von PowerShell freigegeben wurde.SaveAtExit
: Anfügen der Verlaufsdatei, wenn PowerShell beendet wird.SaveNothing
: Verwenden Sie keine Verlaufsdatei.
Hinweis
Wenn Sie "HistorySaveStyle" auf "HistorySaveStyleSaveNothing
" festlegen und diese SaveIncrementally
dann später in derselben Sitzung festlegen, speichert PSReadLine alle Befehle, die zuvor in der Sitzung ausgeführt werden.
Type: | HistorySaveStyle |
Position: | Named |
Default value: | SaveIncrementally |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySearchCaseSensitive
Gibt an, dass bei der Verlaufssuche die Groß-/Kleinschreibung in Funktionen wie ReverseSearchHistory oder HistorySearchBackward beachtet wird.
Standardmäßig ist die HistorySearchCaseSensitive-Eigenschaft des globalen PSConsoleReadLineOptions-Objekts auf festgelegt False
. Mit diesem SwitchParameter wird der Eigenschaftswert auf True
. Um den Eigenschaftswert wieder zu ändern, müssen Sie den Wert des SwitchParameter wie folgt angeben: -HistorySearchCaseSensitive:$False
Mit dem folgenden Befehl können Sie den Eigenschaftswert direkt festlegen:
(Get-PSReadLineOption).HistorySearchCaseSensitive = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-HistorySearchCursorMovesToEnd
Gibt an, dass der Cursor mithilfe einer Suche zum Ende der Befehle wechselt, die Sie aus dem Verlauf laden.
Wenn dieser Parameter auf $False
festgelegt ist, wird der Standard Cursor an der Position, an der er sich befand, als Sie die NACH-OBEN- oder NACH-UNTEN-TASTE gedrückt haben.
Standardmäßig ist die HistorySearchCursorMovesToEnd-Eigenschaft des globalen PSConsoleReadLineOptions-Objekts auf festgelegt False
. Legen Sie mit diesem SwitchParameter den Eigenschaftswert auf True
. Um den Eigenschaftswert wieder zu ändern, müssen Sie den Wert des SwitchParameter wie folgt angeben: -HistorySearchCursorMovesToEnd:$False
Mit dem folgenden Befehl können Sie den Eigenschaftswert direkt festlegen:
(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumHistoryCount
Gibt die maximale Anzahl von Befehlen an, die im PSReadLine-Verlauf gespeichert werden sollen.
Der PSReadLine-Verlauf ist vom PowerShell-Verlauf getrennt.
Type: | Int32 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaximumKillRingCount
Gibt die maximale Anzahl der im Kill-Ring gespeicherten Elemente an.
Type: | Int32 |
Position: | Named |
Default value: | 10 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PredictionSource
Gibt die Quelle für PSReadLine an, um Vorhersagevorschläge zu erhalten.
Gültige Werte sind:
- None – Deaktivieren Sie das Predictive IntelliSense-Feature (Standard).
- Verlauf – Aktivieren Sie das Predictive IntelliSense-Feature, und verwenden Sie den PSReadLine-Verlauf als einzige Quelle.
- Plug-In – aktivieren Sie das Predictive IntelliSense-Feature und verwenden Sie die Plug-Ins (
CommandPrediction
) als einzige Quelle. Dieser Wert wurde in PSReadLine 2.2.0 hinzugefügt. - HistoryAndPlugin – Aktivieren Sie das predictive IntelliSense-Feature, und verwenden Sie sowohl Verlauf als auch Plug-In als Quellen. Dieser Wert wurde in PSReadLine 2.2.0 hinzugefügt.
Type: | Microsoft.PowerShell.PredictionSource |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PredictionViewStyle
Legt die Formatvorlage für die Anzeige des Vorhersagetexts fest. Der Standardwert ist InlineView.
- InlineView - der Stil heute, ähnlich wie in Fischschale und zsh. (Standard)
- ListView – Vorschläge werden in einer Dropdownliste gerendert, und Benutzer können mithilfe von UpArrow und DownArrow auswählen.
Dieser Parameter wurde in PSReadLine 2.2.0 hinzugefügt.
Type: | Microsoft.PowerShell.PredictionViewStyle |
Position: | Named |
Default value: | InlineView |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PromptText
Dieser Parameter legt den Wert der PromptText-Eigenschaft fest. Der Standardwert ist "> "
.
PSReadLine analysiert Ihre Eingabeaufforderungsfunktion, um zu bestimmen, wie nur die Farbe eines Teils der Eingabeaufforderung geändert wird. Diese Analyse ist nicht 100 % zuverlässig. Verwenden Sie diese Option, wenn PSReadLine Ihre Eingabeaufforderung auf unerwartete Weise ändert. Schließen Sie nachfolgende Leerzeichen ein.
Der Wert dieses Parameters kann eine einzelne Zeichenfolge oder ein Array von zwei Zeichenfolgen sein. Die erste Zeichenfolge ist der Teil ihrer Eingabeaufforderungszeichenfolge, der bei einem Analysefehler in Rot geändert werden soll. Die zweite Zeichenfolge ist eine alternative Zeichenfolge, die verwendet werden soll, wenn ein Analysefehler auftritt.
Type: | String[] |
Position: | Named |
Default value: | > |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ShowToolTips
Wenn mögliche Fertigstellungen angezeigt werden, werden QuickInfos in der Liste der Fertigstellungen angezeigt.
Diese Option ist standardmäßig aktiviert. Diese Option wurde in früheren Versionen von PSReadLine nicht standardmäßig aktiviert. Um die Option zu deaktivieren, legen Sie diese Option auf $False
.
Standardmäßig ist die ShowTool Tipps -Eigenschaft des globalen PSConsoleReadLineOptions -Objekts auf True
festgelegt. Mit diesem SwitchParameter wird der Eigenschaftswert auf True
. Um den Eigenschaftswert zu ändern, müssen Sie den Wert des SwitchParameter wie folgt angeben: -ShowToolTips:$False
Mit dem folgenden Befehl können Sie den Eigenschaftswert direkt festlegen:
(Get-PSReadLineOption).ShowToolTips = $False
Type: | SwitchParameter |
Position: | Named |
Default value: | True |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ViModeChangeHandler
Wenn der ViModeIndicator auf Script
"" festgelegt ist, wird der bereitgestellte Skriptblock jedes Mal aufgerufen, wenn sich der Modus ändert. Der Skriptblock wird ein Argument vom Typ ViMode
bereitgestellt.
Dieser Parameter wurde in PowerShell 7 eingeführt.
Type: | ScriptBlock |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ViModeIndicator
Mit dieser Option wird der visuelle Indikator für den aktuellen Vi-Modus festgelegt. Der Einfügemodus oder der Befehlsmodus.
Die folgenden Werte sind gültig:
- Keine: Es gibt keinen Indikator.
- Eingabeaufforderung: Die Eingabeaufforderung ändert die Farbe.
- Cursor: Der Cursor ändert die Größe.
- Skript: Vom Benutzer angegebener Text wird gedruckt.
Type: | ViModeStyle |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WordDelimiters
Gibt die Zeichen an, die Wörter für Funktionen wie ForwardWord oder KillWord trennen.
Type: | String |
Position: | Named |
Default value: | ;:,.[]{}()/\|^&*-=+'"--- |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Eingaben
None
Sie können keine Objekte an dieses Cmdlet weiterleiten.
Ausgaben
None
Dieses Cmdlet gibt keine Ausgabe zurück.
Ähnliche Themen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für