Obiekt PowerShellTab

Obiekt PowerShellTab reprezentuje Windows PowerShell uruchomieniowego.

Metody

Wywoływanie ( skryptu )

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

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 żadnego obiektu ani wartości. Jeśli kod modyfikuje dowolną zmienną, te zmiany są utrwalane na karcie, względem której zostało wywołane polecenie.

Skrypt — System.Management.Automation.ScriptBlock lub Ciąg 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, ] millisecondsTimeout )

Obsługiwane w Windows PowerShell ISE 3.0 i nowszych, a nie 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, a dowolna wartość zwrócona ze skryptu jest zwracana do środowiska uruchomieniowego, z którego wywołano polecenie. Jeśli uruchomienie polecenia trwa dłużej niż określa wartość millesecondsTimeout, polecenie kończy się niepowodzeniem z wyjątkiem: "Udano limit czasu operacji".

Skrypt — System.Management.Automation.ScriptBlock lub Ciąg Blok skryptu do uruchomienia.

[ useNewScope ] — opcjonalnie wartość logiczna ustawiana domyślnie na wartość , a następnie tworzony jest nowy zakres, w którym $true ma być uruchamiane $true polecenie. Środowisko uruchomieniowe karty programu PowerShell określonej za pomocą polecenia nie jest modyfikowane.

[ millisecondsTimeout ] — opcjonalna liczba całkowita, która domyślnie wynosi 500. Jeśli polecenie nie zakończy się w określonym czasie, polecenie generuje timeoutException z komunikatem "U 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 Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która pobiera menu Dodatków 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 Windows PowerShell ISE 2.0 i nowszych.

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

Obsługiwane w Windows PowerShell ISE 3.0 i nowszych, a nie we wcześniejszych wersjach. W Windows PowerShell ISE 2.0 nosiło to nazwę CommandPane.

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

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

Nazwa wyświetlana

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

Właściwość odczytu i zapisu, 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 Windows PowerShell ISE 2.0 i nowszych.

Właściwość logiczna do odczytu i zapisu, która określa, 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 Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która pobiera kolekcję plików skryptów, które są otwarte 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 ise. W nowszych wersjach Windows PowerShell ISE można użyć obiektu ConsolePane do tych samych celów.

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 Windows PowerShell ISE 2.0 i nowszych.

Właściwość tylko do odczytu, która pobiera tekst bieżącego 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

ShowCommands

Obsługiwane w Windows PowerShell ISE 3.0 i nowszych, a nie we wcześniejszych wersjach.

Właściwość do odczytu i zapisu, która wskazuje, 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}

Tekst stanu

Obsługiwane w Windows PowerShell ISE 2.0 i nowszych.

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

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

HorizontalAddOnToolsPaneOpened

Obsługiwane w Windows PowerShell ISE 3.0 i nowszych, a nie we wcześniejszych wersjach.

Właściwość tylko do odczytu, która wskazuje, czy okienko narzędzi Add-Ons jest obecnie otwarte.

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

VerticalAddOnToolsPaneOpened

Obsługiwane w Windows PowerShell ISE 3.0 i nowszych, a nie we wcześniejszych wersjach.

Właściwość tylko do odczytu, która wskazuje, czy 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ż