Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Methods
RestoreDefaultConsoleTokenColors()
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Restaura os valores padrão das cores dos tokens no painel do 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 versões posteriores.
Restaura os valores padrão de todas as configurações de opções no painel do Console. Também reinicia o comportamento de várias mensagens de aviso que fornecem a caixa padrão para evitar que a mensagem seja exibida 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 versões posteriores.
Restaura os valores padrão das cores dos tokens no painel do 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()
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Restaura os valores padrão das cores dos tokens para elementos XML exibidos no Windows PowerShell ISE. Veja 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
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica o número de minutos entre as operações de salvamento automático dos 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, veja ConsolePaneBackgroundColor.
Especifica a cor 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 de comandos está localizado acima do painel de saída.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica a cor de fundo do painel do 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
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica a cor do texto em primeiro plano no painel do Console.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextoBackColor
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica a cor de fundo do texto no painel do Console.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica as cores dos tokens IntelliSense no painel do console ISE do Windows PowerShell. Essa propriedade é um objeto de dicionário que contém pares nome/valor de tipos de tokens e cores para o painel do Console. Para alterar as cores dos tokens IntelliSense no painel de Script, veja TokenColors. Para redefinir as cores para os valores padrão, veja RestoreDefaultConsoleTokenColors. As cores das fichas podem ser definidas para as seguintes opções: Attribute, Command, CommandArgument, CommandParameterComment, GroupEnd, GroupStart, 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
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica a cor de fundo do texto de depuração que aparece no painel do 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 versões posteriores.
Especifica a cor do primeiro plano para o texto de depuração que aparece no painel do 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 versões posteriores.
Uma coleção de propriedades que especificam os valores padrão a serem usados quando os métodos Reset são utilizados.
# 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
ErroBackBackgroundColor
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica a cor de fundo para o texto de erro que aparece no painel do 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'
ErroPrimeiroPlanoColor
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica a cor do primeiro plano para o texto de erro que aparece no painel do 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'
FontName
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica o nome da fonte atualmente em uso tanto no painel de script quanto no painel de console.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
Tamanho da Fonte
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica o tamanho da fonte como um inteiro. Ele é usado no painel de script, no painel de comandos e no painel de saída. A faixa válida de valores é de 8 a 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeOutEmSegundos
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica o número de segundos que o IntelliSense usa para tentar resolver o texto digitado atualmente. Após esse número de segundos, o IntelliSense expira 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
Suportado no Windows PowerShell ISE 3.0 e posteriores, 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 Arquivos . O valor padrão é 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
SaídaPaneBackgroundColor
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, veja ConsolePaneBackgroundColor.
A propriedade de leitura/gravação que recebe ou define a cor de fundo para o próprio painel de 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, veja ConsolePaneForegroundColor.
A propriedade de leitura/gravação que altera a cor do texto em primeiro plano no painel de 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'
SaídaPaneTextoContextoColor
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, veja ConsolePaneTextBackgroundColor.
A propriedade de leitura/gravação que altera a cor de fundo do texto no painel de Saída.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackColor
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
A propriedade de leitura/gravação que recebe ou define a cor de fundo dos 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 versões posteriores.
A propriedade de leitura/escrita que recebe ou define a cor em primeiro plano para arquivos não-script no painel de script. Para definir a cor em primeiro plano para arquivos de script, use o TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelecionadoScriptPaneState
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
A propriedade de leitura/gravação que obtém ou define a posição do painel de script na tela. A corda pode ser 'Maximizada', 'Top' 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'
MostrarSNippets PadrãoPadrão
Suportado no Windows PowerShell ISE 3.0 e posteriores, 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, apenas trechos definidos pelo usuário aparecem na lista Ctrl+J . O valor padrão é $true.
# Hide the default snippets from the Ctrl+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se o IntelliSense oferece sugestões de sintaxe, parâmetros e valores no painel do Console.
O valor padrão é $true.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se o IntelliSense oferece sugestões de sintaxe, parâmetros e valores no painel de Script.
O valor padrão é $true.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se o painel Script exibe números de linha na margem esquerda. O valor padrão é $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
ShowPloting
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se o painel Script exibe colchetes expansíveis e dobráveis ao lado de seções de código na margem esquerda. Quando eles aparecem, você pode clicar nos ícones negativos - ao lado de um bloco de texto para colapsá-lo ou clicar no ícone de mais + para expandir um bloco de texto. O valor padrão é $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
ShowToolBar
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica se a barra de ferramentas ISE aparece no topo da janela ISE do Windows PowerShell. O valor padrão é $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
MostrarAvisoAntes de SalvarOnRun
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica se uma mensagem de aviso aparece quando um script é salvo automaticamente antes de ser executado.
O valor padrão é $true.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
MostrarAvisoParaArquivosDuplicados
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica se aparece uma mensagem de aviso quando o mesmo arquivo é aberto em abas diferentes do PowerShell. Se definido para $true, para abrir o mesmo arquivo em várias abas, aparece esta mensagem: "Uma cópia deste arquivo está aberta em outra aba do PowerShell do Windows. 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 versões posteriores.
Especifica as cores dos tokens IntelliSense no painel de scripts ISE do Windows PowerShell. Essa propriedade é um objeto de dicionário que contém pares nome/valor de tipos de token e cores para o painel de script. Para alterar as cores dos tokens IntelliSense no painel do Console, veja ConsoleTokenColors. Para redefinir as cores para os valores padrão, veja RestoreDefaultTokenColors. As cores dos tokens podem ser definidas para os seguintes dispositivos: Atributo, Comando, ArgumentoComando, Parámetro Comando, Comentário, FimGrupo, StartGrupo, Palavra-chave, ContinuaçãoLinha, Etiqueta de Loop, Membro, LinhaNova, Número, Operador, Posição, SeparadorSentem, String, Tipo, Desconhecido, Variável.
# 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
Suportado no Windows PowerShell ISE 3.0 e posteriores, 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 do Console. O valor padrão é $true.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
Suportado no Windows PowerShell ISE 3.0 e posteriores, 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 de Script. O valor padrão é $true.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalHelp
Suportado no Windows PowerShell ISE 3.0 e posteriores, 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 configurado para $true, então 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 estiver definido para $false, então seu navegador abre para 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 versões posteriores.
Especifica a cor de fundo para texto verboso que aparece no painel do Console. É um objeto System.Windows.Media.Color .
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
Cor VerboseForeground
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica a cor em primeiro plano para texto extenso que aparece no painel do Console. É um objeto System.Windows.Media.Color .
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
AvisoCorFundo
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica a cor de fundo para o texto de aviso que aparece no painel do Console. É um objeto System.Windows.Media.Color .
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
AvisoCorCorPrimeiro Plano
Suportado no Windows PowerShell ISE 2.0 e versões posteriores.
Especifica a cor do primeiro plano para o texto de aviso que aparece no painel de Saída. É um objeto System.Windows.Media.Color .
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica um objeto de dicionário que contém pares nome/valor de tipos de tokens e cores para conteúdo XML que é exibido no Windows PowerShell ISE. As cores dos tokens podem ser definidas para os seguintes dispositivos: Atributo, Comando, ArgumentoComando, Parámetro Comando, Comentário, FimGrupo, StartGrupo, Palavra-chave, ContinuaçãoLinha, Etiqueta de Loop, Membro, LinhaNova, Número, Operador, Posição, SeparadorSentem, String, Tipo, Desconhecido, Variável. Veja 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
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica o tamanho relativo do texto tanto nos painéis de Console quanto de Script. O valor padrão é 100. Valores menores fazem com que o texto no Windows PowerShell ISE pareça menor, enquanto números maiores fazem o texto parecer 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