Set-PSReadLineOption (PSReadLine)

Set-PSReadLineOption

Modül:

PSReadLine

PSReadLine'da komut satırı düzenleme davranışını özelleştirir.

Sözdizimi

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>]

Tanım

Set-PSReadLineOption 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 Get-PSReadLineOption'u kullanın.

Bu komut tarafından belirlenen seçenekler yalnızca geçerli oturuma uygulanır. Herhangi bir seçeneği kalıcı kılmak için bunları bir profil komut dosyasına ekleyin. Daha fazla bilgi için about_Profiles ve Kabuk ortamınızı özelleştirme bölümlerine bakın.

Örnekler

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

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

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

Yalnızca ön plan metin rengini ayarlamayı seçebilirsiniz. Örneğin, Yorum jetonu için parlak yeşil ön plan metin rengi: "Comment"="`e[92m".

Örnek 2: Zil stilini ayarlama

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

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

Örnek 3: Birden fazla seçeneği ayarlama

Set-PSReadLineOption, karma tablosuyla birden fazla seçeneği ayarlayabilir.

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

$PSReadLineOptions karma tablosu anahtarları ve değerleri ayarlar. Set-PSReadLineOption, PSReadLine seçeneklerini güncellemek için @PSReadLineOptions ile anahtarları ve değerleri kullanır.

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

Örnek 4: Birden fazla renk seçeneğini ayarlama

Bu örnek, tek bir komutta birden fazla renk değerinin nasıl ayarlanacağını gösterir.

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ğerlerini ayarlama

Bu örnekte PSReadLine'da görüntülenen belirteçlerin renginin nasıl ayarlanacağına ilişkin üç 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'ı kullanın

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

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: ekleme ve komut. ViModeChangeHandler, OnViModeChange'e bir komut dosyası bloğu nesnesi olarak başvurmak için Function: sağlayıcısını kullanır.

Daha fazla bilgi için bkz. about_Providers.

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

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

$ScriptBlock = {
    Param([string]$line)

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

Set-PSReadLineOption -AddToHistoryHandler $ScriptBlock

Komut git ile başladıysa, komut dosyası bloğu $false değerini döndürür. Bu, SkipAdding AddToHistory numaralandırmasının döndürülmesiyle aynı etkiye sahiptir. Komut git ile başlamazsa işleyici $true değerini döndürür ve PSReadLine komutu geçmişe kaydeder.

Örnek 8: Bir komutu yürütülmeden önce doğrulamak için CommandValidationHandler'ı kullanın

Bu örnek, yürütülmeden önce bir komutu doğrulamak için CommandValidationHandler parametresinin nasıl kullanılacağını gösterir. Örnek, özellikle cmt alt komutuyla git komutunu kontrol eder ve bunu commit tam adıyla değiştirir. Bu şekilde alt komutlar için kısa takma 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

Bir ayrıştırma hatası oluştuğunda, PSReadLine istemin bir bölümünü kırmızıya dönüştürür. PromptText parametresi PSReadLine'a bilgi istemi dizesinin kırmızıya dönüştürülmesini bildirir.

Örneğin, aşağıdaki örnek, geçerli yolu ve ardından büyük karakteri (>) ve bir boşluğu içeren bir bilgi istemi 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, bir ayrıştırma hatası olduğunda bilgi istemi dizenizin kırmızı yapmak istediğiniz kısmı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 denetleyen bir ScriptBlock belirtir.

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

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

• MemoryAndFile - Komutu geçmiş dosyasına ve geçerli oturuma ekleyin.
• MemoryOnly - Komutu yalnızca geçerli oturum için geçmişe ekleyin.
• Eklemeyi Atla - Geçerli oturumun geçmiş dosyasına komutu eklemeyin.
• $false - Değer SkipAdding ile aynı.
• $true - Değer MemoryAndFile ile aynı.

Tip :

Func[System.String,System.Object]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-AnsiEscapeTimeout

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

Windows'ta yeniden yönlendirilmiş giriş ile birçok anahtar, kaçış karakteriyle başlayan bir karakter dizisi olarak gönderilir. Daha fazla karakterin takip ettiği tek bir kaçış karakteri ile geçerli bir kaçış dizisi arasında ayrım yapmak imkansızdır.

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

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

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

100

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-BellStyle

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

Geçerli değerler aşağıdaki gibidir:

• Sesli: Kısa bir bip sesi.
• Görsel: Metin kısa süreliğine yanıp söner.
• Yok: Geri bildirim yok.

Tip :

BellStyle

Konum:

Adlandırılmış

Varsayılan değer:

sesli

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-Colors

Renkler parametresi PSReadLine tarafından kullanılan çeşitli renkleri belirtir.

Argüman, anahtarların öğeleri belirttiği ve değerlerin rengi belirttiği bir karma tablosudur. Daha fazla bilgi için bkz. about_Hash_Tables.

Renkler ConsoleColor'dan bir değer olabilir (örneğin, [ConsoleColor]::Red) 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 kaçış sırası $ ([char]0x1b)[91m'dir. PowerShell 6 ve daha yeni sürümlerde aynı kaçış sırası `e[91m'dir. Aşağıdaki türler de dahil olmak üzere diğer kaçış sıralarını belirtebilirsiniz:

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

• ListPredictionColor - baştaki > karakteri ve sondaki kaynak adı için rengi ayarlayın (örneğin, [History]). Varsayılan olarak ön plan rengi olarak DarkYellow'u kullanır.

• ListPredictionSelectedColor - bir liste öğesinin seçildiğini belirtmek için rengi ayarlayın. Varsayılan olarak arka plan rengi olarak DarkBlack'i 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 şunları içerir:

• Devam İstemi: Devam isteminin rengi.
• Vurgu: Vurgu rengi. Örneğin, geçmişte arama yaparken eşleşen metin.
• Hata: Hata rengi. Örneğin, istemde.
• Seçim: Menü seçimini veya seçilen metni vurgulamak için kullanılan renk.
• Varsayılan: Varsayılan jeton rengi.
• Yorum: Yorum belirteci rengi.
• Anahtar Kelime: Anahtar kelime belirteci rengi.
• Dize: Dize belirteci rengi.
• Operatör: Operatör belirteci rengi.
• Değişken: Değişken jeton rengi.
• Komut: Komut jetonunun rengi.
• Parametre: Parametre belirteci rengi.
• Tür: Tür belirteci rengi.
• Sayı: Sayı belirtecinin rengi.
• Üye: Üye adı belirteci rengi.
• Satır İçi Tahmin: Tahmine dayalı önerinin satır içi görünümünün rengi.
• ListPrediction: Baştaki > karakterinin ve tahmin kaynağı adının rengi.
• ListPredictionSelected: Liste görünümünde seçilen tahminin rengi.

Tip :

Karma tablo

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-CommandValidationHandler

ValidateAndAcceptLine'dan çağrılan bir ScriptBlock'u belirtir. Bir istisna atılırsa doğrulama başarısız olur ve hata raporlanır.

Bir istisna atmadan önce doğrulama işleyicisi, düzeltmeyi kolaylaştırmak için imleci hatanın olduğu noktaya yerleştirebilir. Doğrulama işleyicisi ayrıca yaygın yazım hatalarını düzeltmek için komut satırını değiştirebilir.

ValidateAndAcceptLine, geçmişinizi işe yaramayan komutlarla doldurmamak için kullanılır.

Tip :

Eylem[CommandAst]

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-CompletionQueryItems

Sorulmadan gösterilen tamamlama öğelerinin maksimum 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'ı sorar.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

100

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

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çerlidir.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

>>

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-DingDuration

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

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

50ms

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-DingTone

BellStyle Audible olarak ayarlandığında bip sesinin tonunu Hertz (Hz) cinsinden belirtir.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

1221

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-EditMode

Komut satırı düzenleme modunu belirtir. Bu parametrenin kullanılması Set-PSReadLineKeyHandler tarafından ayarlanan tüm tuş atamalarını sıfırlar.

Geçerli değerler aşağıdaki gibidir:

• Windows: Anahtar bağlamaları PowerShell, cmd ve Visual Studio'ya öykünür.
• Emacs: Tuş bağlamaları Bash veya Emacs'i taklit eder.
• Vi: Tuş atamaları Vi'yi taklit eder.

Şu anda yapılandırılmış olan EditMode'un tuş bağlantılarını görmek için Get-PSReadLineKeyHandler'ı kullanın.

Tip :

EditMode

Konum:

Adlandırılmış

Varsayılan değer:

Windows

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ExtraPromptLineCount

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

İsteminiz birden fazla satıra yayılıyorsa bu parametre için bir değer belirtin. PSReadLine bazı çıktılar gösterdikten sonra istemi görüntülediğinde fazladan satırların kullanılabilir olmasını istiyorsanız bu seçeneği kullanın. Örneğin, PSReadLine tamamlamaların bir listesini döndürür.

Bu seçeneğe PSReadLine'ın önceki sürümlerine göre daha az ihtiyaç duyulur, ancak InvokePrompt işlevi kullanıldığında kullanışlıdır.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

0

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-HistoryNoDuplicates

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

Varsayılan olarak, genel PSConsoleReadLineOptions nesnesinin HistoryNoDuplicates özelliği True olarak ayarlanmıştır. Özellik değerini değiştirmek için SwitchParameter'ın değerini şu şekilde belirtmeniz gerekir: -HistoryNoDuplicates:$False. Yalnızca SwitchParameter, -HistoryNoDuplicates'i kullanarak True'a geri dönebilirsiniz.

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

(Get-PSReadLineOption).HistoryNoDuplicates = $False

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-HistorySavePath

Geçmişin kaydedildiği dosyanın yolunu belirtir. Windows veya Windows dışı platformları çalıştıran bilgisayarlar, dosyayı farklı konumlarda saklar. Dosya adı $ ($Host.Name)_history.txt değişkeninde saklanır; örneğin ConsoleHost_history.txt.

Bu parametreyi kullanmazsanız varsayılan yol aşağıdaki gibidir:

Windows

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

Windows olmayan

$env:XDG_DATA_HOME/powershell/PSReadLine/$($Host.Name)_history.txt

$HOME/.local/share/powershell/PSReadLine/$($Host.Name)_history.txt

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

Windows'ta $env:APPDATA\Microsoft\Windows\PowerShell\PSReadLine dizininde $ ($Host.Name)_history.txt ve $env:XDG_DATA_HOME/powershell/PSReadLine veya $HOME/.local/share/powershell/ adlı bir dosya Windows dışı platformlarda PSReadLine

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-HistorySaveStyle

PSReadLine'ın geçmişi nasıl kaydettiğini belirtir.

Geçerli değerler aşağıdaki gibidir:

• Artırımlı Olarak Kaydet: Her komut yürütüldükten sonra geçmişi kaydedin ve birden çok PowerShell örneği arasında paylaşın.
• SaveAtExit: PowerShell'den çıkıldığında geçmiş dosyasını ekleyin.
• SaveNothing: Geçmiş dosyası kullanmayın.

Tip :

GeçmişKaydetStil

Konum:

Adlandırılmış

Varsayılan değer:

SaveIncrementally

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-HistorySearchCaseSensitive

ReverseSearchHistory veya HistorySearchBackward gibi 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 False olarak ayarlanmıştır. Bu SwitchParameter'in kullanılması, özellik değerini True olarak ayarlar. Özellik değerini geri değiştirmek için SwitchParameter'ın değerini şu şekilde belirtmeniz gerekir: -HistorySearchCaseSensitive:$False.

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

(Get-PSReadLineOption).HistorySearchCaseSensitive = $False

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-HistorySearchCursorMovesToEnd

İmlecin, arama kullanarak geçmişten yüklediğiniz komutların sonuna gittiğini belirtir. Bu parametre $False olarak ayarlandığında, imleç yukarı veya aşağı oklara bastığınızda olduğu konumda kalır.

Varsayılan olarak, global PSConsoleReadLineOptions nesnesinin HistorySearchCursorMovesToEnd özelliği False olarak ayarlanmıştır. Bu SwitchParameter'i kullanarak özellik değerini True olarak ayarlayın. Özellik değerini geri değiştirmek için SwitchParameter'ın değerini şu şekilde belirtmeniz gerekir: -HistorySearchCursorMovesToEnd:$False.

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

(Get-PSReadLineOption).HistorySearchCursorMovesToEnd = $False

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

False

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-MaximumHistoryCount

PSReadLine geçmişine kaydedilecek maksimum komut sayısını belirtir.

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

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-MaximumKillRingCount

Öldürme halkasında depolanan maksimum öğe sayısını belirtir.

Tip :

Int32

Konum:

Adlandırılmış

Varsayılan değer:

10

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PredictionSource

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

Geçerli değerler şunlardır:

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

Tip :

Microsoft.PowerShell.PredictionSource

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PredictionViewStyle

Tahminli metnin görüntülenme stilini ayarlar. Varsayılan InlineView'dir.

• InlineView - günümüzde mevcut olan stil, balık kabuğu ve zsh'ye benzer. (varsayılan)
• ListView - öneriler bir açılır listede görüntülenir ve kullanıcılar UpArrow ve DownArrow'u kullanarak seçim yapabilir.

Bu parametre PSReadLine 2.2.0'a eklendi

Tip :

Microsoft.PowerShell.PredictionViewStyle

Konum:

Adlandırılmış

Varsayılan değer:

InlineView

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-PromptText

Bu parametre PromptText özelliğinin değerini ayarlar. Varsayılan değer: "> ".

PSReadLine, isteminizin yalnızca bir kısmının renginin nasıl değiştirileceğini belirlemek için bilgi istemi işlevinizi analiz eder. 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, bir ayrıştırma hatası olduğunda bilgi istemi dizenizin kırmızıya değiştirilmesini istediğiniz kısmıdır. İkinci dize, ayrıştırma hatası olduğunda kullanılacak alternatif bir dizedir.

Tip :

String[]

Konum:

Adlandırılmış

Varsayılan değer:

>

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ShowToolTips

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

Bu seçenek varsayılan olarak etkindir. Bu seçenek PSReadLine'ın önceki sürümlerinde varsayılan olarak etkin değildi. Devre dışı bırakmak için bu seçeneği $False olarak ayarlayın.

Bu parametre ve seçenek PSReadLine 2.3.4'e eklenmiştir.

Varsayılan olarak, global PSConsoleReadLineOptions nesnesinin ShowToolTips özelliği True olarak ayarlanmıştır. Bu SwitchParameter'in kullanılması, özellik değerini True olarak ayarlar. Özellik değerini değiştirmek için SwitchParameter'ın değerini şu şekilde belirtmeniz gerekir: -ShowToolTips:$False.

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

(Get-PSReadLineOption).ShowToolTips = $False

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

True

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-TerminateOrphanedConsoleApps

Bu parametre, TerminateOrphanedConsoleApps seçeneğini $true olarak ayarlar.

Windows'ta, bir işlemi sonlandırmak için Ctrl+c tuşlarına bastığınızda, yalnızca etkin kabuğun aksine, konsola bağlı her işlem bir sonlandırma sinyali alır. Bazen, bir kabuk büyük bir alt süreç ağacını başlattığında (örneğin bir yapı sistemi hayal edin), bazı işlemlerden çıkılabilir ve birden fazla süreç aynı anda konsol girişini tüketmeye çalışır.

TerminateOrphanedConsoleApps seçeneği $true olarak ayarlandığında, PSReadLine şu anda konsola eklenmiş olan işlemlerin listesini kaydeder. Daha sonra, PSReadLine her çalıştırıldığında konsola eklenen işlemlerin yeni bir listesini alacak ve orijinal listede olmayanları sonlandıracaktır.

Bu parametre ve seçenek PSReadLine 2.3.4'e eklenmiştir.

Tip :

SwitchParameter

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ViModeChangeHandler

ViModeIndicator, Script olarak ayarlandığında, sağlanan komut dosyası bloğu, mod her değiştiğinde çağrılacaktır. Komut dosyası bloğuna ViMode türünde bir bağımsız değişken sağlanır.

Bu parametre PowerShell 7'de tanıtıldı.

Tip :

ScriptBlock

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-ViModeIndicator

Bu seçenek mevcut Vi moduna ilişkin görsel göstergeyi ayarlar. Ekleme modu veya komut modu.

Geçerli değerler aşağıdaki gibidir:

• Yok: Gösterge yok.
• İstem: İstemin rengi değişir.
• İmleç: İmlecin boyutu değişir.
• Komut Dosyası: Kullanıcı tarafından belirlenen metin yazdırılır.

Tip :

ViModeStyle

Konum:

Adlandırılmış

Varsayılan değer:

None

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

-WordDelimiters

ForwardWord veya KillWord gibi işlevlere ilişkin sözcükleri sınırlayan karakterleri belirtir.

Tip :

String

Konum:

Adlandırılmış

Varsayılan değer:

;:,.[]{}()/\|^&*-=+'"---

Gerekli:

False

Boru hattı girişini kabul edin:

False

Joker karakterleri kabul et:

False

Girişler

Yok

Nesneleri bu cmdlet'e aktaramazsınız.

Çıkışlar

Yok

Bu cmdlet hiçbir çıktı döndürmez.