Set-PSReadLineOption
Personaliza o comportamento da edição de linha de comando no 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 Set-PSReadLineOption cmdlet personaliza o comportamento do módulo PSReadLine quando você está editando a linha de comando. Para exibir as configurações do PSReadLine , use Get-PSReadLineOption.
As opções definidas por este comando aplicam-se apenas à 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 de comentário com texto de 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 do plano 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 em primeiro plano verde brilhante para o token Comment : "Comment"="`e[92m".
Exemplo 2: Definir o estilo do sino
Neste exemplo, PSReadLine responderá a erros ou condições que exigem atenção do usuário. O BellStyle está configurado para emitir um bipe audível a 1221 Hz por 60 ms.
Set-PSReadLineOption -BellStyle Audible -DingTone 1221 -DingDuration 60Observação
Esse recurso pode não funcionar em todos os hosts nas 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 @PSReadLineOptionsA $PSReadLineOptions tabela de hash define as chaves e os valores. Set-PSReadLineOptionusa as chaves e os valores com @PSReadLineOptions para atualizar as opções PSReadLine.
Você pode exibir as chaves e os valores que inserem o nome $PSReadLineOptions da tabela de hash na linha de comando do PowerShell.
Exemplo 4: Definir várias opções de cores
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 de como definir a cor dos tokens exibidos em 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 VT de mudança de cursor em resposta a uma mudança de modo 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:OnViModeChangeA função OnViModeChange define as opções do cursor para os modos Vi : insert e command.
ViModeChangeHandler usa o Function: provedor para fazer referência a 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 qualquer comando git no histórico.
$ScriptBlock = {
Param([string]$line)
if ($line -match "^git") {
return $false
} else {
return $true
}
}
Set-PSReadLineOption -AddToHistoryHandler $ScriptBlockO scriptblock retorna $false se o comando começou com git. Isso tem o mesmo efeito que retornar a SkipAdding enumeraçã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 uma validação de um comando antes que ele seja executado. O exemplo verifica especificamente o comando git com o comando cmt sub e o substitui pelo nome commitcompleto . 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 ValidateAndAcceptLineExemplo 9: Usando o parâmetro PromptText
Quando há um erro de análise, PSReadLine altera uma parte do prompt em vermelho. O parâmetro PromptText informa a PSReadLine a parte da cadeia de caracteres de prompt a ser tornada 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 string é a parte da string de prompt que você deseja deixar vermelha quando houver um erro de análise. A segunda string é uma string alternativa a ser usada quando houver um erro de análise.
Parâmetros
-AddToHistoryHandler
Especifica um ScriptBlock que controla como os comandos são adicionados ao histórico do PSReadLine .
O ScriptBlock recebe a linha de comando como entrada.
O ScripBlock deve retornar um membro da enumeração AddToHistoryOption , o nome da cadeia de caracteres de um desses membros ou um valor booliano. A lista abaixo 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 apenas para a sessão atual.SkipAdding- Não adicione o comando ao arquivo de histórico da sessão atual.$false- O mesmo que se o valor fosseSkipAdding.$true- O mesmo que se o valor fosseMemoryAndFile.
| 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 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 usuário digita. 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 feedback.
| 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]::Red, ou uma sequência de escape ANSI válida. As sequências de escape válidas dependem do seu terminal. No PowerShell 5.0, um exemplo de sequência de escape 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 cores foram adicionadas para dar suporte à personalização do ListView PSReadLine 2.2.0:
ListPredictionColor - defina a cor do caractere à esquerda
>e do nome da fonte à direita, como[History]. Por padrão, ele usaDarkYellowcomo a cor do primeiro plano.ListPredictionSelectedColor - defina a cor para indicar que um item de lista está selecionado. Por padrão, ele usa
DarkBlackcomo cor de fundo.256 cores
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 Wikipedia 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 no histórico.
- Erro: A cor do erro. Por exemplo, no prompt.
- Seleção: A cor para destacar a seleção do menu ou o texto selecionado.
- Padrão: a cor padrão do token.
- Comentário: a cor do token de comentário.
- Palavra-chave: a cor do token de palavra-chave.
- Cadeia de caracteres: a cor do token de cadeia de caracteres.
- Operador: a cor do token do operador.
- Variável: a cor do token variável.
- Comando: A cor do token de comando.
- Parâmetro: o parâmetro token color.
- Tipo: a cor do token de tipo.
- Número: a cor do token numérico.
- Membro: a cor do token do nome do membro.
- InlinePrediction: a cor da exibição embutida da sugestão preditiva.
- ListPrediction: a cor do caractere principal
>e do nome da fonte de 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 que é chamado de ValidateAndAcceptLine. Se uma exceção for lançada, 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 sobrecarregar seu histórico com comandos que não funcionam.
| 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 avisar.
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 string exibida no início das linhas subsequentes quando a entrada de várias linhas é inserida. O padrão é duplo maior que sinais (>>). Uma string 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 está 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 da linha de comando. O uso desse parâmetro redefine todas as combinações de teclas definidas por Set-PSReadLineKeyHandler.
Os valores válidos são os seguintes:
- Windows: as associações de teclas emulam o PowerShell, o cmd e o Visual Studio.
- Emacs: As combinações de teclas emulam Bash ou Emacs.
- Vi: Os atalhos de teclado emulam o Vi.
Use Get-PSReadLineKeyHandler para ver as combinações de teclas para o EditMode configurado 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 é menos necessária do que nas versões anteriores do PSReadLine, mas é útil quando a InvokePrompt função é 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 recuperação. Comandos duplicados ainda são adicionados ao arquivo de histórico. Quando essa opção é definida, somente a chamada mais recente aparece ao chamar comandos. Comandos repetidos são adicionados ao histórico para preservar a ordem durante a recuperação. No entanto, você normalmente não deseja ver o comando várias vezes ao recuperar ou pesquisar o histórico.
Por padrão, a propriedade HistoryNoDuplicates do objeto PSConsoleReadLineOptions global é definida como True. Para alterar o valor da propriedade, você deve especificar o valor do SwitchParameter da seguinte maneira: -HistoryNoDuplicates:$False. Você pode definir de volta True usando apenas o SwitchParameter, -HistoryNoDuplicates.
Usando o comando a seguir, 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 onde o histórico é salvo. Os 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.
Estes são os valores válidos:
SaveIncrementally: salve o histórico depois que cada comando for executado e compartilhe entre várias instâncias do PowerShell.SaveAtExit: Acrescente o arquivo de histórico quando o PowerShell for encerrado.SaveNothing: Não use um arquivo de histórico.
Observação
Se você definir HistorySaveStyle como SaveNothing e, em seguida, defini-lo como SaveIncrementally mais tarde na mesma sessã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 é definida como False. O uso desse SwitchParameter define o valor da propriedade como True. Para alterar o valor da propriedade de volta, você deve especificar o valor do SwitchParameter da seguinte maneira: -HistorySearchCaseSensitive:$False.
Usando o comando a seguir, 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 é definida como False. Usando esse SwitchParameter , defina o valor da propriedade como True. Para alterar o valor da propriedade de volta, você deve especificar o valor do SwitchParameter da seguinte maneira: -HistorySearchCursorMovesToEnd:$False.
Usando o comando a seguir, 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 do PSReadLine .
O histórico do 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 de PSReadLine para obter sugestões preditivas.
Os valores válidos são:
- Nenhum – desabilite o recurso IntelliSense preditivo (padrão).
- Histórico – habilite o recurso IntelliSense preditivo e use o histórico PSReadLine como a única fonte.
- Plug-in – habilite o recurso IntelliSense preditivo e use os plug-ins (
CommandPrediction) como a única fonte. Esse valor foi adicionado no PSReadLine 2.2.0 - HistoryAndPlugin – habilite o recurso 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 hoje, semelhante ao da 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 Seta para cima e Seta para baixo.
Esse parâmetro foi adicionado no 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 seu prompt. Esta 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 string é a parte da string de prompt que você deseja que seja alterada para vermelho quando houver um erro de análise. A segunda string é uma string alternativa a ser usada 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 ferramentas são mostradas na lista de conclusões.
Por padrão, essa opção é ativada. Essa opção não estava habilitada por padrão em versões anteriores do PSReadLine. Para desativar, defina essa opção como $False.
Esse parâmetro e opção foram adicionados no PSReadLine 2.3.4.
Por padrão, a propriedade ShowToolTips do objeto PSConsoleReadLineOptions global é definida como True. O uso desse 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 comando a seguir, 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 como $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 grande árvore de processos filhos (imagine um sistema de compilação, por exemplo), alguns processos podem sair, deixando vários processos simultaneamente tentando consumir a entrada do console.
Ao definir a opção TerminateOrphanedConsoleApps como $true, 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 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 é definido como Script, o bloco de script fornecido será invocado toda vez que o modo for alterado. O bloco de script recebe 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
Esta opção define o indicador visual para o modo 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 muda de cor.
- Cursor: O cursor muda de 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 canalizar objetos para esse cmdlet.
Saídas
None
Esse cmdlet não retorna nenhuma saída.
Links Relacionados
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de