Udostępnij za pośrednictwem

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

Typ:Int32[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-InstanceId

Określa identyfikator GUID wystąpienia uruchomionego zadania.

Typ:Guid[]
Position:0
Domyślna wartość:None
Wymagane:True
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

-Name

Określa nazwę przestrzeni uruchomieniowej

Typ:String[]
Position:0
Domyślna wartość:None
Wymagane:False
Akceptowanie danych wejściowych potoku:False
Akceptowanie symboli wieloznacznych:False

Dane wyjściowe

Runspace

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