Set-PSReadLineOption

Módulo:

PSReadLine

Personaliza o comportamento da edição de linha de comando em PSReadLine.

Sintaxe

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

Description

O cmdlet Set-PSReadLineOption personaliza o comportamento do módulo PSReadLine ao editar a linha de comando. Para exibir as configurações de PSReadLine, use Get-PSReadLineOption.

As opções definidas por esse comando se aplicam somente à sessão atual. Para persistir as opções, adicione-as a um script de perfil. Para obter mais informações, consulte about_Profiles e Personalizando seu ambiente de shell.

Exemplos

Exemplo 1: Definir cores de primeiro plano e plano de fundo

Este exemplo define PSReadLine para exibir o token Comment com texto em primeiro plano verde em um plano de fundo cinza. Na sequência de escape usada no exemplo, 32 representa a cor do primeiro plano e 47 representa a cor da tela de fundo.

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

Você pode optar por definir apenas uma cor de texto em primeiro plano. Por exemplo, uma cor de texto de primeiro plano verde brilhante para o token de de comentário: "Comment"="`e[92m".

Exemplo 2: Definir estilo de sino

Neste exemplo, PSReadLine responderá a erros ou condições que exigem atenção do usuário. O BellStyle está definido para emitir um bipe audível a 1221 Hz para 60 ms.

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

Nota

Esse recurso pode não funcionar em todos os hosts em plataformas.

Exemplo 3: Definir várias opções

Set-PSReadLineOption pode definir várias opções com uma tabela de hash.

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

A tabela de hash $PSReadLineOptions define as chaves e os valores. Set-PSReadLineOption usa as chaves e os valores com @PSReadLineOptions para atualizar as opções de PSReadLine.

Você pode exibir as chaves e os valores que inserem o nome da tabela de hash, $PSReadLineOptions na linha de comando do PowerShell.

Exemplo 4: Definir várias opções de cor

Este exemplo mostra como definir mais de um valor de cor em um único comando.

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

Exemplo 5: Definir valores de cor para vários tipos

Este exemplo mostra três métodos diferentes para definir a cor dos tokens exibidos no 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"
}

Exemplo 6: Usar ViModeChangeHandler para exibir alterações no modo Vi

Este exemplo emite um escape de VT de alteração de cursor em resposta a uma alteração no modo do 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

A função OnViModeChange define as opções de cursor para os modos de do Vi: inserir e comando. ViModeChangeHandler usa o provedor Function: para fazer referência OnViModeChange como um objeto de bloco de script.

Para obter mais informações, consulte about_Providers.

Exemplo 7: Usar HistoryHandler para filtrar comandos adicionados ao histórico

O exemplo a seguir mostra como usar o AddToHistoryHandler para evitar salvar quaisquer comandos git no histórico.

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

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

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

O scriptblock retornará $false se o comando começou com git. Isso tem o mesmo efeito que retornar a SkipAddingenumeração AddToHistory. Se o comando não começar com git, o manipulador retornará $true e PSReadLine salvará o comando no histórico.

Exemplo 8: Usar CommandValidationHandler para validar um comando antes de ser executado

Este exemplo mostra como usar o parâmetro CommandValidationHandler para executar um comando de validação antes de ser executado. O exemplo verifica especificamente se o comando git com o subconjunto cmt e o substitui pelo nome completo commit. Dessa forma, você pode criar aliases abreviados para subcomandos.

# 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

Exemplo 9: Usando o parâmetro PromptText

Quando há um erro de análise, PSReadLine altera uma parte do prompt vermelho. O parâmetro PromptText informa PSReadLine a parte da cadeia de caracteres de prompt a ser vermelha.

Por exemplo, o exemplo a seguir cria um prompt que contém o caminho atual seguido pelo caractere maior que (>) e um espaço.

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

A primeira cadeia de caracteres é a parte da cadeia de caracteres de prompt que você deseja tornar vermelha quando houver um erro de análise. A segunda cadeia de caracteres é uma cadeia de caracteres alternativa para usar quando houver um erro de análise.

