Az PowerShellTab objektum

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

Metódusok

Invoke( Script )

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

Futtatja a megadott szkriptet a PowerShell lapon.

Megjegyzés

Ez a metódus csak más PowerShell-lapokon működik, nem azon a PowerShell-lapon, amelyen fut. Nem ad vissza 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 ISE 3.0-s és újabb verzióiban támogatott, a korábbi verziókban nem.

Futtatja a megadott szkriptet a PowerShell lapon.

Megjegyzés

Ez a metódus csak más PowerShell-lapokon működik, nem azon a PowerShell-lapon, amelyen fut. A szkriptblokk lefut, és a szkript által visszaadott érték visszakerül ahhoz a futtató környezethez, ahonnan a parancsot meghívta. Ha a parancs futtatása tovább tart, 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 Ha értékre $truevan állítva, majd 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.

[millisecondsTimeout] – 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 túllépte az időkorlátot" ü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

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

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

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

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 ISE 3.0-s és újabb verzióiban támogatott, a korábbi verziókban nem. Az WINDOWS POWERSHELL ISE 2.0-ban ez a CommandPane nevet kapta.

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

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

DisplayName

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

A PowerShell lapon megjelenő szöveget lekérő vagy beállító írási-írási tulajdonság. 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'

ExpandedScript

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

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

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

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

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

Kimenet

Ez a funkció megtalálható Windows PowerShell ISE 2.0-s verziójában, de az ISE későbbi verzióiban eltávolították vagy átnevezték. A Windows PowerShell ISE 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

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

Az aktuális üzenetszö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

Parancsok megjelenítése

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

Az olvasási-írási tulajdonság, amely azt 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

Az ISE 2.0-s és újabb verziói Windows PowerShell támogatottak.

A PowerShellTab állapotszövegét leolvasó írásvédett tulajdonság.

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

HorizontalAddOnToolsPaneOpened

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

A csak olvasható tulajdonság, amely azt jelzi, hogy a vízszintes Add-Ons eszközpanel jelenleg nyitva van-e.

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

VerticalAddOnToolsPaneOpened

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

Az írásvédett tulajdonság, amely azt jelzi, hogy a függőleges Add-Ons 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

Lásd még: