Objet ISEOptions

L'objet Options représente divers paramètres pour Windows PowerShell ISE. Il s'agit d'une instance de la classe Microsoft.PowerShell.Host.ISE.ISEOptions.

Méthodes

RestoreDefaultTokenColors()

Restaure les valeurs par défaut des couleurs de jeton.

# Changes the color of the comments in the script to red and then restores it to its default value.
$psISE.Options.TokenColors["Comment"]="red"
$psISE.Options.RestoreDefaultTokenColors()

RestoreDefaults()

Restaure les valeurs par défaut de tous les paramètres d'options. Réinitialise également le comportement des divers messages d'avertissement qui fournissent la case à cocher standard « Ne plus afficher ce message ».

# Changes the background color in the Command Pane and then restores it to its default value.
$psISE.Options.CommandPaneBackground = "orange"
$psISE.Options.RestoreDefaults()

Propriétés

CommandPaneBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan de l'éditeur du volet de commandes. Il s'agit d'une instance de la classe System.Windows.Media.Color.

# Changes the background color of the Command Pane to orange. 
$psISE.Options.CommandPaneBackground = "orange"

CommandPaneUp

Propriété en lecture/écriture qui obtient ou définit une valeur booléenne qui indique si le volet de commandes se trouve au-dessus du volet de sortie.

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

DebugBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan du texte de débogage qui s'affiche dans le volet de sortie. Il s'agit d'une instance de la classe System.Windows.Media.Color.

# Changes the background color for the debug text that appears in the Output Pane to blue. 
$psISE.Options.DebugBackgroundColor ='#0000FF'

DebugForegroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur de premier plan du texte de débogage qui s'affiche dans le volet de sortie. Il s'agit d'une instance de la classe System.Windows.Media.Color.

# Changes the foreground color for the debug text that appears in the Output Pane to yellow. 
$psISE.Options.DebugForegroundColor =”yellow”

DefaultOptions

Propriété en lecture seule qui obtient les valeurs par défaut des paramètres d'options.

# Displays the name of the default options. 
$psISE.Options.DefaultOptions

# Here is a typical listing of the default options:
SelectedScriptPaneState       : Right
ShowToolBar                   : True
TokenColors                   : {[Attribute, #FFADD8E6], [Command, #FF0000FF], [Com
                                mandArgument, #FF8A2BE2], [CommandParameter, #FF000
                                080]...}
DefaultOptions                : Microsoft.PowerShell.Host.ISE.ISEOptions
FontSize                      : 12
FontName                      : Lucida Console
ErrorForegroundColor          : #FF0000FF
ErrorBackgroundColor          : #00FFFFFF
WarningForegroundColor        : #FFFF8C00
WarningBackgroundColor        : #00FFFFFF
VerboseForegroundColor        : #FF0000FF
VerboseBackgroundColor        : #00FFFFFF
DebugForegroundColor          : #FF0000FF
DebugBackgroundColor          : #00FFFFFF
OutputPaneBackgroundColor     : #FFF0F8FF
OutputPaneTextBackgroundColor : #FFF0F8FF
OutputPaneForegroundColor     : #FF000000
CommandPaneBackgroundColor    : #FFFFFFFF
ScriptPaneBackgroundColor     : #FFFFFFFF
ShowWarningForDuplicateFiles  : True
ShowWarningBeforeSavingOnRun  : True
UseLocalHelp                  : True
CommandPaneUp                 : False

ErrorBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan du texte d'erreur qui s'affiche dans le volet de sortie. Il s'agit d'une instance de la classe System.Windows.Media.Color.

# Changes the background color for the error text that appears in the Output Pane to black. 
$psISE.Options.ErrorBackgroundColor="black"

ErrorForegroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur de premier plan du texte d'erreur qui s'affiche dans le volet de sortie. Il s'agit d'une instance de la classe System.Windows.Media.Color.

# Changes the foreground color for the error text that appears in the Output Pane to green. 
$psISE.Options.ErrorForegroundColor =”green”

FontName

Propriété en lecture/écriture qui obtient ou définit le nom de police actuellement utilisé dans les volets de script, de commandes et de sortie.

# Changes the font used in all the panes. 
$psISE.Options.FontName = "courier new"

OutputPaneBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan du volet de sortie. Il s'agit d'une instance de la classe System.Windows.Media.Color.

# Changes the background color of the Output Pane to gold. 
$psISE.Options.OutputPaneForegroundColor = "gold"

OutputPaneTextForegroundColor

Propriété en lecture/écriture qui modifie la couleur de premier plan du texte dans le volet de sortie.

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

OutputPaneTextBackgroundColor

Propriété en lecture/écriture qui modifie la couleur d'arrière-plan du texte dans le volet de sortie.

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

ScriptPaneBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan des fichiers. Il s'agit d'une instance de la classe System.Windows.Media.Color.

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

ScriptPaneForegroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur de premier plan des fichiers non-script dans le volet de script. Pour définir la couleur de premier plan des fichiers script, utilisez la propriété TokenColors.

# Sets the foreground to color of non-script files in the script pane to green.
$psISE.Options.ScriptPaneBackgroundColor = ”green”

SelectedScriptPaneState

Propriété en lecture/écriture qui obtient ou définit la position du volet de script à l'écran. Les valeurs possibles sont « Top » (en haut), « Right » (à droite) et « Maximized » (agrandi).

# 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"

ShowToolBar

Propriété booléenne en lecture/écriture qui détermine si la barre d'outils est visible.

# Show the tool bar.
$psISe.Options.ShowToolBar = $true

ShowWarningBeforeSavingOnRun

Propriété en lecture/écriture qui obtient ou définit une valeur booléenne qui détermine si un message d'avertissement s'affiche lorsqu'un script est enregistré automatiquement avant son exécution.

# Sets the option to display a warning message 
# when an attempt is made to save a script before running it.
$psISE.Options.ShowWarningBeforeSavingOnRun=$true

ShowWarningForDuplicateFiles

Propriété en lecture/écriture qui obtient ou définit une valeur booléenne qui provoque l'affichage d'un message d'avertissement lorsque le même fichier est ouvert sous différents onglets PowerShell.

# Set the ShowWarningForDuplicateFiles property to true. 
$psISE.Options.ShowWarningForDuplicateFiles = $true
# The following  message is displayed: “A copy of this file
# is open in another PowerShell Tab. Changes made to this
# file will affect all open copies.”

TokenColors

Propriété qui obtient un objet dictionnaire contenant les paires nom/valeur des types de jeton et des couleurs des volets de commandes et de script.

# Sets the color of commands to green.
$psISE.Options.TokenColors["Command"] = "green"
# Sets the color of keywords to magenta.
$psISE.Options.TokenColors["Keyword"] = "magenta"

UseLocalHelp

Propriété en lecture/écriture qui obtient ou définit une valeur booléenne qui indique si l'aide locale ou l'aide en ligne est affichée.

# Sets the option for the online help to be displayed. 
$psISE.Options.LocalHelp=$false

VerboseBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan du texte en clair qui s'affiche dans le volet de sortie. Il s'agit d'un objet System.Windows.Media.Color.

# Changes the background color for the verbose text that appears in the Output Pane to blue. 
$psISE.Options.VerboseBackgroundColor ='#0000FF'

VerboseForegroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur de premier plan du texte en clair qui s'affiche dans le volet de sortie. Il s'agit d'un objet System.Windows.Media.Color.

# Changes the foreground color for the verbose text that appears in the Output Pane to yellow. 
$psISE.Options.VerboseForegroundColor =”yellow”

WarningBackgroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur d'arrière-plan du texte d'avertissement qui s'affiche dans le volet de sortie. Il s'agit d'un objet System.Windows.Media.Color.

# Changes the background color for the warning text that appears in the Output Pane to blue. 
$psISE.Options.WarningBackgroundColor ='#0000FF'

WarningForegroundColor

Propriété en lecture/écriture qui obtient ou définit la couleur de premier plan du texte d'avertissement qui s'affiche dans le volet de sortie. Il s'agit d'un objet System.Windows.Media.Color.

# Changes the foreground color for the warning text that appears in the Output Pane to yellow. 
$psISE.Options.WarningForegroundColor =”yellow”