Get-Runspace

  • Referenz
Modul:
Microsoft.PowerShell.Utility

Ruft aktive Runspaces innerhalb eines PowerShell-Hostprozesses ab.

Syntax

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

Beschreibung

Das Get-Runspace Cmdlet ruft aktive Runspaces in einem PowerShell-Hostprozess ab.

Beispiele

Beispiel 1: Abrufen von Runspaces

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

Beispiel 2: Abrufen von Runspace nach ID

Get-Runspace -Id 2

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

Beispiel 3: Abrufen von Runspace nach Name

Get-Runspace -Name Runspace1

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

Beispiel 4: Abrufen von Runspace nach InstanceId

In diesem Beispiel identifizieren wir einen verfügbaren Runspace mithilfe des Name Parameters und speichern das Rückgabeobjekt in der Variablen $activeRunspace. Auf diese Weise können Sie die Eigenschaften des Runspace in nachfolgenden Ausführungsläufen Get-Runspaceverwenden.

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

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

Parameter

-Id

Gibt die ID eines Runspaces an.

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

-InstanceId

Gibt die Instanz-ID-GUID eines ausgeführten Auftrags an.

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

-Name

Gibt den Namen eines Runspaces an.

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

Ausgaben

Runspace

Dieses Cmdlet gibt ein Runspace zurück. Sie können die Ergebnisse eines Get-Runspace Befehls an Debug-Runspace.