Get-Runspace
取得 PowerShell 主機進程內的使用中 Runspace。
Syntax
Get-Runspace
[[-Name] <String[]>]
[<CommonParameters>]
Get-Runspace
[-Id] <Int32[]>
[<CommonParameters>]
Get-Runspace
[-InstanceId] <Guid[]>
[<CommonParameters>]
Description
Cmdlet Get-Runspace
會在 PowerShell 主機進程中取得作用中的 Runspace。
範例
範例 1:取得 Runspace
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:依標識符取得 Runspace
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
參數識別可用的 Runspace,並將傳回物件儲存至變數 $activeRunspace
。 這可讓您在後續Get-Runspace
執行的 中,使用 Runspace 的屬性。
$activeRunspace = Get-Runspace -Name Runspace1
Get-Runspace -InstanceId $activeRunspace.InstanceId
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
1 Runspace1 localhost Local Opened Busy
參數
-Id
指定 Runspace 的識別碼
Type: | Int32[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InstanceId
指定執行中工作的執行個體識別碼 GUID。
Type: | Guid[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
指定 Runspace 的名稱
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
輸出
此 Cmdlet 會傳回 Runspace。 您可以使用管線將命令的結果 Get-Runspace
傳送至 Debug-Runspace
。