Freigeben über

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 cmdlet Get-Runspace 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 von 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.

Typ:Int32[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-InstanceId

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

Typ:Guid[]
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Name

Gibt den Namen eines Runspaces an.

Typ:String[]
Position:0
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

Ausgaben

Runspace

Sie können die Ergebnisse eines Get-Runspace Befehls an Debug-Runspacepfeifen.