Start-SCOMTask
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 |