Get-Runspace
Obtém runspaces ativos em um processo de host do PowerShell.
Sintaxe
NameParameterSet (Default)
Get-Runspace
[[-Name] <String[]>]
[<CommonParameters>]
IdParameterSet
Get-Runspace
[-Id] <Int32[]>
[<CommonParameters>]
InstanceIdParameterSet
Get-Runspace
[-InstanceId] <Guid[]>
[<CommonParameters>]
Description
O cmdlet Get-Runspace obtém runspaces 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 runspace por Id
Get-Runspace -Id 2
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
2 Runspace2 localhost Local Opened Available
Exemplo 3: Obter runspace por Nome
Get-Runspace -Name Runspace1
Id Name ComputerName Type State Availability
-- ---- ------------ ---- ----- ------------
1 Runspace1 localhost Local Opened Busy
Exemplo 4: Obter runspace por InstanceId
Neste exemplo, identificamos um runspace 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 a ID de um runspace
Propriedades do parâmetro
| Tipo: | Int32[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
IdParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-InstanceId
Especifica o GUID de ID da instância de um trabalho em execução.
Propriedades do parâmetro
| Tipo: | Guid[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
InstanceIdParameterSet
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Name
Especifica o nome de um runspace
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
NameParameterSet
| Cargo: | 0 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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
Esse cmdlet retorna um de runspace. Você pode canalizar os resultados de um comando Get-Runspace para Debug-Runspace.