Az PowerShellTab objektum
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
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: