Obiekt PowerShellTabThe PowerShellTab Object

PowerShellTab obiekt reprezentuje środowiska uruchomieniowego programu Windows PowerShell.The PowerShellTab object represents a Windows PowerShell runtime environment.

MetodyMethods

Wywołanie( skryptu )Invoke( Script )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Uruchamia skrypt danej karcie środowiska PowerShell.Runs the given script in the PowerShell tab.

Uwaga

Ta metoda działa tylko na inne karty z programu PowerShell, nie na karcie środowiska PowerShell, z którego zostało uruchomione.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. Nie zwraca żadnych obiektu lub wartości.It does not return any object or value. Jeśli kod modyfikuje dowolnej zmiennej, a następnie zachować te zmiany na karcie, względem którego wywołano polecenia.If the code modifies any variable, then those changes persist on the tab against which the command was invoked.

Skrypt -System.Management.Automation.ScriptBlock lub ciągu bloku skryptu do uruchomienia.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( skryptu, [useNewScope], millisecondsTimeout )InvokeSynchronous( Script, [useNewScope], millisecondsTimeout )

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Uruchamia skrypt danej karcie środowiska PowerShell.Runs the given script in the PowerShell tab.

Uwaga

Ta metoda działa tylko na inne karty z programu PowerShell, nie na karcie środowiska PowerShell, z którego zostało uruchomione.This method only works on other PowerShell tabs, not the PowerShell tab from which it is run. Blok skryptu zostanie uruchomione, a każdą wartość, która jest zwracana w skrypcie jest zwracana do uruchamiania środowiska, z którego wywołany polecenia.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. Jeśli polecenie trwa dłużej, niż millesecondsTimeout określa wartość, a następnie polecenie kończy się niepowodzeniem z powodu wyjątku: "operacji został przekroczony."If the command takes longer to run than the millesecondsTimeout value specifies, then the command fails with an exception: "The operation has timed out."

Skrypt -System.Management.Automation.ScriptBlock lub ciągu bloku skryptu do uruchomienia.Script - System.Management.Automation.ScriptBlock or String The script block to run.

[useNewScope] -opcjonalna wartość logiczna który domyślnie $true Jeśli ustawioną $true, następnie nowego zakresu jest tworzony w ramach którego uruchomienia polecenia.[useNewScope] - Optional Boolean that defaults to $true If set to $true, then a new scope is created within which to run the command. Nie modyfikuje środowisko uruchomieniowe karta programu PowerShell, określonym przez polecenie.It does not modify the runtime environment of the PowerShell tab that is specified by the command.

[millisecondsTimeout] — opcjonalnie liczba całkowita, która domyślnie 500.[millisecondsTimeout] - Optional integer that defaults to 500. Jeśli polecenie nie zakończy się w określonym czasie, a następnie generuje polecenie TimeoutException z komunikatem "operacji został przekroczony."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)}

WłaściwościProperties

AddOnsMenuAddOnsMenu

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera menu dodatków na karcie środowiska PowerShell.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

Właściwość CanInvokeCanInvoke

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwości typu Boolean tylko do odczytu, która zwraca $true wartość, gdy skrypt może być wywoływana ze Invoke (skrypt) metody.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

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions. W programie Windows PowerShell ISE 2.0 to miał nazwę CommandPane.In Windows PowerShell ISE 2.0 this was named CommandPane.

Właściwość tylko do odczytu, która w okienku konsoli edytor obiektu.The read-only property that gets the Console pane editor object.

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

DisplayNameDisplayName

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Pobiera lub ustawia tekst, który jest wyświetlany na karcie środowiska PowerShell właściwość do odczytu i zapisu. Domyślnie program o nazwie karty "PowerShell #", gdzie # reprezentuje liczbę.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

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Odczyt i zapis właściwości typu Boolean, która określa, czy w okienku skryptu jest rozwinięty, czy ukryty.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

PlikiFiles

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera kolekcji plików skryptów otwartych na karcie środowiska 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

Dane wyjścioweOutput

Ta funkcja znajduje się w programie Windows PowerShell ISE 2.0, ale została usunięta lub zmieniona w nowszej wersji programu ISE.This feature is present in Windows PowerShell ISE 2.0, but was removed or renamed in later versions of the ISE. W nowszych wersjach programu Windows PowerShell ISE, można użyć ConsolePane obiektu dla tych samych celów.In later versions of Windows PowerShell ISE, you can use the ConsolePane object for the same purposes.

Właściwość tylko do odczytu, która w okienku danych wyjściowych bieżącego edytor.The read-only property that gets the Output pane of the current editor.

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

MonitPrompt

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera bieżący tekst monitu.The read-only property that gets the current prompt text. Uwaga: monitu funkcja może zostać przesłonięta przez użytkownika "™ s profilu.Note: the Prompt function can be overridden by the user'™s profile. Jeśli wynik wynosi innego niż prosty ciąg, następnie ta właściwość nic nie zwraca.If the result is other than a simple string, then this property returns nothing.

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

ShowCommandsShowCommands

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Właściwość odczytu i zapisu, która wskazuje, czy okienko poleceń jest aktualnie wyświetlany.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

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszy.Supported in Windows PowerShell ISE 2.0 and later.

Właściwość tylko do odczytu, która pobiera PowerShellTab tekstu stanu.The read-only property that gets the PowerShellTab status text.

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

HorizontalAddOnToolsPaneOpenedHorizontalAddOnToolsPaneOpened

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Właściwości tylko do odczytu, która wskazuje, czy poziomy okienko narzędzi dodatków jest obecnie otwarty.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

Obsługiwane w programie Windows PowerShell ISE 3.0 i nowszych i nie znajduje się w starszych wersjach.Supported in Windows PowerShell ISE 3.0 and later, and not present in earlier versions.

Właściwości tylko do odczytu, która wskazuje, czy pionowy okienko narzędzi dodatków jest obecnie otwarty.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

Zobacz teżSee Also