Get-Runspace

  • Referentie
Module:
Microsoft.PowerShell.Utility

Hiermee worden actieve runspaces binnen een PowerShell-hostproces opgehaald.

Syntax

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

Description

De Get-Runspace cmdlet haalt actieve runspaces op in een PowerShell-hostproces.

Voorbeelden

Voorbeeld 1: Runspaces ophalen

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

Voorbeeld 2: Runspace ophalen op id

Get-Runspace -Id 2

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

Voorbeeld 3: Runspace ophalen op naam

Get-Runspace -Name Runspace1

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

Voorbeeld 4: Runspace ophalen op InstanceId

In dit voorbeeld identificeren we een beschikbare runspace met behulp van de Name parameter en slaan we het retourobject op in de variabele $activeRunspace. Hiermee kunt u de eigenschappen van de Runspace gebruiken in volgende uitvoeringen van Get-Runspace.

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

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

Parameters

-Id

Hiermee geeft u de id van een runspace

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

-InstanceId

Hiermee geeft u de exemplaar-id-GUID van een actieve taak.

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

-Name

Hiermee geeft u de naam van een runspace

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

Uitvoerwaarden

Runspace

Met deze cmdlet wordt een Runspace geretourneerd. U kunt de resultaten van een Get-Runspace opdracht doorsluisen naar Debug-Runspace.