Set-PSReadLineKeyHandler
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+x
Ctrl+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.
İlişkili Bağlantılar
PowerShell
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin