Set-PSReadLineOption

  • Riferimento
Modulo:
PSReadLine

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 60

Nota

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 @PSReadLineOptions

La $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:OnViModeChange

La 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 $ScriptBlock

Scriptblock restituisce $false se il comando è stato avviato con git. Questo ha lo stesso effetto della restituzione dell'enumerazione SkipAdding AddToHistory . 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 ValidateAndAcceptLine

Esempio 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 fosse SkipAdding.
  • $true - Uguale a se il valore fosse MemoryAndFile.
Tipo:Func<T,TResult>[System.String,System.Object]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:100
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.
Tipo:BellStyle
Posizione:Named
Valore predefinito:Audible
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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, usa DarkYellow come colore di primo piano.

  • ListPredictionSelectedColor : imposta il colore per indicare che è selezionata una voce di elenco. Per impostazione predefinita, usa DarkBlack come 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.
Tipo:Hashtable
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Action<T>[CommandAst]
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:100
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String
Posizione:Named
Valore predefinito:>>
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DingDuration

Specifica la durata del segnale acustico quando BellStyle è impostato su Audible.

Tipo:Int32
Posizione:Named
Valore predefinito:50ms
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-DingTone

Specifica il tono inHz (Hz) del segnale acustico quando BellStyle è impostato su Audible.

Tipo:Int32
Posizione:Named
Valore predefinito:1221
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:EditMode
Posizione:Named
Valore predefinito:Windows
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:Int32
Posizione:Named
Valore predefinito:0
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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
Tipo:String
Posizione:Named
Valore predefinito: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
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:HistorySaveStyle
Posizione:Named
Valore predefinito:SaveIncrementally
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:False
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaximumHistoryCount

Specifica il numero massimo di comandi da salvare nella cronologia di PSReadLine .

La cronologia di PSReadLine è separata dalla cronologia di PowerShell.

Tipo:Int32
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-MaximumKillRingCount

Specifica il numero massimo di elementi archiviati nell'anello di terminazioni.

Tipo:Int32
Posizione:Named
Valore predefinito:10
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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
Tipo:Microsoft.PowerShell.PredictionSource
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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

Tipo:Microsoft.PowerShell.PredictionViewStyle
Posizione:Named
Valore predefinito:InlineView
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:String[]
Posizione:Named
Valore predefinito:>
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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à ShowToolTips 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

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:True
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:SwitchParameter
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.

Tipo:ScriptBlock
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly: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.
Tipo:ViModeStyle
Posizione:Named
Valore predefinito:None
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

-WordDelimiters

Specifica i caratteri che delimitano le parole per funzioni come ForwardWord o KillWord.

Tipo:String
Posizione:Named
Valore predefinito:;:,.[]{}()/\|^&*-=+'"---
Necessario:False
Accettare l'input della pipeline:False
Accettare caratteri jolly:False

Input

None

Non è possibile inviare tramite pipe oggetti a questo cmdlet.

Output

None

Questo cmdlet non restituisce output.