Partager via

Start-SCOMTask

  • Référence
Module:
OperationsManager

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

Syntax

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 accepte 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 montre comment démarrer 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 complet Obtenir l’état du moniteur 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 Reset State 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 demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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 l’applet de commande Get-SCOMClassInstance 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 .

Type:EnterpriseManagementObject[]
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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 les paramètres d’une tâche qui autorisent les remplacements, utilisez la méthode GetOverrideableParameters pour l’objet de tâche.

Type:Hashtable
Position:4
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 l’applet de commande Get-SCOMTask qui obtient une tâche. Ce paramètre accepte un seul objet de tâche.

Type:ManagementPackTask
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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 , 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 s’affiche.

Ce paramètre est 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
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

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