PowerShellTab 对象

PowerShellTab 对象代表 Windows PowerShell 运行时环境。

方法

调用（脚本）

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

在 PowerShell 选项卡中运行给定脚本。

笔记

此方法仅适用于其他 PowerShell 选项卡，不适用于运行该方法的 PowerShell 选项卡。它不返回任何对象或值。如果代码修改了任何变量，那么这些更改将保留在调用该命令的选项卡上。

脚本 - System.Management.Automation.ScriptBlock 或 String 要运行的脚本块。

# 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( 脚本, [useNewScope], millisecondsTimeout )

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

在 PowerShell 选项卡中运行给定脚本。

笔记

此方法仅适用于其他 PowerShell 选项卡，不适用于运行该方法的 PowerShell 选项卡。脚本块将运行，并且从脚本返回的任何值都将返回到您调用命令的运行环境。如果该命令的运行时间比 millesecondsTimeout 值指定的时间长，则该命令将失败并出现异常：“操作已超时”。

脚本 - System.Management.Automation.ScriptBlock 或 String 要运行的脚本块。

[useNewScope] - 可选布尔值，默认为 $true 如果设置为 $true，则会创建一个新作用域，在其中运行命令。它不会修改命令指定的 PowerShell 选项卡的运行时环境。

[millisecondsTimeout] - 可选整数，默认为500。如果该命令未在指定时间内完成，则该命令会生成 TimeoutException 并显示消息“操作已超时”。

# 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)}

特性

附加菜单

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取 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

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

如果可以使用 Invoke( Script ) 方法调用脚本，则返回 $true 值的只读布尔属性。

# 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

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。在 Windows PowerShell ISE 2.0 中，它被命名为 CommandPane。

获取控制台窗格编辑器对象的只读属性。

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

DisplayName

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

读写属性，用于获取或设置 PowerShell 选项卡上显示的文本。默认情况下，选项卡命名为“PowerShell #”，其中 # 代表数字。

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

ExpandedScript

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

确定脚本窗格是展开还是隐藏的读写布尔属性。

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

文件

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取在 PowerShell 选项卡中打开的脚本文件集合的只读属性。

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

输出

此功能存在于 Windows PowerShell ISE 2.0 中，但在更高版本的 ISE 中被删除或重命名。在 Windows PowerShell ISE 的更高版本中，您可以使用 ConsolePane 对象来实现相同目的。

获取当前编辑器的输出窗格的只读属性。

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

迅速的

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取当前提示文本的只读属性。注意：提示功能可以被用户的配置文件覆盖。如果结果不是简单字符串，则此属性不返回任何内容。

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

ShowCommands

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

指示当前是否显示命令窗格的读写属性。

# 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

在 Windows PowerShell ISE 2.0 及更高版本中受支持。

获取 PowerShellTab 状态文本的只读属性。

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

水平附加工具窗格已打开

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

只读属性，指示水平附加组件工具窗格当前是否打开。

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

垂直附加工具窗格已打开

在 Windows PowerShell ISE 3.0 及更高版本中受支持，但在早期版本中不存在。

只读属性，指示垂直附加组件工具窗格当前是否打开。

# Turns on the Commands pane
$psISE.CurrentPowerShellTab.ShowCommands = $true
# Gets the current state of the vertical Add-ons tool pane.
$psISE.CurrentPowerShellTab.HorizontalAddOnToolsPaneOpened

参见

• PowerShellTabCollection 对象
• Windows PowerShell ISE 脚本对象模型的用途
• ISE 对象模型层次结构