Get-SCOMTaskResult
Obtém os resultados de tarefas que foram executadas.
Syntax
Get-SCOMTaskResult
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-BatchID] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-Id] <Guid[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-Instance] <EnterpriseManagementObject[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Get-SCOMTaskResult
[-Task] <ManagementPackTask[]>
[-SCSession <Connection[]>]
[-ComputerName <String[]>]
[-Credential <PSCredential>]
[<CommonParameters>]
Description
O cmdlet Get-SCOMTaskResult obtém os resultados das tarefas executadas. Use esse cmdlet para obter resultados por nome de tarefa ou ID, bem como para tarefas associadas a instâncias de classe ou lotes especificados.
Exemplos
Exemplo 1: obter resultados da tarefa especificando um nome de exibição parcial e uma ação de erro
PS C:\>Get-SCOMTask -Name "*SystemCenter*" | Get-SCOMTaskResult -ErrorAction SilentlyContinue
Esse comando obtém resultados para tarefas que têm o SystemCenter em seus nomes. O comando usa o cmdlet Get-SCOMTask para obter tarefas com base no nome e as passa para o cmdlet Get-SCOMTaskResult usando o operador de pipeline. Como o comando especifica SilentlyContinue para o parâmetro ErrorAction , se o cmdlet encontrar uma tarefa sem resultados correspondentes, o comando continuará sendo executado e não exibirá mensagens de erro.
Exemplo 2: Obter resultados da tarefa especificando instâncias de classe
PS C:\>Get-SCOMClassInstance -DisplayName "*.Consoso.com" | Get-SCOMTaskResult -ErrorAction SilentlyContinue
Esse comando obtém todas as instâncias de classe no domínio Contoso.com e retorna os resultados da tarefa para cada objeto de instância de classe. O comando usa o cmdlet Get-SCOMClassInstance para obter todas as instâncias que têm um nome de exibição que contém .Contoso.com e as passa para o cmdlet Get-SCOMTaskResult usando o operador de pipeline. Como o comando especifica SilentlyContinue para o parâmetro ErrorAction , se o cmdlet encontrar uma instância de classe sem resultados de tarefa correspondentes, o comando continuará a ser executado e não exibirá mensagens de erro.
Exemplo 3: obter resultados da tarefa especificando uma ID de tarefa
PS C:\>Get-SCOMTaskResult -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd
Esse comando obtém os resultados da tarefa que tem uma ID de 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.
Exemplo 4: obter resultados da tarefa especificando uma ID do lote
PS C:\>Get-SCOMTaskResult -BatchId 2ef74789-f9f5-46b0-af70-16d01d4f4577
Esse comando obtém os resultados de uma tarefa que é executada em um lote que tem uma ID de 2ef74789-f9f5-46b0-af70-16d01d4f4577.
Parâmetros
-BatchID
Especifica uma matriz que contém as IDs de lotes em que as tarefas são executadas. O cmdlet obtém resultados da tarefa para cada lote.
Type: | Guid[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ComputerName
Especifica uma matriz que contém o nome do computador com o qual estabelecer uma conexão. Os formatos válidos incluem um nome de NetBIOS, um endereço IP ou um nome de domínio totalmente qualificado (FQDN). Para especificar o computador local, especifique o nome do computador, localhost ou um ponto (.).
O computador deve executar o serviço de Acesso a Dados do System Center.
Se você não especificar esse parâmetro, o padrão será o computador para a conexão do grupo de gerenciamento atual.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada.
Especifique um objeto PSCredential , como um que o cmdlet Get-Credential retorna, para esse parâmetro.
Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential
.
Essa conta deve ter acesso ao servidor especificado no parâmetro ComputerName se esse parâmetro for exibido.
Se você não especificar esse parâmetro, o padrão será a conta do usuário atual.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Id
Especifica uma matriz de IDs de tarefa. O cmdlet obtém os resultados das tarefas que têm essas IDs.
Type: | Guid[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Instance
Especifica uma matriz de instâncias de classe para as quais iniciar uma tarefa. Especifique uma variável que armazena instâncias de classe ou use um cmdlet como Get-SCOMClassInstance que obtém as instâncias de classe. Esse parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup .
Type: | EnterpriseManagementObject[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-SCSession
Especifica uma matriz de conexões com servidores de gerenciamento. Para obter objetos de conexão do grupo de gerenciamento, use o cmdlet Get-SCOMManagementGroupConnection . Se esse parâmetro não aparecer, o padrão será a conexão do grupo de gerenciamento atual.
Type: | Connection[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Task
Especifica uma matriz de tarefas do pacote de gerenciamento. O cmdlet obtém resultados para os objetos de tarefa que a matriz contém. Especifique uma variável que contenha objetos de tarefa ou use um cmdlet como cmdlet Get-SCOMTask que obtém tarefas.
Type: | ManagementPackTask[] |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |