about_PSReadLine_Functions
Descrição breve
O PSReadLine fornece uma experiência de edição de linha de comando aprimorada no console do PowerShell.
Descrição longa
O PowerShell 7.3 é fornecido com o PSReadLine 2.2.6. A versão atual é PSReadLine 2.3.4. A versão atual do PSReadLine pode ser instalada e usada no Windows PowerShell 5.1 e mais recente. Para alguns recursos, você precisa estar executando o PowerShell 7.2 ou superior.
Este artigo documenta as funções fornecidas pelo PSReadLine 2.3.4. Essas funções podem ser vinculadas a pressionamentos de tecla para facilitar o acesso e a invocação.
Usando a classe Microsoft.PowerShell.PSConsoleReadLine
As funções a seguir estão disponíveis na classe Microsoft.PowerShell.PSConsoleReadLine.
Funções básicas de edição
Anular
Anular a ação atual, por exemplo: pesquisa incremental de histórico.
- Modo Emacs:
Ctrl+g
- Vi modo de inserção:
Ctrl+g
- Modo de comando Vi:
<Ctrl+g>
AcceptAndGetNext
Tente executar a entrada atual. Se ele puder ser executado (como AcceptLine), lembre-se do próximo item do histórico na próxima vez que ReadLine for chamado.
- Modo Emacs:
Ctrl+o
Linha Aceite
Tente executar a entrada atual. Se a entrada atual estiver incompleta (por exemplo, há um parêntese, colchete ou aspa de fechamento ausente), o prompt de continuação será exibido na próxima linha e PSReadLine aguardará as chaves para editar a entrada atual.
- Modo Windows:
Enter
- Modo Emacs:
Enter
- Vi modo de inserção:
Enter
AddLine
O prompt de continuação é exibido na próxima linha e PSReadLine aguarda as teclas para editar a entrada atual. Isso é útil para inserir a entrada de várias linhas como um único comando, mesmo quando uma única linha é entrada completa por si só.
- Modo Windows:
Shift+Enter
- Modo Emacs:
Shift+Enter
- Vi modo de inserção:
Shift+Enter
- Modo de comando Vi:
<Shift+Enter>
BackwardDeleteChar
Exclua o caractere antes do cursor.
- Modo Windows:
Backspace
,Ctrl+h
- Modo Emacs:
Backspace
,Ctrl+Backspace
, ,Ctrl+h
- Vi modo de inserção:
Backspace
- Modo de comando Vi:
<X>
,<d,h>
BackwardDeleteInput
Como BackwardKillInput - exclui o texto do ponto para o início da entrada, mas não coloca o texto excluído no anel de morte.
- Modo Windows:
Ctrl+Home
- Vi modo de inserção:
Ctrl+u
,Ctrl+Home
- Modo de comando Vi:
<Ctrl+u>
,<Ctrl+Home>
BackwardDeleteLine
Como BackwardKillLine - exclui o texto do ponto para o início da linha, mas não coloca o texto excluído no anel de morte.
- Modo de comando Vi:
<d,0>
BackwardDeleteWord
Exclui a palavra anterior.
- Modo de comando Vi:
<Ctrl+w>
,<d,b>
BackwardKillInput
Limpe o texto do início da entrada para o cursor. O texto limpo é colocado no anel de morte.
- Modo Emacs:
Ctrl+u
,Ctrl+x,Backspace
BackwardKillLine
Limpe o texto do início da linha lógica atual para o cursor. O texto limpo é colocado no anel de morte.
- A função não está acoplada.
BackwardKillWord
Limpe a entrada do início da palavra atual para o cursor. Se o cursor estiver entre palavras, a entrada será limpa do início da palavra anterior para o cursor. O texto limpo é colocado no anel de morte.
- Modo Windows:
Ctrl+Backspace
,Ctrl+w
- Modo Emacs:
Alt+Backspace
,Escape,Backspace
- Vi modo de inserção:
Ctrl+Backspace
- Modo de comando Vi:
<Ctrl+Backspace>
BackwardReplaceChar
Substitui o caractere na frente do cursor.
- Modo de comando Vi:
<c,h>
CancelLine
Cancele a entrada atual, deixando a entrada na tela, mas retorne ao host para que o prompt seja avaliado novamente.
- Vi modo de inserção:
Ctrl+c
- Modo de comando Vi:
<Ctrl+c>
Colocar o CapitalizeWord
Adicionado em PSReadLine 2.3.0
Converta o primeiro caractere da próxima palavra em maiúsculas e os caracteres restantes em minúsculas.
- Modo Emacs:
Alt+c
,Escape,c
Copiar
Copie a região selecionada para a área de transferência do sistema. Se nenhuma região for selecionada, copie a linha inteira.
- Modo Windows:
Ctrl+C
CopyOrCancelLine
Se o texto estiver selecionado, copie para a área de transferência, caso contrário, cancele a linha.
- Modo Windows:
Ctrl+c
- Modo Emacs:
Ctrl+c
Recortar
Excluir a região selecionada colocando texto excluído na área de transferência do sistema.
- Modo Windows:
Ctrl+x
DeleteChar
Exclua o caractere sob o cursor.
- Modo Windows:
Delete
- Modo Emacs:
Delete
- Vi modo de inserção:
Delete
- Modo de comando Vi:
<Delete>
,<x>
,<d,l>
, ,<d,Spacebar>
DeleteCharOrExit
Exclua o caractere sob o cursor ou, se a linha estiver vazia, saia do processo.
- Modo Emacs:
Ctrl+d
DeleteEndOfBuffer
Exclui até o final do buffer de várias linhas.
- Modo de comando Vi:
<d,G>
DeleteEndOfWord
Excluir até o final da palavra.
- Modo de comando Vi:
<d,e>
ExcluirLinha
Exclui a linha lógica atual de um buffer de várias linhas, habilitando desfazer.
- Modo de comando Vi:
<d,d>
,<d,_>
DeleteLineToFirstChar
Exclui do primeiro caractere não em branco da linha lógica atual em um buffer de várias linhas.
- Modo de comando Vi:
<d,^>
ExcluirNextLines
Exclui as linhas lógicas n atuais e seguintes em um buffer de várias linhas.
- Modo de comando Vi:
<d,j>
DeletePreviousLines
Exclui as linhas lógicas solicitadas anteriormente e a linha lógica atual em um buffer de várias linhas.
- Modo de comando Vi:
<d,k>
DeleteRelativeLines
Exclui do início do buffer para a linha lógica atual em um buffer de várias linhas.
Como a maioria dos comandos Vi, o comando pode ser precedido <d,g,g>
por um argumento numérico que especifica um número de linha absoluto, que, juntamente com o número de linha atual, compõem um intervalo de linhas a serem excluídas. Se não for especificado, o argumento numérico assumirá como padrão 1, que se refere à primeira linha lógica em um buffer de várias linhas.
O número real de linhas a serem excluídas da multilinha é calculado como a diferença entre o número de linha lógica atual e o argumento numérico especificado, que pode, portanto, ser negativo. Daí a parte relativa do nome do método.
- Modo de comando Vi:
<d,g,g>
ExcluirToEnd
Excluir até o final da linha.
- Modo de comando Vi:
<D>
,<d,$>
DeleteWord
Exclua a próxima palavra.
- Modo de comando Vi:
<d,w>
DowncaseWord
Adicionado em PSReadLine 2.3.0
Converta a próxima palavra em minúsculas.
- Modo Emacs:
Alt+l
,Escape,l
ForwardDeleteInput
Como KillLine - exclui o texto do ponto para o final da entrada, mas não coloca o texto excluído no anel de morte.
- Modo Windows:
Ctrl+End
- Vi modo de inserção:
Ctrl+End
- Modo de comando Vi:
<Ctrl+End>
ForwardDeleteLine
Exclui o texto do ponto para o final da linha lógica atual, mas não coloca o texto excluído no anel de morte.
- A função não está acoplada
InsertLineAbove
Uma nova linha vazia é criada acima da linha atual, independentemente de onde o cursor está na linha atual. O cursor se move para o início da nova linha.
- Modo Windows:
Ctrl+Enter
InsertLineAbaixo
Uma nova linha vazia é criada abaixo da linha atual, independentemente de onde o cursor está na linha atual. O cursor se move para o início da nova linha.
- Modo Windows:
Shift+Ctrl+Enter
InvertCase
Inverta o caso do caractere atual e passe para o próximo.
- Modo de comando Vi:
<~>
Linha de Morte
Limpe a entrada do cursor para o final da entrada. O texto limpo é colocado no anel de morte.
- Modo Emacs:
Ctrl+k
KillRegion
Mate o texto entre o cursor e a marca.
- A função não está acoplada.
KillWord
Limpe a entrada do cursor para o final da palavra atual. Se o cursor estiver entre palavras, a entrada será limpa do cursor para o final da próxima palavra. O texto limpo é colocado no anel de morte.
- Modo Windows:
Alt+d
,Ctrl+Delete
- Modo Emacs:
Alt+d
,Escape,d
- Vi modo de inserção:
Ctrl+Delete
- Modo de comando Vi:
<Ctrl+Delete>
Colar
Cole o texto da área de transferência do sistema.
- Modo Windows:
Ctrl+v
,Shift+Insert
- Vi modo de inserção:
Ctrl+v
- Modo de comando Vi:
<Ctrl+v>
Importante
Ao usar a função Colar , todo o conteúdo do buffer da área de transferência é colado no buffer de entrada do PSReadLine. O buffer de entrada é então passado para o analisador do PowerShell. A entrada colada usando o método de colar com o botão direito do mouse do aplicativo de console é copiada para o buffer de entrada, um caractere por vez. O buffer de entrada é passado para o analisador quando um caractere de nova linha é copiado. Portanto, a entrada é analisada uma linha por vez. A diferença entre os métodos de colagem resulta em comportamento de execução diferente.
Colar Depois
Cole a área de transferência após o cursor, movendo o cursor para o final do texto colado.
- Modo de comando Vi:
<p>
ColarAntes
Cole a área de transferência antes do cursor, movendo o cursor para o final do texto colado.
- Modo de comando Vi:
<P>
PrependAndAccept
Antece um '#' e aceite a linha.
- Modo de comando Vi:
<#>
Refazer
Desfazer um desfazer.
- Modo Windows:
Ctrl+y
- Vi modo de inserção:
Ctrl+y
- Modo de comando Vi:
<Ctrl+y>
RepeatLastCommand
Repita a última modificação de texto.
- Modo de comando Vi:
<.>
SubstituirChar
Substitua o caractere atual pelo próximo conjunto de caracteres digitados.
- Modo de comando Vi:
<c,l>
,<c,Spacebar>
SubstituirCharInPlace
Substitua o caractere atual por apenas um caractere.
- Modo de comando Vi:
<r>
RevertLine
Reverte toda a entrada para a entrada atual.
- Modo Windows:
Escape
- Modo Emacs:
Alt+r
,Escape,r
ShellBackwardKillWord
Limpe a entrada do início da palavra atual para o cursor. Se o cursor estiver entre palavras, a entrada será limpa do início da palavra anterior para o cursor. O texto limpo é colocado no anel de morte.
A função não está acoplada.
ShellKillWord
Limpe a entrada do cursor para o final da palavra atual. Se o cursor estiver entre palavras, a entrada será limpa do cursor para o final da próxima palavra. O texto limpo é colocado no anel de morte.
A função não está acoplada.
TrocaCaracteres
Troque o caractere atual e o anterior.
- Modo Emacs:
Ctrl+t
- Vi modo de inserção:
Ctrl+t
- Modo de comando Vi:
<Ctrl+t>
Desfazer
Desfazer uma edição anterior.
- Modo Windows:
Ctrl+z
- Modo Emacs:
Ctrl+_
,Ctrl+x,Ctrl+u
- Vi modo de inserção:
Ctrl+z
- Modo de comando Vi:
<Ctrl+z>
,<u>
Desfazer tudo
Desfazer todas as edições anteriores da linha.
- Modo de comando Vi:
<U>
UnixWordRubout
Limpe a entrada do início da palavra atual para o cursor. Se o cursor estiver entre palavras, a entrada será limpa do início da palavra anterior para o cursor. O texto limpo é colocado no anel de morte.
- Modo Emacs:
Ctrl+w
UpcaseWord
Adicionado em PSReadLine 2.3.0
Converta a próxima palavra em maiúsculas.
- Modo Emacs:
Alt+u
,Escape,u
ValidateAndAcceptLine
Tente executar a entrada atual. Se a entrada atual estiver incompleta (por exemplo, há um parêntese, colchete ou aspa de fechamento ausente), o prompt de continuação será exibido na próxima linha e PSReadLine aguardará as chaves para editar a entrada atual.
- Modo Emacs:
Ctrl+m
ViAcceptLine
Aceite a linha e alterne para o modo Inserir.
- Modo de comando Vi:
<Enter>
ViAcceptLineOrExit
Como DeleteCharOrExit no modo Emacs, mas aceita a linha em vez de excluir um caractere.
- Vi modo de inserção:
Ctrl+d
- Modo de comando Vi:
<Ctrl+d>
ViAppendLine
Uma nova linha é inserida abaixo da linha atual.
- Modo de comando Vi:
<o>
ViBackwardDeleteGlob
Exclui a palavra anterior, usando apenas espaço em branco como delimitador de palavras.
- Modo de comando Vi:
<d,B>
ViBackwardGlob
Move o cursor de volta para o início da palavra anterior, usando apenas espaço em branco como delimitadores.
- Modo de comando Vi:
<B>
ViBackwardReplaceGlob
Exclua para trás para o início da palavra anterior, conforme delimitado por espaço em branco, e entre no modo de inserção.
- Modo de comando Vi:
<c,B>
ViBackwardReplaceLine
Substitui a linha esquerda do cursor e todo o caminho até o início.
- Modo de comando Vi:
<c,0>
ViBackwardReplaceLineToFirstChar
Substitui a linha à esquerda do cursor e todos os caracteres, exceto um, para o início da linha.
- Modo de comando Vi:
<c,^>
ViBackwardReplaceWord
Substitua a palavra anterior.
- Modo de comando Vi:
<c,B>
ViDeleteBrace
Localize a chave, o parêntese ou o colchete correspondente e exclua todo o conteúdo interno, incluindo a chave.
- Modo de comando Vi:
<d,%>
ViDeleteEndOfGlob
Excluir até o final da palavra.
- Modo de comando Vi:
<d,E>
ViDeleteGlob
Exclua o próximo glob (palavra delimitada por espaço em branco).
- Modo de comando Vi:
<d,W>
ViDeleteToBeforeChar
Exclui até determinado caractere.
- Modo de comando Vi:
<d,t>
ViDeleteToBeforeCharBackward
Exclui até determinado caractere.
- Modo de comando Vi:
<d,T>
ViDeleteToChar
Exclui até determinado caractere.
- Modo de comando Vi:
<d,f>
ViDeleteToCharBackward
Exclui para trás até determinado caractere.
- Modo de comando Vi:
<d,F>
ViInsertAtBegining
Alterne para o modo Inserir e posicione o cursor no início da linha.
- Modo de comando Vi:
<I>
ViInsertAtEnd
Alterne para o modo Inserir e posicione o cursor no final da linha.
- Modo de comando Vi:
<A>
ViInsertLine
Uma nova linha é inserida acima da linha atual.
- Modo de comando Vi:
<O>
ViInsertWithAppend
Acrescentar a partir da posição da linha atual.
- Modo de comando Vi:
<a>
ViInsertWithDelete
Exclua o caractere atual e alterne para o modo Inserir.
- Modo de comando Vi:
<s>
ViJoinLines
Junta a linha atual e a próxima linha.
- Modo de comando Vi:
<J>
ViReplaceBrace
Substitua todos os caracteres entre o caractere de chave atual e seu parceiro correspondente.
- Modo de comando Vi:
<c,%>
ViReplaceEndOfGlob
Exclua até o final da palavra, conforme delimitado por espaço em branco, e entre no modo de inserção.
- Modo de comando Vi:
<c,E>
ViReplaceEndOfWord
Exclua até o final da palavra, conforme delimitado por espaço em branco e delimitadores comuns, e entre no modo de inserção.
- Modo de comando Vi:
<c,E>
ViReplaceGlob
Exclua até o início da próxima palavra, conforme delimitado por espaço em branco, e entre no modo de inserção.
- Modo de comando Vi:
<c,W>
ViReplaceLine
Apague toda a linha de comando.
- Modo de comando Vi:
<S>
,<c,c>
ViReplaceToBeforeChar
Substitui até determinado personagem.
- Modo de comando Vi:
<c,t>
ViReplaceToBeforeCharBackward
Substitui até determinado personagem.
- Modo de comando Vi:
<c,T>
ViReplaceToChar
Exclui até determinado caractere.
- Modo de comando Vi:
<c,f>
ViReplaceToCharBackward
Substitui até determinado personagem.
- Modo de comando Vi:
<c,F>
ViReplaceToEnd
Substitua os caracteres da posição do cursor até o final da linha.
- Modo de comando Vi:
<c,$>
,<C>
ViReplaceUntilEsc
Substitua o caractere atual até que um escape seja inserido ou a linha seja aceita.
- Modo de comando Vi:
<r>
ViReplaceWord
Substitua a palavra atual.
- Modo de comando Vi:
<c,W>
ViYankBeginningOfLine
Alterne do início do buffer para o cursor.
- Modo de comando Vi:
<y,0>
ViYankEndOfGlob
Deslize do cursor para o final da(s) PALAVRA(s).
- Modo de comando Vi:
<y,E>
ViYankEndOfWord
Deslize do cursor para o final da(s) palavra(s).
- Modo de comando Vi:
<y,e>
ViYankEsquerda
Caractere(s) Yank à esquerda do cursor.
- Modo de comando Vi:
<y,h>
ViYankLine
Mexa todo o buffer.
- Modo de comando Vi:
<y,y>
ViYankNextGlob
Deslize do cursor para o início da(s) próxima(s) PALAVRA(s).
- Modo de comando Vi:
<y,W>
ViYankNextWord
Mova a(s) palavra(s) após o cursor.
- Modo de comando Vi:
<y,w>
ViYankPercent
Yank de/para a cinta correspondente.
- Modo de comando Vi:
<y,%>
ViYankAnteriorGlob
Deslize do início da(s) PALAVRA(s) para o cursor.
- Modo de comando Vi:
<y,B>
ViYankPreviousWord
Empurre a(s) palavra(s) antes do cursor.
- Modo de comando Vi:
<y,b>
ViYankRight
Caractere(s) Yank sob e à direita do cursor.
- Modo de comando Vi:
<y,l>
,<y,Spacebar>
ViYankToEndOfLine
Deslize do cursor para o final do buffer.
- Modo de comando Vi:
<y,$>
ViYankToFirstChar
Alterne do primeiro caractere que não seja de espaço em branco para o cursor.
- Modo de comando Vi:
<y,^>
Ianque
Adicione o texto morto mais recentemente à entrada.
- Modo Emacs:
Ctrl+y
YankLastArg
Remova o último argumento da linha do histórico anterior. Com um argumento, a primeira vez que é invocado, comporta-se como YankNthArg. Se invocado várias vezes, em vez disso, ele itera pelo histórico e arg define a direção (negativo inverte a direção).
- Modo Windows:
Alt+.
- Modo Emacs:
Alt+.
,Alt+_
,Escape,.
, ,Escape,_
YankNthArg
Remova o primeiro argumento (após o comando) da linha de histórico anterior. Com um argumento, puxe o enésimo argumento (começando de 0), se o argumento for negativo, comece a partir do último argumento.
- Modo Emacs:
Ctrl+Alt+y
,Escape,Ctrl+y
YankPop
Se a operação anterior foi Yank ou YankPop, substitua o texto retirado anteriormente pelo próximo texto morto do anel de morte.
- Modo Emacs:
Alt+y
,Escape,y
Funções de conclusão
Concluído
Tente concluir o texto ao redor do cursor. Se houver várias conclusões possíveis, o prefixo inequívoco mais longo será usado para conclusão. Se tentar concluir a conclusão inequívoca mais longa, uma lista de possíveis conclusões será exibida.
- Modo Emacs:
Tab
MenuComplete
Tente concluir o texto ao redor do cursor. Se houver várias conclusões possíveis, o prefixo inequívoco mais longo será usado para conclusão. Se tentar concluir a conclusão inequívoca mais longa, uma lista de possíveis conclusões será exibida.
- Modo Windows:
Ctrl+@
,Ctrl+Spacebar
- Modo Emacs:
Ctrl+Spacebar
Possíveis Conclusões
Exiba a lista de possíveis conclusões.
- Modo Emacs:
Alt+=
- Vi modo de inserção:
Ctrl+Spacebar
- Modo de comando Vi:
<Ctrl+Spacebar>
TabCompletePróximo
Tente concluir o texto ao redor do cursor com a próxima conclusão disponível.
- Modo Windows:
Tab
- Modo de comando Vi:
<Tab>
TabCompletePrevious
Tente concluir o texto ao redor do cursor com a conclusão anterior disponível.
- Modo Windows:
Shift+Tab
- Modo de comando Vi:
<Shift+Tab>
ViTabCompletePróximo
Encerra o grupo de edição atual, se necessário, e invoca TabCompleteNext.
- Vi modo de inserção:
Tab
ViTabCompletePrevious
Encerra o grupo de edição atual, se necessário, e invoca TabCompletePrevious.
- Vi modo de inserção:
Shift+Tab
Funções de movimento do cursor
BackwardChar
Mova o cursor um caractere para a esquerda. Isso pode mover o cursor para a linha anterior de entrada de várias linhas.
- Modo Windows:
LeftArrow
- Modo Emacs:
LeftArrow
,Ctrl+b
Retrocesso
Mova o cursor de volta para o início da palavra atual ou, se entre palavras, o início da palavra anterior. Os limites de palavras são definidos por um conjunto configurável de caracteres.
- Modo Windows:
Ctrl+LeftArrow
- Modo Emacs:
Alt+b
,Escape,b
- Vi modo de inserção:
Ctrl+LeftArrow
- Modo de comando Vi:
<Ctrl+LeftArrow>
Os caracteres que definem limites de palavra são configurados na propriedade WordDelimiters do objeto PSConsoleReadLineOptions . Para exibir ou alterar a propriedade WordDelimiters , consulte Get-PSReadLineOption e Set-PSReadLineOption.
InícioDeLinha
Se a entrada tiver várias linhas, mova para o início da linha atual ou, se já estiver no início da linha, mova para o início da entrada. Se a entrada tiver uma única linha, mova para o início da entrada.
- Modo Windows:
Home
- Modo Emacs:
Home
,Ctrl+a
- Vi modo de inserção:
Home
- Modo de comando Vi:
<Home>
Fim de Linha
Se a entrada tiver várias linhas, mova para o final da linha atual ou, se já estiver no final da linha, mova para o final da entrada. Se a entrada tiver uma única linha, mova para o final da entrada.
- Modo Windows:
End
- Modo Emacs:
End
,Ctrl+e
- Vi modo de inserção:
End
ForwardChar
Mova o cursor um caractere para a direita. Isso pode mover o cursor para a próxima linha de entrada de várias linhas.
- Modo Windows:
RightArrow
- Modo Emacs:
RightArrow
,Ctrl+f
EncaminharWord
Mova o cursor para a frente até o final da palavra atual ou, se entre palavras, para o final da próxima palavra. Os limites de palavras são definidos por um conjunto configurável de caracteres.
- Modo Emacs:
Alt+f
,Escape,f
Os caracteres que definem limites de palavra são configurados na propriedade WordDelimiters do objeto PSConsoleReadLineOptions . Para exibir ou alterar a propriedade WordDelimiters , consulte Get-PSReadLineOption e Set-PSReadLineOption.
GotoBrace
Vá para a chave correspondente, parêntese ou colchete quadrado.
- Modo Windows:
Ctrl+]
- Vi modo de inserção:
Ctrl+]
- Modo de comando Vi:
<Ctrl+]>
GotoColuna
Mover para a coluna indicada por arg.
- Modo de comando Vi:
<|>
GotoFirstNonBlankOfLine
Mova o cursor para o primeiro caractere não em branco na linha.
- Modo de comando Vi:
<^>
,<_>
MoveToEndOfLine
Mova o cursor para o final da entrada.
- Modo de comando Vi:
<End>
,<$>
MoveToFirstLine
Vá para a primeira linha em um comando de várias linhas.
- Modo de comando Vi:
<g,g>
MoveToLastLine
Vá para a última linha em um comando de várias linhas.
- Modo de comando Vi:
<G>
NextLine
Mova o cursor para a próxima linha.
- A função não está acoplada.
PróximoPalavra
Mova o cursor para a frente até o início da próxima palavra. Os limites de palavras são definidos por um conjunto configurável de caracteres.
- Modo Windows:
Ctrl+RightArrow
- Vi modo de inserção:
Ctrl+RightArrow
- Modo de comando Vi:
<Ctrl+RightArrow>
Os caracteres que definem limites de palavra são configurados na propriedade WordDelimiters do objeto PSConsoleReadLineOptions . Para exibir ou alterar a propriedade WordDelimiters , consulte Get-PSReadLineOption e Set-PSReadLineOption.
PróximoWordEnd
Mova o cursor para a frente até o final da palavra atual ou, se entre palavras, para o final da próxima palavra. Os limites de palavras são definidos por um conjunto configurável de caracteres.
- Modo de comando Vi:
<e>
Os caracteres que definem limites de palavra são configurados na propriedade WordDelimiters do objeto PSConsoleReadLineOptions . Para exibir ou alterar a propriedade WordDelimiters , consulte Get-PSReadLineOption e Set-PSReadLineOption.
AnteriorLinha
Mova o cursor para a linha anterior.
- A função não está acoplada.
ShellBackwardWord
Mova o cursor de volta para o início da palavra atual ou, se entre palavras, o início da palavra anterior. Os limites de palavras são definidos por tokens do PowerShell.
- A função não está acoplada.
ShellForwardWord
Mova o cursor para a frente até o início da próxima palavra. Os limites de palavras são definidos por tokens do PowerShell.
- A função não está acoplada.
ShellNextWord
Mova o cursor para a frente até o final da palavra atual ou, se entre palavras, para o final da próxima palavra. Os limites de palavras são definidos por tokens do PowerShell.
- A função não está acoplada.
ViBackwardChar
Mova o cursor um caractere para a esquerda no modo de edição Vi. Isso pode mover o cursor para a linha anterior de entrada de várias linhas.
- Vi modo de inserção:
LeftArrow
- Modo de comando Vi:
<LeftArrow>
,<Backspace>
,<h>
ViBackwardWord
Mova o cursor de volta para o início da palavra atual ou, se entre palavras, o início da palavra anterior. Os limites de palavras são definidos por um conjunto configurável de caracteres.
- Modo de comando Vi:
<b>
Os caracteres que definem limites de palavra são configurados na propriedade WordDelimiters do objeto PSConsoleReadLineOptions . Para exibir ou alterar a propriedade WordDelimiters , consulte Get-PSReadLineOption e Set-PSReadLineOption.
ViEndOfGlob
Mova o cursor para o final desta palavra, conforme delimitado por espaço em branco.
- Modo de comando Vi:
<E>
ViEndOfPreviousGlob
Move para o final da palavra anterior, usando apenas espaço em branco como um delimitador de palavra.
- A função não está acoplada.
ViForwardChar
Mova o cursor um caractere para a direita no modo de edição Vi. Isso pode mover o cursor para a próxima linha de entrada de várias linhas.
- Vi modo de inserção:
RightArrow
- Modo de comando Vi:
<RightArrow>
,<Spacebar>
,<l>
ViGotoBrace
Semelhante ao GotoBrace, mas é baseado em caracteres em vez de token.
- Modo de comando Vi:
<%>
ViNextGlob
Move para a próxima palavra, usando apenas espaço em branco como delimitador de palavra.
- Modo de comando Vi:
<W>
ViNextWord
Mova o cursor para a frente até o início da próxima palavra. Os limites de palavras são definidos por um conjunto configurável de caracteres.
- Modo de comando Vi:
<w>
Os caracteres que definem limites de palavra são configurados na propriedade WordDelimiters do objeto PSConsoleReadLineOptions . Para exibir ou alterar a propriedade WordDelimiters , consulte Get-PSReadLineOption e Set-PSReadLineOption.
Funções de histórico
InícioDeHistória
Mover para o primeiro item do histórico.
- Modo Emacs:
Alt+<
Limpar História
Limpa o histórico no PSReadLine. Isso não afeta o histórico do PowerShell.
- Modo Windows:
Alt+F7
Fim da História
Mover para o último item (a entrada atual) no histórico.
- Modo Emacs:
Alt+>
ForwardSearchHistory
Execute uma pesquisa incremental pelo histórico.
- Modo Windows:
Ctrl+s
- Modo Emacs:
Ctrl+s
- Vi modo de inserção:
Ctrl+s
- Modo de comando Vi:
<Ctrl+s>
HistóriaPesquisarRetroceder
Substitua a entrada atual pelo item 'anterior' do histórico PSReadLine que corresponde aos caracteres entre o início e a entrada e o cursor.
- Modo Windows:
F8
HistorySearchForward
Substitua a entrada atual pelo item 'próximo' do histórico PSReadLine que corresponde aos caracteres entre o início e a entrada e o cursor.
- Modo Windows:
Shift+F8
PróximoHistória
Substitua a entrada atual pelo item 'próximo' do histórico do PSReadLine.
- Modo Windows:
DownArrow
- Modo Emacs:
DownArrow
,Ctrl+n
- Vi modo de inserção:
DownArrow
- Modo de comando Vi:
<DownArrow>
,<j>
,<+>
AnteriorHistória
Substitua a entrada atual pelo item 'anterior' do histórico do PSReadLine.
- Modo Windows:
UpArrow
- Modo Emacs:
UpArrow
,Ctrl+p
- Vi modo de inserção:
UpArrow
- Modo de comando Vi:
<UpArrow>
,<k>
,<->
ReverseSearchHistory
Execute uma pesquisa incremental para trás através do histórico.
- Modo Windows:
Ctrl+r
- Modo Emacs:
Ctrl+r
- Vi modo de inserção:
Ctrl+r
- Modo de comando Vi:
<Ctrl+r>
ViSearchHistoryBackward
Solicita uma cadeia de caracteres de pesquisa e inicia a pesquisa em AcceptLine.
- Modo de comando Vi:
</>
Funções diversas
Captura de tela
Iniciar captura de tela interativa - setas para cima/para baixo selecionar linhas, inserir cópias do texto selecionado para a área de transferência como texto e HTML.
- A função não está acoplada.
ClearScreen
Limpe a tela e desenhe a linha atual na parte superior da tela.
- Modo Windows:
Ctrl+l
- Modo Emacs:
Ctrl+l
- Vi modo de inserção:
Ctrl+l
- Modo de comando Vi:
<Ctrl+l>
DigitArgument
Inicie um novo argumento de dígito para passar para outras funções. Você pode usar isso como um multiplicador para a próxima função que é invocada por um pressionamento de tecla. Por exemplo, pressionar <Alt+1>
<Alt+0>
define o valor do argumento de dígito como 10. Em seguida, pressionar a #
tecla envia 10 #
caracteres (##########
) para a linha de entrada.
Da mesma forma, você pode usar isso com outras operações, como <Delete>
ou Left-Arrow
.
- Modo Windows:
Alt+0
,Alt+1
,Alt+2
,Alt+3
,Alt+4
,Alt+5
,Alt+6
,Alt+7
, ,Alt+8
, ,Alt+9
Alt+-
- Modo Emacs:
Alt+0
,Alt+1
,Alt+2
,Alt+3
,Alt+4
Alt+5
Alt+6
,Alt+7
, ,Alt+9
Alt+8
Alt+-
- Modo de comando Vi:
<0>
,<1>
,<2>
,<3>
,<4>
,<5>
,<6>
, ,<7>
, ,<8>
<9>
InvokePrompt
Apaga o prompt atual e chama a função de prompt para exibir novamente o prompt. Útil para manipuladores de chave personalizados que alteram o estado. Por exemplo, altere o diretório atual.
- A função não está acoplada.
RolagemDisplayDown
Role a tela para baixo uma tela.
- Modo Windows:
PageDown
- Modo Emacs:
PageDown
ScrollDisplayDownLine
Role a tela uma linha para baixo.
- Modo Windows:
Ctrl+PageDown
- Modo Emacs:
Ctrl+PageDown
ScrollDisplayToCursor
Role a tela até o cursor.
- Modo Emacs:
Ctrl+End
ScrollDisplayTop
Role a tela até a parte superior.
- Modo Emacs:
Ctrl+Home
RolagemDisplayUp
Role a tela para cima.
- Modo Windows:
PageUp
- Modo Emacs:
PageUp
ScrollDisplayUpLine
Role a tela uma linha para cima.
- Modo Windows:
Ctrl+PageUp
- Modo Emacs:
Ctrl+PageUp
ShowCommandHelp
Fornece uma exibição da ajuda completa do cmdlet. Quando o cursor está no final de um parâmetro totalmente expandido, pressionar a <F1>
tecla posiciona a exibição da ajuda no local desse parâmetro.
A ajuda é exibida em um buffer de tela alternativo usando um Pager de Microsoft.PowerShell.Pager. Ao sair do pager, você retornará à posição original do cursor na tela original. Este pager só funciona em aplicativos de terminal modernos, como o Windows Terminal.
- Modo Windows:
F1
- Modo Emacs:
F1
- Vi modo de inserção:
F1
- Modo de comando Vi:
<F1>
ShowKeyBindings
Mostrar todas as chaves acopladas.
- Modo Windows:
Ctrl+Alt+?
- Modo Emacs:
Ctrl+Alt+?
- Vi modo de inserção:
Ctrl+Alt+?
ShowParameterHelp
Fornece ajuda dinâmica para parâmetros, mostrando-a abaixo da linha de comando atual, como MenuComplete
. O cursor deve estar no final do nome do parâmetro totalmente expandido quando você pressiona a <Alt+h>
tecla.
- Modo Windows:
Alt+h
- Modo Emacs:
Alt+h
- Vi modo de inserção:
Alt+h
- Modo de comando Vi:
<Alt+h>
ViCommandMode
Alterne o modo de operação atual de Vi-Insert para Vi-Command.
- Vi modo de inserção:
Escape
ViDigitArgumentInChord
Inicie um novo argumento de dígito para passar para outras funções enquanto estiver em um dos acordes de vi.
- A função não está acoplada.
ViEditVisualmente
Edite a linha de comando em um editor de texto especificado por $env:EDITOR
ou $env:VISUAL
.
- Modo Emacs:
Ctrl+x,Ctrl+e
- Modo de comando Vi:
<v>
ViExit
Sai da concha.
- A função não está acoplada.
ViInsertMode
Alterne para o modo Inserir.
- Modo de comando Vi:
<i>
WhatIsKey
Leia uma chave e diga-me a que a chave está vinculada.
- Modo Windows:
Alt+?
- Modo Emacs:
Alt+?
Funções de previsão
AceitarNextSuggestionWord
Aceitar a próxima palavra da sugestão embutida ou selecionada
- A função não está acoplada.
AceitarSugestão
Ao usar InlineView
como o estilo de exibição para previsão, aceite a sugestão embutida atual.
- A função não está acoplada.
PróximoSugestão
Ao usar ListView
como o estilo de exibição para previsão, navegue até a próxima sugestão na lista.
- A função não está acoplada.
AnteriorSugestão
Ao usar ListView
como o estilo de exibição para previsão, navegue até a sugestão anterior na lista.
- A função não está acoplada.
ShowFullPredictionTooltip
Mostrar a dica de ferramenta do item de lista selecionado no momento na exibição completa.
- Modo Windows:
F4
- Modo Emacs:
F4
- Vi modo de inserção:
F4
SwitchPredictionView
Alternar o estilo de exibição para previsão entre InlineView
e ListView
.
- Modo Windows:
F2
- Modo Emacs:
F2
- Vi modo de inserção:
F2
Pesquisar funções
Busca de Personagens
Leia um personagem e procure a próxima ocorrência desse personagem. Se um argumento for especificado, pesquise para frente (ou para trás, se negativo) a enésima ocorrência.
- Modo Windows:
F3
- Modo Emacs:
Ctrl+]
- Vi modo de inserção:
F3
- Modo de comando Vi:
<F3>
CharacterSearchBackward
Leia um caractere e procure para trás a próxima ocorrência desse caractere. Se um argumento for especificado, pesquise para trás (ou para frente se negativo) a enésima ocorrência.
- Modo Windows:
Shift+F3
- Modo Emacs:
Ctrl+Alt+]
- Vi modo de inserção:
Shift+F3
- Modo de comando Vi:
<Shift+F3>
RepeatLastCharSearch
Repita a última pesquisa de caracteres gravada.
- Modo de comando Vi:
<;>
RepeatLastCharSearchBackwards
Repita a última pesquisa de caracteres gravada, mas na direção oposta.
- Modo de comando Vi:
<,>
RepeatSearch
Repita a última pesquisa na mesma direção de antes.
- Modo de comando Vi:
<n>
RepeatSearchBackward
Repita a última pesquisa na mesma direção de antes.
- Modo de comando Vi:
<N>
SearchChar
Leia o próximo personagem e depois encontre-o, daqui para frente.
- Modo de comando Vi:
<f>
SearchCharBackward
Leia o próximo caractere e depois encontre-o, indo para trás.
- Modo de comando Vi:
<F>
SearchCharBackwardWithBackoff
Leia o próximo caractere e encontre-o, indo para trás e, em seguida, recue um personagem.
- Modo de comando Vi:
<T>
SearchCharWithBackoff
Leia o próximo personagem e, em seguida, encontre-o, indo em frente e, em seguida, recue de um personagem.
- Modo de comando Vi:
<t>
PesquisarAvançar
Solicita uma cadeia de caracteres de pesquisa e inicia a pesquisa em AcceptLine.
- Modo de comando Vi:
<?>
Funções de seleção
ExchangePointAndMark
O cursor é colocado no local da marca e a marca é movida para o local do cursor.
- Modo Emacs:
Ctrl+x,Ctrl+x
SelectAll
Selecione a linha inteira.
- Modo Windows:
Ctrl+a
SelectBackwardChar
Ajuste a seleção atual para incluir o caractere anterior.
- Modo Windows:
Shift+LeftArrow
- Modo Emacs:
Shift+LeftArrow
SelectBackwardsLine
Ajuste a seleção atual para incluir do cursor ao início da linha.
- Modo Windows:
Shift+Home
- Modo Emacs:
Shift+Home
SelectBackwardWord
Ajuste a seleção atual para incluir a palavra anterior.
- Modo Windows:
Shift+Ctrl+LeftArrow
- Modo Emacs:
Alt+B
SelectCommandArgument
Faça a seleção visual dos argumentos de comando. A seleção de argumentos tem como escopo um bloco de script. Com base na posição do cursor, ele pesquisa do bloco de script mais interno para o bloco de script mais externo e pára quando encontra argumentos em um escopo de bloco de script.
Essa função honra DigitArgument. Ele trata os valores de argumento positivo ou negativo como os deslocamentos para frente ou para trás do argumento selecionado no momento ou da posição atual do cursor quando nenhum argumento é selecionado.
- Modo Windows:
Alt+a
- Modo Emacs:
Alt+a
SelectForwardChar
Ajuste a seleção atual para incluir o próximo caractere.
- Modo Windows:
Shift+RightArrow
- Modo Emacs:
Shift+RightArrow
SelectForwardWord
Ajuste a seleção atual para incluir a próxima palavra usando o ForwardWord.
- Modo Emacs:
Alt+F
SelectLine
Ajuste a seleção atual para incluir do cursor até o final da linha.
- Modo Windows:
Shift+End
- Modo Emacs:
Shift+End
SelecionarNextWord
Ajuste a seleção atual para incluir a próxima palavra.
- Modo Windows:
Shift+Ctrl+RightArrow
SelectShellBackwardWord
Ajuste a seleção atual para incluir a palavra anterior usando ShellBackwardWord.
- A função não está acoplada.
SelectShellForwardWord
Ajuste a seleção atual para incluir a próxima palavra usando ShellForwardWord.
- A função não está acoplada.
SelectShellNextWord
Ajuste a seleção atual para incluir a próxima palavra usando ShellNextWord.
- A função não está acoplada.
Marca
Marque o local atual do cursor para uso em um comando de edição subsequente.
- Modo Emacs:
Ctrl+@
APIs de suporte à vinculação de chave personalizada
As funções a seguir são públicas em Microsoft.PowerShell.PSConsoleReadLine, mas não podem ser vinculadas diretamente a uma chave. A maioria é útil em associações de chave personalizadas.
void AddToHistory(string command)
Adicione uma linha de comando ao histórico sem executá-la.
void ClearKillRing()
Limpe o anel de morte. Isso é usado principalmente para testes.
void Delete(int start, int length)
Exclua caracteres de comprimento do início. Esta operação suporta desfazer/refazer.
void Ding()
Execute a ação Ding com base na preferência do usuário.
void GetBufferState([ref] string input, [ref] int cursor)
void GetBufferState([ref] Ast ast, [ref] Token[] tokens,
[ref] ParseError[] parseErrors, [ref] int cursor)
Essas duas funções recuperam informações úteis sobre o estado atual do buffer de entrada. O primeiro é mais comumente usado para casos simples. O segundo é usado se sua ligação estiver fazendo algo mais avançado com o Ast.
IEnumerable[Microsoft.PowerShell.KeyHandler]
GetKeyHandlers(bool includeBound, bool includeUnbound)
IEnumerable[Microsoft.PowerShell.KeyHandler]
GetKeyHandlers(string[] Chord)
Essas duas funções são usadas pelo Get-PSReadLineKeyHandler
. O primeiro é usado para obter todas as ligações de chave. O segundo é usado para obter ligações de chave específicas.
Microsoft.PowerShell.PSConsoleReadLineOptions GetOptions()
Essa função é usada por Get-PSReadLineOption e provavelmente não é muito útil em uma associação de chave personalizada.
void GetSelectionState([ref] int start, [ref] int length)
Se não houver seleção na linha de comando, a função retornará -1 em início e comprimento. Se houver uma seleção na linha de comando, o início e o comprimento da seleção serão retornados.
void Insert(char c)
void Insert(string s)
Insira um caractere ou cadeia de caracteres no cursor. Esta operação suporta desfazer/refazer.
string ReadLine(runspace remoteRunspace,
System.Management.Automation.EngineIntrinsics engineIntrinsics)
Este é o principal ponto de entrada para PSReadLine. Ele não oferece suporte à recursão, portanto, não é útil em uma associação de chave personalizada.
void RemoveKeyHandler(string[] key)
Essa função é usada por Remove-PSReadLineKeyHandler e provavelmente não é muito útil em uma associação de chave personalizada.
void Replace(int start, int length, string replacement)
Substitua algumas entradas. Esta operação suporta desfazer/refazer. Isso é preferido em relação a Excluir seguido de Inserir porque é tratado como uma única ação para desfazer.
void SetCursorPosition(int cursor)
Mova o cursor para o deslocamento fornecido. O movimento do cursor não é rastreado para desfazer.
void SetOptions(Microsoft.PowerShell.SetPSReadLineOption options)
Essa função é um método auxiliar usado pelo cmdlet Set-PSReadLineOption
, mas pode ser útil para uma associação de chave personalizada que deseja alterar temporariamente uma configuração.
bool TryGetArgAsInt(System.Object arg, [ref] int numericArg,
int defaultNumericArg)
Esse método auxiliar é usado para associações personalizadas que honram DigitArgument. Uma chamada típica se parece com
[int]$numericArg = 0
[Microsoft.PowerShell.PSConsoleReadLine]::TryGetArgAsInt($arg,
[ref]$numericArg, 1)
Observações
Comportamento do evento OnIdle
Quando PSReadLine está em uso, o evento OnIdle é acionado quando
ReadKey()
o tempo limite (sem digitação em 300ms). O evento pode ser sinalizado enquanto o usuário está no meio da edição de uma linha de comando, por exemplo, o usuário está lendo a ajuda para decidir qual parâmetro usar.A partir do PSReadLine 2.2.0-beta4, o comportamento do OnIdle foi alterado para sinalizar o evento somente se houver um
ReadKey()
tempo limite e o buffer de edição atual estiver vazio.
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
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, consulteEnviar e exibir comentários de