Start-SCOMTask
Démarre une tâche pour un objet spécifié.
Syntaxe
Default (Par défaut)
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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | cf |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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
Propriétés du paramètre
| Type: | EnterpriseManagementObject[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | Hashtable |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 4 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | ManagementPackTask |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 2 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-TaskCredentials
Spécifie le compte d’utilisateur sous lequel la connexion au groupe d’administration s’exécute.
Spécifiez un objet 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.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | 3 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | Wi |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.