Get-Runspace

模組:
Microsoft.PowerShell.Utility Module

在 PowerShell 主機程序中獲得活躍的跑道空間。

語法

NameParameterSet (預設值) 

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

IdParameterSet 

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

InstanceIdParameterSet 

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

Description

Get-Runspace指令長在 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[]

預設值: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

此指令子回傳一個 Runspace。 你可以將指令的結果 Get-Runspace 管道傳送到 Debug-Runspace。