Az PowerShellTab objektum

  • Cikk

A PowerShellTab objektum egy Windows PowerShell-futtatókörnyezetet jelöl.

Metódusok

Invoke( Script )

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

Futtatja a megadott szkriptet a PowerShell lapon.

Feljegyzés

Ez a módszer csak más PowerShell-lapon működik, nem pedig azon a PowerShell-lapon, amelyről futtatja. Nem ad vissza semmilyen objektumot vagy értéket. Ha a kód módosít egy változót, akkor ezek a módosítások azon a lapon maradnak, amelyen a parancsot meghívták.

Szkript – System.Management.Automation.ScriptBlock vagy Sztring A futtatandó szkriptblokk.

# Manually create a second PowerShell tab before running this script.
# Return to the first PowerShell tab and type the following command
$psISE.PowerShellTabs[1].Invoke({dir})

InvokeSynchronous( Script, [useNewScope], ezredmásodpercTimeout )

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

Futtatja a megadott szkriptet a PowerShell lapon.

Feljegyzés

Ez a módszer csak más PowerShell-lapon működik, nem pedig azon a PowerShell-lapon, amelyről futtatja. A szkriptblokk lefut, és a szkriptből visszaadott értékek vissza lesznek adva ahhoz a futtató környezethez, ahonnan a parancsot meghívta. Ha a parancs futtatása hosszabb időt vesz igénybe, mint a millesecondsTimeout érték, akkor a parancs kivétellel meghiúsul: "A művelet túllépte az időkorlátot."

Szkript – System.Management.Automation.ScriptBlock vagy Sztring A futtatandó szkriptblokk.

[useNewScope] - Nem kötelező logikai érték, amely alapértelmezés szerint $true a Ha be van állítva $true, akkor létrejön egy új hatókör, amelyen belül futtatni szeretné a parancsot. Nem módosítja a parancs által megadott PowerShell-lap futtatókörnyezetét.

[ezredmásodpercTimeout] – Nem kötelező egész szám, amely alapértelmezés szerint 500. Ha a parancs nem fejeződik be a megadott időn belül, akkor a parancs " A művelet időtúllépése" üzenettel időtúllépést hoz létre.

# Create a new PowerShell tab and then switch back to the first
$psISE.PowerShellTabs.Add()
$psISE.PowerShellTabs.SetSelectedPowerShellTab($psISE.PowerShellTabs[0])

# Invoke a simple command on the other tab, in its own scope
$psISE.PowerShellTabs[1].InvokeSynchronous('$x=1', $false)
# You can switch to the other tab and type '$x' to see that the value is saved there.

# This example sets a value in the other tab (in a different scope)
# and returns it through the pipeline to this tab to store in $a
$a = $psISE.PowerShellTabs[1].InvokeSynchronous('$z=3;$z')
$a

# This example runs a command that takes longer than the allowed timeout value
# and measures how long it runs so that you can see the impact
Measure-Command {$psISE.PowerShellTabs[1].InvokeSynchronous('sleep 10', $false, 5000)}

Tulajdonságok

AddOnsMenu

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

A PowerShell lap Bővítmények menüjét lekérő írásvédett tulajdonság.

# Clear the Add-ons menu if one exists.
$psISE.CurrentPowerShellTab.AddOnsMenu.SubMenus.Clear()
# Create an AddOns menu with an accessor.
# Note the use of "_"  as opposed to the "&" for mapping to the fast key letter for the menu item.
$menuAdded = $psISE.CurrentPowerShellTab.AddOnsMenu.SubMenus.Add('_Process', {Get-Process}, 'Alt+P')
# Add a nested menu.
$parentAdded = $psISE.CurrentPowerShellTab.AddOnsMenu.SubMenus.Add('Parent', $null, $null)
$parentAdded.SubMenus.Add('_Dir', {dir}, 'Alt+D')
# Show the Add-ons menu on the current PowerShell tab.
$psISE.CurrentPowerShellTab.AddOnsMenu

CanInvoke

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

Az írásvédett logikai tulajdonság, amely értéket ad vissza $true , ha egy szkript meghívható az Invoke (Script) metódussal.

# CanInvoke will be false if the PowerShell
# tab is running a script that takes a while, and you
# check its properties from another PowerShell tab. It is
# always false if checked on the current PowerShell tab.
# Manually create a second PowerShell tab before running this script.
# Return to the first tab and type
$secondTab = $psISE.PowerShellTabs[1]
$secondTab.CanInvoke
$secondTab.Invoke({sleep 20})
$secondTab.CanInvoke

ConsolePane

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 Windows PowerShell I Standard kiadás 2.0-ban ez CommandPane néven volt elnevezve.

A Konzol panel szerkesztőobjektumát lekérő írásvédett tulajdonság.

# Gets the Console Pane editor.
$psISE.CurrentPowerShellTab.ConsolePane

Megjelenített név

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

Az írás-olvasás tulajdonság, amely lekéri vagy beállítja a PowerShell lapon megjelenő szöveget. Alapértelmezés szerint a lapok neve "PowerShell #", ahol a # egy számot jelöl.

$newTab = $psISE.PowerShellTabs.Add()
# Change the DisplayName of the new PowerShell tab.
$newTab.DisplayName = 'Brand New Tab'

ExpandScript

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

Az olvasási-írási logikai tulajdonság, amely meghatározza, hogy a Szkript panel kibontva vagy elrejtve van-e.

# Toggle the expanded script property to see its effect.
$psISE.CurrentPowerShellTab.ExpandedScript = !$psISE.CurrentPowerShellTab.ExpandedScript

Fájlok

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

Az írásvédett tulajdonság, amely lekéri a PowerShell lapon megnyitott szkriptfájlok gyűjteményét.

$newFile = $psISE.CurrentPowerShellTab.Files.Add()
$newFile.Editor.Text = "a`r`nb"
# Gets the line count
$newFile.Editor.LineCount

Hozam

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 Windows PowerShell I Standard kiadás későbbi verzióiban a ConsolePane objektumot is használhatja ugyanezekre a célokra.

Az aktuális szerkesztő Kimenet panelét lekérő írásvédett tulajdonság.

# Clears the text in the Output pane.
$psISE.CurrentPowerShellTab.output.clear()

Adatkérés

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

Az aktuális parancssori szöveget lekérő írásvédett tulajdonság. Megjegyzés: a Prompt függvényt felül lehet bírálni a felhasználó profilja ™alapján. Ha az eredmény nem egyszerű sztring, akkor ez a tulajdonság nem ad vissza semmit.

# Gets the current prompt text.
$psISE.CurrentPowerShellTab.Prompt

ShowCommands

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 olvasási-írási tulajdonság, amely jelzi, hogy a Parancsok panel jelenleg jelenik-e meg.

# Gets the current status of the Commands pane and stores it in the $a variable
$a = $psISE.CurrentPowerShellTab.ShowCommands
# if $a is $false, then turn the Commands pane on by changing the value to $true
if (!$a) {$psISE.CurrentPowerShellTab.ShowCommands = $true}

Állapotszöveg

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

A PowerShellTab állapotszövegét lekérő írásvédett tulajdonság.

# Gets the current status text,
$psISE.CurrentPowerShellTab.StatusText

HorizontalAddOnToolsPaneOpened

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 írásvédett tulajdonság, amely jelzi, hogy a vízszintes Bővítmények eszközpanel jelenleg nyitva van-e.

# Gets the current state of the horizontal Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened

VerticalAddOnToolsPaneOpened

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 írásvédett tulajdonság, amely jelzi, hogy a függőleges Bővítmények eszközpanel jelenleg nyitva van-e.

# Turns on the Commands pane
$psISE.CurrentPowerShellTab.ShowCommands = $true
# Gets the current state of the vertical Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened

Kapcsolódó információk