Parâmetros

-AddToHistoryHandler

Especifica um ScriptBlock que controla como os comandos são adicionados ao histórico de PSReadLine.

O ScriptBlock recebe a linha de comando como entrada.

O ScripBlock deve retornar um membro do enumeração AddToHistoryOption, o nome da cadeia de caracteres de um desses membros ou um valor booliano. A lista a seguir descreve os valores possíveis e seus efeitos.

• MemoryAndFile - Adicione o comando ao arquivo de histórico e à sessão atual.
• MemoryOnly - Adicione o comando ao histórico somente para a sessão atual.
• SkipAdding - Não adicione o comando ao arquivo de histórico da sessão atual.
• $false - Igual a se o valor fosse SkipAdding.
• $true - Igual a se o valor fosse MemoryAndFile.

Tipo:	Func<T,TResult>[System.String,System.Object]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-AnsiEscapeTimeout

Essa opção é específica para o Windows quando a entrada é redirecionada, por exemplo, ao executar em tmux ou screen.

Com a entrada redirecionada no Windows, muitas chaves são enviadas como uma sequência de caracteres começando com o caractere de escape. É impossível distinguir entre um único caractere de escape seguido por mais caracteres e uma sequência de escape válida.

A suposição é que o terminal pode enviar os caracteres mais rápido do que um tipo de usuário. PSReadLine aguarda esse tempo limite antes de concluir que recebeu uma sequência de escape completa.

Se você vir caracteres aleatórios ou inesperados ao digitar, poderá ajustar esse tempo limite.

Tipo:	Int32
Cargo:	Named
Valor padrão:	100
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-BellStyle

Especifica como PSReadLine responde a vários erros e condições ambíguas.

Os valores válidos são os seguintes:

• audível: um bipe curto.
• Visual: o texto pisca brevemente.
• Nenhum: sem comentários.

Tipo:	BellStyle
Cargo:	Named
Valor padrão:	Audible
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-Colors

O parâmetro Colors especifica várias cores usadas por PSReadLine.

O argumento é uma tabela de hash em que as chaves especificam os elementos e os valores especificam a cor. Para obter mais informações, consulte about_Hash_Tables.

