Start-SCOMTask
Inicia uma tarefa para um objeto especificado.
Sintaxe
Default (Padrão)
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 Obter estado do monitor 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 Iniciar Serviço NT 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 de tempo limite 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 a partir 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 Reset State e inicia a tarefa para a instância de classe armazenada em $Instance. O comando executa a tarefa com as credenciais armazenadas em $Credential.
Parâmetros
-Confirm
Solicita sua confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 armazene 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 .
Propriedades do parâmetro
| Tipo: | EnterpriseManagementObject[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 de uma tarefa permitem substituições, use o método GetOverrideableParameters para o objeto de tarefa.
Propriedades do parâmetro
| Tipo: | Hashtable |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | ManagementPackTask |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 aparecer.
Esse parâmetro é obrigatório. Se você especificar um valor nulo, o Operations Manager usará o TaskCredentials padrão da conta para o usuário atual.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.