Share via


Az ISEOptions objektum

Az I Standard kiadás Options objektum a Windows PowerShell I Standard kiadás különböző beállításait jelöli. Ez a Microsoft.PowerShell.Host.I Standard kiadás egy példánya. Én Standard kiadás Options osztály.

Az I Standard kiadás Options objektum a következő metódusokat és tulajdonságokat biztosítja.

Metódusok

RestoreDefaultConsoleTokenColors()

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Visszaállítja a konzol panel jogkivonatszíneinek alapértelmezett értékeit.

# 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()

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Visszaállítja a Konzol panel összes beállítási beállításának alapértelmezett értékeit. Emellett alaphelyzetbe állítja a különböző figyelmeztető üzenetek viselkedését, amelyek a szokásos jelölőnégyzetet adják meg, hogy megakadályozzák az üzenet újbóli megtekintését.

# Changes the background color in the Console pane and then restores it to its default value.
$psISE.Options.ConsolePaneBackgroundColor = 'orange'
$psISE.Options.RestoreDefaults()

RestoreDefaultTokenColors()

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Visszaállítja a tokenszínek alapértelmezett értékeit a Szkript panelen.

# 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()

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Visszaállítja a Windows PowerShell I Standard kiadás-ben megjelenített XML-elemek tokenszíneinek alapértelmezett értékeit. Lásd még: 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()

Tulajdonságok

AutoSaveMinuteInterval

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

A fájlok Windows PowerShell I Standard kiadás által végzett automatikus mentési műveletei között eltelt percek számát adja meg. Az alapértelmezett érték 2 perc. Az érték egész szám.

# Changes the number of minutes between automatic save operations to every 3 minutes.
$psISE.Options.AutoSaveMinuteInterval = 3

CommandPaneBackgroundColor

Ez a funkció megtalálható a Windows PowerShell I Standard kiadás 2.0-s verziójában, de az I Standard kiadás későbbi verzióiban eltávolították vagy átnevezték. A későbbi verziókért lásd: ConsolePaneBackgroundColor.

A Parancs panel háttérszínét adja meg. Ez a System.Windows.Media.Color osztály egy példánya.

# Changes the background color of the Command pane to orange.
$psISE.Options.CommandPaneBackgroundColor = 'orange'

CommandPaneUp

Ez a funkció megtalálható a Windows PowerShell I Standard kiadás 2.0-s verziójában, de az I Standard kiadás későbbi verzióiban eltávolították vagy átnevezték.

Megadja, hogy a Parancs ablaktábla a Kimenet panel felett található-e.

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

ConsolePaneBackgroundColor

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

A Konzol panel háttérszínét adja meg. Ez a System.Windows.Media.Color osztály egy példánya.

# Changes the background color of the Console pane to red.
$psISE.Options.ConsolePaneBackgroundColor = 'red'

ConsolePaneForegroundColor

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja a szöveg előtérszínét a Konzol panelen.

# Changes the foreground color of the text in the Console pane to yellow.
$psISE.Options.ConsolePaneForegroundColor  = 'yellow'

ConsolePaneTextBackgroundColor

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja a szöveg háttérszínét a Konzol panelen.

# Changes the background color of the Console pane text to pink.
$psISE.Options.ConsolePaneTextBackgroundColor = 'pink'

ConsoleTokenColors

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Az IntelliSense-jogkivonatok színét adja meg a Windows PowerShell I Standard kiadás Konzol panelen. Ez a tulajdonság egy szótárobjektum, amely a Konzol panelen található jogkivonattípusok és színek név-érték párjait tartalmazza. Az IntelliSense-jogkivonatok színeinek a Szkript panelen való módosításához tekintse meg a TokenColorst. A színek alapértelmezett értékre állításához lásd : RestoreDefaultConsoleTokenColors. A jogkivonat színei a következőkhöz állíthatók be: Attribútum, Parancs, 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

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja a Konzol panelen megjelenő hibakeresési szöveg háttérszínét. Ez a System.Windows.Media.Color osztály egy példánya.

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

DebugForegroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja a Konzol panelen megjelenő hibakeresési szöveg előtérszínét. Ez a System.Windows.Media.Color osztály egy példánya.

# Changes the foreground color for the debug text that appears in the Console pane to yellow.
$psISE.Options.DebugForegroundColor = 'yellow'

DefaultOptions

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Olyan tulajdonságok gyűjteménye, amelyek megadják az alapértelmezett értékeket, amelyeket az Alaphelyzetbe állítási metódusok használatakor kell használni.

# 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

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A Konzol panelen megjelenő hibaszöveg háttérszínét adja meg. Ez a System.Windows.Media.Color osztály egy példánya.

# Changes the background color for the error text that appears in the Console pane to black.
$psISE.Options.ErrorBackgroundColor = 'black'

ErrorForegroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja a Konzol panelen megjelenő hibaszöveg előtérszínét. Ez a System.Windows.Media.Color osztály egy példánya.

# Changes the foreground color for the error text that appears in the console pane to green.
$psISE.Options.ErrorForegroundColor = 'green'

FontName

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A Szkript és a Konzol panelen jelenleg használt betűtípus nevét adja meg.

# Changes the font used in both panes.
$psISE.Options.FontName = 'Courier New'

FontSize

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A betűméretet egész számként adja meg. A parancsot a Szkript panelen, a Parancs panelen és a Kimenet panelen használják. Az értékek érvényes tartománya 8–32.

# Changes the font size in all panes.
$psISE.Options.FontSize = 20

IntellisenseTimeoutInSeconds

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy az IntelliSense hány másodpercet használ az aktuálisan beírt szöveg feloldására. Ennyi másodperc elteltével az IntelliSense túllépi az időkorlátot, és lehetővé teszi a gépelés folytatását. Az alapértelmezett érték 3 másodperc. Az érték egész szám.

# Changes the number of seconds for IntelliSense syntax recognition to 5.
$psISE.Options.IntellisenseTimeoutInSeconds = 5

MruCount

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja a Windows PowerShell I Standard kiadás által nyomon követhető és a Fájl megnyitása menü alján megjelenő legutóbb megnyitott fájlok számát. Az alapértelmezett érték 10. Az érték egész szám.

# Changes the number of recently used files that appear at the bottom of the File Open menu to 5.
$psISE.Options.MruCount = 5

OutputPaneBackgroundColor

Ez a funkció megtalálható a Windows PowerShell I Standard kiadás 2.0-s verziójában, de az I Standard kiadás későbbi verzióiban eltávolították vagy átnevezték. A későbbi verziókért lásd: ConsolePaneBackgroundColor.

Az olvasási/írási tulajdonság, amely lekéri vagy beállítja magának a Kimenet panelnek a háttérszínét. Ez a System.Windows.Media.Color osztály egy példánya.

# Changes the background color of the Output pane to gold.
$psISE.Options.OutputPaneForegroundColor = 'gold'

OutputPaneTextForegroundColor

Ez a funkció megtalálható a Windows PowerShell I Standard kiadás 2.0-s verziójában, de az I Standard kiadás későbbi verzióiban eltávolították vagy átnevezték. A későbbi verziókért lásd: ConsolePaneForegroundColor.

Az olvasási/írási tulajdonság, amely megváltoztatja a szöveg előtérszínét a Windows PowerShell I Kimenet paneljén Standard kiadás 2.0.

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

OutputPaneTextBackgroundColor

Ez a funkció megtalálható a Windows PowerShell I Standard kiadás 2.0-s verziójában, de az I Standard kiadás későbbi verzióiban eltávolították vagy átnevezték. A későbbi verziókért lásd: ConsolePaneTextBackgroundColor.

