PowerShellTab-objektetThe PowerShellTab Object

Objektet PowerShellTab representerar en miljö för Windows PowerShell-körningsmiljön.The PowerShellTab object represents a Windows PowerShell runtime environment.

MetoderMethods

Anropa ( skript )Invoke( Script )

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Kör det aktuella skriptet på PowerShell-fliken.Runs the given script in the PowerShell tab.

Anteckning

Den här metoden fungerar bara på andra PowerShell-flikar, inte på PowerShell-fliken som den körs från.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. Det returnerar inga objekt eller värde.It does not return any object or value. Om koden ändrar vilken variabel som helst, sparas ändringarna på fliken som kommandot anropades mot.If the code modifies any variable, then those changes persist on the tab against which the command was invoked.

Skript -system. Management. Automation. script block eller en sträng som skript blocket ska köras.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- ( skript, [ useNewScope ] , millisecondsTimeout )InvokeSynchronous( Script, [useNewScope], millisecondsTimeout )

Stöds i Windows PowerShell ISE 3,0 och senare, och finns inte i tidigare versioner.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Kör det aktuella skriptet på PowerShell-fliken.Runs the given script in the PowerShell tab.

Anteckning

Den här metoden fungerar bara på andra PowerShell-flikar, inte på PowerShell-fliken som den körs från.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. Skript blocket körs och alla värden som returneras från skriptet returneras till den körnings miljö från vilken du anropade kommandot.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. Om kommandot tar längre tid att köra än millesecondsTimeout -värdet anger, Miss lyckas kommandot med ett undantag: "åtgärden har nått sin tids gräns."If the command takes longer to run than the millesecondsTimeout value specifies, then the command fails with an exception: "The operation has timed out."

Skript -system. Management. Automation. script block eller en sträng som skript blocket ska köras.Script - System.Management.Automation.ScriptBlock or String The script block to run.

[ useNewScope ] – valfritt booleskt värde som är standardvärdet $true om det är inställt på $true , skapas en ny omfattning i vilken kommandot ska köras.[useNewScope] - Optional Boolean that defaults to $true If set to $true, then a new scope is created within which to run the command. Den ändrar inte körnings miljön för PowerShell-fliken som anges av kommandot.It does not modify the runtime environment of the PowerShell tab that is specified by the command.

[ millisecondsTimeout ] -valfritt heltal som är som standard 500 .[millisecondsTimeout] - Optional integer that defaults to 500 . Om kommandot inte slutförs inom den angivna tiden genererar kommandot en TimeoutException med meddelandet "åtgärden har nått sin tids gräns."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)}

EgenskaperProperties

AddOnsMenuAddOnsMenu

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Den skrivskyddade egenskapen som hämtar tilläggs menyn för PowerShell-fliken.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

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Den skrivskyddade booleska egenskapen som returnerar ett $true värde om ett skript kan anropas med metoden Invoke (skript) .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

Stöds i Windows PowerShell ISE 3,0 och senare, och finns inte i tidigare versioner.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions. I Windows PowerShell ISE 2,0 heter CommandPane .In Windows PowerShell ISE 2.0 this was named CommandPane .

Den skrivskyddade egenskapen som hämtar konsol fönstrets redigerings objekt.The read-only property that gets the Console pane editor object.

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

DisplayNameDisplayName

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Egenskapen Read-Write som hämtar eller anger den text som visas på PowerShell-fliken. Som standard heter flikarna "PowerShell #" där # representerar ett tal.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

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Den Read-Write-booleska egenskap som avgör om skript fönstret är expanderat eller dolt.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

FilesFiles

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Den skrivskyddade egenskapen som hämtar de skriptfiler som är öppna på PowerShell-fliken.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

UtdataOutput

Den här funktionen finns i Windows PowerShell ISE 2,0, men har tagits bort eller bytt namn i senare versioner av ISE.This feature is present in Windows PowerShell ISE 2.0, but was removed or renamed in later versions of the ISE. I senare versioner av Windows PowerShell ISE kan du använda ConsolePane -objektet för samma syfte.In later versions of Windows PowerShell ISE, you can use the ConsolePane object for the same purposes.

Den skrivskyddade egenskapen som hämtar fönstret utdata i den aktuella redigeraren.The read-only property that gets the Output pane of the current editor.

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

PromptPrompt

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Den skrivskyddade egenskapen som hämtar den aktuella meddelande texten.The read-only property that gets the current prompt text. Obs: prompt -funktionen kan åsidosättas av användarens ™ profil.Note: the Prompt function can be overridden by the user'™s profile. Om resultatet skiljer sig från en enkel sträng returnerar den här egenskapen ingenting.If the result is other than a simple string, then this property returns nothing.

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

ShowCommandsShowCommands

Stöds i Windows PowerShell ISE 3,0 och senare, och finns inte i tidigare versioner.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Egenskapen Read-Write som anger om kommando fönstret visas för tillfället.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}

Status textStatusText

Stöds i Windows PowerShell ISE 2,0 och senare.Supported in Windows PowerShell ISE 2.0 and later.

Den skrivskyddade egenskapen som hämtar PowerShellTab status text.The read-only property that gets the PowerShellTab status text.

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

HorizontalAddOnToolsPaneOpenedHorizontalAddOnToolsPaneOpened

Stöds i Windows PowerShell ISE 3,0 och senare, och finns inte i tidigare versioner.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Den skrivskyddade egenskapen som anger om det vågräta Add-Ons verktygs fönstret är öppet.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

Stöds i Windows PowerShell ISE 3,0 och senare, och finns inte i tidigare versioner.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Den skrivskyddade egenskapen som anger om den lodräta Add-Ons verktygs fönstret är öppet.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

Se ävenSee Also