Get-Runspace
Získá aktivní runspaces v rámci hostitelského procesu PowerShellu.
Syntaxe
NameParameterSet (Výchozí)
Get-Runspace
[[-Name] <String[]>]
[<CommonParameters>]
IdParameterSet
Get-Runspace
[-Id] <Int32[]>
[<CommonParameters>]
InstanceIdParameterSet
Get-Runspace
[-InstanceId] <Guid[]>
[<CommonParameters>]
Description
Rutina Get-Runspace získá aktivní prostředí Runspace v procesu hostitele PowerShellu.
Příklady
Příklad 1: Získání 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
Příklad 2: Získání runspace podle identifikátoru
Get-Runspace -Id 2
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
2 Runspace2 localhost Local Opened Available
Příklad 3: Získání runspace podle názvu
Get-Runspace -Name Runspace1
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
1 Runspace1 localhost Local Opened Busy
Příklad 4: Získání runspace podle InstanceId
V tomto příkladu identifikujeme dostupný runspace pomocí parametru Name a uložíme návratový objekt do proměnné $activeRunspace. Toto vám umožňuje využít vlastnosti Runspace při následných spuštěních 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
Určuje ID runspace.
Vlastnosti parametru
| Typ: | Int32[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
IdParameterSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-InstanceId
Určuje identifikátor GUID ID instance spuštěné úlohy.
Vlastnosti parametru
| Typ: | Guid[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
InstanceIdParameterSet
| Position: | 0 |
| Povinné: | True |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
-Name
Určuje název konkrétního běhového prostoru.
Vlastnosti parametru
| Typ: | String[] |
| Default value: | None |
| Podporuje zástupné znaky: | False |
| DontShow: | False |
Sady parametrů
NameParameterSet
| Position: | 0 |
| Povinné: | False |
| Hodnota z kanálu: | False |
| Hodnota z kanálu podle názvu vlastnosti: | False |
| Hodnota ze zbývajících argumentů: | False |
CommonParameters
Tato rutina podporuje běžné parametry: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction a -WarningVariable. Další informace najdete v about_CommonParameters.
Výstupy
Runspace
Tento cmdlet vrátí runspace. Výsledky příkazu Get-Runspace můžete převést na Debug-Runspace.