Set-PSReadLineOption

Modül:

PSReadLine Module

PSReadLinekomut satırı düzenleme davranışını özelleştirir.

Syntax

Default (Varsayılan)

Set-PSReadLineOption
    [-EditMode <EditMode>]
    [-ContinuationPrompt <string>]
    [-HistoryNoDuplicates]
    [-AddToHistoryHandler <Func[string,Object]>]
    [-CommandValidationHandler <Action[CommandAst]>]
    [-HistorySearchCursorMovesToEnd]
    [-MaximumHistoryCount <int>]
    [-MaximumKillRingCount <int>]
    [-ShowToolTips]
    [-ExtraPromptLineCount <int>]
    [-DingTone <int>]
    [-DingDuration <int>]
    [-BellStyle <BellStyle>]
    [-CompletionQueryItems <int>]
    [-WordDelimiters <string>]
    [-HistorySearchCaseSensitive]
    [-HistorySaveStyle <HistorySaveStyle>]
    [-HistorySavePath <string>]
    [-AnsiEscapeTimeout <int>]
    [-PromptText <string[]>]
    [-ViModeIndicator <ViModeStyle>]
    [-ViModeChangeHandler <scriptblock>]
    [-PredictionSource <PredictionSource>]
    [-PredictionViewStyle <PredictionViewStyle>]
    [-Colors <hashtable>]
    [-TerminateOrphanedConsoleApps]
    [<CommonParameters>]

Description

cmdlet'i, komut satırını düzenlerken PSReadLine modülünün davranışını özelleştirir. PSReadLine ayarlarını görüntülemek için kullanın.

Bu komut tarafından ayarlanan seçenekler yalnızca geçerli oturum için geçerlidir. Seçenekleri kalıcı hale getirmek için bunları bir profil betiğine ekleyin. Daha fazla bilgi için bkz. about_Profiles ve kabuk ortamınızı özelleştirme.

Örnekler

Örnek 1: Ön plan ve arka plan renklerini ayarlama

Bu örnek, PSReadLine yeşil ön plan metniyle Açıklama belirtecini gri arka planda görüntüleyecek şekilde ayarlar. Örnekte kullanılan kaçış dizisinde 32 ön plan rengini, 47 arka plan rengini temsil eder.

Set-PSReadLineOption -Colors @{ "Comment"="`e[32;47m" }

Yalnızca ön plan metin rengini ayarlamayı seçebilirsiniz. Örneğin, Açıklama belirteci için parlak yeşil ön plan metin rengi: .

Örnek 2: Zil stilini ayarlama

Bu örnekte PSReadLine, kullanıcı dikkatini gerektiren hatalara veya koşullara yanıt verecektir. BellStyle, 60 ms için 1221 Hz'de sesli bir bip sesi yayacak şekilde ayarlanmıştır.

Set-PSReadLineOption -BellStyle Audible -DingTone 1221 -DingDuration 60

Uyarı

Bu özellik platformlardaki tüm konaklarda çalışmayabilir.

Örnek 3: Birden çok seçenek ayarlama

, karma tabloyla birden çok seçenek ayarlayabilir.

$PSReadLineOptions = @{
    EditMode = "Emacs"
    HistoryNoDuplicates = $true
    HistorySearchCursorMovesToEnd = $true
    Colors = @{
        "Command" = "#8181f7"
    }
}
Set-PSReadLineOption @PSReadLineOptions

karma tablosu anahtarları ve değerleri ayarlar. , seçeneklerini güncelleştirmek için anahtarları ve değerleri kullanır.

PowerShell komut satırında karma tablo adını giren anahtarları ve değerleri görüntüleyebilirsiniz.

Örnek 4: Birden çok renk seçeneği ayarlama

Bu örnekte, tek bir komutta birden fazla renk değerinin nasıl ayarlanacağı gösterilmektedir.

Set-PSReadLineOption -Colors @{
  Command            = 'Magenta'
  Number             = 'DarkGray'
  Member             = 'DarkGray'
  Operator           = 'DarkGray'
  Type               = 'DarkGray'
  Variable           = 'DarkGreen'
  Parameter          = 'DarkGreen'
  ContinuationPrompt = 'DarkGray'
  Default            = 'DarkGray'
}

