Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
El objeto ISEOptions representa varios ajustes para Windows PowerShell ISE. Es una instancia de la clase Microsoft.PowerShell.Host.ISE.ISEOptions .
El objeto ISEOptions proporciona los siguientes métodos y propiedades.
Methods
RestoreDefaultConsoleTokenColors()
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Restaura los valores predeterminados de los colores de los tokens en el panel de la 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()
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Restaura los valores predeterminados de todos los ajustes de opciones en el panel de la consola. También reinicia el comportamiento de varios mensajes de advertencia que proporcionan la casilla estándar para evitar que el mensaje se muestre de nuevo.
# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()
RestoreDefaultTokenColors()
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Restaura los valores predeterminados de los colores de los tokens en el panel de 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()
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Restaura los valores predeterminados de los colores de los tokens para los elementos XML que se muestran en Windows PowerShell ISE. Véase también 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()
Propiedades
AutoSaveMinuteInterval
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el número de minutos entre operaciones de guardado automático de tus archivos mediante Windows PowerShell ISE. El valor por defecto es 2 minutos. El valor es un entero.
# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3
CommandPaneBackgroundColor
Esta característica está presente en Windows PowerShell ISE 2.0, pero fue eliminada o renombrada en versiones posteriores del ISE. Para versiones posteriores, véase ConsolePaneBackgroundColor.
Especifica el color de fondo para el panel de comandos. Es una instancia de la clase System.Windows.Media.Color .
# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'
CommandPaneUp
Esta característica está presente en Windows PowerShell ISE 2.0, pero fue eliminada o renombrada en versiones posteriores del ISE.
Especifica si el panel de comandos está ubicado por encima del panel de salida.
# Moves the Command pane to the top of the screen.
$psISE.Options.CommandPaneUp = $true
ConsolePaneBackgroundColor
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el color de fondo para el panel de la consola. Es una instancia de la clase System.Windows.Media.Color .
# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'
ConsolePaneForegroundColor
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el color del primer plano del texto en el panel de la Consola.
# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor = 'yellow'
ConsolePaneTextBackColor
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el color de fondo del texto en el panel de la Consola.
# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'
ConsoleTokenColors
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica los colores de los tokens IntelliSense en el panel de la consola ISE de Windows PowerShell. Esta propiedad es un objeto de diccionario que contiene pares nombre/valor de tipos de tokens y colores para el panel de la Consola. Para cambiar los colores de los tokens IntelliSense en el panel de scripts, consulta TokenColors. Para restablecer los colores a los valores predeterminados, consulta RestoreDefaultConsoleTokenColors. Los colores de las fichas pueden configurarse para los siguientes: 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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color de fondo para el texto de depuración que aparece en el panel de la consola. Es una instancia de la clase 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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color del primer plano para el texto de depuración que aparece en el panel de la consola. Es una instancia de la clase 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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Un conjunto de propiedades que especifican los valores por defecto que se usarán cuando se usan los métodos de 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 : #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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color de fondo para el texto de error que aparece en el panel de la consola. Es una instancia de la clase 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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color del primer plano para el texto de error que aparece en el panel de la consola. Es una instancia de la clase 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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el nombre de la fuente que se usa actualmente tanto en el panel de Script como en el panel de Consola.
# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'
Tamaño de fuente
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el tamaño de fuente como un entero. Se usa en el panel de scripts, el panel de comandos y el panel de salida. El rango válido de valores es del 8 al 32.
# Changes the font size in all panes.
$psISE.Options.FontSize = 20
IntellisenseTimeOutEnSegundos
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el número de segundos que utiliza IntelliSense para intentar resolver el texto actualmente tecleando. Tras este número de segundos, IntelliSense se agota y te permite seguir escribiendo. El valor por defecto es 3 segundos. El valor es un entero.
# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5
MruCount
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el número de archivos abiertos recientemente que Windows PowerShell ISE rastrea y muestra en la parte inferior del menú de Apertura de Archivo . El valor predeterminado es 10. El valor es un entero.
# 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 característica está presente en Windows PowerShell ISE 2.0, pero fue eliminada o renombrada en versiones posteriores del ISE. Para versiones posteriores, véase ConsolePaneBackgroundColor.
La propiedad de lectura/escritura que obtiene o establece el color de fondo para el propio panel de salida. Es una instancia de la clase System.Windows.Media.Color .
# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'
OutputPaneTextForegroundColor
Esta característica está presente en Windows PowerShell ISE 2.0, pero fue eliminada o renombrada en versiones posteriores del ISE. Para versiones posteriores, véase ConsolePaneForegroundColor.
La propiedad de lectura/escritura que cambia el color del primer plano del texto en el panel de salida en Windows PowerShell ISE 2.0.
# Changes the foreground color of the text in the Output Pane to blue.
$psISE.Options.OutputPaneTextForegroundColor = 'blue'
OutputPaneTextBackgroundColor
Esta característica está presente en Windows PowerShell ISE 2.0, pero fue eliminada o renombrada en versiones posteriores del ISE. Para versiones posteriores, véase ConsolePaneTextBackgroundColor.
La propiedad de lectura/escritura que cambia el color de fondo del texto en el panel de salida.
# Changes the background color of the Output pane text to pink.
$psISE.Options.OutputPaneTextBackgroundColor = 'pink'
ScriptPaneBackColor
Compatible con Windows PowerShell ISE 2.0 y posteriores.
La propiedad de lectura/escritura que obtiene o establece el color de fondo para los archivos. Es una instancia de la clase System.Windows.Media.Color .
# Sets the color of the script pane background to yellow.
$psISE.Options.ScriptPaneBackgroundColor = 'yellow'
ScriptPaneForegroundColor
Compatible con Windows PowerShell ISE 2.0 y posteriores.
La propiedad de lectura/escritura que obtiene o establece el color del primer plano para archivos que no son script en el panel de script. Para establecer el color de primer plano para los archivos de script, utiliza los TokenColors.
# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = 'green'
ScreenPaneEstado seleccionado
Compatible con Windows PowerShell ISE 2.0 y posteriores.
La propiedad de lectura/escritura que obtiene o establece la posición del panel de scripts en la pantalla. La cuerda puede ser 'Maximizada', 'Superior' o 'Derecha'.
# 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'
MostrarFragmentosDeDefaultSnippets
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si la lista de fragmentos Ctrl+J incluye el set inicial que está incluido en Windows PowerShell. Cuando se establece en $false, solo aparecen fragmentos definidos por el usuario en la lista Ctrl+J . El valor predeterminado es $true.
# Hide the default snippets from the Ctrl+J list.
$psISE.Options.ShowDefaultSnippets = $false
ShowIntellisenseInConsolePane
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si IntelliSense ofrece sugerencias de sintaxis, parámetros y valores en el panel de Consola.
El valor predeterminado es $true.
# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false
ShowIntellisenseInScriptPane
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si IntelliSense ofrece sugerencias de sintaxis, parámetros y valores en el panel de Script.
El valor predeterminado es $true.
# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false
ShowLineNumbers
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si el panel de Script muestra los números de línea en el margen izquierdo. El valor predeterminado es $true.
# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false
Esquema de Exposición
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si el panel de Script muestra corchetes expandibles y plegables junto a secciones de código en el margen izquierdo. Cuando se muestran, puedes hacer clic en los iconos de menos - junto a un bloque de texto para colapsarlo o en el icono de más + para expandir un bloque de texto. El valor predeterminado es $true.
# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false
BarreHerramientasShowTool
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica si la barra de herramientas ISE aparece en la parte superior de la ventana ISE de Windows PowerShell. El valor predeterminado es $true.
# Show the toolbar.
$psISE.Options.ShowToolBar = $true
MostrarAdvertenciaAntes de GuardarOnRun
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica si aparece un mensaje de advertencia cuando un script se guarda automáticamente antes de ejecutarse.
El valor predeterminado es $true.
# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true
MostrarDeAdvertenciaParaArchivos Duplicados
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica si aparece un mensaje de advertencia cuando se abre el mismo archivo en diferentes pestañas de PowerShell. Si se configura en $true, para abrir el mismo archivo en varias pestañas se muestra este mensaje: "Una copia de este archivo está abierta en otra pestaña de PowerShell de Windows. Los cambios realizados en este archivo afectarán a todas las copias abiertas." El valor por defecto es $true.
# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true
TokenColors
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica los colores de los tokens IntelliSense en el panel de scripts ISE de Windows PowerShell. Esta propiedad es un objeto de diccionario que contiene pares nombre/valor de tipos de tokens y colores para el panel de script. Para cambiar los colores de los tokens IntelliSense en el panel de Consola, consulte ConsoleTokenColors. Para restablecer los colores a los valores predeterminados, consulte RestoreDefaultTokenColors. Los colores de los tokens pueden configurarse para los siguientes: Atributo, Comando, ArgumentoComando, Parámetro de Comando, Comentario, FinalGrupo, InicioGrupo, Palabra clave, ContinuaciónLínea, Etiqueta de Bucle, Miembro, LíneaNova, Número, Operador, Posición, SeparadorSentencia, Cadena, Tipo, Desconocido, 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
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si puedes usar la tecla Enter para seleccionar una opción proporcionada por IntelliSense en el panel de Consola. El valor predeterminado es $true.
# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false
UseEnterToSelectInScriptPaneIntellisense
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si puedes usar la tecla Enter para seleccionar una opción proporcionada por IntelliSense en el panel de script. El valor predeterminado es $true.
# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true
UseLocalizHelp
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica si aparece la Ayuda instalada localmente o la Ayuda online cuando pulsas F1 con el cursor posicionado en una palabra clave. Si se configura en $true, entonces una ventana emergente muestra contenido de la Ayuda instalada localmente. Puedes instalar los archivos de ayuda ejecutando el Update-Help comando. Si se configura en $false, entonces tu navegador se abre a una página en 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
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color de fondo para el texto extenso que aparece en el panel de la consola. Es un objeto System.Windows.Media.Color .
# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'
VerboseForegroundColor
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color del primer plano para el texto extenso que aparece en el panel de la consola. Es un objeto System.Windows.Media.Color .
# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'
AdvertenciaColor de fondo
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color de fondo para el texto de advertencia que aparece en el panel de la consola. Es un objeto System.Windows.Media.Color .
# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'
AdvertenciaPrimer Plano Color
Compatible con Windows PowerShell ISE 2.0 y posteriores.
Especifica el color de primer plano para el texto de advertencia que aparece en el panel de salida. Es un objeto System.Windows.Media.Color .
# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'
XmlTokenColors
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica un objeto diccionario que contiene pares nombre/valor de tipos de tokens y colores para contenido XML que se muestra en Windows PowerShell ISE. Los colores de los tokens pueden configurarse para los siguientes: Atributo, Comando, ArgumentoComando, Parámetro de Comando, Comentario, FinalGrupo, InicioGrupo, Palabra clave, ContinuaciónLínea, Etiqueta de Bucle, Miembro, LíneaNova, Número, Operador, Posición, SeparadorSentencia, Cadena, Tipo, Desconocido, Variable. Véase también 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
Compatible con Windows PowerShell ISE 3.0 y posteriores, y no presente en versiones anteriores.
Especifica el tamaño relativo del texto tanto en el panel de Consola como en el de Guion. El valor predeterminado es 100. Los valores más pequeños hacen que el texto en Windows PowerShell ISE parezca más pequeño, mientras que los números más grandes hacen que el texto parezca más grande. El valor es un entero que varía de 20 a 400.
# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200