Partilhar via

Start-SCOMTask

  • Referência
Módulo:
OperationsManager

Inicia uma tarefa para um objeto especificado.

Syntax

Start-SCOMTask
     [-Instance] <EnterpriseManagementObject[]>
     [-Task] <ManagementPackTask>
     -TaskCredentials <PSCredential>
     [[-Override] <Hashtable>]
     [-WhatIf]
     [-Confirm]
     [<CommonParameters>]

Description

O cmdlet Start-SCOMTask inicia uma tarefa para um objeto especificado. Este cmdlet leva um objeto de tarefa e um objeto de instância de classe como entrada. O cmdlet aceita apenas uma tarefa, mas pode aceitar múltiplas instâncias de classe e substituições.

Exemplos

Exemplo 1: Iniciar uma tarefa utilizando um nome de exibição

PS C:\>$Instances = Get-SCOMClassInstance -Name "*.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Get Monitor State" | Start-SCOMTask -Instance $Instances

Este exemplo inicia uma tarefa utilizando um nome de exibição.

O primeiro comando obtém todas as instâncias de classe no domínio Contoso.com e armazena-as na variável $Instances.

O segundo comando obtém a tarefa que tem o nome de visualização Get Monitor State e inicia a tarefa para cada instância de classe que é armazenada na variável $Instances.

Exemplo 2: Iniciar uma tarefa utilizando um nome de exibição e uma especificação de tempo limite

PS C:\>$Overrides = @{Timeout=60}
PS C:\> $Instances = Get-SCOMClassInstance -DisplayName "Contoso Service"
PS C:\> $Task = Get-SCOMTask -DisplayName "Start NT Service"
PS C:\> Start-SCOMTask -Task $Task -Instance $Instances -Override $Overrides

Este exemplo mostra como iniciar uma tarefa utilizando um nome de exibição e uma tabela de haxixe que especifica um valor de tempo limite.

O primeiro comando cria uma tabela de haxixe que tem um valor para a chave Timeout e armazena-a na variável $Overrides.

O segundo comando recebe todas as instâncias de classe que têm o nome Serviço Contoso e armazena-as na variável $Instances.

O terceiro comando obtém a tarefa que tem o nome de exibição Iniciar o Serviço NT e inicia a tarefa para cada instância de classe que é armazenada na variável $Instances.

O quarto comando inicia a tarefa para cada instância de classe que é armazenada na variável $Instances. O comando especifica um valor de chave timeout de 60.

Exemplo 3: Iniciar uma tarefa utilizando credenciais

PS C:\>$Credential = Get-Credential
PS C:\> $Instance = Get-SCOMClassInstance -Name "Server01.Contoso.com"
PS C:\> Get-SCOMTask -DisplayName "Reset State" | Start-SCOMTask -Instance $Instance -TaskCredentials $Credential

Este exemplo inicia uma tarefa utilizando credenciais.

O primeiro comando solicita ao utilizador um nome de utilizador e palavra-passe, cria um objeto credencial a partir da entrada e armazena o objeto credencial na variável $Credential.

O segundo comando recebe uma instância de classe chamada Server01.Contoso.com e armazena-a na variável $Instance.

O terceiro comando obtém uma tarefa que tem o nome de visualização Reset State e inicia a tarefa para a instância de classe que é armazenada em $Instance. O comando executa a tarefa sob as credenciais que são armazenadas em $Credential.

Parâmetros

-Confirm

Solicita a sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Instance

Especifica uma variedade de objetos EnterpriseManagementObject que representam objetos de instância de classe para os quais iniciar uma tarefa. Especifique uma variável que armazena as instâncias de classe ou use um cmdlet como o cmdlet Get-SCOMClassInstance que obtém as instâncias de classe. Este parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, utilize o cmdlet Get-SCOMGroup .

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Override

Especifica uma tabela de haxixe que define novos valores para um ou mais parâmetros de tarefa, se esses parâmetros permitirem sobreposições. Para mais informações sobre tabelas de haxixe, escreva "Get-Help about_Hash_Tables".

Para determinar quais os parâmetros para uma tarefa que permitem sobreposições, utilize o método GetOverrideableParameters para o objeto de tarefa.

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Task

Especifica um objeto de tarefa para iniciar. Especifique uma variável que represente uma tarefa, ou use um cmdlet como o cmdlet Get-SCOMTask que obtém uma tarefa. Este parâmetro aceita apenas um objeto de tarefa.

Type:ManagementPackTask
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-TaskCredentials

Especifica a conta de utilizador sob a qual a ligação do grupo de gestão é executado. Especifique um objeto PSCredential , tal como aquele que o cmdlet Get-Credential devolve, para este parâmetro. Para mais informações sobre objetos credenciais, escreva "Get-Help Get-Credential".

Esta conta deve ter acesso ao servidor especificado no parâmetro ComputerName se esse parâmetro aparecer.

Este parâmetro é obrigatório. Se especificar um valor nulo, o Gestor de Operações utiliza os Resultados de Tarefas predefinidos da conta para o utilizador atual.

Type:PSCredential
Position:3
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False