Объект ISEOptions

Статья
05/09/2024

Объект ISEOptions представляет различные параметры для интегрированной среды сценариев Windows PowerShell. Он является экземпляром класса Microsoft.PowerShell.Host.ISE.ISEOptions.

Объект ISEOptions предоставляет следующие методы и свойства.

Методы

RestoreDefaultConsoleTokenColors()

Поддерживается в интегрированной среде сценариев Windows PowerShell 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 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 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()

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

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

CommandPaneBackgroundColor

Этот компонент присутствует в интегрированной среде сценариев Windows PowerShell 2.0, но был удален или переименован в более поздних версиях интегрированной среды сценариев. Сведения для более поздних версий см. в разделе ConsolePaneBackgroundColor.

Задает цвет фона для области команд. Это экземпляр класса System.Windows.Media.Color.

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

CommandPaneUp

Указывает, находится ли область команд над областью вывода.

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

ConsolePaneBackgroundColor

Задает цвет фона для области консоли. Это экземпляр класса System.Windows.Media.Color.

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

ConsolePaneForegroundColor

Задает цвет переднего плана для текста в области консоли.

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

ConsolePaneTextBackgroundColor

Задает цвет фона для текста в области консоли.

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

ConsoleTokenColors

Задает цвета маркеров IntelliSense в области консоли интегрированной среды сценариев Windows PowerShell. Это свойство является объектом словаря, который содержит пары "имя — значение" для типов и цветов маркеров для области консоли. Сведения об изменении цвета маркеров 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 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 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 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 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 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 2.0 и более поздних версий.

Задает название текущего шрифта в области сценариев и в области консоли.

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

IntellisenseTimeoutInSeconds

Указывает интервал (в секундах), в течение которого IntelliSense пытается разрешить текущий вводимый текст. По завершении указанного интервала время ожидания IntelliSense истекает, и компонент позволяет продолжить ввод текста. Значение по умолчанию — 3 секунды. Значение представлено целым числом.

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

MruCount

Задает число недавно открывавшихся файлов, которые интегрированная среда сценариев Windows PowerShell отслеживает и отображает в нижней части меню Открытие файла. Значение по умолчанию — 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

Свойство для чтения и записи, которое получает или задает цвет фона самой области вывода. Это экземпляр класса System.Windows.Media.Color.

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

OutputPaneTextForegroundColor

Свойство для чтения и записи, которое изменяет цвет переднего плана текста в области вывода в интегрированной среде сценариев Windows PowerShell 2.0.

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

OutputPaneTextBackgroundColor

Свойство для чтения и записи, которое изменяет цвет фона текста в области вывода.

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

ScriptPaneBackgroundColor

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

Свойство для чтения и записи, которое получает или задает цвет фона для файлов. Это экземпляр класса System.Windows.Media.Color.

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

ScriptPaneForegroundColor

Поддерживается в интегрированной среде сценариев Windows PowerShell 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 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

Указывает, содержит ли список фрагментов CTRL+J начальный набор, который включен в Windows PowerShell. Если задано значение $false, в списке CTRL+J отображаются только определенные пользователем фрагменты. Значение по умолчанию — $true.

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

ShowIntellisenseInConsolePane

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

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

ShowIntellisenseInScriptPane

Указывает, предлагает ли IntelliSense синтаксис, параметры и значения в области сценариев. Значение по умолчанию — $true.

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

ShowLineNumbers

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

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

ShowOutlining

Указывает, отображаются ли в области сценариев расширяемые и свертываемые скобки рядом с фрагментами кода в левом поле. Когда они отображаются, можно щелкнуть значок "минус" - рядом с блоком текста, чтобы свернуть, или значок "плюс" +, чтобы развернуть блок текста. Значение по умолчанию — $true.

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

ShowToolBar

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

Указывает, отображается ли в верхней части окна интегрированной среды сценариев Windows PowerShell панель инструментов ISE. Значение по умолчанию — $true.

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

ShowWarningBeforeSavingOnRun

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

Задает цвета маркеров IntelliSense в области сценариев интегрированной среды сценариев Windows PowerShell. Это свойство является объектом словаря, который содержит пары "имя — значение" для типов и цветов маркеров для области сценариев. Сведения об изменении цветов маркеров 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

Указывает, можно ли использовать клавишу ВВОД для выбора варианта, предложенного IntelliSense, в области консоли. Значение по умолчанию — $true.

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

UseEnterToSelectInScriptPaneIntellisense

Указывает, можно ли использовать клавишу ВВОД для выбора варианта, предложенного IntelliSense, в области сценариев. Значение по умолчанию — $true.

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

UseLocalHelp

Указывает, выводится ли на экран локальная справка или справка в Интернете при нажатии клавиши 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 2.0 и более поздних версий.

Задает цвет фона для подробных сообщений, отображаемых в области консоли. Это объект System.Windows.Media.Color.

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

VerboseForegroundColor

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

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

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

WarningBackgroundColor

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

Задает цвет фона для текста предупреждений, отображаемых в области консоли. Это объект System.Windows.Media.Color.

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

WarningForegroundColor

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

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

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

XmlTokenColors

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

Масштабирование

Указывает относительный размер текста в области консоли и сценариев. Значение по умолчанию — 100. Чем больше это значение, тем больше размер отображаемого текста в интегрированной среде сценариев Windows PowerShell. Значение представлено целым числом в диапазоне от 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

Масштабирование

См. также

Обратная связь

Дополнительные ресурсы