ISEOptions 物件

發行項
11/08/2024

ISEOptions 物件代表 Windows PowerShell ISE 的各種設定。它是 Microsoft.PowerShell.Host.ISE.ISEOptions 類別的實例。

ISEOptions 物件提供下列方法和屬性。

方法

RestoreDefaultConsoleTokenColors（）

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

還原控制檯窗格中令牌色彩的預設值。

# 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（）

Windows PowerShell ISE 2.0 和更新版本支援。

還原控制檯窗格中所有選項設定的預設值。它也會重設各種警告訊息的行為，以提供標準複選框，以防止再次顯示訊息。

# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()

RestoreDefaultTokenColors（）

Windows PowerShell ISE 2.0 和更新版本支援。

還原腳本窗格中標記色彩的預設值。

# 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（）

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

針對 Windows PowerShell ISE 中顯示的 XML 元素，還原標記色彩的預設值。另請參閱 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()

屬性

AutoSaveMinuteInterval

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 Windows PowerShell ISE 自動儲存檔案作業之間的分鐘數。預設值為2分鐘。這個值是整數。

# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3

CommandPaneBackgroundColor

這項功能存在於 Windows PowerShell ISE 2.0 中，但在更新版本的 ISE 中已移除或重新命名。如需更新版本，請參閱 ConsolePaneBackgroundColor。

指定 [命令] 窗格的背景色彩。它是 System.Windows.Media.Color 類別的實例。

# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'

CommandPaneUp

這項功能存在於 Windows PowerShell ISE 2.0 中，但在更新版本的 ISE 中已移除或重新命名。

指定 [命令] 窗格是否位於 [輸出] 窗格上方。

# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp  = $true

ConsolePaneBackgroundColor

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定主控檯窗格的背景色彩。它是 System.Windows.Media.Color 類別的實例。

# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'

ConsolePaneForegroundColor

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定主控台窗格中文字的前景色彩。

# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor  = 'yellow'

ConsolePaneTextBackgroundColor

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定主控檯窗格中文字的背景色彩。

# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'

ConsoleTokenColors

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 Windows PowerShell ISE 控制檯窗格中 IntelliSense 令牌的色彩。這個屬性是字典物件，其中包含控制檯窗格的標記類型和色彩名稱/值組。若要變更腳本窗格中 IntelliSense 令牌的色彩，請參閱 TokenColors。若要將色彩重設為預設值，請參閱 RestoreDefaultConsoleTokenColors。您可以針對下列項目設定令牌色彩：Attribute、Command、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

Windows PowerShell ISE 2.0 和更新版本支援。

指定 [主控台] 窗格中所顯示偵錯文字的背景色彩。它是 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

Windows PowerShell ISE 2.0 和更新版本支援。

指定出現在主控台窗格中之偵錯文字的前景色彩。它是 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

Windows PowerShell ISE 2.0 和更新版本支援。

屬性的集合，指定使用 Reset 方法時要使用的預設值。

# 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

Windows PowerShell ISE 2.0 和更新版本支援。

指定 [主控台] 窗格中出現之錯誤文字的背景色彩。它是 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

Windows PowerShell ISE 2.0 和更新版本支援。

指定 [主控台] 窗格中出現之錯誤文字的前景色彩。它是 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

Windows PowerShell ISE 2.0 和更新版本支援。

指定目前在 [文稿] 窗格和 [控制台] 窗格中使用的字型名稱。

# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'

IntellisenseTimeoutInSeconds

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 IntelliSense 用來嘗試解析目前輸入文字的秒數。在此秒數之後，IntelliSense 會逾時，並可讓您繼續輸入。預設值為 3 秒。這個值是整數。

# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5

MruCount

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 Windows PowerShell ISE 追蹤並顯示在 [檔案開啟] 選單底部最近開啟的檔案數目。預設值為 10。這個值是整數。

# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5

OutputPaneBackgroundColor

這項功能存在於 Windows PowerShell ISE 2.0 中，但在更新版本的 ISE 中已移除或重新命名。如需更新版本，請參閱 ConsolePaneBackgroundColor。