Örnek 5: Birden çok tür için renk değerleri ayarlama

Bu örnekte, PSReadLineiçinde görüntülenen belirteçlerin rengini ayarlamaya yönelik üç farklı yöntem gösterilmektedir.

Set-PSReadLineOption -Colors @{
 # Use a ConsoleColor enum
 "Error" = [ConsoleColor]::DarkRed

 # 24 bit color escape sequence
 "String" = "$([char]0x1b)[38;5;100m"

 # RGB value
 "Command" = "#8181f7"
}

Örnek 6: Vi modu değişikliklerini görüntülemek için ViModeChangeHandler kullanma

Bu örnek, Vi modu değişikliğine yanıt olarak bir imleç değişikliği VT kaçışı yayar.

function OnViModeChange {
    if ($args[0] -eq 'Command') {
        # Set the cursor to a blinking block.
        Write-Host -NoNewline "`e[1 q"
    } else {
        # Set the cursor to a blinking line.
        Write-Host -NoNewline "`e[5 q"
    }
}
Set-PSReadLineOption -ViModeIndicator Script -ViModeChangeHandler $Function:OnViModeChange

OnViModeChange işlevi, Vi modları için imleç seçeneklerini ayarlar: insert ve command. ViModeChangeHandler, betik bloğu nesnesi olarak OnViModeChange'e başvurmak için sağlayıcıyı kullanır.

Daha fazla bilgi için bkz. about_Providers.

Örnek 7: Geçmişe eklenen komutları filtrelemek için HistoryHandler kullanma

Aşağıdaki örnekte, git komutlarının geçmişe kaydedilmesini önlemek için nasıl kullanılacağı gösterilmektedir.

$ScriptBlock = {
    param ([string]$Line)

    if ($Line -match "^git") {
        return $false
    } else {
        return $true
    }
}

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

komut ile başladıysa betik bloğu döndürür. Bu, AddToHistory sabit listesini döndürmeyle aynı etkiye sahiptir. Komut ile başlamazsa işleyici döndürür ve PSReadLine komutu geçmişe kaydeder.

Örnek 8: Komutu yürütülmeden önce doğrulamak için CommandValidationHandler kullanma

Bu örnekte, yürütülmeden önce bir komutu doğrulamak için CommandValidationHandler parametresinin nasıl kullanılacağı gösterilmektedir. Örnek, alt komut git ile cmt komut cmt özel olarak denetler ve bunu tam adıyla değiştirir. Bu şekilde alt komutlar için kısa adlar oluşturabilirsiniz.

# Load the namespace so you can use the [CommandAst] object type
using namespace System.Management.Automation.Language

Set-PSReadLineOption -CommandValidationHandler {
    param([CommandAst]$CommandAst)

    switch ($CommandAst.GetCommandName()) {
        'git' {
            $gitCmd = $CommandAst.CommandElements[1].Extent
            switch ($gitCmd.Text) {
                'cmt' {
                    [Microsoft.PowerShell.PSConsoleReadLine]::Replace(
                        $gitCmd.StartOffset, $gitCmd.EndOffset - $gitCmd.StartOffset, 'commit')
                }
            }
        }
    }
}
# This checks the validation script when you hit enter
Set-PSReadLineKeyHandler -Chord Enter -Function ValidateAndAcceptLine

Örnek 9: PromptText parametresini kullanma

Ayrıştırma hatası olduğunda PSReadLine istemin bir bölümünü kırmızı olarak değiştirir. PromptText parametresi PSReadLine'a istem dizesinin kırmızıya bölümünü bildirir.

Örneğin, aşağıdaki örnek geçerli yolu ve ardından büyüktür karakterini () ve bir boşluğu içeren bir istem oluşturur.

function prompt { "PS $PWD> " }`
Set-PSReadLineOption -PromptText '> ' # change the '>' character red
Set-PSReadLineOption -PromptText '> ', 'X ' # replace the '>' character with a red 'X'

İlk dize, istem dizenizin ayrıştırma hatası olduğunda kırmızı yapmak istediğiniz bölümüdür. İkinci dize, ayrıştırma hatası olduğunda kullanılacak alternatif bir dizedir.

Parametreler

-AddToHistoryHandler

Komutların PSReadLine geçmişine nasıl ekleneceğini denetleyebilen bir ScriptBlock belirtir.

ScriptBlock komut satırını giriş olarak alır.

ScripBlock, AddToHistoryOption sabit listesinin bir üyesini, bu üyelerden birinin dize adını veya boole değerini döndürmelidir. Aşağıdaki listede olası değerler ve bunların etkileri açıklanmaktadır.

• - Komutu geçmiş dosyasına ve geçerli oturuma ekleyin.
• - Komutu yalnızca geçerli oturum için geçmişe ekleyin.
• - Komutu geçerli oturum için geçmiş dosyasına eklemeyin.
• - Değerin olduğu gibi.
• - Değerin olduğu gibi.

Parametre özellikleri

Tür:	Func<T,TResult>[System.String,System.Object]
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

-AnsiEscapeTimeout

Bu seçenek, giriş yeniden yönlendirildiğinde, örneğin tmux veya screen altında çalışırken Windows özeldir.

Windows'da yeniden yönlendirilen girişle, birçok anahtar kaçış karakteriyle başlayan bir karakter dizisi olarak gönderilir. Tek bir kaçış karakteri ile ardından daha fazla karakter ve geçerli bir kaçış dizisi arasında ayrım yapmak mümkün değildir.

Varsayım, terminalin karakterleri bir kullanıcı türünden daha hızlı gönderebileceğidir. PSReadLine, tam bir kaçış dizisi aldığı sonucuna varmadan önce bu zaman aşımını bekler.

Yazarken rastgele veya beklenmeyen karakterler görürseniz bu zaman aşımını ayarlayabilirsiniz.

Parametre özellikleri

Tür:	Int32
Default value:	100
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

-BellStyle

PSReadLine çeşitli hatalara ve belirsiz koşullara nasıl yanıt vereceğini belirtir.

Geçerli değerler şunlardır:

• : Kısa bip sesi.
• : Metin kısa bir süre yanıp söner.
• : Geri bildirim yok.

Parametre özellikleri

Tür:	BellStyle
Default value:	Audible
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

-Colors

Colors parametresi, PSReadLinetarafından kullanılan çeşitli renkleri belirtir.

Bağımsız değişken, anahtarların öğeleri ve değerlerin rengi belirttiği bir karma tablodur. Daha fazla bilgi için bkz. about_Hash_Tables.

Renkler, ConsoleColorbir değer olabilir, örneğin veya geçerli bir ANSI kaçış dizisi olabilir. Geçerli kaçış dizileri terminalinize bağlıdır. PowerShell 5.0'da, kırmızı metin için örnek bir kaçış dizisi . PowerShell 6 ve daha yeni sürümlerde aynı kaçış dizisi . Aşağıdaki türler de dahil olmak üzere diğer kaçış dizilerini belirtebilirsiniz:

PSReadLine 2.2.0'da özelleştirmesini desteklemek için iki renk ayarı eklendi:

• - baştaki karakter ve sondaki kaynak adı için renk (örneğin ) ayarlayın. Varsayılan olarak, ön plan rengi olarak kullanır.

• - bir liste öğesinin seçili olduğunu belirten rengi ayarlayın. Varsayılan olarak, arka plan rengi olarak kullanır.

• 256 renk

• 24 bit renk

• Ön plan, arka plan veya her ikisi

• Ters, kalın

ANSI renk kodları hakkında daha fazla bilgi için ANSI kaçış kodu Wikipedia makalesine bakın.

Geçerli anahtarlar şunlardır:

• : Devamlılık isteminin rengi.
• : Vurgu rengi. Örneğin, geçmiş araması yaparken eşleşen metin.
• : Hata rengi. Örneğin, isteminde.
• : Menü seçimini veya seçili metni vurgulama rengi.
• : Varsayılan belirteç rengi.
• : Açıklama belirteci rengi.
• : Anahtar sözcük belirteci rengi.
• : Dize belirteci rengi.
• : İşleç belirteci rengi.
• : Değişken belirteci rengi.
• : Komut belirteci rengi.
• : Parametre belirteci rengi.
• : Tür belirteci rengi.
• : Sayı belirteci rengi.
• : Üye adı belirteci rengi.
• : Tahmine dayalı önerinin satır içi görünümünün rengi.
• : Baştaki karakterin ve tahmin kaynağı adının rengi.
• : Liste görünümünde seçili tahminin rengi.

Parametre özellikleri

Tür:	Hashtable
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

-CommandValidationHandler

ValidateAndAcceptLinetarafından çağrılan bir ScriptBlock belirtir. Özel durum oluşursa doğrulama başarısız olur ve hata bildirilir.

Bir özel durum oluşturmadan önce, doğrulama işleyicisi düzeltmeyi kolaylaştırmak için imleci hatanın noktasına getirebilir. Doğrulama işleyicisi, yaygın tipografik hataları düzeltmek için komut satırını da değiştirebilir.

ValidateAndAcceptLine, çalışmayan komutlarla geçmişinizin karmaşık olmasını önlemek için kullanılır.

Parametre özellikleri

Tür:	Action<T>[CommandAst]
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

-CompletionQueryItems

İstenmeden gösterilen en fazla tamamlanma öğesi sayısını belirtir.

Gösterilecek öğe sayısı bu değerden büyükse, PSReadLine tamamlama öğelerini görüntülemeden önce evet/hayır ister.

Parametre özellikleri

Tür:	Int32
Default value:	100
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

-ContinuationPrompt

Çok satırlı giriş girildiğinde sonraki satırların başında görüntülenen dizeyi belirtir. Varsayılan değer çift büyüktür işaretidir (). Boş bir dize geçerli.

Parametre özellikleri

Tür:	String
Default value:	>>
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

-DingDuration

BellStyle olarak ayarlandığında bip sesinin süresini belirtir.

Parametre özellikleri

Tür:	Int32
Default value:	50ms
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

-DingTone

BellStyle olarak ayarlandığında bip sesinin Hertz (Hz) içindeki tonunu belirtir

Parametre özellikleri

Tür:	Int32
Default value:	1221
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

-EditMode

Komut satırı düzenleme modunu belirtir. Bu parametre kullanıldığında, tarafından ayarlanan tüm anahtar bağlamaları sıfırlanır.

Geçerli değerler şunlardır:

• Windows: Anahtar bağlamaları PowerShell, cmd ve Visual Studio öykünmektedir. (Windows üzerinde varsayılan)
• : Anahtar bağlamaları Bash veya Emacs'e öykünmektedir. (Windows olmayan platformlarda varsayılan)
• : Anahtar bağlamaları Vi'ye öykünmektedir.

EditMode yapılandırılmış olan anahtar bağlamalarını görmek için kullanın.

Parametre özellikleri

Tür:	EditMode
Default value:	Windows
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

-ExtraPromptLineCount

Ek satır sayısını belirtir.

İsteminiz birden fazla satıra yayılmışsa, bu parametre için bir değer belirtin. PSReadLine bazı çıktıları gösterdikten sonra istem görüntülendiğinde ek satırların kullanılabilir olmasını istediğinizde bu seçeneği kullanın. Örneğin, PSReadLine tamamlamaların listesini döndürür.

Bu seçenek, PSReadLineönceki sürümlerinden daha az gereklidir, ancak işlevi kullanıldığında kullanışlıdır.

Parametre özellikleri

Tür:	Int32
Default value:	0
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

-HistoryNoDuplicates

Bu seçenek geri çağırma davranışını denetler. Yine de geçmiş dosyasına yinelenen komutlar eklenir. Bu seçenek ayarlandığında, komutları geri çağırırken yalnızca en son çağrı görüntülenir. Geri çekme sırasında sıralamayı korumak için geçmişe yinelenen komutlar eklenir. Ancak, genellikle geçmişi geri çağırırken veya ararken komutu birden çok kez görmek istemezsiniz.

Varsayılan olarak, HistoryNoDuplicates genel PSConsoleReadLineOptions nesnesi olarak ayarlanır. Özellik değerini değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: . yalnızca kullanarak dönebilirsiniz.

Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:

(Get-PSReadLineOption).HistoryNoDuplicates = $false

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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

-HistorySavePath

Geçmişin kaydedildiği dosyanın yolunu belirtir. Windows veya Windows olmayan platformları çalıştıran bilgisayarlar dosyayı farklı konumlarda depolar. Dosya adı bir değişkende depolanır, örneğin .

Bu parametreyi kullanmıyorsanız, varsayılan yol aşağıdaki gibidir:

Windows

• $Env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine\$($Host.Name)_history.txt

non-Windows

• $Env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt
• $HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt

Parametre özellikleri

Tür:	String
Default value:	A file named $($Host.Name)_history.txt in $Env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine on Windows and $Env:XDG_DATA_HOME/powershell/PSReadLine or $HOME/.local/share/powershell/PSReadLine on non-Windows platforms
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

-HistorySaveStyle

PSReadLine geçmişi nasıl kaydediyor belirtir.

Geçerli değerler şunlardır:

• : Her komut yürütüldükten sonra geçmişi kaydedin ve PowerShell'in birden çok örneğinde paylaşın.
• : PowerShell'in çıkışında geçmiş dosyasını ekleyin.
• : Geçmiş dosyası kullanmayın.

Uyarı

HistorySaveStyle olarak ayarladıysanız ve daha sonra aynı oturumda olarak ayarlarsanız, PSReadLine daha önce oturumda çalıştırdığınız tüm komutları kaydeder.

Parametre özellikleri

Tür:	HistorySaveStyle
Default value:	SaveIncrementally
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

-HistorySearchCaseSensitive

ReverseSearchHistory veya HistorySearchBackwardgibi işlevlerde geçmiş aramanın büyük/küçük harfe duyarlı olduğunu belirtir.

Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistorySearchCaseSensitive özelliği olarak ayarlanır. Bu SwitchParameter kullanıldığında özellik değeri olarak ayarlar. Özellik değerini geri değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: .

Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:

(Get-PSReadLineOption).HistorySearchCaseSensitive = $false

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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

-HistorySearchCursorMovesToEnd

İmlecin, arama kullanarak geçmişten yüklediğiniz komutların sonuna taşındığını gösterir. Bu parametre olarak ayarlandığında, imleç yukarı veya aşağı oklara bastığınızda olduğu konumda kalır.

Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistorySearchCursorMovesToEnd özelliği olarak ayarlanır. Bu SwitchParameter kullanarak özellik değerini olarak ayarlayın. Özellik değerini geri değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: .

Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $false

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
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

-MaximumHistoryCount

PSReadLine geçmişinde kaydedilecek en fazla komut sayısını belirtir.

PSReadLine geçmişi PowerShell geçmişinden ayrıdır.

Parametre özellikleri

Tür:	Int32
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

-MaximumKillRingCount

Sonlandırma halkasında depolanan en fazla öğe sayısını belirtir.

Parametre özellikleri

Tür:	Int32
Default value:	10
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

-PredictionSource

Tahmine dayalı öneriler almak için PSReadLine kaynağını belirtir.

Geçerli değerler şunlardır:

• - Tahmine dayalı IntelliSense özelliğini devre dışı bırakın (varsayılan).
• - Tahmine dayalı IntelliSense özelliğini etkinleştirin ve psreadline geçmişini tek kaynak olarak kullanın.
• - tahmine dayalı IntelliSense özelliğini etkinleştirin ve eklentileri () tek kaynak olarak kullanın. Bu değer PSReadLine 2.2.0'a eklendi
• - tahmine dayalı IntelliSense özelliğini etkinleştirin ve kaynak olarak hem geçmiş hem de eklenti kullanın. Bu değer PSReadLine 2.2.0'a eklendi

Parametre özellikleri

Tür:	Microsoft.PowerShell.PredictionSource
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

-PredictionViewStyle

Tahmine dayalı metnin görüntülenmesi için stili ayarlar. Varsayılan değer: .

• - balık kabuğu ve zsh'de olduğu gibi bugün var olan stil. (default)
• - öneriler açılan listede işlenir ve kullanıcılar UpArrow ve DownArrow kullanarak seçim yapabilir.

Bu parametre PSReadLine 2.2.0'a eklendi

Parametre özellikleri

Tür:	Microsoft.PowerShell.PredictionViewStyle
Default value:	InlineView
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

-PromptText

Bu parametre, PromptText özelliğinin değerini ayarlar. Varsayılan değer şudur: .

PSReadLine istem işlevinizi analiz eder ve isteminizin yalnızca bir bölümünün renginin nasıl değiştirileceğini belirler. Bu analiz 100% güvenilir değildir. PSReadLine isteminizi beklenmedik şekillerde değiştiriyorsa bu seçeneği kullanın. Sondaki boşlukları ekleyin.

Bu parametrenin değeri tek bir dize veya iki dizeden oluşan bir dizi olabilir. İlk dize, ayrıştırma hatası olduğunda istem dizenizin kırmızıya değiştirilmesini istediğiniz bölümüdür. İkinci dize, ayrıştırma hatası olduğunda kullanılacak alternatif bir dizedir.

Parametre özellikleri

Tür:	String[]
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

-ShowToolTips

Olası tamamlamalar görüntülenirken, araç ipuçları tamamlamalar listesinde gösterilir.

Bu seçenek varsayılan olarak etkindir. Bu seçenek, PSReadLineönceki sürümlerinde varsayılan olarak etkinleştirilmedi. Devre dışı bırakmak için bu seçeneği olarak ayarlayın.

Bu parametre ve seçenek PSReadLine 2.3.4'e eklendi.

Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin ShowToolTips özelliği olarak ayarlanır. Bu SwitchParameter kullanıldığında özellik değeri olarak ayarlar. Özellik değerini değiştirmek için SwitchParameter değerini şu şekilde belirtmeniz gerekir: .

Aşağıdaki komutu kullanarak özellik değerini doğrudan ayarlayabilirsiniz:

(Get-PSReadLineOption).ShowToolTips = $false

Parametre özellikleri

Tür:	SwitchParameter
Default value:	True
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

-TerminateOrphanedConsoleApps

Bu parametre TerminateOrphanedConsoleApps seçeneğini olarak ayarlar.

'da, bir işlemi sonlandırmak için Ctrlc<3> tuşlarına bastığınızda, konsola bağlı her işlem yalnızca etkin kabuk yerine sonlandırma sinyali alır. Bazen, bir kabuk bazı büyük alt işlem ağacını başlattığında (örneğin bir derleme sistemi düşünün) bazı işlemlerden çıkılabilir ve birden çok işlem eşzamanlı olarak konsol girişini tüketmeye çalışır.

TerminateOrphanedConsoleApps seçeneğini olarak ayarlarken, PSReadLine şu anda konsola bağlı olan işlemlerin listesini kaydeder. Daha sonra PSReadLine her çalıştırıldığında konsola eklenen işlemlerin yeni bir listesini alır ve özgün listede olmayan işlemleri sonlandırır.

Bu parametre ve seçenek PSReadLine 2.3.4'e eklendi.

Parametre özellikleri

Tür:	SwitchParameter
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

-ViModeChangeHandler

ViModeIndicator olarak ayarlandığında, mod her değiştiğinde sağlanan betik bloğu çağrılır. Betik bloğu türünde bir bağımsız değişken sağlanır.

Bu parametre PowerShell 7'de kullanıma sunulmuştur.

Parametre özellikleri

Tür:	ScriptBlock
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

-ViModeIndicator

Bu seçenek geçerli mod için görsel göstergeyi ayarlar. Ekleme modu veya komut modu.

Geçerli değerler şunlardır:

• : Gösterge yok.
• : İstem rengi değiştirir.
• : İmleç boyutu değiştirir.
• : Kullanıcı tarafından belirtilen metin yazdırılır.

Parametre özellikleri

Tür:	ViModeStyle
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

-WordDelimiters

ForwardWord veya KillWordgibi işlevler için sözcükleri sınırlandıran karakterleri belirtir.

Parametre özellikleri

Tür:	String
Default value:	;:,.[]{}()/\|^&*-=+'"---
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.

İlişkili Bağlantılar

• about_PSReadLine Hakkında
• Get-PSReadLineKeyHandler (PSReadLine Anahtar İşleyicisi Al)
• Get-PSReadLineOption
• Remove-PSReadLineKeyHandler
• Set-PSReadLineKeyHandler