As cores podem ser um valor de ConsoleColor, por exemplo, [ConsoleColor]::Redou uma sequência de escape ANSI válida. As sequências de escape válidas dependem do terminal. No PowerShell 5.0, uma sequência de escape de exemplo para texto vermelho é $([char]0x1b)[91m. No PowerShell 6 e mais recente, a mesma sequência de escape é `e[91m. Você pode especificar outras sequências de escape, incluindo os seguintes tipos:

Duas configurações de cor foram adicionadas para dar suporte à personalização do ListView no PSReadLine 2.2.0:

• ListPredictionColor - defina a cor para o caractere de > à esquerda e o nome de origem à direita, como [History]. Por padrão, ele usa DarkYellow como a cor do primeiro plano.

• ListPredictionSelectedColor – defina a cor para indicar que um item de lista está selecionado. Por padrão, ele usa DarkBlack como a cor da tela de fundo.

• Cor 256

• Cor de 24 bits

• Primeiro plano, plano de fundo ou ambos

• Inverso, negrito

Para obter mais informações sobre códigos de cores ANSI, consulte o artigo da Wikipédia código de escape ANSI.

As chaves válidas incluem:

• ContinuationPrompt: a cor do prompt de continuação.
• Ênfase: a cor de ênfase. Por exemplo, o texto correspondente ao pesquisar o histórico.
• Erro: a cor do erro. Por exemplo, no prompt.
• Seleção: a cor para realçar a seleção do menu ou o texto selecionado.
• padrão: a cor do token padrão.
• Comentário: a cor do token de comentário.
• palavra-chave: a cor do token de palavra-chave.
• String: a cor do token de cadeia de caracteres.
• operador : a cor do token do operador.
• Variável: a cor do token variável.
• Command: a cor do token de comando.
• de parâmetro: a cor do token de parâmetro.
• Tipo: a cor do token de tipo.
• Número: a cor do token numérico.
• Membro: a cor do token de nome do membro.
• InlinePrediction: a cor da exibição embutida da sugestão preditiva.
• ListPrediction: a cor do caractere de > principal e o nome de origem da previsão.
• ListPredictionSelected: a cor da previsão selecionada no modo de exibição de lista.

Tipo:	Hashtable
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CommandValidationHandler

Especifica um ScriptBlock chamado de ValidateAndAcceptLine. Se uma exceção for gerada, a validação falhará e o erro será relatado.

Antes de lançar uma exceção, o manipulador de validação pode colocar o cursor no ponto do erro para facilitar a correção. Um manipulador de validação também pode alterar a linha de comando para corrigir erros tipográficos comuns.

ValidateAndAcceptLine é usado para evitar desordenar seu histórico com comandos que não podem funcionar.

Tipo:	Action<T>[CommandAst]
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-CompletionQueryItems

Especifica o número máximo de itens de conclusão que são mostrados sem solicitação.

Se o número de itens a serem mostrados for maior que esse valor, PSReadLine solicitará sim/não antes de exibir os itens de conclusão.

Tipo:	Int32
Cargo:	Named
Valor padrão:	100
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ContinuationPrompt

Especifica a cadeia de caracteres exibida no início das linhas subsequentes quando a entrada de várias linhas é inserida. O padrão é duplo maior que sinais (>>). Uma cadeia de caracteres vazia é válida.

Tipo:	String
Cargo:	Named
Valor padrão:	>>
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DingDuration

Especifica a duração do bipe quando BellStyle é definido como audível.

Tipo:	Int32
Cargo:	Named
Valor padrão:	50ms
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-DingTone

Especifica o tom em Hertz (Hz) do bipe quando BellStyle está definido como Audível.

Tipo:	Int32
Cargo:	Named
Valor padrão:	1221
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-EditMode

Especifica o modo de edição de linha de comando. Usar esse parâmetro redefine todas as associações de chave definidas por Set-PSReadLineKeyHandler.

Os valores válidos são os seguintes:

• Windows: associações de chave emulam PowerShell, cmd e Visual Studio.
• Emacs: associações de chave emulam Bash ou Emacs.
• Vi: associações de chave emulam Vi.

Use Get-PSReadLineKeyHandler para ver as associações de chave para o editModeconfigurado no momento.

Tipo:	EditMode
Cargo:	Named
Valor padrão:	Windows
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ExtraPromptLineCount

Especifica o número de linhas extras.

Se o prompt abranger mais de uma linha, especifique um valor para esse parâmetro. Use essa opção quando quiser que linhas extras estejam disponíveis quando PSReadLine exibir o prompt depois de mostrar alguma saída. Por exemplo, PSReadLine retorna uma lista de conclusões.

Essa opção é necessária menos do que nas versões anteriores do PSReadLine, mas é útil quando a função InvokePrompt é usada.

Tipo:	Int32
Cargo:	Named
Valor padrão:	0
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-HistoryNoDuplicates

Essa opção controla o comportamento de recall. Comandos duplicados ainda são adicionados ao arquivo de histórico. Quando essa opção é definida, somente a invocação mais recente é exibida ao recuperar comandos. Comandos repetidos são adicionados ao histórico para preservar a ordenação durante o recall. No entanto, normalmente, você não deseja ver o comando várias vezes ao lembrar ou pesquisar o histórico.

Por padrão, a propriedade HistoryNoDuplicates do objeto PSConsoleReadLineOptions global está definida como True. Para alterar o valor da propriedade, você deve especificar o valor do SwitchParameter da seguinte maneira: -HistoryNoDuplicates:$False. Você pode voltar a True usando apenas o SwitchParameter, -HistoryNoDuplicates.

Usando o seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-HistorySavePath

Especifica o caminho para o arquivo em que o histórico é salvo. Computadores que executam plataformas Windows ou não Windows armazenam o arquivo em locais diferentes. O nome do arquivo é armazenado em uma variável $($Host.Name)_history.txt, por exemplo, ConsoleHost_history.txt.

Se você não usar esse parâmetro, o caminho padrão será o seguinte:

Windows

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

não Windows

• $env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
• $HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt

Tipo:	String
Cargo:	Named
Valor padrão:	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
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-HistorySaveStyle

Especifica como PSReadLine salva o histórico.

Os valores válidos são os seguintes:

• SaveIncrementally: salve o histórico depois que cada comando for executado e compartilhe em várias instâncias do PowerShell.
• SaveAtExit: anexar o arquivo de histórico quando o PowerShell for encerrado.
• SaveNothing: não use um arquivo de histórico.

Nota

Se você definir HistorySaveStyle para SaveNothing e defini-lo como SaveIncrementally posteriormente na mesma sessão, o PSReadLine salvará todos os comandos executados anteriormente na sessão.

Tipo:	HistorySaveStyle
Cargo:	Named
Valor padrão:	SaveIncrementally
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-HistorySearchCaseSensitive

Especifica que a pesquisa de histórico diferencia maiúsculas de minúsculas em funções como ReverseSearchHistory ou HistorySearchBackward.

Por padrão, a propriedade HistorySearchCaseSensitive do objeto PSConsoleReadLineOptions global está definida como False. Usar esse SwitchParameter define o valor da propriedade como True. Para alterar o valor da propriedade novamente, você deve especificar o valor do SwitchParameter da seguinte maneira: -HistorySearchCaseSensitive:$False.

Usando o seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-HistorySearchCursorMovesToEnd

Indica que o cursor se move para o final dos comandos que você carrega do histórico usando uma pesquisa. Quando esse parâmetro é definido como $False, o cursor permanece na posição em que estava quando você pressionou as setas para cima ou para baixo.

Por padrão, a propriedade HistorySearchCursorMovesToEnd do objeto PSConsoleReadLineOptions global está definida como False. Usando esse SwitchParameter definir o valor da propriedade como True. Para alterar o valor da propriedade novamente, você deve especificar o valor do SwitchParameter da seguinte maneira: -HistorySearchCursorMovesToEnd:$False.

Usando o seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	False
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MaximumHistoryCount

Especifica o número máximo de comandos a serem salvos no histórico de PSReadLine.

histórico de PSReadLine é separado do histórico do PowerShell.

Tipo:	Int32
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-MaximumKillRingCount

Especifica o número máximo de itens armazenados no anel de eliminação.

Tipo:	Int32
Cargo:	Named
Valor padrão:	10
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PredictionSource

Especifica a origem do PSReadLine para obter sugestões preditivas.

Os valores válidos são:

• Nenhum – desabilite o recurso do IntelliSense preditivo (padrão).
• Histórico – habilite o recurso do IntelliSense preditivo e use o histórico PSReadLine como a única origem.
• plug-in – habilite o recurso do IntelliSense preditivo e use os plug-ins (CommandPrediction) como a única origem. Esse valor foi adicionado no PSReadLine 2.2.0
• HistoryAndPlugin – habilite o recurso do IntelliSense preditivo e use o histórico e o plug-in como fontes. Esse valor foi adicionado no PSReadLine 2.2.0

Tipo:	Microsoft.PowerShell.PredictionSource
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PredictionViewStyle

Define o estilo para a exibição do texto preditivo. O padrão é InlineView.

• InlineView - o estilo existente atualmente, semelhante ao de casca de peixe e zsh. (padrão)
• ListView – as sugestões são renderizadas em uma lista suspensa e os usuários podem selecionar usando UpArrow e DownArrow.

Esse parâmetro foi adicionado ao PSReadLine 2.2.0

Tipo:	Microsoft.PowerShell.PredictionViewStyle
Cargo:	Named
Valor padrão:	InlineView
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-PromptText

Esse parâmetro define o valor da propriedade PromptText. O valor padrão é "> ".

PSReadLine analisa sua função de prompt para determinar como alterar apenas a cor de parte do prompt. Essa análise não é 100% confiável. Use essa opção se PSReadLine estiver alterando seu prompt de maneiras inesperadas. Inclua qualquer espaço em branco à direita.

O valor desse parâmetro pode ser uma única cadeia de caracteres ou uma matriz de duas cadeias de caracteres. A primeira cadeia de caracteres é a parte da cadeia de caracteres de prompt que você deseja que seja alterada para vermelho quando houver um erro de análise. A segunda cadeia de caracteres é uma cadeia de caracteres alternativa para usar quando houver um erro de análise.

Tipo:	String[]
Cargo:	Named
Valor padrão:	>
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ShowToolTips

Ao exibir possíveis conclusões, as dicas de ferramenta são mostradas na lista de conclusões.

Essa opção está habilitada por padrão. Essa opção não foi habilitada por padrão em versões anteriores do PSReadLine. Para desabilitar, defina essa opção como $False.

Esse parâmetro e a opção foram adicionados no PSReadLine 2.3.4.

Por padrão, a propriedade ShowToolTips do objeto PSConsoleReadLineOptions global está definida como True. Usar esse SwitchParameter define o valor da propriedade como True. Para alterar o valor da propriedade, você deve especificar o valor do SwitchParameter da seguinte maneira: -ShowToolTips:$False.

Usando o seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).ShowToolTips = $False

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	True
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-TerminateOrphanedConsoleApps

Esse parâmetro define a opção TerminateOrphanedConsoleApps para $true.

No Windows, quando você pressiona Ctrl+c para encerrar um processo, cada processo anexado a um console recebe um sinal de encerramento, em vez de apenas o shell ativo. Às vezes, quando um shell inicia uma árvore grande de processos filho (imagine um sistema de build, por exemplo) alguns processos podem sair, deixando vários processos simultaneamente tentando consumir a entrada do console.

Ao definir a opção TerminateOrphanedConsoleApps para $true, o PSReadLine registra a lista de processos que estão atualmente anexados ao console. Posteriormente, sempre que o PSReadLine for executado, ele obterá uma nova lista de processos anexados ao console e encerrará aqueles que não estão na lista original.

Esse parâmetro e a opção foram adicionados no PSReadLine 2.3.4.

Tipo:	SwitchParameter
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ViModeChangeHandler

Quando o ViModeIndicator for definido como Script, o bloco de script fornecido será invocado sempre que o modo for alterado. O bloco de script é fornecido com um argumento do tipo ViMode.

Esse parâmetro foi introduzido no PowerShell 7.

Tipo:	ScriptBlock
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-ViModeIndicator

Essa opção define o indicador visual para o modo de do Vi atual. Modo de inserção ou modo de comando.

Os valores válidos são os seguintes:

• Nenhum: não há indicador.
• prompt: o prompt altera a cor.
• cursor: o cursor altera o tamanho.
• Script: o texto especificado pelo usuário é impresso.

Tipo:	ViModeStyle
Cargo:	Named
Valor padrão:	None
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

-WordDelimiters

Especifica os caracteres que delimitam palavras para funções como ForwardWord ou KillWord.

Tipo:	String
Cargo:	Named
Valor padrão:	;:,.[]{}()/\|^&*-=+'"---
Obrigatório:	False
Aceitar a entrada de pipeline:	False
Aceitar caracteres curinga:	False

Entradas

None

Você não pode redirecionar objetos para este cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Links Relacionados

• about_PSReadLine
• Get-PSReadLineKeyHandler
• Get-PSReadLineOption
• Remove-PSReadLineKeyHandler
• Set-PSReadLineKeyHandler