Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
O objeto ISEOptions representa várias definiçõ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 da Consola.
# 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 posteriores.
Restaura os valores predefinidos de todas as definições de opções no painel da Consola. Também reinicia o comportamento de várias mensagens de aviso que fornecem a caixa de seleção padrão para evitar que a mensagem volte a aparecer.
# 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 posteriores.
Restaura os valores predefinidos das cores dos tokens 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()
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Restaura os valores predefinidos das cores dos tokens para elementos XML que são 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 operações de gravação automática dos seus ficheiros 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
Esta funcionalidade está presente no Windows PowerShell ISE 2.0, mas foi removida ou renomeada 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
Esta funcionalidade está presente no Windows PowerShell ISE 2.0, mas foi removida ou renomeada 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 para o painel da Consola. É 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 em primeiro plano do texto no painel da Consola.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackgroundColor
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 da Consola.
# 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 da Consola ISE do Windows PowerShell. Esta propriedade é um objeto de dicionário que contém pares nome/valor de tipos de tokens e cores para o painel da Consola. Para alterar as cores dos tokens IntelliSense no painel de Script, veja TokenColors. Para redefinir as cores para os valores predefinidos, consulte RestoreDefaultConsoleTokenColors. As cores das fichas podem ser definidas para o seguinte: Attribute, Command, CommandArgumentCommandParameter, Comment, 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 posteriores.
Especifica a cor de fundo do texto de depuração que aparece no painel da Consola. É 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 posteriores.
Especifica a cor do primeiro plano para o texto de depuração que aparece no painel da Consola. É 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 posteriores.
Um conjunto 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
ErroBackgroundColor
Suportado no Windows PowerShell ISE 2.0 e posteriores.
Especifica a cor de fundo para o texto de erro que aparece no painel da Consola. É 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 posteriores.
Especifica a cor em primeiro plano para o texto de erro que aparece no painel da Consola. É 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 posteriores.
Especifica o nome da fonte atualmente em uso tanto no painel de Script como no painel de Consola.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
Tamanho da Fonte
Suportado no Windows PowerShell ISE 2.0 e posteriores.
Especifica o tamanho da fonte como um inteiro. É usado no painel de scripts, no painel de comandos e no painel de saída. O intervalo válido 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 atualmente digitado. Após este número de segundos, o IntelliSense expira e permite-lhe continuar a escrever. 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 ficheiros recentemente abertos que o Windows PowerShell ISE rastreia e apresenta na parte inferior do menu Abrir Ficheiros . 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
OutputPaneBackgroundColor
Esta funcionalidade está presente no Windows PowerShell ISE 2.0, mas foi removida ou renomeada em versões posteriores do ISE. Para versões posteriores, veja ConsolePaneBackgroundColor.
A propriedade de leitura/escrita 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
Esta funcionalidade está presente no Windows PowerShell ISE 2.0, mas foi removida ou renomeada em versões posteriores do ISE. Para versões posteriores, veja ConsolePaneForegroundColor.
A propriedade de leitura/escrita 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'
OutputPaneTextBackgroundColor
Esta funcionalidade está presente no Windows PowerShell ISE 2.0, mas foi removida ou renomeada em versões posteriores do ISE. Para versões posteriores, veja ConsolePaneTextBackgroundColor.
A propriedade de leitura/escrita 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'
ScriptPaneBackgroundColor
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade de leitura/escrita que recebe ou define a cor de fundo dos ficheiros. É 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 posteriores.
A propriedade de leitura/escrita que recebe ou define a cor em primeiro plano para ficheiros não-script no painel de script. Para definir a cor em primeiro plano dos ficheiros de script, use o TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
SelecionadoScriptPaneEstado
Suportado no Windows PowerShell ISE 2.0 e posteriores.
A propriedade de leitura/escrita que obtém ou define a posição do painel do Script no ecrã. 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'
MostrarExceçõesDeDefaultSnippets
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se a lista de excertos Ctrl+J inclui o conjunto inicial incluído no Windows PowerShell. Quando definido para $false, apenas fragmentos definidos pelo utilizador aparecem na lista Ctrl+J . O valor predefinido é $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 da Consola.
O valor predefinido é $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 predefinido é $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 mostra números de linha na margem esquerda. O valor predefinido é $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
Esboço de Exposição
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se o painel Script mostra colchetes expansíveis e dobráveis ao lado de secções de código na margem esquerda. Quando aparecem, podes clicar nos ícones negativos - ao lado de um bloco de texto para o colapsar ou clicar no ícone de mais + 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 posteriores.
Especifica se a barra de ferramentas ISE aparece no topo da janela ISE do Windows PowerShell. O valor predefinido é $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
MostrarAvisoAntes de GuardarOnRun
Suportado no Windows PowerShell ISE 2.0 e posteriores.
Especifica se aparece uma mensagem de aviso quando um script é guardado 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
MostrarAvisoParaFicheirosDuplicados
Suportado no Windows PowerShell ISE 2.0 e posteriores.
Especifica se aparece uma mensagem de aviso quando o mesmo ficheiro é aberto em separadores PowerShell diferentes. Se definido para $true, para abrir o mesmo ficheiro em vários separadores, mostra esta mensagem: "Uma cópia deste ficheiro está aberta noutra aba PowerShell do Windows. Alterações feitas a este ficheiro 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 posteriores.
Especifica as cores dos tokens IntelliSense no painel de scripts ISE do Windows PowerShell. Esta propriedade é um objeto de dicionário que contém pares nome/valor de tipos de tokens e cores para o painel Script. Para alterar as cores dos tokens IntelliSense no painel de Consola, veja ConsoleTokenColors. Para repor as cores para os valores predefinidos, consulte RestoreDefaultTokenColors. As cores dos tokens podem ser definidas para as seguintes: Atributo, Comando, ArgumentoCommand, CommandParameter, Comentário, FimGrupo, StartGrupo, Palavra-chave, ContinuaçãoLinha, Etiqueta de Loop, Membro, LinhaNova, Número, Operador, Posição, SeparadorSentencia, 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 pode usar a tecla Enter para selecionar uma opção fornecida pelo IntelliSense no painel da Consola. 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
Suportado no Windows PowerShell ISE 3.0 e posteriores, e não presente em versões anteriores.
Especifica se 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
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 pressiona F1 com o cursor posicionado numa palavra-chave. Se estiver definido para $true, então uma janela pop-up mostra o conteúdo da Ajuda instalada localmente. Podes instalar os ficheiros de Ajuda executando o Update-Help comando. Se estiver definido para $false, então 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 posteriores.
Especifica a cor de fundo para texto extenso que aparece no painel da Consola. É 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 posteriores.
Especifica a cor do primeiro plano para texto prolixo que aparece no painel da Consola. É 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 posteriores.
Especifica a cor de fundo para o texto de aviso que aparece no painel da Consola. É um objeto System.Windows.Media.Color .
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
AvisoCorPrimeiro Plano
Suportado no Windows PowerShell ISE 2.0 e 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 token e cores para conteúdo XML que é exibido no Windows PowerShell ISE. As cores dos tokens podem ser definidas para as seguintes: Atributo, Comando, ArgumentoCommand, CommandParameter, Comentário, FimGrupo, StartGrupo, Palavra-chave, ContinuaçãoLinha, Etiqueta de Loop, Membro, LinhaNova, Número, Operador, Posição, SeparadorSentencia, 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 Consola como de Script. O valor padrão é 100. Valores mais pequenos 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 entre 20 e 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200