Compartilhar via

Get-SCOMTaskResult

  • Referência
Módulo:
OperationsManager

Obtém os resultados de tarefas que foram executadas.

Sintaxe

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 este 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á sendo 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 nos quais as tarefas são executadas. O cmdlet obtém os resultados da tarefa para cada lote.

Tipo:Guid[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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 NetBIOS, um endereço IP ou um FQDN (nome de domínio totalmente qualificado). 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.

Tipo:String[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:PSCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica uma matriz de IDs de tarefa. O cmdlet obtém os resultados das tarefas que têm essas IDs.

Tipo:Guid[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:EnterpriseManagementObject[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga: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.

Tipo:Connection[]
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

Tipo:ManagementPackTask[]
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False