Partager via


Get-SCOMTask

Obtient une liste de tâches.

Syntaxe

Empty (Par défaut)

Get-SCOMTask
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromTaskDisplayName

Get-SCOMTask
    [-DisplayName] <String[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromTaskId

Get-SCOMTask
    -Id <Guid[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromInstance

Get-SCOMTask
    [-Instance] <EnterpriseManagementObject[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementPack

Get-SCOMTask
    [-ManagementPack] <ManagementPack[]>
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromTaskName

Get-SCOMTask
    [-Name <String[]>]
    [-SCSession <Connection[]>]
    [-ComputerName <String[]>]
    [-Credential <PSCredential>]
    [<CommonParameters>]

FromManagementPackClass

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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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

-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.

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:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

FromTaskDisplayName
Position:1
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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.

Propriétés du paramètre

Type:

Guid[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

FromTaskId
Position:Named
Obligatoire:True
Valeur du pipeline:True
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 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.

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

FromInstance
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

ManagementPack[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

FromManagementPack
Position:1
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants: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.

Propriétés du paramètre

Type:

String[]

Valeur par défaut:None
Prend en charge les caractères génériques:True
DontShow:False

Jeux de paramètres

FromTaskName
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-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».

Propriétés du paramètre

Type:

Connection[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

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

-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.

Propriétés du paramètre

Type:

ManagementPackClass[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

FromManagementPackClass
Position:Named
Obligatoire:False
Valeur du pipeline:True
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.