Compartilhar via

Set-PSReadLineKeyHandler

Módulo:
PSReadLine Module

Associa chaves a funções de manipulador de chave PSReadLine ou definidas pelo usuário.

Sintaxe

ScriptBlock 

Set-PSReadLineKeyHandler
    [-ScriptBlock] <ScriptBlock>
    [-Chord] <String[]>
    [-BriefDescription <String>]
    [-Description <String>]
    [-ViMode <ViMode>]
    [<CommonParameters>]

Function 

Set-PSReadLineKeyHandler
    [-Chord] <String[]>
    [-Function] <String>
    [-ViMode <ViMode>]
    [<CommonParameters>]

Description

O cmdlet Set-PSReadLineKeyHandler personaliza o resultado quando uma tecla ou sequência de teclas é pressionada. Com associações de chave definidas pelo usuário, você pode fazer quase tudo o que for possível em um script do PowerShell.

Exemplos

Exemplo 1: Associar a tecla de direção a uma função

Esse comando associa a tecla de seta para cima à função HistorySearchBackward. Essa função pesquisa o histórico de comandos em busca de linhas de comando que começam com o conteúdo atual da linha de comando.

Set-PSReadLineKeyHandler -Chord UpArrow -Function HistorySearchBackward

Exemplo 2: associar uma chave a um bloco de script

Este exemplo mostra como uma única chave pode ser usada para executar um comando. O comando associa a chave Ctrl+b a um bloco de script que limpa a linha, insere a palavra "build" e aceita a linha.

Set-PSReadLineKeyHandler -Chord Ctrl+b -ScriptBlock {
    [Microsoft.PowerShell.PSConsoleReadLine]::RevertLine()
    [Microsoft.PowerShell.PSConsoleReadLine]::Insert('build')
    [Microsoft.PowerShell.PSConsoleReadLine]::AcceptLine()
}

Parâmetros

-BriefDescription

Uma breve descrição da associação de chave. Esta descrição é exibida pelo cmdlet Get-PSReadLineKeyHandler.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ScriptBlock
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Chord

A chave ou a sequência de chaves a serem associadas a uma função ou bloco de script. Use uma única cadeia de caracteres para especificar uma única associação. Se a associação for uma sequência de chaves, separe as chaves por vírgula. Por exemplo: Ctrl+x,Ctrl+l

As referências de chave de letra são definidas usando letras minúsculas. Se você quiser definir um acorde que use uma letra maiúscula, o acorde deverá incluir a tecla Shift. Por exemplo, Ctrl+Shift+x e Ctrl+x criar associações diferentes.

Esse parâmetro aceita uma matriz de cadeias de caracteres. Cada cadeia de caracteres é uma associação separada, não uma sequência de chaves para uma única associação.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:Chave

Conjuntos de parâmetros

(All)
Cargo:0
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Description

Especifica uma descrição mais detalhada da associação de chave visível na saída do cmdlet Get-PSReadLineKeyHandler.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:LongDescription

Conjuntos de parâmetros

ScriptBlock
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Function

Especifica o nome de um manipulador de chaves existente fornecido pelo PSReadLine. Esse parâmetro permite que você revincula as associações de chave existentes ou associe um manipulador que está desvinculado no momento.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

Function
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ScriptBlock

Especifica um valor de bloco de script a ser executado quando o acorde é inserido. O PSReadLine passa um ou dois parâmetros para esse bloco de script. O primeiro parâmetro é um objeto ConsoleKeyInfo que representa a tecla pressionada. O segundo argumento pode ser qualquer objeto dependendo do contexto.

Propriedades do parâmetro

Tipo:ScriptBlock
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ScriptBlock
Cargo:1
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-ViMode

Especifique a qual modo vi a associação se aplica.

Os valores válidos são:

  • Insert
  • Command

Propriedades do parâmetro

Tipo:ViMode
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

None

Não é possível transferir objetos para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.