Beim PowerShell-Registerkartenobjekt handelt es sich um eine Windows PowerShell-Ausführungsumgebung. Ein Beispiel hierfür ist $psISE.CurrentPowerShellTab.

Methoden

Das PowerShell-Registerkartenobjekt verfügt über folgende Methoden.

Invoke(System.Management.Automation.ScriptBlock script)

Führt das angegebene Skript auf der PowerShell-Registerkarte aus.

Hinweis:

Diese Methode kann nur auf andere PowerShell-Registerkarten angewendet werden, nicht auf die PowerShell-Registerkarte, auf der sie ausgeführt wird.

script:
Das Skript, das ausgeführt werden soll.

# Manually create a second PowerShell tab before running this script. 
# Return to the first tab and type
$secondTab = $psise.PowerShellTabs[1] 
$secondTab.Invoke({dir})

Eigenschaften

AddOnsMenu

Schreibgeschützte Eigenschaft, die das Menü "Add-Ons" für die PowerShell-Registerkarte abruft.

# 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

Schreibgeschützte boolesche Eigenschaft, die den Wert "True" abruft, wenn ein Skript mit der Invoke(System.Management.Automation.ScriptBlock script)-Methode aufgerufen werden kann.

# 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 

CommandPane

Schreibgeschützte Eigenschaft, die das Befehlsbereich-Editor-Objekt abruft.

# Gets the Command Pane editor.
$psISE.CurrentPowerShellTab.CommandPane

DisplayName

Eigenschaft mit Lese-/Schreibzugriff, die den Namen der PowerShell-Registerkarte abruft oder festlegt.

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

ExpandedScript

Boolesche Eigenschaft mit Lese-/Schreibzugriff, die bestimmt, ob der Skriptbereich erweitert oder ausgeblendet wird.

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

Files

Schreibgeschützte Eigenschaft, die die Auflistung von Skriptdateien abruft, die auf der PowerShell-Registerkarte geöffnet sind.

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

Output

Schreibgeschützte Eigenschaft, die den Ausgabe-Editor abruft.

# Clears the text in the output.
$psise.CurrentPowerShellTab.output.clear()

Prompt

Schreibgeschützte Eigenschaft, die den aktuellen Text an der Eingabeaufforderung abruft.

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

StatusText

Schreibgeschützte Eigenschaft, die die PowerShellTab-Statusmeldung abruft.

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

Siehe auch




Inhaltsverzeichnis