Het PowerShellTab-objectThe PowerShellTab Object

De PowerShellTab object vertegenwoordigt een Windows PowerShell-runtime-omgeving.The PowerShellTab object represents a Windows PowerShell runtime environment.

MethodenMethods

Aanroepen( Script )Invoke( Script )

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Het opgegeven script wordt uitgevoerd op het tabblad PowerShell.Runs the given script in the PowerShell tab.

Notitie

Deze methode werkt alleen op andere tabbladen PowerShell niet het PowerShell-tabblad waaruit deze wordt uitgevoerd.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. Deze retourneert een object of de waarde.It does not return any object or value. Als de code in eventuele variabele wijzigt, klikt u vervolgens de wijzigingen behouden blijven op het tabblad op basis waarvan de opdracht werd aangeroepen.If the code modifies any variable, then those changes persist on the tab against which the command was invoked.

Script -System.Management.Automation.ScriptBlock of tekenreeks het scriptblok worden uitgevoerd.Script - System.Management.Automation.ScriptBlock or String The script block to run.

# 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 )InvokeSynchronous( Script, [useNewScope], millisecondsTimeout )

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Het opgegeven script wordt uitgevoerd op het tabblad PowerShell.Runs the given script in the PowerShell tab.

Notitie

Deze methode werkt alleen op andere tabbladen PowerShell niet het PowerShell-tabblad waaruit deze wordt uitgevoerd.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. Het scriptblok wordt uitgevoerd en een waarde die wordt geretourneerd uit het script wordt geretourneerd naar de uitvoeren-omgeving van waaruit u de opdracht aangeroepen.The script block is run and any value that is returned from the script is returned to the run environment from which you invoked the command. Als de opdracht langer duurt dan de millesecondsTimeout waarde geeft aan en vervolgens de opdracht is mislukt met een uitzondering: "de bewerking is een time-out."If the command takes longer to run than the millesecondsTimeout value specifies, then the command fails with an exception: "The operation has timed out."

Script -System.Management.Automation.ScriptBlock of tekenreeks het scriptblok worden uitgevoerd.Script - System.Management.Automation.ScriptBlock or String The script block to run.

[useNewScope] -optionele Booleaanse die standaard $true als ingesteld op $true, wordt een nieuwe scope gemaakt waarin de opdracht uit te voeren.[useNewScope] - Optional Boolean that defaults to $true If set to $true, then a new scope is created within which to run the command. De runtime-omgeving van het PowerShell-tabblad die is opgegeven door de opdracht wijzigt niet.It does not modify the runtime environment of the PowerShell tab that is specified by the command.

[millisecondsTimeout] -optioneel geheel getal dat wordt standaard ingesteld op 500.[millisecondsTimeout] - Optional integer that defaults to 500. Als de opdracht niet is voltooid binnen de opgegeven tijd, wordt de opdracht genereert een TimeoutException met het bericht 'de bewerking is een time-out."If the command does not finish within the specified time, then the command generates a TimeoutException with the message "The operation has timed out."

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

EigenschappenProperties

AddOnsMenuAddOnsMenu

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die in het menu invoegtoepassingen voor het PowerShell-tabblad opgehaald.The read-only property that gets the Add-ons menu for the PowerShell tab.

# 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

CanInvokeCanInvoke

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen Boole-eigenschap die als resultaat geeft een $true waarde als een script kan worden aangeroepen met de Invoke (Script) methode.The read-only Boolean property that returns a $true value if a script can be invoked with the Invoke( Script ) method.

# 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

ConsolepaneConsolepane

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions. In Windows PowerShell ISE 2.0 Dit heette CommandPane.In Windows PowerShell ISE 2.0 this was named CommandPane.

De alleen-lezen eigenschap die opgehaald van het consolevenster editor object.The read-only property that gets the Console pane editor object.

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

DisplayNameDisplayName

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die de tekst die wordt weergegeven op het tabblad PowerShell opgehaald of ingesteld. Standaard tabbladen zijn met de naam ' PowerShell #", waarbij het # een getal vertegenwoordigt.The read-write property that gets or sets the text that is displayed on the PowerShell tab. By default, tabs are named "PowerShell #", where the # represents a number.

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

ExpandedScriptExpandedScript

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

Lezen / schrijven Boole-eigenschap die bepaalt of het scriptvenster is uitgevouwen of verborgen.The read-write Boolean property that determines whether the Script pane is expanded or hidden.

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

BestandenFiles

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die krijgt de verzameling van scriptbestanden die zijn geopend in het tabblad PowerShell.The read-only property that gets the collection of script files that are open in the PowerShell tab.

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

UitvoerOutput

Deze functie is is aanwezig in Windows PowerShell ISE 2.0, maar verwijderd of hernoemd in latere versies van de ISE.This feature is present in Windows PowerShell ISE 2.0, but was removed or renamed in later versions of the ISE. In latere versies van Windows PowerShell ISE kunt u de ConsolePane -object voor dezelfde doelen.In later versions of Windows PowerShell ISE, you can use the ConsolePane object for the same purposes.

De alleen-lezen eigenschap die opgehaald van het deelvenster Uitvoer van de huidige editor.The read-only property that gets the Output pane of the current editor.

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

VragenPrompt

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die de huidige prompttekst opgehaald.The read-only property that gets the current prompt text. Opmerking: de vragen functie kan worden genegeerd door de gebruiker '™ profiel s.Note: the Prompt function can be overridden by the user'™s profile. Als het resultaat dan een eenvoudige tekenreeks is, geeft deze eigenschap niets als resultaat.If the result is other than a simple string, then this property returns nothing.

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

ShowCommandsShowCommands

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

De alleen-lezen eigenschap die aangeeft of het opdrachtenvenster weergegeven die momenteel wordt weergegeven.The read-write property that indicates if the Commands pane is currently displayed.

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

StatusTextStatusText

In Windows PowerShell ISE 2.0 en hoger ondersteund.Supported in Windows PowerShell ISE 2.0 and later.

De alleen-lezen eigenschap die krijgt de PowerShellTab statustekst.The read-only property that gets the PowerShellTab status text.

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

HorizontalAddOnToolsPaneOpenedHorizontalAddOnToolsPaneOpened

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

De alleen-lezen eigenschap die aangeeft of het horizontale werkvenster van invoegtoepassingen momenteel geopend is.The read-only property that indicates whether the horizontal Add-Ons tool pane is currently open.

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

VerticalAddOnToolsPaneOpenedVerticalAddOnToolsPaneOpened

Ondersteunde Windows PowerShell ISE 3.0 en hoger, en niet aanwezig in eerdere versies.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

De alleen-lezen eigenschap die aangeeft of de verticale werkvenster van invoegtoepassingen momenteel geopend is.The read-only property that indicates whether the vertical Add-Ons tool pane is currently open.

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

Zie ookSee Also