Sdílet prostřednictvím

Objekt PowerShellTab

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

Methods

Invoke( Script )

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Spustí daný skript v záložce PowerShell.

Poznámka:

Tato metoda funguje pouze na jiných záložkách PowerShell, ne na záložce PowerShell, ze které se spouští. Nevrací žádný objekt ani hodnotu. Pokud kód změní jakoukoli proměnnou, tyto změny zůstanou na záložce, proti které byl příkaz vyvolán.

  • Skript - System.Management.Automation.ScriptBlock nebo String - Skriptový blok pro spustení.
# 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 ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Spustí daný skript v záložce PowerShell.

Poznámka:

Tato metoda funguje pouze na jiných záložkách PowerShell, ne na záložce PowerShell, ze které se spouští. Skriptový blok se spustí a jakákoli hodnota vrácená ze skriptu se vrátí do prostředí běhu, ze kterého jste příkaz vyvolali. Pokud příkaz trvá déle, než je stanoveno v milisekundách , příkaz selže s výjimkou: "Operace vypršela."

  • Skript - System.Management.Automation.ScriptBlock nebo String - Skriptový blok pro spustení.
  • [useNewScope] - Volitelný Boolean s výchozím nastavením - $true Pokud je nastaveno na $true, vytvoří se nový rozsah, ve kterém se příkaz spustí. Nemění runtime prostředí záložky PowerShell, kterou specifikuje příkaz.
  • [milisekundový časový limit] - Volitelné celé číslo, které je výchozí na 500. - Pokud příkaz není dokončen ve stanoveném čase, vygeneruje TimeoutException se zprávou "Operace vypršela."
# 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 ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získá menu Add-ons pro záložku PowerShell.

# 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 ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost Booleovské funkce pouze pro čtení, která vrací hodnotu$true, pokud lze skript spustit metodou Invoke( Script ).

# 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's
# 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

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo. Ve Windows PowerShell ISE 2.0 se to nazývalo CommandPane.

Vlastnost pouze pro čtení, která získává objekt editoru panelů Console.

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

ZobrazovanéJméno

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost read-write, která získává nebo nastavuje text zobrazený na záložce PowerShell. Ve výchozím nastavení jsou záložky pojmenovány "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 ve Windows PowerShell ISE 2.0 a novějších.

Booleovská vlastnost read-write, která určuje, zda je okno Script rozšířené nebo skryté.

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

Files

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která získává sbírku skriptových souborů otevřených v záložce PowerShell.

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

Výstup

Tato funkce je přítomna ve Windows PowerShell ISE 2.0, ale v pozdějších verzích ISE byla odstraněna nebo přejmenována. V pozdějších verzích Windows PowerShell ISE můžete použít objekt ConsolePane pro stejné účely.

Vlastnost pouze pro čtení, která získává výstupní panel aktuálního editoru.

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

Podnět

Podporováno ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která přijímá aktuální text výzvy. Poznámka: tuto prompt funkci lze přepsat uživatelským profilem. Pokud je výsledek jiný než jednoduchý řetězec, tato vlastnost nic nevrátí.

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

ShowCommands

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Vlastnost read-write, která určuje, zda je panel příkazů aktuálně zobrazen.

# 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 ve Windows PowerShell ISE 2.0 a novějších.

Vlastnost pouze pro čtení, která přijímá stav PowerShellTab .

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

HorizontálníPřidáníNástrojůPaneOtevřeno

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Vlastnost pouze pro čtení, která určuje, zda je horizontální Add-Ons nástrojová tabule aktuálně otevřená.

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

VertikálníDoplňkovéNástrojePaneOtevřeno

Podporováno ve Windows PowerShell ISE 3.0 a novějších, a v dřívějších verzích nebylo.

Vlastnost pouze pro čtení, která určuje, zda je vertikální Add-Ons nástrojové tabule 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é

  • Last updated on