Set-PSReadLineOption

  • Referência
Módulo:
PSReadLine

Personaliza o comportamento de 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 Set-PSReadLineOption cmdlet personaliza o comportamento do módulo PSReadLine quando você edita a linha de comando. Para visualizar as configurações do PSReadLine , use Get-PSReadLineOption.

As opções definidas por este comando aplicam-se apenas à sessão atual. Para persistir quaisquer 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 de primeiro plano verde em um plano de fundo cinza. Na sequência de escape usada no exemplo, 32 representa a cor de primeiro plano e 47 representa a cor de 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 de primeiro plano verde brilhante para o token Comment : "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á configurado para emitir um sinal sonoro a 1221 Hz durante 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 hash.

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

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

Pode ver as chaves e os valores que introduzem o nome da tabela hash, $PSReadLineOptions na linha de comandos 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 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: Use ViModeChangeHandler para exibir alterações no modo Vi

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

A função OnViModeChange define as opções do cursor para os modos Vi : inserir e comando. ViModeChangeHandler usa o provedor para fazer referência a Function: 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 tiver começado com git. Isso tem o mesmo efeito que retornar o SkipAdding enum AddToHistory . Se o comando não começar com git, o manipulador retornará $true e PSReadLine salvará o comando no histórico.

Exemplo 8: Use 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 que ele seja executado. O exemplo verifica especificamente o comando git com o subcomando cmt 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 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 ao PSReadLine a parte da cadeia de caracteres do prompt para ficar 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 há um erro de análise. A segunda cadeia de caracteres é uma cadeia de caracteres alternativa a ser usada quando há um erro de análise.

Parâmetros

-AddToHistoryHandler

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

O ScriptBlock recebe a linha de comando como entrada.

O ScripBlock deve retornar um membro do enum AddToHistoryOption , o nome da cadeia de caracteres de um desses membros ou um valor booleano. 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 fosse SkipAdding.
  • $true - O mesmo que se o valor fosse MemoryAndFile.
Tipo:Func<T,TResult>[System.String,System.Object]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-AnsiEscapeTimeout

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

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

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

Se vir carateres aleatórios ou inesperados quando escreve, pode ajustar este tempo limite.

Tipo:Int32
Position:Named
Default value:100
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 sinal sonoro curto.
  • Visual: O texto pisca brevemente.
  • Nenhum: Sem comentários.
Tipo:BellStyle
Position:Named
Default value:Audible
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Colors

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

O argumento é uma tabela de hash onde 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. Sequências de fuga 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 cor foram adicionadas para suportar a personalização do ListView PSReadLine 2.2.0:

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

  • ListPredictionSelectedColor - defina a cor para indicar que um item de lista está selecionado. Por padrão, ele usa DarkBlack como a cor do plano 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 ANSI escape code.

As chaves válidas incluem:

  • ContinuationPrompt: A cor do prompt de continuação.
  • Ênfase: A cor da ê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 padrão do token.
  • 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 variável cor do token.
  • Comando: A cor do token de comando.
  • Parâmetro: A cor do token do parâmetro.
  • 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 para a visualizaçã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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 podem funcionar.

Tipo:Action<T>[CommandAst]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 exibidos for maior que esse valor, PSReadLine solicitará sim/não antes de exibir os itens de conclusão.

Tipo:Int32
Position:Named
Default value:100
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 é o dobro maior que os sinais (>>). Uma cadeia de caracteres vazia é válida.

Tipo:String
Position:Named
Default value:>>
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DingDuration

Especifica a duração do bipe quando BellStyle está definido como Audível.

Tipo:Int32
Position:Named
Default value:50ms
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-DingTone

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

Tipo:Int32
Position:Named
Default value:1221
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-EditMode

Especifica o modo de edição da linha de comando. O uso desse parâmetro redefine todas as ligações de chave definidas pelo Set-PSReadLineKeyHandler.

Os valores válidos são os seguintes:

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

Use Get-PSReadLineKeyHandler para ver as ligações de chave para o EditMode configurado no momento.

Tipo:EditMode
Position:Named
Default value:Windows
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ExtraPromptLineCount

Especifica o número de linhas extras.

Se o prompt se estender por mais de uma linha, especifique um valor para esse parâmetro. Use esta 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ão.

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

Tipo:Int32
Position:Named
Default value:0
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-HistoryNoDuplicates

Esta 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 invocação mais recente aparece ao chamar comandos. Comandos repetidos são adicionados ao histórico para preservar a ordem durante a recuperação. No entanto, normalmente você não quer ver o comando várias vezes ao lembrar ou pesquisar o histórico.

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

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

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
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
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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: Anexe o arquivo de histórico quando o PowerShell for encerrado.
  • SaveNothing: Não use um arquivo de histórico.

Nota

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

Tipo:HistorySaveStyle
Position:Named
Default value:SaveIncrementally
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 global PSConsoleReadLineOptions é 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 seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 global PSConsoleReadLineOptions é definida como False. Usando este 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 seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-MaximumKillRingCount

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

Tipo:Int32
Position:Named
Default value:10
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PredictionSource

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

Os valores válidos são:

  • Nenhum - desative o recurso IntelliSense preditivo (padrão).
  • Histórico - ative o recurso IntelliSense preditivo e use o histórico PSReadLine como a única fonte.
  • Plugin - ative o recurso IntelliSense preditivo e use os plugins (CommandPrediction) como a única fonte. Este valor foi adicionado em PSReadLine 2.2.0
  • HistoryAndPlugin - ative o recurso preditivo IntelliSense e use o histórico e o plug-in como fontes. Este valor foi adicionado em PSReadLine 2.2.0
Tipo:Microsoft.PowerShell.PredictionSource
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PredictionViewStyle

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

  • InlineView - o estilo como existe hoje, semelhante como em casca de peixe e zsh. (predefinição)
  • ListView - as sugestões são renderizadas em uma lista suspensa e os usuários podem selecionar usando UpArrow e DownArrow.

Este parâmetro foi adicionado no PSReadLine 2.2.0

Tipo:Microsoft.PowerShell.PredictionViewStyle
Position:Named
Default value:InlineView
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-PromptText

Este parâmetro define o valor da propriedade PromptText . O valor predefinido é "> ".

PSReadLine analisa sua função de prompt para determinar como alterar apenas a cor de parte do prompt. Esta análise não é 100% fiável. Use esta 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 a ser usada quando há um erro de análise.

Tipo:String[]
Position:Named
Default value:>
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ShowToolTips

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

Por predefinição, esta opção encontra-se ativada. Esta opção não estava habilitada por padrão em versões anteriores do PSReadLine. Para desativar, defina esta opção como $False.

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

Por padrão, a propriedade ShowToolTips do objeto global PSConsoleReadLineOptions é 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 seguinte comando, você pode definir o valor da propriedade diretamente:

(Get-PSReadLineOption).ShowToolTips = $False

Tipo:SwitchParameter
Position:Named
Default value:True
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-TerminateOrphanedConsoleApps

Este 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 lançou alguma grande árvore de processos filho, (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. Depois, sempre que o PSReadLine for executado, ele receberá uma nova lista de processos anexados ao console e encerrará aqueles que não estão na lista original.

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

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ViModeChangeHandler

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

Esse parâmetro foi introduzido no PowerShell 7.

Tipo:ScriptBlock
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-WordDelimiters

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

Tipo:String
Position:Named
Default value:;:,.[]{}()/\|^&*-=+'"---
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

None

Não é possível canalizar objetos para este cmdlet.

Saídas

None

Este cmdlet não retorna nenhuma saída.