Start-SCOMTask
Inicia uma tarefa para um objeto especificado.
Sintaxe
Default (Predefiniçã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. Este 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 para 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 para 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 para 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 para 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 Serviço Contoso 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 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 no $Instance. O comando executa a tarefa sob as credenciais armazenadas no $Credential.
Parâmetros
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Instance
Especifica uma matriz de EnterpriseManagementObject objetos 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. Este parâmetro também aceita objetos de grupo. Para obter um objeto de grupo, use o cmdlet Get-SCOMGroup.
Propriedades dos parâmetros
| Tipo: | EnterpriseManagementObject[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 1 |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | Hashtable |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 4 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Task
Especifica um objeto de tarefa a ser iniciado. Especifique uma variável que represente uma tarefa ou use um cmdlet como o Get-SCOMTask cmdlet que obtém uma tarefa. Este parâmetro aceita apenas um objeto de tarefa.
Propriedades dos parâmetros
| Tipo: | ManagementPackTask |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 2 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-TaskCredentials
Especifica a conta de usuário sob a qual a conexão do grupo de gerenciamento é executada.
Especifique um objeto PSCredential 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.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | 3 |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.