Aracılığıyla paylaş

Set-PSReadLineKeyHandler

Modül:
PSReadLine Module

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

Syntax

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

Set-PSReadLineKeyHandler cmdlet'i 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 Get-PSReadLineKeyHandler cmdlet'i tarafından görüntülenir.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ScriptBlock
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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+x ve Ctrl+x farklı bağlamalar oluşturur.

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

Parametre özellikleri

Tür:

String[]

Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:Anahtar

Parametre kümeleri

(All)
Position:0
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-Description

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

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False
Diğer adlar:LongDescription

Parametre kümeleri

ScriptBlock
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer: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.

Parametre özellikleri

Tür:String
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

Function
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ScriptBlock

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

Parametre özellikleri

Tür:ScriptBlock
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

ScriptBlock
Position:1
Zorunlu:True
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

-ViMode

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

Geçerli değerler şunlardır:

  • Insert
  • Command

Parametre özellikleri

Tür:ViMode
Default value:None
Joker karakterleri destekler:False
DontShow:False

Parametre kümeleri

(All)
Position:Named
Zorunlu:False
İşlem hattından gelen değer:False
Özellik adına göre işlem hattından gelen değer:False
Kalan bağımsız değişkenlerden elde edilen değer:False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

None

Nesneleri bu cmdlet'e yöneltemezsiniz.

Çıkışlar

None

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