Get-Runspace

参考

模块:: Microsoft.PowerShell.Utility

获取 PowerShell 主机进程内的活动运行空间。

语法

Get-Runspace
   [[-Name] <String[]>]
   [<CommonParameters>]

Get-Runspace
   [-Id] <Int32[]>
   [<CommonParameters>]

Get-Runspace
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

说明

Get-Runspace cmdlet 获取 PowerShell 主机进程中的活动运行空间。

示例

示例 1：获取运行空间

Get-Runspace

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  1 Runspace1       localhost       Local         Opened        Busy
  2 Runspace2       localhost       Local         Opened        Available
  3 Runspace3       localhost       Local         Opened        Available

示例 2：按 ID 获取运行空间

Get-Runspace -Id 2

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  2 Runspace2       localhost       Local         Opened        Available

示例 3：按名称获取运行空间

Get-Runspace -Name Runspace1

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  1 Runspace1       localhost       Local         Opened        Busy

示例 4：按 InstanceId 获取运行空间

在此示例中，我们使用 Name 参数识别可用的运行空间，并将返回对象存储到变量 $activeRunspace。这样就可以在后续运行 Get-Runspace 时使用运行空间的属性。

$activeRunspace = Get-Runspace -Name Runspace1
Get-Runspace -InstanceId $activeRunspace.InstanceId

Id Name            ComputerName    Type          State         Availability
 -- ----            ------------    ----          -----         ------------
  1 Runspace1       localhost       Local         Opened        Busy

参数

-Id

指定运行空间的 ID

类型:	Int32[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-InstanceId

指定正在运行的作业的实例 ID GUID。

类型:	Guid[]
Position:	0
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Name

指定运行空间的名称

类型:	String[]
Position:	0
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

Runspace

此 cmdlet 返回一个运行空间。可以通过管道将 Get-Runspace 命令的结果传递给 Debug-Runspace。

Debug-Runspace

通过