Sdílet prostřednictvím

Objekt PowerShellTab

  • Článek

Objekt PowerShellTab představuje prostředí modulu runtime Prostředí Windows PowerShell.

Metody

Invoke( Script )

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Spustí daný skript na kartě PowerShellu.

Poznámka:

Tato metoda funguje jenom na jiných kartách PowerShellu, nikoli na kartě PowerShellu, ze které se spouští. Nevrací žádný objekt ani hodnotu. Pokud kód změní libovolnou proměnnou, tyto změny se zachovají na kartě, proti které byl příkaz vyvolán.

Skript – System.Management.Automation.ScriptBlock nebo String Blok skriptu, který se má spustit.

# 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], millisecondsTimeout )

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Spustí daný skript na kartě PowerShellu.

Poznámka:

Tato metoda funguje jenom na jiných kartách PowerShellu, nikoli na kartě PowerShellu, ze které se spouští. Blok skriptu se spustí a jakákoli hodnota vrácená ze skriptu se vrátí do prostředí spuštění, ze kterého jste příkaz vyvolali. Pokud spuštění příkazu trvá déle, než určuje hodnota milesecondsTimeout , příkaz selže s výjimkou: Operace vypršela.

Skript – System.Management.Automation.ScriptBlock nebo String Blok skriptu, který se má spustit.

[useNewScope] - Volitelná logická hodnota, která je nastavena na $true$trueHodnotu If , pak se vytvoří nový obor, ve kterém se má příkaz spustit. Neupravuje prostředí modulu runtime na kartě PowerShellu určené příkazem.

[milisekundTimeout] – Volitelné celé číslo, které je ve výchozím nastavení 500. Pokud se příkaz nedokončí v zadaném čase, vygeneruje příkaz timeoutException se zprávou "Operace vypršel časový limit".

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

Vlastnosti

AddOnsMenu

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá nabídku Doplňky pro kartu PowerShellu.

# 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

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Logická vlastnost jen pro čtení, která vrací $true hodnotu, pokud lze vyvolat skript pomocí Invoke( Script ) metoda.

# 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

Podokno konzoly

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích. V prostředí Windows PowerShell ISE 2.0 se jmenuje CommandPane.

Vlastnost jen pro čtení, která získá objekt editoru podokna konzoly.

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

DisplayName

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost pro čtení i zápis, která získá nebo nastaví text zobrazený na kartě PowerShellu. Ve výchozím nastavení se karty nazývají PowerShell #, kde # představuje číslo.

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

ExpandedScript

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Logická vlastnost pro čtení i zápis, která určuje, zda je podokno Skript rozbalené nebo skryté.

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

Soubory

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá kolekci souborů skriptu, které jsou otevřené na kartě PowerShellu.

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

Výstup

Tato funkce je k dispozici v prostředí Windows PowerShell ISE 2.0, ale byla odebrána nebo přejmenována v novějších verzích isE. V novějších verzích prostředí Windows PowerShell ISE můžete použít objekt ConsolePane pro stejné účely.

Vlastnost jen pro čtení, která získá podokno Výstup aktuálního editoru.

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

Výzva

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá aktuální text výzvy. Poznámka: Funkci Prompt lze přepsat profilem uživatele ™. Pokud je výsledek jiný než jednoduchý řetězec, vrátí tato vlastnost nic.

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

ShowCommands

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Vlastnost pro čtení i zápis, která označuje, zda je podokno Příkazy aktuálně zobrazeno.

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

Statustext

Podporováno v prostředí Windows PowerShell ISE 2.0 a novějším.

Vlastnost jen pro čtení, která získá stavový text PowerShellTab .

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

HorizontalAddOnToolsPaneOpened

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Vlastnost jen pro čtení, která označuje, zda je vodorovné podokno nástrojů Doplňky aktuálně otevřené.

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

VerticalAddOnToolsPaneOpened

Podporováno v prostředí Windows PowerShell ISE 3.0 a novějších verzích a není k dispozici v dřívějších verzích.

Vlastnost jen pro čtení, která označuje, zda je svislé podokno nástrojů Doplňky aktuálně otevřené.

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

Viz také