Get-Runspace

  • Odwołanie
Moduł:
Microsoft.PowerShell.Utility

Pobiera aktywne przestrzenie uruchamiania w procesie hosta programu PowerShell.

Składnia

Get-Runspace
   [[-Name] <String[]>]
   [<CommonParameters>]
Get-Runspace
   [-Id] <Int32[]>
   [<CommonParameters>]
Get-Runspace
   [-InstanceId] <Guid[]>
   [<CommonParameters>]

Opis

Polecenie Get-Runspace cmdlet pobiera aktywne przestrzenie uruchamiania w procesie hosta programu PowerShell.

Przykłady

Przykład 1. Pobieranie przestrzeni uruchomieniowych

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

Przykład 2. Pobieranie przestrzeni uruchomieniowej według identyfikatora

Get-Runspace -Id 2

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

Przykład 3. Pobieranie przestrzeni uruchomieniowej według nazwy

Get-Runspace -Name Runspace1

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

Przykład 4. Pobieranie przestrzeni uruchomieniowej według identyfikatora wystąpienia

W tym przykładzie identyfikujemy dostępną przestrzeń uruchomieniową przy użyciu parametru Name i zapisujemy obiekt zwracany do zmiennej $activeRunspace. Dzięki temu można używać właściwości elementu Runspace w kolejnych uruchomieniach programu Get-Runspace.

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

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

Parametry

-Id

Określa identyfikator obszaru uruchomieniowego

Type:Int32[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-InstanceId

Określa identyfikator GUID wystąpienia uruchomionego zadania.

Type:Guid[]
Position:0
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Name

Określa nazwę przestrzeni uruchomieniowej

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Dane wyjściowe

Runspace

To polecenie cmdlet zwraca przestrzeń uruchomieniową. Wyniki polecenia można przekazać potokiem Get-Runspace do Debug-Runspacepolecenia .