Compartilhar 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. Esse cmdlet usa um objeto de tarefa e um objeto de instância de classe como entrada. O cmdlet aceita apenas uma tarefa, mas pode aceitar várias instâncias de classe e substituições.

Exemplos

Exemplo 1: iniciar uma tarefa usando 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 usando um nome de exibição.

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

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

Exemplo 2: iniciar uma tarefa usando 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 usando um nome de exibição e uma tabela de hash que especifica um valor de tempo limite.

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

O segundo comando obtém todas as instâncias de classe que têm o nome Contoso Service e as armazena na variável $Instances.

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

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

Exemplo 3: Iniciar uma tarefa usando 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 usando credenciais.

O primeiro comando solicita ao usuário um nome de usuário e senha, cria um objeto de credencial da entrada e armazena o objeto de credencial na variável $Credential.

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

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

Parâmetros

-Confirm

Solicita 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 matriz 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. 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:False
Accept wildcard characters:False

-Override

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

Para determinar quais parâmetros para uma tarefa permitem substituições, use 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 a ser iniciado. Especifique uma variável que represente uma tarefa ou use um cmdlet, como o cmdlet Get-SCOMTask que obtém uma tarefa. Esse 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 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.

Este é um parâmetro obrigatório. Se você especificar um valor nulo, o Operations Manager usará as TaskCredentials padrão da conta para o usuário atual.

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

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

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