Get-SCJob

Obtient des objets de travail VMM.

Syntax

Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Full]
   [-Newest <Int32>]
   [-Job <Task>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Full]
   [-All]
   [-Job <Task>]
   [-ID <Guid>]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]
Get-SCJob
   [-VMMServer <ServerConnection>]
   [[-Name] <String>]
   [-Running]
   [-OnBehalfOfUser <String>]
   [-OnBehalfOfUserRole <UserRole>]
   [<CommonParameters>]

Description

L’applet de commande Get-SCJob obtient un ou plusieurs objets de travail Virtual Machine Manager (VMM) sur le serveur VMM. Un travail est une série d’étapes effectuées séquentiellement pour effectuer une action dans l’environnement VMM. Vous pouvez extraire des objets de traitement en fonction de critères définis.

Dans VMM, vous pouvez regrouper une série de travaux et les exécuter ensemble en tant qu’ensemble. Par exemple, une action complexe dans VMM, telle que la création d’un modèle, peut incorporer une série de travaux, appelée groupe de travaux. Pour obtenir des exemples illustrant l’utilisation de groupes de travaux, consultez les applets de commande suivantes : New-SCVMTemplate, New-SCHardwareProfile, New-SCVirtualDiskDrive, New-SCVirtualDVDDrive, New-SCVirtualMachine et Set-SCVirtualCOMPort.

Exemples

Exemple 1 : Obtenir tous les travaux en cours d’exécution

PS C:\> Get-Job -Running

Cette commande récupère tous les travaux en cours d’exécution.

Exemple 2 : Obtenir tous les travaux ayant échoué

PS C:\> $VMMJobs = Get-SCJob | where { $_.Status -eq "Failed" } | Format-List -Property Name, ID, Status
PS C:\> $VMMJobs

La première commande obtient tous les objets de travail avec l’état Failed, puis utilise l’opérateur de pipeline pour transmettre chaque objet à l’applet de commande Format-List, qui stocke le nom, l’ID et l’état dans la variable $VMMJobs.

La deuxième commande affiche les informations stockées dans $VMMJobs à l’utilisateur (dans ce cas, c’est-à-dire le nom, l’ID et l’état de chaque travail en cours d’exécution).

Exemple 3 : Obtenir des informations sur le type, les méthodes et les propriétés des objets de travail VMM

PS C:\> Get-SCJob | Get-Member

Cette commande utilise l’applet de commande Get-Member pour afficher le type, les propriétés, les méthodes et les événements .NET pour Get-SCJob.

Paramètres

-All

Indique que cette applet de commande obtient tous les objets subordonnés indépendants de l’objet parent. Par exemple, la commande Get-SCVirtualDiskDrive -All obtient tous les objets de lecteur de disque virtuel, quel que soit l’objet de machine virtuelle ou l’objet modèle auquel chaque objet de lecteur de disque virtuel est associé.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Full

Indique que l’applet de commande retourne l’objet de travail avec un enregistrement d’audit.

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

-ID

Spécifie l’identificateur numérique comme identificateur global unique ou GUID pour un objet spécifique.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Job

Spécifie un objet travail VMM.

Type:Task
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

Spécifie le nom d’un objet VMM.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Newest

Retourne tous les travaux créés dans le dernier nombre d’heures spécifié ou retourne le nombre spécifié de mises à jour logicielles les plus récentes.

Exemple de format pour renvoyer tous les travaux créés au cours des 48 dernières heures : Get-SCJob -Newest 48

Exemple de format pour retourner les 10 mises à jour les plus récentes : Get-SCUpdate -Newest 10

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUser

Spécifie un nom d'utilisateur. Cette applet de commande fonctionne pour le compte de l’utilisateur que ce paramètre spécifie.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez l’applet de commande Get-SCUserRole . Cette applet de commande fonctionne pour le compte du rôle d’utilisateur spécifié par ce paramètre.

Type:UserRole
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Running

Indique que tous les travaux en cours d’exécution sont retournés.

Type:SwitchParameter
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-VMMServer

Spécifie un objet serveur VMM.

Type:ServerConnection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

Sorties

Job

Cette applet de commande retourne un objet Job .