Partager via

Get-SCOMTask

  • Référence
Module:
OperationsManager

Obtient une liste de tâches.

Syntaxe

Get-SCOMTask
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-DisplayName] <String[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   -Id <Guid[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Instance] <EnterpriseManagementObject[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-ManagementPack] <ManagementPack[]>
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Name <String[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]
Get-SCOMTask
   [-Target <ManagementPackClass[]>]
   [-SCSession <Connection[]>]
   [-ComputerName <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

La cmdlet Get-SCOMTask obtient une liste de tâches. Utilisez cette applet de commande pour obtenir des tâches qui ont un nom ou un ID spécifique, ainsi que des tâches associées à des rôles d’utilisateur, des instances de classe, des packs d’administration ou des classes cibles spécifiées.

Exemples

Exemple 1 : Obtenir des tâches en spécifiant un nom partiel

PS C:\>Get-SCOMTask -Name "*health*"

Cette commande obtient toutes les tâches qui ont l’intégrité dans leurs noms.

Exemple 2 : Obtenir une tâche à l’aide d’un nom complet partiel

PS C:\>Get-SCOMTask -DisplayName "Stop*"

Cette commande obtient toutes les tâches qui ont des noms d’affichage qui commencent par Arrêter.

Exemple 3 : Obtenir une tâche en spécifiant un nom d’affichage partiel et une action d’erreur

PS C:\>Get-SCOMManagementPack -DisplayName "System Center Core*" | Get-SCOMTask -ErrorAction SilentlyContinue

Cette commande obtient toutes les tâches pour les packs d’administration qui ont System Center Core dans leurs noms d’affichage. La commande utilise l’applet de commande Get-SCOMManagementPack pour obtenir des packs d’administration basés sur des noms d’affichage et les transmet à l’applet de commande Get-SCOMTask. Étant donné que la commande spécifie SilentlyContinue pour le paramètre ErrorAction, si l’applet de commande trouve un pack d’administration sans tâches associées, il continue à s’exécuter et n’affiche pas les messages d’erreur.

Exemple 4 : Obtenir des tâches à l’aide d’un nom de classe partiel

PS C:\>Get-SCOMClass -Name "*health*" | Get-SCOMTask

Cette commande obtient toutes les tâches pour les classes qui ont l’intégrité dans leurs noms.

Exemple 5 : Obtenir des tâches en spécifiant un nom d’instance de classe partielle

PS C:\>Get-SCOMClassInstance -Name "*.Contoso.com" | Get-SCOMTask

Cette commande obtient toutes les tâches pour les instances de classe qui ont .Contoso.com dans leurs noms.

Exemple 6 : Obtenir une tâche en spécifiant un ID

PS C:\>Get-SCOMTask -Id 7413b06b-a95b-4ae3-98f2-dac9ff76dabd

Cette commande obtient la tâche qui a un ID de 7413b06b-a95b-4ae3-98f2-dac9ff76dabd.

Paramètres

-ComputerName

Spécifie un tableau de noms d’ordinateurs. L’applet de commande établit des connexions temporaires avec des groupes d’administration pour ces ordinateurs. Vous pouvez utiliser des noms NetBIOS, des adresses IP ou des noms de domaine complets (FQDN). Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, localhost ou un point (.).

L’ordinateur doit exécuter le service System Center Data Access.

Si vous ne spécifiez pas ce paramètre, la valeur par défaut est l’ordinateur de la connexion de groupe d’administration actuelle.

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

-Credential

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.

Si vous ne spécifiez pas ce paramètre, la valeur par défaut est le compte de l’utilisateur actuel.

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

-DisplayName

Spécifie un tableau de noms d’affichage pour les objets de tâche. Ce paramètre prend une ou plusieurs chaînes, et l’applet de commande recherche des correspondances entre les noms d’affichage des objets de tâche avec utilisant l’applet de commande. Les valeurs de ce paramètre varient selon les packs d’administration localisés importés dans le groupe d’administration et les paramètres régionaux de l’utilisateur qui exécute Windows PowerShell.

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

-Id

Spécifie un tableau d’ID de tâche. L’applet de commande obtient les tâches qui ont ces ID. Pour obtenir une tâche, utilisez l’applet de commande Get-SCOMTask . L’ID est l’ID propriété d’un objet de tâche.

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

-Instance

Spécifie un tableau d’objets EnterpriseManagementObject qui représentent des instances de classe. L’applet de commande récupère les tâches pour les instances de classe que le tableau stocke. Spécifiez une variable qui représente les instances de classe ou utilisez une applet de commande telle que 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 Get-SCOMGroup.

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

-ManagementPack

Spécifie un tableau d’objets de pack d’administration. L’applet de commande obtient des tâches pour les objets du pack d’administration dans le tableau. Spécifiez une variable qui contient des objets de pack d’administration ou utilisez une applet de commande telle que Get-SCOMManagementPack qui obtient des objets du pack d’administration.

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

-Name

Spécifie un tableau de noms de tâches.

L’applet de commande prend chaque chaîne du tableau et la met en correspondance avec les propriétés Name des objets de tâche avec utilisant cette applet de commande.

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

-SCSession

Spécifie un tableau d’objets Connection. Pour obtenir objets Connection, spécifiez l’applet de commande Get-SCOMManagementGroupConnection .

Si ce paramètre n’apparaît pas, l’applet de commande utilise la connexion persistante active à un groupe d’administration. Utilisez le paramètre SCSession pour spécifier une connexion persistante différente. Vous pouvez créer une connexion temporaire à un groupe d’administration à l’aide des paramètres ComputerName et Credential. Pour plus d’informations, tapez «Get-Help about_OpsMgr_Connections».

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

-Target

Spécifie un tableau d’objets de classe de pack d’administration qui représentent des classes cibles. Spécifiez une variable qui contient les objets de classe cible ou utilisez une applet de commande telle que Get-SCOMClass qui obtient les objets de classe cible.

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