Get-Runspace
获取 PowerShell 主机进程中的活动运行空间。
语法
NameParameterSet (默认值)
Get-Runspace
[[-Name] <String[]>]
[<CommonParameters>]
IdParameterSet
Get-Runspace
[-Id] <Int32[]>
[<CommonParameters>]
InstanceIdParameterSet
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:按名称获取 runspace
Get-Runspace -Name Runspace1
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
1 Runspace1 localhost Local Opened Busy
示例 4:按 InstanceId 获取 runspace
在此示例中,我们使用 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[] |
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
IdParameterSet
Position: | 0 |
必需: | True |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-InstanceId
指定正在运行的作业的实例 ID GUID。
参数属性
类型: | Guid[] |
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
InstanceIdParameterSet
Position: | 0 |
必需: | True |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
-Name
指定运行空间的名称
参数属性
类型: | String[] |
默认值: | None |
支持通配符: | False |
不显示: | False |
参数集
NameParameterSet
Position: | 0 |
必需: | False |
来自管道的值: | False |
来自管道的值(按属性名称): | False |
来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
输出
Runspace
此 cmdlet 返回 Runspace。 可以通过管道将 Get-Runspace
命令的结果传递给 Debug-Runspace
。