Delen via

Get-Runspace

Module:
Microsoft.PowerShell.Utility Module

Hiermee worden actieve runspaces binnen een PowerShell-hostproces opgehaald.

Syntaxis

NameParameterSet (Standaard) 

Get-Runspace
    [[-Name] <String[]>]
    [<CommonParameters>]

IdParameterSet 

Get-Runspace
    [-Id] <Int32[]>
    [<CommonParameters>]

InstanceIdParameterSet 

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 met 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 bij InstanceId

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

$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 specificeert u de ID van een runspace

Parametereigenschappen

Type:

Int32[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

IdParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-InstanceId

Hiermee specificeert u de exemplaar-id-GUID van een lopende taak.

Parametereigenschappen

Type:

Guid[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

InstanceIdParameterSet
Position:0
Verplicht:True
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

-Name

Hiermee wordt de naam van een runspace gespecificeerd

Parametereigenschappen

Type:

String[]

Default value:None
Ondersteunt jokertekens:False
DontShow:False

Parametersets

NameParameterSet
Position:0
Verplicht:False
Waarde uit pijplijn:False
Waarde uit pijplijn op eigenschapsnaam:False
Waarde van resterende argumenten:False

CommonParameters

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Uitvoerwaarden

Runspace

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