Поделиться через

Объект ISEOptions

Объект 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 и более поздних версиях, отсутствует в предыдущих версиях.

Восстанавливает значения цветов токенов по умолчанию для XML-элементов, отображаемых в Windows PowerShell ISE. См. также 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 и более поздних версиях, отсутствует в предыдущих версиях.

Указывает цвета токенов IntelliSense в панели консоли Windows PowerShell ISE. Это свойство является объектом словаря, содержащим пары типов токенов и цветов имени/значения для панели консоли. Чтобы изменить цвета токенов IntelliSense в панели Script, см. раздел TokenColors. Чтобы сбросить цвета к значениям по умолчанию, см. RestoreDefaultConsoleTokenColors. Цвета жетонов можно задать для следующих: Attribute, Command, CommandArgumentCommandParameterCommentGroupEndGroupStart, Keyword, . LineContinuationLoopLabelMemberNewLineNumberOperatorPositionStatementSeparatorStringTypeUnknownVariable

# 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 и более поздних версиях.

Коллекция свойств, указывающих значения по умолчанию, используемые при использовании методов сброса.

# 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                      : #FFFF9494
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

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'

Размер шрифта

Поддерживается в Windows PowerShell ISE 2.0 и более поздних версиях.

Указывает размер шрифта как целое число. Он используется в панели Script, Command и Output. Допустимый диапазон значений — от 8 до 32.

# Changes the font size in all panes.
$psISE.Options.FontSize = 20

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 и более поздних версиях.

Свойство чтения/записи, которое получает или устанавливает цвет переднего плана для нескриптных файлов в панели Script. Чтобы задать цвет на переднем плане для файлов скриптов, используйте 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 и более поздних версиях, отсутствует в предыдущих версиях.

Указывает, отображается ли панель Script номера строк в левом поле. Значение по умолчанию — $true.

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

Конспект шоу

Поддерживается в 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

Предупреждение перед сохранением OnRun

Поддерживается в 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 и более поздних версиях.

Задаёт цвета токенов IntelliSense в панели скриптов Windows PowerShell ISE. Это свойство является словарным объектом, содержащим пары типов токенов и цветов имени/значения для панели скриптов. Чтобы изменить цвета токенов 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'

МногословныйПередний планЦвет

Поддерживается в Windows PowerShell ISE 2.0 и более поздних версиях.

Указывает цвет переднего плана для многословного текста, который появляется в панели консоли. Это объект System.Windows.Media.Color .

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

ПредупреждениеФонЦвет

Поддерживается в Windows PowerShell ISE 2.0 и более поздних версиях.

Указывает цвет фона для предупреждающего текста, который появляется в панели консоли. Это объект System.Windows.Media.Color .

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

ПредупреждениеПередний планЦвет

Поддерживается в 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 и более поздних версиях, отсутствует в предыдущих версиях.

Задаёт объект словаря, содержащий пары типов токенов и цветов для XML-контента, отображаемого в Windows PowerShell ISE. Цвета токена можно задать для следующих параметров: 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 и более поздних версиях, отсутствует в предыдущих версиях.

Задаёт относительный размер текста как в панелях Console, так и в Script. Значение по умолчанию — 100. Меньшие значения заставляют текст в Windows PowerShell ISE казаться меньшим, а большие числа — больше. Это целое число, варьирующееся от 20 до 400.

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

См. также

  • Last updated on