Az olvasási/írási tulajdonság, amely megváltoztatja a szöveg háttérszínét a Kimenet panelen.

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

ScriptPaneBackgroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az olvasási/írási tulajdonság, amely lekéri vagy beállítja a fájlok háttérszínét. Ez a System.Windows.Media.Color osztály egy példánya.

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

ScriptPaneForegroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az olvasási/írási tulajdonság, amely lekéri vagy beállítja a nem szkriptfájlok előtérszínét a Szkript panelen. A szkriptfájlok előtérszínének beállításához használja a TokenColorst.

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

SelectedScriptPaneState

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az olvasási/írási tulajdonság, amely lekéri vagy beállítja a Szkript panel helyét a kijelzőn. A sztring lehet "Teljes", "Top" vagy "Jobbra".

# 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

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy a CTRL+J kódrészletek listája tartalmazza-e a Windows PowerShellben található kezdőkészletet. Ha be van $falseállítva, csak a felhasználó által megadott kódrészletek jelennek meg a CTRL+J listában. Az alapértelmezett érték $true.

# Hide the default snippets from the CTRL+J list.
$psISE.Options.ShowDefaultSnippets = $false

ShowIntellisenseInConsolePane

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy az IntelliSense szintaxisra, paraméterre és értékre vonatkozó javaslatokat kínál-e a Konzol panelen. Az alapértelmezett érték $true.

# Turn off IntelliSense in the console pane.
$psISE.Options.ShowIntellisenseInConsolePane = $false

ShowIntellisenseInScriptPane

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy az IntelliSense szintaxisra, paraméterre és értékre vonatkozó javaslatokat kínál-e a Szkript panelen. Az alapértelmezett érték $true.

# Turn off IntelliSense in the Script pane.
$psISE.Options.ShowIntellisenseInScriptPane = $false

ShowLineNumbers

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy a Szkript panel megjeleníti-e a sorszámokat a bal margón. Az alapértelmezett érték $true.

# Turn off line numbers in the Script pane.
$psISE.Options.ShowLineNumbers = $false

ShowOutlining

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy a Szkript panel a kódszakaszok mellett megjeleníthető és összecsukható szögletes zárójeleket jelenít-e meg a bal margón. Ha megjelennek, a szövegblokk melletti mínusz - ikonokra kattintva összecsukhatja azt, vagy a plusz + ikonra kattintva kibonthat egy szövegblokkot. Az alapértelmezett érték $true.

# Turn off outlining in the Script pane.
$psISE.Options.ShowOutlining = $false

ShowToolBar

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja, hogy az I Standard kiadás eszköztár megjelenjen-e a Windows PowerShell I Standard kiadás ablakának tetején. Az alapértelmezett érték $true.

# Show the toolbar.
$psISE.Options.ShowToolBar = $true

ShowWarningBeforeSavingOnRun

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja, hogy megjelenik-e figyelmeztető üzenet, ha egy szkript automatikusan mentve lesz a futtatás előtt. Az alapértelmezett érték $true.

# Enable the warning message when an attempt
# is made to run a script without saving it first.
$psISE.Options.ShowWarningBeforeSavingOnRun = $true

ShowWarningForDuplicateFiles

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja, hogy megjelenik-e figyelmeztető üzenet, ha ugyanazt a fájlt különböző PowerShell-lapokban nyitja meg. Ha be van állítva $true, ugyanazon fájl több lapon való megnyitásához a következő üzenet jelenik meg: "A fájl egy példánya meg van nyitva egy másik Windows PowerShell-lapon. A fájl módosításai az összes megnyitott példányt érintik." Az alapértelmezett érték a következő $true: .

# Enable the warning message when a file is
# opened in multiple PowerShell tabs.
$psISE.Options.ShowWarningForDuplicateFiles = $true

TokenColors

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Az IntelliSense-jogkivonatok színét adja meg a Windows PowerShell I Standard kiadás Szkript panelen. Ez a tulajdonság egy szótárobjektum, amely a Szkript ablaktábla név-érték párjait és tokentípusait és színeit tartalmazza. Az IntelliSense-jogkivonatok színének módosításához a Konzol panelen lásd : ConsoleTokenColors. A színek alapértelmezett értékre állításához tekintse meg a RestoreDefaultTokenColors című témakört. A jogkivonat színei a következőkhöz állíthatók be: Attribútum, Parancs, 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

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy az Enter billentyű használatával kiválaszthat-e egy IntelliSense-beállítást a Konzol panelen. Az alapértelmezett érték $true.

# Turn off using the ENTER key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $false

UseEnterToSelectInScriptPaneIntellisense

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy az Enter billentyűvel kiválaszthat-e egy IntelliSense által biztosított beállítást a Szkript panelen. Az alapértelmezett érték $true.

# Turn on using the Enter key to select an IntelliSense provided option in the Console pane.
$psISE.Options.UseEnterToSelectInConsolePaneIntellisense = $true

UseLocalHelp

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja, hogy a helyileg telepített súgó vagy az online súgó megjelenjen-e, amikor lenyomja az F1 billentyűt egy kulcsszóban elhelyezett kurzorral. Ha be van $trueállítva, akkor egy előugró ablak megjeleníti a helyileg telepített súgó tartalmát. A súgófájlokat a parancs futtatásával Update-Help telepítheti. Ha be van $falseállítva, a böngésző megnyit egy lapot a Microsoft Learnben.

# 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

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja a Konzol panelen megjelenő részletes szöveg háttérszínét. Ez egy System.Windows.Media.Color objektum.

# Changes the background color for verbose text to blue.
$psISE.Options.VerboseBackgroundColor ='#0000FF'

VerboseForegroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja a Konzol panelen megjelenő részletes szöveg előtérszínét. Ez egy System.Windows.Media.Color objektum.

# Changes the foreground color for verbose text to yellow.
$psISE.Options.VerboseForegroundColor = 'yellow'

WarningBackgroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

Megadja a Konzol panelen megjelenő figyelmeztető szöveg háttérszínét. Ez egy System.Windows.Media.Color objektum.

# Changes the background color for warning text to blue.
$psISE.Options.WarningBackgroundColor = '#0000FF'

WarningForegroundColor

A Windows PowerShell I Standard kiadás 2.0-s és újabb verzióiban támogatott.

A Kimenet panelen megjelenő figyelmeztető szöveg előtérszínét adja meg. Ez egy System.Windows.Media.Color objektum.

# Changes the foreground color for warning text to yellow.
$psISE.Options.WarningForegroundColor = 'yellow'

XmlTokenColors

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Olyan szótárobjektumot ad meg, amely a Windows PowerShell I Standard kiadás-ben megjelenített XML-tartalomhoz tartozó név-érték párokat és színeket tartalmazza. A jogkivonat színei a következőkhöz állíthatók be: Attribútum, Parancs, CommandArgument, CommandParameter, Comment, GroupEnd, GroupStart, Keyword, LineContinuation, LoopLabel, Member, NewLine, Number, Operator, Position, StatementSeparator, String, Type, Unknown, Variable. Lásd még: 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'

Nagyítás

A Windows PowerShell I Standard kiadás 3.0-s és újabb verzióiban támogatott, és nem szerepel a korábbi verziókban.

Megadja a szöveg relatív méretét a Konzol és a Szkript panelen is. Az alapértelmezett érték 100. A kisebb értékek miatt a Windows PowerShell I-ben a szöveg kisebbnek Standard kiadás, míg a nagyobb számok nagyobbnak tűnnek. Az érték egy 20 és 400 közötti egész szám.

# Changes the text in the Windows PowerShell ISE to be double its normal size.
$psISE.Options.Zoom = 200

Kapcsolódó információk