可取得或設定 [輸出] 窗格本身背景色彩的讀取/寫入屬性。它是 System.Windows.Media.Color 類別的實例。

# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'

OutputPaneTextForegroundColor

這項功能存在於 Windows PowerShell ISE 2.0 中，但在更新版本的 ISE 中已移除或重新命名。如需更新版本，請參閱 ConsolePaneForegroundColor。

讀取/寫入屬性，會變更 Windows PowerShell ISE 2.0 中 [輸出] 窗格中文字的前景色彩。

# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor  = 'blue'

OutputPaneTextBackgroundColor

這項功能存在於 Windows PowerShell ISE 2.0 中，但在更新版本的 ISE 中已移除或重新命名。如需更新版本，請參閱 ConsolePaneTextBackgroundColor。

變更 [輸出] 窗格中文字背景色彩的讀取/寫入屬性。

# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'

ScriptPaneBackgroundColor

Windows PowerShell ISE 2.0 和更新版本支援。

可取得或設定檔案背景色彩的讀取/寫入屬性。它是 System.Windows.Media.Color 類別的實例。

# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'

ScriptPaneForegroundColor

Windows PowerShell ISE 2.0 和更新版本支援。

讀取/寫入屬性，可取得或設定腳本窗格中非腳本檔案的前景色彩。若要設定腳本檔案的前景色彩，請使用 TokenColors。

# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'

SelectedScriptPaneState

Windows PowerShell ISE 2.0 和更新版本支援。

可取得或設定顯示上 [腳稿] 窗格位置的讀取/寫入屬性。字串可以是 'Maximized'、'Top' 或 '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'

ShowDefaultSnippets

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 CTRL+J 代碼段清單是否包含 Windows PowerShell 中包含的入門集。當設定為 $false時，只有使用者定義的代碼段會出現在 CTRL+J 清單中。預設值是 $true。

# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false

ShowIntellisenseInConsolePane

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 IntelliSense 是否在控制檯窗格中提供語法、參數和值建議。預設值是 $true。

# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false

ShowIntellisenseInScriptPane

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 IntelliSense 是否在 [腳本] 窗格中提供語法、參數和值建議。預設值是 $true。

# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false

ShowLineNumbers

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定 [文稿] 窗格是否在左邊界中顯示行號。預設值是 $true。

# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false

ShowOutlining

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定腳本窗格是否顯示左邊界程式碼區段旁的可展開和可折疊括弧。顯示時，您可以按下文字塊旁的減號 - 圖示來折疊它，或按兩下加號 + 圖示展開文字塊。預設值是 $true。

# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false

ShowToolBar

Windows PowerShell ISE 2.0 和更新版本支援。

指定 ISE 工具列是否出現在 Windows PowerShell ISE 視窗頂端。預設值是 $true。

# Show the toolbar.
$psISE.Options.ShowToolBar = $true

ShowWarningBeforeSavingOnRun

Windows PowerShell ISE 2.0 和更新版本支援。

指定在執行文稿之前是否自動儲存文稿時顯示警告訊息。預設值是 $true。

# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true

ShowWarningForDuplicateFiles

Windows PowerShell ISE 2.0 和更新版本支援。

指定當相同檔案在不同的 PowerShell 索引標籤中開啟時，是否會出現警告訊息。如果設定為 $true，在多個索引卷標中開啟相同的檔案會顯示此訊息：「此檔案的複本在另一個 Windows PowerShell 索引卷標中開啟。對此檔案所做的變更會影響所有開啟的複本。」預設值為 $true。

# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true

TokenColors

Windows PowerShell ISE 2.0 和更新版本支援。

指定 Windows PowerShell ISE 腳本窗格中 IntelliSense 令牌的色彩。這個屬性是字典物件，其中包含腳本窗格的標記類型和色彩名稱/值組。若要變更控制檯窗格中 IntelliSense 令牌的色彩，請參閱 ConsoleTokenColors。若要將色彩重設為預設值，請參閱 RestoreDefaultTokenColors。您可以針對下列項目設定令牌色彩：Attribute、Command、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"

UseEnterToSelectInConsolePaneIntellisense

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定您是否可以使用 Enter 鍵來選取控制檯窗格中提供的 IntelliSense 選項。預設值是 $true。

# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false

UseEnterToSelectInScriptPaneIntellisense

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定您是否可以使用 Enter 鍵，在 [腳本] 窗格中選取 IntelliSense 提供的選項。預設值是 $true。

# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true

UseLocalHelp

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定當您按下 F1 時，本機安裝的 [說明] 或 [在線說明] 是否會出現，且游標位於關鍵詞中。如果設定為 $true，則彈出視窗會顯示本機安裝 [說明] 中的內容。您可以執行 Update-Help 命令來安裝說明檔。如果設定為 $false，則您的瀏覽器會開啟至 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

Windows PowerShell ISE 2.0 和更新版本支援。

指定 [主控台] 窗格中所顯示詳細資訊文字的背景色彩。它是 System.Windows.Media.Color 物件。

# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'

VerboseForegroundColor

Windows PowerShell ISE 2.0 和更新版本支援。

指定 [主控台] 窗格中所顯示詳細資訊文字的前景色彩。它是 System.Windows.Media.Color 物件。

# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'

WarningBackgroundColor

Windows PowerShell ISE 2.0 和更新版本支援。

指定出現在主控台窗格中之警告文字的背景色彩。它是 System.Windows.Media.Color 物件。

# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'

WarningForegroundColor

Windows PowerShell ISE 2.0 和更新版本支援。

指定出現在 [輸出] 窗格中之警告文字的前景色彩。它是 System.Windows.Media.Color 物件。

# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'

XmlTokenColors

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定字典物件，其中包含 Windows PowerShell ISE 中顯示的 XML 內容之標記類型和色彩的名稱/值組。您可以針對下列項目設定令牌色彩：Attribute、Command、CommandArgument、CommandParameter、Comment、GroupEnd、GroupStart、Keyword、LineContinuation、LoopLabel、Member、NewLine、Number、Operator、Position、StatementSeparator、String、Type、Unknown、Variable。另請參閱 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

Windows PowerShell ISE 3.0 和更新版本中支援，且未出現在舊版中。

指定主控台和文稿窗格中文字的相對大小。預設值是 100。較小的值會導致 Windows PowerShell ISE 中的文字顯示較小，而較大的數位會導致文字出現較大。值是介於 20 到 400 的整數。

# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200

共用方式為

ISEOptions 物件

方法

RestoreDefaultConsoleTokenColors（）

RestoreDefaults（）

RestoreDefaultTokenColors（）

RestoreDefaultXmlTokenColors（）

屬性

AutoSaveMinuteInterval

CommandPaneBackgroundColor

CommandPaneUp

ConsolePaneBackgroundColor

ConsolePaneForegroundColor

ConsolePaneTextBackgroundColor

ConsoleTokenColors

DebugBackgroundColor

DebugForegroundColor

DefaultOptions

ErrorBackgroundColor

ErrorForegroundColor

FontName

FontSize

IntellisenseTimeoutInSeconds

MruCount

OutputPaneBackgroundColor

OutputPaneTextForegroundColor

OutputPaneTextBackgroundColor

ScriptPaneBackgroundColor

ScriptPaneForegroundColor

SelectedScriptPaneState

ShowDefaultSnippets

ShowIntellisenseInConsolePane

ShowIntellisenseInScriptPane

ShowLineNumbers

ShowOutlining

ShowToolBar

ShowWarningBeforeSavingOnRun

ShowWarningForDuplicateFiles

TokenColors

UseEnterToSelectInConsolePaneIntellisense

UseEnterToSelectInScriptPaneIntellisense

UseLocalHelp

VerboseBackgroundColor

VerboseForegroundColor

WarningBackgroundColor

WarningForegroundColor

XmlTokenColors

Zoom

另請參閱

其他資源