Objeto ISEOptions
O objeto ISEOptions representa várias configurações para o Windows PowerShell ISE. É uma instância da classe Microsoft.PowerShell.Host.ISE.ISEOptions .
O objeto ISEOptions fornece os seguintes métodos e propriedades.
Métodos
RestoreDefaultConsoleTokenColors()
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Restaura os valores padrão das cores do token no painel Console.
# 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()
Suportado no Windows PowerShell ISE 2.0 e posterior.
Restaura os valores padrão de todas as configurações de opções no painel Console. Ele também redefine o comportamento de várias mensagens de aviso que fornecem a caixa de seleção padrão para impedir que a mensagem seja mostrada novamente.
# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()
RestoreDefaultTokenColors()
Suportado no Windows PowerShell ISE 2.0 e posterior.
Restaura os valores padrão das cores do token no painel Script.
# 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()
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Restaura os valores padrão das cores de token para elementos XML exibidos no Windows PowerShell ISE. Consulte também 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()
Propriedades
AutoSaveMinuteInterval
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica o número de minutos entre as operações de salvamento automático de seus arquivos pelo Windows PowerShell ISE. O valor padrão é 2 minutos. O valor é um inteiro.
# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3
CommandPaneBackgroundColor
Esse recurso está presente no Windows PowerShell ISE 2.0, mas foi removido ou renomeado em versões posteriores do ISE. Para versões posteriores, consulte ConsolePaneBackgroundColor.
Especifica a cor do plano de fundo para o painel de comandos. É uma instância da classe System.Windows.Media.Color .
# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'
CommandPaneUp
Esse recurso está presente no Windows PowerShell ISE 2.0, mas foi removido ou renomeado em versões posteriores do ISE.
Especifica se o painel Comando está localizado acima do painel Saída.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica a cor do plano de fundo para o painel Console. É uma instância da classe System.Windows.Media.Color .
# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'
ConsolePaneForegroundColor
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica a cor de primeiro plano do texto no painel Console.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackgroundColor
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica a cor do plano de fundo do texto no painel Console.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica as cores dos tokens IntelliSense no painel Console ISE do Windows PowerShell. Esta propriedade é um objeto de dicionário que contém pares nome/valor de tipos de token e cores para o painel Console. Para alterar as cores dos tokens IntelliSense no painel Script, consulte TokenColors. Para redefinir as cores para os valores padrão, consulte RestoreDefaultConsoleTokenColors. As cores do token podem ser definidas para o seguinte: Atributo, Comando, 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
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor do plano de fundo para o texto de depuração que aparece no painel Console. É uma instância da classe 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
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor de primeiro plano para o texto de depuração que aparece no painel Console. É uma instância da classe 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
Suportado no Windows PowerShell ISE 2.0 e posterior.
Uma coleção de propriedades que especificam os valores padrão a serem usados quando os métodos Reset são usados.
# 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
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor do plano de fundo para o texto de erro que aparece no painel Console. É uma instância da classe 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
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor de primeiro plano para o texto de erro que aparece no painel Console. É uma instância da classe System.Windows.Media.Color .
# Changes the foreground color for the error text that appears in the console pane to green.
$psISE.Options.ErrorForegroundColor = 'green'
Nome da fonte
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica o nome da fonte atualmente em uso no painel Script e no painel Console.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
Tamanho do tipo de Letra
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica o tamanho da fonte como um inteiro. Ele é usado no painel Script, no painel Comando e no painel Saída. O intervalo válido de valores é de 8 a 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeoutInSeconds
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica o número de segundos que o IntelliSense usa para tentar resolver o texto digitado no momento. Após esse número de segundos, o IntelliSense atinge o tempo limite e permite que você continue digitando. O valor padrão é 3 segundos. O valor é um inteiro.
# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5
MruCount
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica o número de arquivos abertos recentemente que o Windows PowerShell ISE rastreia e exibe na parte inferior do menu Abrir Arquivo. O valor predefinido é 10. O valor é um inteiro.
# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5
OutputPaneBackgroundColor
Esse recurso está presente no Windows PowerShell ISE 2.0, mas foi removido ou renomeado em versões posteriores do ISE. Para versões posteriores, consulte ConsolePaneBackgroundColor.
A propriedade de leitura/gravação que obtém ou define a cor do plano de fundo para o próprio painel Saída. É uma instância da classe System.Windows.Media.Color .
# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'
OutputPaneTextForegroundColor
Esse recurso está presente no Windows PowerShell ISE 2.0, mas foi removido ou renomeado em versões posteriores do ISE. Para versões posteriores, consulte ConsolePaneForegroundColor.
A propriedade de leitura/gravação que altera a cor do primeiro plano do texto no painel Saída no Windows PowerShell ISE 2.0.
# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor = 'blue'
OutputPaneTextBackgroundColor
Esse recurso está presente no Windows PowerShell ISE 2.0, mas foi removido ou renomeado em versões posteriores do ISE. Para versões posteriores, consulte ConsolePaneTextBackgroundColor.
A propriedade de leitura/gravação que altera a cor do plano de fundo do texto no painel Saída.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackgroundColor
Suportado no Windows PowerShell ISE 2.0 e posterior.
A propriedade de leitura/gravação que obtém ou define a cor de plano de fundo para arquivos. É uma instância da classe System.Windows.Media.Color .
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'
ScriptPaneForegroundColor
Suportado no Windows PowerShell ISE 2.0 e posterior.
A propriedade de leitura/gravação que obtém ou define a cor de primeiro plano para arquivos não script no painel Script. Para definir a cor de primeiro plano para arquivos de script, use TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelectedScriptPaneState
Suportado no Windows PowerShell ISE 2.0 e posterior.
A propriedade de leitura/gravação que obtém ou define a posição do painel Script na exibição. A cadeia de caracteres pode ser 'Maximizada', 'Superior' ou 'Direita'.
# 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
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se a lista de trechos CTRL+J inclui o conjunto inicial incluído no Windows PowerShell. Quando definido como $false, somente trechos definidos pelo usuário aparecem na lista CTRL+J.
O valor predefinido é $true.
# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se o IntelliSense oferece sugestões de sintaxe, parâmetro e valor no painel Console.
O valor predefinido é $true.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se o IntelliSense oferece sugestões de sintaxe, parâmetro e valor no painel Script.
O valor predefinido é $true.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se o painel Script exibe números de linha na margem esquerda. O valor predefinido é $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
ShowOutlining
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se o painel Script exibe colchetes expansíveis e recolhíveis ao lado de seções de código na margem esquerda. Quando eles são exibidos, você pode clicar nos ícones de menos - ao lado de um bloco de texto para recolhê-lo ou clicar no ícone de adição + para expandir um bloco de texto. O valor predefinido é $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
ShowToolBar
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica se a barra de ferramentas ISE aparece na parte superior da janela ISE do Windows PowerShell. O valor predefinido é $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
ShowWarningBeforeSavingOnRun
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica se uma mensagem de aviso aparece quando um script é salvo automaticamente antes de ser executado.
O valor predefinido é $true.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
ShowWarningForDuplicateFiles
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica se uma mensagem de aviso aparece quando o mesmo arquivo é aberto em diferentes guias do PowerShell. Se definido como $true, para abrir o mesmo arquivo em várias guias exibe esta mensagem: "Uma cópia deste arquivo está aberta em outra guia do Windows PowerShell. As alterações feitas neste arquivo afetarão todas as cópias abertas." O valor padrão é $true.
# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true
TokenColors
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica as cores dos tokens IntelliSense no painel Script ISE do Windows PowerShell. Esta propriedade é um objeto de dicionário que contém pares nome/valor de tipos de token e cores para o painel Script. Para alterar as cores dos tokens IntelliSense no painel Console, consulte ConsoleTokenColors. Para redefinir as cores para os valores padrão, consulte RestoreDefaultTokenColors. As cores do token podem ser definidas para o seguinte: Atributo, Comando, 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
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se você pode usar a tecla Enter para selecionar uma opção fornecida pelo IntelliSense no painel Console. O valor predefinido é $true.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se você pode usar a tecla Enter para selecionar uma opção fornecida pelo IntelliSense no painel Script. O valor predefinido é $true.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalHelp
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica se a Ajuda instalada localmente ou a Ajuda online aparece quando você pressiona F1 com o cursor posicionado em uma palavra-chave. Se definido como $true, uma janela pop-up mostra o conteúdo da Ajuda instalada localmente. Você pode instalar os arquivos de Ajuda executando o Update-Help comando. Se definido como $false, o navegador será aberto em uma página no 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
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor do plano de fundo para o texto detalhado que aparece no painel Console. É um objeto System.Windows.Media.Color .
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
VerboseForegroundColor
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor de primeiro plano para o texto detalhado que aparece no painel Console. É um objeto System.Windows.Media.Color .
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
AvisoBackgroundColor
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor do plano de fundo para o texto de aviso que aparece no painel Console. É um objeto System.Windows.Media.Color .
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
AvisoForegroundColor
Suportado no Windows PowerShell ISE 2.0 e posterior.
Especifica a cor de primeiro plano para o texto de aviso que aparece no painel Saída. É um objeto System.Windows.Media.Color .
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica um objeto de dicionário que contém pares nome/valor de tipos de token e cores para conteúdo XML exibido no Windows PowerShell ISE. As cores do token podem ser definidas para o seguinte: Atributo, Comando, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Consulte também 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
Com suporte no Windows PowerShell ISE 3.0 e posterior, e não presente em versões anteriores.
Especifica o tamanho relativo do texto nos painéis Console e Script. O valor predefinido é 100. Valores menores fazem com que o texto no Windows PowerShell ISE pareça menor, enquanto números maiores fazem com que o texto pareça maior. O valor é um inteiro que varia de 20 a 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200
Consulte Também
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários