当前位置:网站首页 > 更多 > 玩电脑 > 正文

[玩转系统] 设置 PSReadLineKeyHandler (PSReadLine)

作者:精品下载站 日期:2024-12-14 02:00:14 浏览:13 分类:玩电脑

设置 PSReadLineKeyHandler (PSReadLine)


设置 PSReadLineKeyHandler

模块 :PS阅读线

将键绑定到用户定义或 PSReadLine 键处理函数。

句法

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

描述

Set-PSReadLineKeyHandler cmdlet 可自定义按下一个键或一系列键时的结果。通过用户定义的键绑定,您几乎可以在 PowerShell 脚本中执行任何可能的操作。

示例

示例 1:将箭头键绑定到函数

此命令将向上箭头键绑定到 HistorySearchBackward 函数。此函数在命令历史记录中搜索以命令行当前内容开头的命令行。

Set-PSReadLineKeyHandler -Chord UpArrow -Function HistorySearchBackward

示例 2:将键绑定到脚本块

此示例显示如何使用单个键来运行命令。该命令将 Ctrl+b 键绑定到一个脚本块,该脚本块清除该行,插入单词“build”,然后接受该行。

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

参数

-BriefDescription

键绑定的简要说明。此描述由 Get-PSReadLineKeyHandler cmdlet 显示。

类型 :

String

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Chord

要绑定到函数或脚本块的键或键序列。使用单个字符串指定单个绑定。如果绑定是一系列键,请用逗号分隔键。例如:Ctrl+x,Ctrl+l

字母键引用使用小写字母定义。如果要定义使用大写字母的和弦,则该和弦必须包含 Shift 键。例如,Ctrl+Shift+xCtrl+x 创建不同的绑定。

该参数接受字符串数组。每个字符串都是一个单独的绑定,而不是单个绑定的键序列。

类型 :

String[]

别名:

Key

位置:

0

默认值:

None

必需的:

True

接受管道输入:

False

接受通配符:

False

-Description

指定在 Get-PSReadLineKeyHandler cmdlet 的输出中可见的键绑定的更详细描述。

类型 :

String

别名:

LongDescription

位置:

命名

默认值:

None

必需的:

False

接受管道输入:

False

接受通配符:

False

-Function

指定 PSReadLine 提供的现有键处理程序的名称。此参数允许您重新绑定现有的键绑定,或绑定当前未绑定的处理程序。

类型 :

String

位置:

1

默认值:

None

必需的:

True

接受管道输入:

False

接受通配符:

False

-ScriptBlock

指定输入和弦时要运行的脚本块值。 PSReadLine 将一两个参数传递给此脚本块。第一个参数是一个 ConsoleKeyInfo 对象,表示按下的键。第二个参数可以是任何对象,具体取决于上下文。

类型 :

ScriptBlock

位置:

1

默认值:

None

必需的:

True

接受管道输入:

False

接受通配符:

False

-ViMode

指定绑定适用的 vi 模式。

有效值为:

    Insert
    Command
    类型 :

    ViMode

    位置:

    命名

    默认值:

    None

    必需的:

    False

    接受管道输入:

    False

    接受通配符:

    False

    输入

    您无法通过管道将对象传递到此 cmdlet。

    输出

    此 cmdlet 不返回任何输出。

    您需要 登录账户 后才能发表评论

    取消回复欢迎 发表评论:

    关灯