Set-PSReadLineKeyHandler

  • Başvuru
Modül:
PSReadLine

Anahtarları kullanıcı tanımlı veya PSReadLine anahtar işleyici işlevlerine bağlar.

Syntax

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

Description

Cmdlet, Set-PSReadLineKeyHandler bir tuşa veya tuş dizisine basıldığında sonucu özelleştirir. Kullanıcı tanımlı anahtar bağlamalarıyla, PowerShell betiği içinden mümkün olan hemen her şeyi yapabilirsiniz.

Örnekler

Örnek 1: Ok tuşunu bir işleve bağlama

Bu komut yukarı ok tuşunu HistorySearchBackward işlevine bağlar. Bu işlev, komut satırının geçerli içeriğiyle başlayan komut satırlarını komut geçmişinde arar.

Set-PSReadLineKeyHandler -Chord UpArrow -Function HistorySearchBackward

Örnek 2: Betik bloğuna anahtar bağlama

Bu örnekte, tek bir anahtarın komutu çalıştırmak için nasıl kullanılabileceğini gösterir. komutu, anahtarı Ctrl+b satırı temizleyen bir betik bloğuna bağlar, "build" sözcüğünü ekler ve ardından satırı kabul eder.

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

Parametreler

-BriefDescription

Anahtar bağlamanın kısa bir açıklaması. Bu açıklama cmdlet'i Get-PSReadLineKeyHandler tarafından görüntülenir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Chord

Bir işleve veya betik bloğuna bağlanacak anahtar veya anahtar dizisi. Tek bir bağlama belirtmek için tek bir dize kullanın. Bağlama bir anahtar dizisiyse, tuşları virgülle ayırın. Örneğin: Ctrl+x,Ctrl+l

Harf anahtarı başvuruları küçük harfler kullanılarak tanımlanır. Büyük harf kullanan bir akor tanımlamak istiyorsanız, akor Shift tuşunu içermelidir. Örneğin, Ctrl+Shift+xCtrl+x farklı bağlamalar oluşturun.

Bu parametre bir dizi dizeyi kabul eder. Her dize ayrı bir bağlamadır, tek bir bağlama için anahtar dizisi değildir.

Type:String[]
Aliases:Key
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Description

Cmdlet'in çıkışında görünen anahtar bağlamasının Get-PSReadLineKeyHandler daha ayrıntılı bir açıklamasını belirtir.

Type:String
Aliases:LongDescription
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Function

PSReadLine tarafından sağlanan mevcut bir anahtar işleyicisinin adını belirtir. Bu parametre, mevcut anahtar bağlamalarını yeniden bağlamanıza veya şu anda ilişkisiz olan bir işleyici bağlamanıza olanak tanır.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ScriptBlock

Akor girildiğinde çalıştırılacak bir betik bloğu değeri belirtir. PSReadLine bu betik bloğuna bir veya iki parametre geçirir. İlk parametre, basılan anahtarı temsil eden bir ConsoleKeyInfo nesnesidir. İkinci bağımsız değişken, bağlama bağlı olarak herhangi bir nesne olabilir.

Type:ScriptBlock
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-ViMode

Bağlamanın hangi vi moduna uygulanacağını belirtin.

Geçerli değerler:

  • Insert
  • Command
Type:ViMode
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

Bu cmdlet çıkış döndürmez.