Compartilhar via


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