Get-Runspace
Obtém espaços de execução ativos em um processo de host do PowerShell.
Sintaxe
NameParameterSet (Predefinição)
Get-Runspace
[[-Name] <String[]>]
[<CommonParameters>]
IdParameterSet
Get-Runspace
[-Id] <Int32[]>
[<CommonParameters>]
InstanceIdParameterSet
Get-Runspace
[-InstanceId] <Guid[]>
[<CommonParameters>]
Description
O cmdlet Get-Runspace obtém espaços de execução ativos em um processo de host do PowerShell.
Exemplos
Exemplo 1: Obter 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
Exemplo 2: Obter espaço de execução por Id
Get-Runspace -Id 2
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
2 Runspace2 localhost Local Opened Available
Exemplo 3: Obter espaço de execução por nome
Get-Runspace -Name Runspace1
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
1 Runspace1 localhost Local Opened Busy
Exemplo 4: Obter espaço de execução por InstanceId
Neste exemplo, identificamos um espaço de execução disponível usando o parâmetro Name e armazenamos o objeto de retorno para a variável $activeRunspace. Isso permite que você use as propriedades do Runspace em execuções subsequentes de Get-Runspace.
$activeRunspace = Get-Runspace -Name Runspace1
Get-Runspace -InstanceId $activeRunspace.InstanceId
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
1 Runspace1 localhost Local Opened Busy
Parâmetros
-Id
Especifica o Id de um espaço de execução
Propriedades dos parâmetros
| Tipo: | Int32[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
IdParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-InstanceId
Especifica o GUID do ID da instância de um trabalho em execução.
Propriedades dos parâmetros
| Tipo: | Guid[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
InstanceIdParameterSet
| Position: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Name
Especifica o Nome de um espaço de execução
Propriedades dos parâmetros
| Tipo: | String[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
NameParameterSet
| Position: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Saídas
Runspace
Este cmdlet retorna um Runspace. Você pode canalizar os resultados de um comando Get-Runspace para Debug-Runspace.
