Set-PSReadLineOption
Personalizza il comportamento della modifica della riga di comando in PSReadLine.
Sintassi
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>] Descrizione
Il Set-PSReadLineOption cmdlet personalizza il comportamento del modulo PSReadLine quando si modifica la riga di comando. Per visualizzare le impostazioni di PSReadLine , usare Get-PSReadLineOption.
Le opzioni impostate da questo comando si applicano solo alla sessione corrente. Per rendere persistenti tutte le opzioni, aggiungerle a uno script del profilo. Per altre informazioni, vedere about_Profiles e Personalizzazione dell'ambiente della shell.
Esempio
Esempio 1: Impostare i colori di primo piano e di sfondo
Questo esempio imposta PSReadLine per visualizzare il token commento con testo in primo piano verde su uno sfondo grigio. Nella sequenza di escape utilizzata nell'esempio 32 rappresenta il colore di primo piano e 47 rappresenta il colore di sfondo.
Set-PSReadLineOption -Colors @{ "Comment"="`e[32;47m" }È possibile scegliere di impostare solo un colore di testo in primo piano. Ad esempio, un colore di primo piano verde brillante per il token commento : "Comment"="`e[92m".
Esempio 2: Impostare lo stile della campana
In questo esempio PSReadLine risponderà a errori o condizioni che richiedono attenzione dell'utente. BellStyle è impostato per generare un segnale acustico a 1221 Hz per 60 ms.
Set-PSReadLineOption -BellStyle Audible -DingTone 1221 -DingDuration 60Nota
Questa funzionalità potrebbe non funzionare in tutti gli host su piattaforme.
Esempio 3: Impostare più opzioni
Set-PSReadLineOption può impostare più opzioni con una tabella hash.
$PSReadLineOptions = @{
EditMode = "Emacs"
HistoryNoDuplicates = $true
HistorySearchCursorMovesToEnd = $true
Colors = @{
"Command" = "#8181f7"
}
}
Set-PSReadLineOption @PSReadLineOptionsLa $PSReadLineOptions tabella hash imposta le chiavi e i valori. Set-PSReadLineOption usa le chiavi e i valori con @PSReadLineOptions per aggiornare le opzioni PSReadLine .
È possibile visualizzare le chiavi e i valori immettendo il nome della tabella hash nella $PSReadLineOptions riga di comando di PowerShell.
Esempio 4: Impostare più opzioni di colore
In questo esempio viene illustrato come impostare più valori di colore in un singolo comando.
Set-PSReadLineOption -Colors @{
Command = 'Magenta'
Number = 'DarkGray'
Member = 'DarkGray'
Operator = 'DarkGray'
Type = 'DarkGray'
Variable = 'DarkGreen'
Parameter = 'DarkGreen'
ContinuationPrompt = 'DarkGray'
Default = 'DarkGray'
}Esempio 5: Impostare i valori di colore per più tipi
In questo esempio vengono illustrati tre metodi diversi per impostare il colore dei token visualizzati in 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"
}Esempio 6: Usare ViModeChangeHandler per visualizzare le modifiche alla modalità Vi
In questo esempio viene generato un escape VT di modifica del cursore in risposta a una modifica della modalità 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:OnViModeChangeLa funzione OnViModeChange imposta le opzioni del cursore per le modalità Vi : insert e command.
ViModeChangeHandler usa il Function: provider per fare riferimento a OnViModeChange come oggetto blocco di script.
Per altre informazioni, vedere about_Providers.
Esempio 7: Usare HistoryHandler per filtrare i comandi aggiunti alla cronologia
L'esempio seguente illustra come usare per AddToHistoryHandler impedire il salvataggio di comandi Git nella cronologia.
$ScriptBlock = {
Param([string]$line)
if ($line -match "^git") {
return $false
} else {
return $true
}
}
Set-PSReadLineOption -AddToHistoryHandler $ScriptBlockScriptblock restituisce $false se il comando è stato avviato con git. Questo ha lo stesso effetto della restituzione dell'enumerazione SkipAddingAddToHistory . Se il comando non inizia con git, il gestore restituisce $true e PSReadLine salva il comando nella cronologia.
Esempio 8: Usare CommandValidationHandler per convalidare un comando prima dell'esecuzione
Questo esempio illustra come usare il parametro CommandValidationHandler per eseguire un comando di convalida prima dell'esecuzione. Nell'esempio viene verificato in modo specifico la presenza del comando git con il comando cmt secondario e viene sostituito con il nome commitcompleto . In questo modo è possibile creare alias abbreviati per i sottocomandi.
# 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 ValidateAndAcceptLineEsempio 9: Uso del parametro PromptText
Quando si verifica un errore di analisi, PSReadLine modifica una parte del prompt rosso. Il parametro PromptText indica a PSReadLine la parte della stringa del prompt da rendere rossa.
Nell'esempio seguente, ad esempio, viene creato un prompt contenente il percorso corrente seguito dal carattere maggiore di (>) e da uno spazio.
function prompt { "PS $pwd> " }`
Set-PSReadLineOption -PromptText '> ' # change the '>' character red
Set-PSReadLineOption -PromptText '> ', 'X ' # replace the '>' character with a red 'X'La prima stringa è la parte della stringa di richiesta che si vuole impostare in rosso quando si verifica un errore di analisi. La seconda stringa è una stringa alternativa da usare per quando si verifica un errore di analisi.
Parametri
-AddToHistoryHandler
Specifica un elemento ScriptBlock che controlla la modalità di aggiunta dei comandi alla cronologia PSReadLine .
ScriptBlock riceve la riga di comando come input.
ScripBlock deve restituire un membro dell'enumerazione AddToHistoryOption, il nome stringa di uno di questi membri o un valore booleano. L'elenco seguente descrive i valori possibili e i relativi effetti.
MemoryAndFile- Aggiungere il comando al file di cronologia e alla sessione corrente.MemoryOnly- Aggiungere il comando alla cronologia solo per la sessione corrente.SkipAdding- Non aggiungere il comando al file di cronologia per la sessione corrente.$false- Uguale a se il valore fosseSkipAdding.$true- Uguale a se il valore fosseMemoryAndFile.
| Type: | Func<T,TResult>[System.String,System.Object] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AnsiEscapeTimeout
Questa opzione è specifica di Windows quando l'input viene reindirizzato, ad esempio quando viene eseguito in tmux o screen.
Con l'input reindirizzato in Windows, molte chiavi vengono inviate come sequenza di caratteri a partire dal carattere di escape. È impossibile distinguere tra un singolo carattere di escape seguito da più caratteri e una sequenza di escape valida.
Il presupposto è che il terminale possa inviare i caratteri più velocemente rispetto ai tipi di utente. PSReadLine attende questo timeout prima di concludere che ha ricevuto una sequenza di escape completa.
Se durante la digitazione vengono visualizzati caratteri casuali o imprevisti, è possibile regolare questo timeout.
| Type: | Int32 |
| Position: | Named |
| Default value: | 100 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-BellStyle
Specifica il modo in cui PSReadLine risponde a varie condizioni di errore e ambigue.
I valori validi sono i seguenti:
- Udibile: un segnale acustico breve.
- Oggetto visivo: il testo lampeggia brevemente.
- Nessuno: nessun feedback.
| Type: | BellStyle |
| Position: | Named |
| Default value: | Audible |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Colors
Il parametro Colors specifica vari colori utilizzati da PSReadLine.
L'argomento è una tabella hash in cui le chiavi specificano gli elementi e i valori specificano il colore. Per altre informazioni, vedere about_Hash_Tables.
I colori possono essere un valore di ConsoleColor, ad esempio [ConsoleColor]::Red, o una sequenza di escape ANSI valida. Le sequenze di escape valide dipendono dal terminale. In PowerShell 5.0, una sequenza di escape di esempio per il testo rosso è $([char]0x1b)[91m. In PowerShell 6 e versioni successive la stessa sequenza di escape è `e[91m. È possibile specificare altre sequenze di escape, inclusi i tipi seguenti:
Sono state aggiunte due impostazioni di colore per supportare la ListView personalizzazione di in PSReadLine 2.2.0:
ListPredictionColor : impostare il colore per il carattere iniziale
>e il nome dell'origine finale, ad esempio[History]. Per impostazione predefinita, usaDarkYellowcome colore di primo piano.ListPredictionSelectedColor : imposta il colore per indicare che è selezionata una voce di elenco. Per impostazione predefinita, usa
DarkBlackcome colore di sfondo.Colore 256
Colore a 24 bit
Primo piano, sfondo o entrambi
Inverso, grassetto
Per altre informazioni sui codici di colore ANSI, vedere l'articolo di Wikipedia codice di escape ANSI.
Le chiavi valide includono:
- ContinuationPrompt: colore della richiesta di continuazione.
- Enfasi: colore di enfasi. Ad esempio, il testo corrispondente durante la ricerca nella cronologia.
- Errore: colore errore. Ad esempio, nel prompt.
- Selezione: colore per evidenziare la selezione del menu o il testo selezionato.
- Impostazione predefinita: colore del token predefinito.
- Commento: colore del token di commento.
- Parola chiave: colore del token della parola chiave.
- Stringa: colore del token stringa.
- Operatore: colore del token dell'operatore.
- Variabile: colore del token variabile.
- Comando: colore del token del comando.
- Parametro: colore del token del parametro.
- Tipo: colore del token di tipo.
- Numero: colore del token numerico.
- Membro: colore del token del nome del membro.
- InlinePrediction: colore per la visualizzazione inline del suggerimento predittivo.
- ListPrediction: colore per il carattere iniziale
>e il nome dell'origine di stima. - ListPredictionSelected: colore per la stima selezionata nella visualizzazione elenco.
| Type: | Hashtable |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CommandValidationHandler
Specifica un oggetto ScriptBlock chiamato da ValidateAndAcceptLine. Se viene generata un'eccezione, la convalida non riesce e viene segnalato l'errore.
Prima di generare un'eccezione, il gestore di convalida può posizionare il cursore al punto dell'errore per semplificare la correzione. Un gestore di convalida può anche modificare la riga di comando per correggere gli errori tipografici comuni.
ValidateAndAcceptLine viene usato per evitare confusione nella cronologia con i comandi che non possono funzionare.
| Type: | Action<T>[CommandAst] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-CompletionQueryItems
Specifica il numero massimo di elementi di completamento visualizzati senza richiedere conferma.
Se il numero di elementi da visualizzare è maggiore di questo valore, PSReadLine richiede sì/no prima di visualizzare gli elementi di completamento.
| Type: | Int32 |
| Position: | Named |
| Default value: | 100 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ContinuationPrompt
Specifica la stringa visualizzata all'inizio delle righe successive quando viene immesso l'input su più righe. Il valore predefinito è doppio segno maggiore di (>>). Una stringa vuota è valida.
| Type: | String |
| Position: | Named |
| Default value: | >> |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DingDuration
Specifica la durata del segnale acustico quando BellStyle è impostato su Audible.
| Type: | Int32 |
| Position: | Named |
| Default value: | 50ms |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-DingTone
Specifica il tono inHz (Hz) del segnale acustico quando BellStyle è impostato su Audible.
| Type: | Int32 |
| Position: | Named |
| Default value: | 1221 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-EditMode
Specifica la modalità di modifica della riga di comando. L'uso di questo parametro reimposta tutte le associazioni di tasti impostate da Set-PSReadLineKeyHandler.
I valori validi sono i seguenti:
- Windows: le associazioni di tasti emulano PowerShell, cmd e Visual Studio.
- Emacs: le associazioni di tasti emulano Bash o Emacs.
- Vi: Le associazioni di tasti emulano Vi.
Usare Get-PSReadLineKeyHandler per visualizzare i tasti di scelta rapida per l'oggetto EditMode attualmente configurato.
| Type: | EditMode |
| Position: | Named |
| Default value: | Windows |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ExtraPromptLineCount
Specifica il numero di righe aggiuntive.
Se il prompt si estende su più righe, specificare un valore per questo parametro. Usare questa opzione quando si desidera che le righe aggiuntive siano disponibili quando PSReadLine visualizza il prompt dopo aver visualizzato un output. Ad esempio, PSReadLine restituisce un elenco di completamenti.
Questa opzione è necessaria meno di quanto nelle versioni precedenti di PSReadLine, ma è utile quando viene usata la InvokePrompt funzione.
| Type: | Int32 |
| Position: | Named |
| Default value: | 0 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HistoryNoDuplicates
Questa opzione controlla il comportamento di richiamo. I comandi duplicati vengono comunque aggiunti al file di cronologia. Quando questa opzione è impostata, viene visualizzata solo la chiamata più recente quando si richiamano i comandi. I comandi ripetuti vengono aggiunti alla cronologia per mantenere l'ordinamento durante il richiamo. Tuttavia, in genere non si vuole visualizzare il comando più volte durante il richiamo o la ricerca nella cronologia.
Per impostazione predefinita, la proprietà HistoryNoDuplicates dell'oggetto PSConsoleReadLineOptions globale è impostata su True. Per modificare il valore della proprietà, è necessario specificare il valore di SwitchParameter come indicato di seguito: -HistoryNoDuplicates:$False. È possibile tornare a True usando solo SwitchParameter, -HistoryNoDuplicates.
Usando il comando seguente, è possibile impostare direttamente il valore della proprietà:
(Get-PSReadLineOption).HistoryNoDuplicates = $False
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HistorySavePath
Specifica il percorso del file in cui viene salvata la cronologia. I computer che eseguono piattaforme Windows o non Windows archiviano il file in posizioni diverse. Il nome file viene archiviato in una variabile $($Host.Name)_history.txt, ad esempio ConsoleHost_history.txt.
Se non si usa questo parametro, il percorso predefinito è il seguente:
Windows
$env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\$($Host.Name)_history.txt
non 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
Specifica il modo in cui PSReadLine salva la cronologia.
I valori validi sono i seguenti:
SaveIncrementally: salva la cronologia dopo l'esecuzione di ogni comando e la condivisione tra più istanze di PowerShell.SaveAtExit: file di cronologia di accodamento all'uscita da PowerShell.SaveNothing: non usare un file di cronologia.
Nota
Se si imposta HistorySaveStyle su SaveNothing e quindi lo SaveIncrementally si imposta su più avanti nella stessa sessione, PSReadLine salva tutti i comandi eseguiti in precedenza nella sessione.
| Type: | HistorySaveStyle |
| Position: | Named |
| Default value: | SaveIncrementally |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HistorySearchCaseSensitive
Specifica che la ricerca della cronologia fa distinzione tra maiuscole e minuscole nelle funzioni come ReverseSearchHistory o HistorySearchBackward.
Per impostazione predefinita, la proprietà HistorySearchCaseSensitive dell'oggetto PSConsoleReadLineOptions globale è impostata su False. Se si usa questo parametro SwitchParameter , il valore della proprietà viene impostato su True. Per ripristinare il valore della proprietà, è necessario specificare il valore di SwitchParameter come indicato di seguito: -HistorySearchCaseSensitive:$False.
Usando il comando seguente, è possibile impostare direttamente il valore della proprietà:
(Get-PSReadLineOption).HistorySearchCaseSensitive = $False
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-HistorySearchCursorMovesToEnd
Indica che il cursore si sposta alla fine dei comandi caricati dalla cronologia usando una ricerca.
Quando questo parametro è impostato su $False, il cursore rimane nella posizione in cui è stata premuta la freccia su o giù.
Per impostazione predefinita, la proprietà HistorySearchCursorMovesToEnd dell'oggetto PSConsoleReadLineOptions globale è impostata su False. Se si usa questo parametro SwitchParameter , impostare il valore della proprietà su True. Per ripristinare il valore della proprietà, è necessario specificare il valore di SwitchParameter come indicato di seguito: -HistorySearchCursorMovesToEnd:$False.
Usando il comando seguente, è possibile impostare direttamente il valore della proprietà:
(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumHistoryCount
Specifica il numero massimo di comandi da salvare nella cronologia di PSReadLine .
La cronologia di PSReadLine è separata dalla cronologia di PowerShell.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-MaximumKillRingCount
Specifica il numero massimo di elementi archiviati nell'anello di terminazioni.
| Type: | Int32 |
| Position: | Named |
| Default value: | 10 |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PredictionSource
Specifica l'origine per PSReadLine per ottenere suggerimenti predittivi.
I valori validi sono:
- Nessuno: disabilitare la funzionalità IntelliSense predittiva (impostazione predefinita).
- Cronologia : abilitare la funzionalità IntelliSense predittiva e usare la cronologia PSReadLine come unica origine.
- Plug-in : abilitare la funzionalità predittiva di IntelliSense e usare i plug-in (
CommandPrediction) come unica origine. Questo valore è stato aggiunto in PSReadLine 2.2.0 - HistoryAndPlugin: abilitare la funzionalità predittiva di IntelliSense e usare sia la cronologia che il plug-in come origini. Questo valore è stato aggiunto in PSReadLine 2.2.0
| Type: | Microsoft.PowerShell.PredictionSource |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PredictionViewStyle
Imposta lo stile per la visualizzazione del testo predittivo. Il valore predefinito è InlineView.
- InlineView : lo stile attuale, simile a quello della shell di pesce e zsh. (predefinito)
- ListView : viene eseguito il rendering dei suggerimenti in un elenco a discesa e gli utenti possono selezionare tramite UpArrow e DownArrow.
Questo parametro è stato aggiunto in PSReadLine 2.2.0
| Type: | Microsoft.PowerShell.PredictionViewStyle |
| Position: | Named |
| Default value: | InlineView |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-PromptText
Questo parametro imposta il valore della proprietà PromptText . Il valore predefinito è "> ".
PSReadLine analizza la funzione prompt per determinare come modificare solo il colore della parte del prompt. Questa analisi non è affidabile al 100%. Usare questa opzione se PSReadLine modifica il prompt in modi imprevisti. Includere eventuali spazi vuoti finali.
Il valore di questo parametro può essere una singola stringa o una matrice di due stringhe. La prima stringa è la parte della stringa di richiesta da modificare in rosso quando si verifica un errore di analisi. La seconda stringa è una stringa alternativa da usare per quando si verifica un errore di analisi.
| Type: | String[] |
| Position: | Named |
| Default value: | > |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ShowToolTips
Quando vengono visualizzati i possibili completamenti, le descrizioni comando vengono visualizzate nell'elenco dei completamenti.
Per impostazione predefinita, questa opzione è attivata. Questa opzione non è stata abilitata per impostazione predefinita nelle versioni precedenti di PSReadLine. Per disabilitare, impostare questa opzione su $False.
Questo parametro e l'opzione sono stati aggiunti in PSReadLine 2.3.4.
Per impostazione predefinita, la proprietà ShowTool Suggerimenti dell'oggetto PSConsoleReadLineOptions globale è impostata su True. Se si usa questo parametro SwitchParameter , il valore della proprietà viene impostato su True. Per modificare il valore della proprietà, è necessario specificare il valore di SwitchParameter come indicato di seguito: -ShowToolTips:$False.
Usando il comando seguente, è possibile impostare direttamente il valore della proprietà:
(Get-PSReadLineOption).ShowToolTips = $False
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | True |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-TerminateOrphanedConsoleApps
Questo parametro imposta l'opzione TerminateOrphanedConsoleApps su $true.
In Windows, quando si preme CTRL+C per terminare un processo, ogni processo collegato a una console riceve un segnale di terminazione, anziché solo la shell attiva. In alcuni casi, quando una shell ha avviato un albero di grandi dimensioni di processi figlio, ad esempio un sistema di compilazione, alcuni processi possono uscire, lasciando più processi contemporaneamente cercando di usare l'input della console.
Quando si imposta l'opzione TerminateOrphanedConsoleApps su $true, PSReadLine registra l'elenco dei processi attualmente collegati alla console. Successivamente, ogni volta che PSReadLine viene eseguito, ottiene un nuovo elenco di processi collegati alla console e termina quelli che non sono nell'elenco originale.
Questo parametro e l'opzione sono stati aggiunti in PSReadLine 2.3.4.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ViModeChangeHandler
Quando ViModeIndicator è impostato su Script, il blocco di script fornito verrà richiamato ogni volta che cambia la modalità. Il blocco di script viene fornito un argomento di tipo ViMode.
Questo parametro è stato introdotto in PowerShell 7.
| Type: | ScriptBlock |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-ViModeIndicator
Questa opzione imposta l'indicatore visivo per la modalità Vi corrente. Modalità di inserimento o modalità di comando.
I valori validi sono i seguenti:
- Nessuno: non c'è alcun indicatore.
- Prompt: il prompt cambia colore.
- Cursore: la dimensione del cursore cambia.
- Script: viene stampato il testo specificato dall'utente.
| Type: | ViModeStyle |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WordDelimiters
Specifica i caratteri che delimitano le parole per funzioni come ForwardWord o KillWord.
| Type: | String |
| Position: | Named |
| Default value: | ;:,.[]{}()/\|^&*-=+'"--- |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Input
None
Non è possibile inviare tramite pipe oggetti a questo cmdlet.
Output
None
Questo cmdlet non restituisce output.
Collegamenti correlati
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per