Het PowerShellTab-object

Het PowerShellTab-object vertegenwoordigt een Windows PowerShell runtime-omgeving.

Methoden

(Script aanroepen)

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

Het opgegeven script wordt uitgevoerd op het PowerShell-tabblad.

Notitie

Deze methode werkt alleen op andere PowerShell-tabbladen, niet op het PowerShell-tabblad van waaruit deze wordt uitgevoerd. Het retourneert geen object of waarde. Als de code een variabele wijzigt, blijven deze wijzigingen bestaan op het tabblad waarop de opdracht is aangeroepen.

Script: System.Management.Automation.ScriptBlock of String Het scriptblok dat moet worden uitgevoerd.

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

Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.

Het opgegeven script wordt uitgevoerd op het PowerShell-tabblad.

Notitie

Deze methode werkt alleen op andere PowerShell-tabbladen, niet op het PowerShell-tabblad van waaruit deze wordt uitgevoerd. Het scriptblok wordt uitgevoerd en elke waarde die door het script wordt geretourneerd, wordt geretourneerd naar de omgeving van waaruit u de opdracht hebt aangeroepen. Als het uitvoeren van de opdracht langer duurt dan de waarde millisecondesecondenTimeout opgeeft, mislukt de opdracht met een uitzondering: "Er is een time-out van de bewerking."

Script: System.Management.Automation.ScriptBlock of String Het scriptblok dat moet worden uitgevoerd.

[ ] useNewScope: optionele Booleaanse naam die standaard is ingesteld op Als is ingesteld op , wordt een nieuw bereik gemaakt waarin $true de opdracht kan worden $true uitgevoerd. De runtime-omgeving van het PowerShell-tabblad dat is opgegeven met de opdracht wordt niet gewijzigd.

[ millisecondsTimeout: optioneel ] geheel getal dat standaard 500 is. Als de opdracht niet binnen de opgegeven tijd is uitgevoerd, genereert de opdracht een TimeoutException met het bericht 'Er is een time-out voor de bewerking'.

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

Eigenschappen

AddOnsMenu

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De eigenschap alleen-lezen die het menu Invoegtoepassingen voor het PowerShell-tabblad op haalt.

# 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

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De booleaanse eigenschap alleen-lezen die een waarde retourneert als een script kan worden aangeroepen met $true de methode 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 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

Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies. In Windows PowerShell ISE 2.0 heet dit CommandPane.

De eigenschap alleen-lezen die het editorobject consoledeelvenster op haalt.

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

DisplayName

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De eigenschap read-write die de tekst op het PowerShell-tabblad op haalt of in stelt. Tabbladen hebben standaard de naam 'PowerShell #', waarbij #een getal vertegenwoordigt.

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

ExpandedScript

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De Booleaanse eigenschap read-write die bepaalt of het deelvenster Script is uit uitgebreid of verborgen.

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

Bestanden

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De eigenschap alleen-lezen die de verzameling scriptbestanden ophaalt die zijn geopend op het PowerShell-tabblad.

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

Uitvoer

Deze functie is aanwezig in Windows PowerShell ISE 2.0, maar is verwijderd of hernoemd in latere versies van de ISE. In latere versies van Windows PowerShell ISE kunt u het object ConsolePane voor dezelfde doeleinden gebruiken.

De eigenschap alleen-lezen die het deelvenster Uitvoer van de huidige editor op haalt.

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

Prompt

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De eigenschap alleen-lezen die de huidige prompttekst op haalt. Opmerking: de functie Prompt kan worden overschrijven door het profiel â„¢ van de gebruiker. Als het resultaat een andere is dan een eenvoudige tekenreeks, retourneert deze eigenschap niets.

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

ShowCommands

Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.

De eigenschap read-write die aangeeft of het deelvenster Opdrachten momenteel wordt weergegeven.

# 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

Ondersteund in Windows PowerShell ISE 2.0 en hoger.

De eigenschap alleen-lezen die de PowerShellTab-statustekst op haalt.

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

HorizontalAddOnToolsPaneOpened

Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.

De eigenschap alleen-lezen die aangeeft of het deelvenster Add-Ons horizontaal hulpprogramma momenteel is geopend.

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

VerticalAddOnToolsPaneOpened

Ondersteund in Windows PowerShell ISE 3.0 en hoger en niet aanwezig in eerdere versies.

De eigenschap alleen-lezen waarmee wordt aangegeven of het deelvenster Add-Ons verticale Add-Ons geopend is.

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

Zie ook