Objek ISEOptions
Objek ISEOptions mewakili berbagai pengaturan untuk Windows PowerShell ISE. Ini adalah instans kelas Microsoft.PowerShell.Host.ISE.ISEOptions .
Objek ISEOptions menyediakan metode dan properti berikut.
Metode
RestoreDefaultConsoleTokenColors()
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Memulihkan nilai default warna token di panel Konsol.
# Changes the color of the commands in the Console pane to red and then restores it to its default value.
$psISE.Options.ConsoleTokenColors["Command"] = 'red'
$psISE.Options.RestoreDefaultConsoleTokenColors()
RestoreDefaults()
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Memulihkan nilai default semua pengaturan opsi di panel Konsol. Ini juga mengatur ulang perilaku berbagai pesan peringatan yang menyediakan kotak centang standar untuk mencegah pesan ditampilkan lagi.
# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()
RestoreDefaultTokenColors()
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Memulihkan nilai default warna token di panel Skrip.
# Changes the color of the comments in the Script pane to red and then restores it to its default value.
$psISE.Options.TokenColors["Comment"] = 'red'
$psISE.Options.RestoreDefaultTokenColors()
RestoreDefaultXmlTokenColors()
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Memulihkan nilai default warna token untuk elemen XML yang ditampilkan di Windows PowerShell ISE. Lihat juga XmlTokenColors.
# Changes the color of the comments in XML data to red and then restores it to its default value.
$psISE.Options.XmlTokenColors["Comment"] = 'red'
$psISE.Options.RestoreDefaultXmlTokenColors()
Properti
AutoSaveMinuteInterval
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan jumlah menit antara operasi penyimpanan otomatis file Anda oleh Windows PowerShell ISE. Nilai defaultnya adalah 2 menit. Nilainya adalah bilangan bulat.
# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3
CommandPaneBackgroundColor
Fitur ini ada di Windows PowerShell ISE 2.0, tetapi dihapus atau diganti namanya dalam versi ISE yang lebih baru. Untuk versi yang lebih baru, lihat ConsolePaneBackgroundColor.
Menentukan warna latar belakang untuk panel Perintah. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'
CommandPaneUp
Fitur ini ada di Windows PowerShell ISE 2.0, tetapi dihapus atau diganti namanya dalam versi ISE yang lebih baru.
Menentukan apakah panel Perintah terletak di atas panel Output.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan warna latar belakang untuk panel Konsol. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'
ConsolePaneForegroundColor
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan warna latar depan teks di panel Konsol.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackgroundColor
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan warna latar belakang teks di panel Konsol.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan warna token IntelliSense di panel Konsol ISE Windows PowerShell. Properti ini adalah objek kamus yang berisi pasangan nama/nilai dari jenis dan warna token untuk panel Konsol. Untuk mengubah warna token IntelliSense di panel Skrip, lihat TokenColors. Untuk mengatur ulang warna ke nilai default, lihat RestoreDefaultConsoleTokenColors. Warna token dapat diatur untuk yang berikut ini: Atribut, Perintah, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable.
# Sets the color of commands to green.
$psISE.Options.ConsoleTokenColors["Command"] = 'green'
# Sets the color of keywords to magenta.
$psISE.Options.ConsoleTokenColors["Keyword"] = 'magenta'
DebugBackgroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar belakang untuk teks debug yang muncul di panel Konsol. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the background color for the debug text that appears in the Console pane to blue.
$psISE.Options.DebugBackgroundColor = '#0000FF'
DebugForegroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar depan untuk teks debug yang muncul di panel Konsol. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the foreground color for the debug text that appears in the Console pane to yellow.
$psISE.Options.DebugForegroundColor = 'yellow'
DefaultOptions
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Kumpulan properti yang menentukan nilai default yang akan digunakan saat metode Reset digunakan.
# Displays the name of the default options. This example is from ISE 4.0.
$psISE.Options.DefaultOptions
SelectedScriptPaneState : Top
ShowDefaultSnippets : True
ShowToolBar : True
ShowOutlining : True
ShowLineNumbers : True
TokenColors : {[Attribute, #FF00BFFF], [Command, #FF0000FF], [CommandArgument, #FF8A2BE2], [CommandParameter, #FF000080]...}
ConsoleTokenColors : {[Attribute, #FFB0C4DE], [Command, #FFE0FFFF], [CommandArgument, #FFEE82EE], [CommandParameter, #FFFFE4B5]...}
XmlTokenColors : {[Comment, #FF006400], [CommentDelimiter, #FF008000], [ElementName, #FF8B0000], [MarkupExtension, #FFFF8C00]...}
DefaultOptions : Microsoft.PowerShell.Host.ISE.ISEOptions
FontSize : 9
Zoom : 100
FontName : Lucida Console
ErrorForegroundColor : #FFFF0000
ErrorBackgroundColor : #00FFFFFF
WarningForegroundColor : #FFFF8C00
WarningBackgroundColor : #00FFFFFF
VerboseForegroundColor : #FF00FFFF
VerboseBackgroundColor : #00FFFFFF
DebugForegroundColor : #FF00FFFF
DebugBackgroundColor : #00FFFFFF
ConsolePaneBackgroundColor : #FF012456
ConsolePaneTextBackgroundColor : #FF012456
ConsolePaneForegroundColor : #FFF5F5F5
ScriptPaneBackgroundColor : #FFFFFFFF
ScriptPaneForegroundColor : #FF000000
ShowWarningForDuplicateFiles : True
ShowWarningBeforeSavingOnRun : True
UseLocalHelp : True
AutoSaveMinuteInterval : 2
MruCount : 10
ShowIntellisenseInConsolePane : True
ShowIntellisenseInScriptPane : True
UseEnterToSelectInConsolePaneIntellisense : True
UseEnterToSelectInScriptPaneIntellisense : True
IntellisenseTimeoutInSeconds : 3
ErrorBackgroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar belakang untuk teks kesalahan yang muncul di panel Konsol. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the background color for the error text that appears in the Console pane to black.
$psISE.Options.ErrorBackgroundColor = 'black'
ErrorForegroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar depan untuk teks kesalahan yang muncul di panel Konsol. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the foreground color for the error text that appears in the console pane to green.
$psISE.Options.ErrorForegroundColor = 'green'
FontName
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan nama font yang saat ini digunakan di panel Skrip dan panel Konsol.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
FontSize
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan ukuran font sebagai bilangan bulat. Ini digunakan di panel Skrip, panel Perintah, dan panel Output. Rentang nilai yang valid adalah 8 hingga 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeoutInSeconds
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan jumlah detik yang digunakan IntelliSense untuk mencoba mengatasi teks yang saat ini ditik. Setelah jumlah detik ini, Waktu IntelliSense habis dan memungkinkan Anda untuk terus mengetik. Nilai default-nya adalah 3 detik. Nilainya adalah bilangan bulat.
# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5
MruCount
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan jumlah file yang baru dibuka yang dilacak dan ditampilkan ISE Windows PowerShell di bagian bawah menu Buka File. Nilai defaultnya adalah 10. Nilainya adalah bilangan bulat.
# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5
OutputPaneBackgroundColor
Fitur ini ada di Windows PowerShell ISE 2.0, tetapi dihapus atau diganti namanya dalam versi ISE yang lebih baru. Untuk versi yang lebih baru, lihat ConsolePaneBackgroundColor.
Properti baca/tulis yang mendapatkan atau mengatur warna latar belakang untuk panel Output itu sendiri. Ini adalah instans kelas System.Windows.Media.Color .
# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'
OutputPaneTextForegroundColor
Fitur ini ada di Windows PowerShell ISE 2.0, tetapi dihapus atau diganti namanya dalam versi ISE yang lebih baru. Untuk versi yang lebih baru, lihat ConsolePaneForegroundColor.
Properti baca/tulis yang mengubah warna latar depan teks di panel Output di Windows PowerShell ISE 2.0.
# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor = 'blue'
OutputPaneTextBackgroundColor
Fitur ini ada di Windows PowerShell ISE 2.0, tetapi dihapus atau diganti namanya dalam versi ISE yang lebih baru. Untuk versi yang lebih baru, lihat ConsolePaneTextBackgroundColor.
Properti baca/tulis yang mengubah warna latar belakang teks di panel Output.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackgroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Properti baca/tulis yang mendapatkan atau mengatur warna latar belakang untuk file. Ini adalah instans kelas System.Windows.Media.Color .
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'
ScriptPaneForegroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Properti baca/tulis yang mendapatkan atau mengatur warna latar depan untuk file non-skrip di panel Skrip. Untuk mengatur warna latar depan untuk file skrip, gunakan TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelectedScriptPaneState
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Properti baca/tulis yang mendapatkan atau mengatur posisi panel Skrip pada tampilan. String dapat berupa 'Maximized', 'Top', atau 'Right'.
# Moves the Script Pane to the top.
$psISE.Options.SelectedScriptPaneState = 'Top'
# Moves the Script Pane to the right.
$psISE.Options.SelectedScriptPaneState = 'Right'
# Maximizes the Script Pane
$psISE.Options.SelectedScriptPaneState = 'Maximized'
TampilkanNippetsDefaultSnippets
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah daftar cuplikan CTRL+J menyertakan set pemula yang disertakan dalam Windows PowerShell. Saat diatur ke $false, hanya cuplikan yang ditentukan pengguna yang muncul di daftar CTRL+J.
Nilai defaultnya adalah $true.
# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah IntelliSense menawarkan sintaks, parameter, dan saran nilai di panel Konsol.
Nilai defaultnya adalah $true.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah IntelliSense menawarkan sintaks, parameter, dan saran nilai di panel Skrip.
Nilai defaultnya adalah $true.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah panel Skrip menampilkan nomor baris di margin kiri. Nilai defaultnya adalah $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
ShowOutlining
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah panel Skrip menampilkan tanda kurung yang dapat diperluas dan dapat diciutkan di samping bagian kode di margin kiri. Saat ditampilkan, Anda dapat mengklik ikon minus - di samping blok teks untuk menciutkannya atau mengklik ikon plus + untuk memperluas blok teks. Nilai defaultnya adalah $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
ShowToolBar
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan apakah toolbar ISE muncul di bagian atas jendela ISE Windows PowerShell. Nilai defaultnya adalah $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
ShowWarningBeforeSavingOnRun
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan apakah pesan peringatan muncul ketika skrip disimpan secara otomatis sebelum dijalankan.
Nilai defaultnya adalah $true.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
ShowWarningForDuplicateFiles
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan apakah pesan peringatan muncul saat file yang sama dibuka di tab PowerShell yang berbeda. Jika diatur ke $true, untuk membuka file yang sama di beberapa tab menampilkan pesan ini: "Salinan file ini terbuka di tab Windows PowerShell lain. Perubahan yang dilakukan pada file ini akan memengaruhi semua salinan terbuka." Nilai defaultnya adalah $true.
# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true
TokenColors
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna token IntelliSense di panel Skrip ISE Windows PowerShell. Properti ini adalah objek kamus yang berisi pasangan nama/nilai dari jenis dan warna token untuk panel Skrip. Untuk mengubah warna token IntelliSense di panel Konsol, lihat ConsoleTokenColors. Untuk mengatur ulang warna ke nilai default, lihat RestoreDefaultTokenColors. Warna token dapat diatur untuk yang berikut ini: Atribut, Perintah, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable.
# Sets the color of commands to green.
$psISE.Options.TokenColors["Command"] = "green"
# Sets the color of keywords to magenta.
$psISE.Options.TokenColors["Keyword"] = "magenta"
GunakanEnterToSelectInConsolePaneIntellisense
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah Anda dapat menggunakan tombol Enter untuk memilih opsi IntelliSense yang disediakan di panel Konsol. Nilai defaultnya adalah $true.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah Anda dapat menggunakan tombol Enter untuk memilih opsi yang disediakan IntelliSense di panel Skrip. Nilai defaultnya adalah $true.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalHelp
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan apakah Bantuan yang diinstal secara lokal atau Bantuan online muncul saat Anda menekan F1 dengan kursor yang diposisikan dalam kata kunci. Jika diatur ke $true, maka jendela pop-up menampilkan konten dari Bantuan yang diinstal secara lokal. Anda dapat menginstal file Bantuan dengan menjalankan Update-Help perintah . Jika diatur ke $false, maka browser Anda terbuka ke halaman di Microsoft Learn.
# Sets the option for the online help to be displayed.
$psISE.Options.UseLocalHelp = $false
# Sets the option for the local Help to be displayed.
$psISE.Options.UseLocalHelp = $true
VerboseBackgroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar belakang untuk teks verbose yang muncul di panel Konsol. Ini adalah objek System.Windows.Media.Color .
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
VerboseForegroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar depan untuk teks verbose yang muncul di panel Konsol. Ini adalah objek System.Windows.Media.Color .
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
WarningBackgroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar belakang untuk teks peringatan yang muncul di panel Konsol. Ini adalah objek System.Windows.Media.Color .
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
WarningForegroundColor
Didukung di Windows PowerShell ISE 2.0 dan yang lebih baru.
Menentukan warna latar depan untuk teks peringatan yang muncul di panel Output. Ini adalah objek System.Windows.Media.Color .
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan objek kamus yang berisi pasangan nama/nilai jenis token dan warna untuk konten XML yang ditampilkan di Windows PowerShell ISE. Warna token dapat diatur untuk yang berikut ini: Atribut, Perintah, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Lihat juga RestoreDefaultXmlTokenColors.
# Sets the color of XML element names to green.
$psISE.Options.XmlTokenColors["ElementName"] = 'green'
# Sets the color of XML comments to magenta.
$psISE.Options.XmlTokenColors["Comment"] = 'magenta'
Zoom
Didukung di Windows PowerShell ISE 3.0 dan yang lebih baru, dan tidak ada di versi sebelumnya.
Menentukan ukuran relatif teks di panel Konsol dan Skrip. Nilai default adalah 100. Nilai yang lebih kecil menyebabkan teks di Windows PowerShell ISE tampak lebih kecil sementara angka yang lebih besar menyebabkan teks tampak lebih besar. Nilainya adalah bilangan bulat yang berkisar antara 20 hingga 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200
Lihat Juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk