Obiekt PowerShellTab

Obiekt PowerShellTab reprezentuje środowisko uruchomieniowe Windows PowerShell.

Metody

Invoke( Skrypt )

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Uruchamia dany skrypt na karcie Programu PowerShell.

Uwaga

Ta metoda działa tylko na innych kartach programu PowerShell, a nie na karcie programu PowerShell, z której jest uruchamiana. Nie zwraca żadnych obiektów ani wartości. Jeśli kod modyfikuje dowolną zmienną, zmiany te są utrwalane na karcie, na której zostało wywołane polecenie.

Script — System.Management.Automation.ScriptBlock lub String Blok skryptu do uruchomienia.

# 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], milisekundsTimeout )

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym oraz nie są obecne we wcześniejszych wersjach.

Uruchamia dany skrypt na karcie Programu PowerShell.

Uwaga

Ta metoda działa tylko na innych kartach programu PowerShell, a nie na karcie programu PowerShell, z której jest uruchamiana. Blok skryptu jest uruchamiany i każda wartość zwrócona ze skryptu jest zwracana do środowiska uruchomieniowego, z którego zostało wywołane polecenie. Jeśli uruchomienie polecenia trwa dłużej niż określono wartość millesecondsTimeout , polecenie kończy się niepowodzeniem z wyjątkiem: "Upłynął limit czasu operacji".

Script — System.Management.Automation.ScriptBlock lub String Blok skryptu do uruchomienia.

[useNewScope] — opcjonalna wartość logiczna domyślnie ustawiona $truena $true wartość , a następnie tworzony jest nowy zakres, w którym ma zostać uruchomione polecenie . Nie modyfikuje środowiska uruchomieniowego karty programu PowerShell określonej przez polecenie .

[milisekundsTimeout] — opcjonalna liczba całkowita, która domyślnie wynosi 500. Jeśli polecenie nie zostanie zakończone w określonym czasie, polecenie wygeneruje wyjątek TimeoutException z komunikatem "Upłynął limit czasu operacji".

# 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ści

AddOnsMenu

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera menu Dodatki dla karty programu 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

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość logiczna tylko do odczytu, która zwraca $true wartość, jeśli można wywołać skrypt za pomocą metody 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

Okienko konsoli

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym oraz nie są obecne we wcześniejszych wersjach. W Windows PowerShell ISE 2.0 nosiło nazwę CommandPane.

Właściwość tylko do odczytu, która pobiera obiekt edytora okienka konsoli.

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

Nazwa wyświetlana

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość read-write, która pobiera lub ustawia tekst wyświetlany na karcie programu PowerShell. Domyślnie karty mają nazwę "PowerShell #", gdzie # reprezentuje liczbę.

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

ExpandedScript

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość logiczna odczytu i zapisu określająca, czy okienko Skrypt jest rozwinięte, czy ukryte.

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

Pliki

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera kolekcję plików skryptów otwartych na karcie programu PowerShell.

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

Dane wyjściowe

Ta funkcja jest obecna w Windows PowerShell ISE 2.0, ale została usunięta lub zmieniona w nowszych wersjach środowiska ISE. W nowszych wersjach Windows PowerShell ISE można użyć obiektu ConsolePane w tym samym celu.

Właściwość tylko do odczytu, która pobiera okienko Dane wyjściowe bieżącego edytora.

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

Monit

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera bieżący tekst monitu. Uwaga: funkcja Prompt może zostać zastąpiona przez profil użytkownika ™. Jeśli wynik jest inny niż prosty ciąg, ta właściwość nie zwraca niczego.

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

Pokażpolecenia

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym oraz nie są obecne we wcześniejszych wersjach.

Właściwość read-write wskazująca, czy okienko Polecenia jest obecnie wyświetlane.

# 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

Obsługiwane w programie Windows PowerShell ISE 2.0 lub nowszym.

Właściwość tylko do odczytu, która pobiera tekst stanu tab programu PowerShell .

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

HorizontalAddOnToolsPaneOpened

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym oraz nie są obecne we wcześniejszych wersjach.

Właściwość tylko do odczytu wskazująca, czy okienko narzędzi Add-Ons poziome jest obecnie otwarte.

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

VerticalAddOnToolsPaneOpened

Obsługiwane w programie Windows PowerShell ISE 3.0 lub nowszym oraz nie są obecne we wcześniejszych wersjach.

Właściwość tylko do odczytu wskazująca, czy pionowe okienko narzędzi Add-Ons jest obecnie otwarte.

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