Partager via

Start-SCOMTask

  • Référence
Module:
OperationsManager

Démarre une tâche pour un objet spécifié.

Syntaxe

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

Description

L’applet de commande Start-SCOMTask démarre une tâche pour un objet spécifié. Cette applet de commande prend un objet de tâche et un objet d’instance de classe comme entrée. L’applet de commande n’accepte qu’une seule tâche, mais elle peut accepter plusieurs instances de classe et remplacements.

Exemples

Exemple 1 : Démarrer une tâche à l’aide d’un nom complet

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

Cet exemple démarre une tâche à l’aide d’un nom complet.

La première commande obtient toutes les instances de classe dans le domaine Contoso.com et les stocke dans la variable $Instances.

La deuxième commande obtient la tâche qui a le nom d’affichage Get Monitor State et démarre la tâche pour chaque instance de classe stockée dans la variable $Instances.

Exemple 2 : Démarrer une tâche à l’aide d’un nom complet et d’une spécification de délai d’expiration

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

Cet exemple montre comment démarrer une tâche à l’aide d’un nom complet et d’une table de hachage qui spécifie une valeur de délai d’expiration.

La première commande crée une table de hachage qui a une valeur pour la clé Timeout et la stocke dans la variable $Overrides.

La deuxième commande obtient toutes les instances de classe qui ont le nom Contoso Service et les stocke dans la variable $Instances.

La troisième commande obtient la tâche qui a le nom complet Start NT Service et démarre la tâche pour chaque instance de classe stockée dans la variable $Instances.

La quatrième commande démarre la tâche pour chaque instance de classe stockée dans la variable $Instances. La commande spécifie une valeur de clé de délai d’expiration de 60.

Exemple 3 : Démarrer une tâche à l’aide d’informations d’identification

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

Cet exemple démarre une tâche à l’aide d’informations d’identification.

La première commande invite l’utilisateur à entrer un nom d’utilisateur et un mot de passe, crée un objet d’informations d’identification à partir de l’entrée et stocke l’objet d’informations d’identification dans la variable $Credential.

La deuxième commande obtient une instance de classe nommée Server01.Contoso.com et la stocke dans la variable $Instance.

La troisième commande obtient une tâche qui a le nom complet Réinitialiser l’état et démarre la tâche pour l’instance de classe stockée dans $Instance. La commande exécute la tâche sous les informations d’identification stockées dans $Credential.

Paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Type:SwitchParameter
Alias:cf
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Instance

Spécifie un tableau d’objets EnterpriseManagementObject qui représentent des objets d’instance de classe pour lesquels démarrer une tâche. Spécifiez une variable qui stocke les instances de classe ou utilisez une applet de commande telle que la Get-SCOMClassInstance applet de commande qui obtient les instances de classe. Ce paramètre accepte également les objets de groupe. Pour obtenir un objet de groupe, utilisez l’applet de commande Get-SCOMGroup Get-SCOMGroup.

Type:EnterpriseManagementObject[]
Position:1
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Override

Spécifie une table de hachage qui définit de nouvelles valeurs pour un ou plusieurs paramètres de tâche, si ces paramètres autorisent les remplacements. Pour plus d’informations sur les tables de hachage, tapez «Get-Help about_Hash_Tables».

Pour déterminer quels paramètres d’une tâche autorisent les remplacements, utilisez la méthode GetOverrideableParameters pour l’objet de tâche.

Type:Hashtable
Position:4
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Task

Spécifie un objet de tâche à démarrer. Spécifiez une variable qui représente une tâche ou utilisez une applet de commande telle que la Get-SCOMTask applet de commande qui obtient une tâche. Ce paramètre accepte un seul objet de tâche.

Type:ManagementPackTask
Position:2
Valeur par défaut:None
Obligatoire:True
Accepter l'entrée de pipeline:True
Accepter les caractères génériques:False

-TaskCredentials

Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute. Spécifiez un objet PSCredential, tel que celui retourné par l’applet de commande Get-Credential Get-Credential, pour ce paramètre. Pour plus d’informations sur les objets d’informations d’identification, tapez «Get-Help Get-Credential».

Ce compte doit avoir accès au serveur spécifié dans le paramètre ComputerName si ce paramètre apparaît.

Il s’agit d’un paramètre obligatoire. Si vous spécifiez une valeur null, Operations Manager utilise les taskCredentials par défaut du compte pour l’utilisateur actuel.

Type:PSCredential
Position:3
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Alias:wi
Position:Named
Valeur par défaut:False
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False