Partager via

Get-SCJob

  • Référence
Module:
VirtualMachineManager

Obtient les objets de travail VMM.

Syntaxe

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 VMM (Virtual Machine Manager) sur le serveur VMM. Un travail est une série d’étapes qui sont effectuées de manière séquentielle pour effectuer une action dans l’environnement VMM. Vous pouvez récupérer des objets de travail en fonction de critères spécifiés.

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 comment utiliser des 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-SCJob -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 passer 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, il s’agit du nom, de l’ID et de 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 .NET 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épendamment 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 de modèle auquel chaque objet de lecteur de disque virtuel est associé.

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

-Full

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

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

-ID

Spécifie l’identificateur numérique en tant qu’identificateur global unique, ou GUID, pour un objet spécifique.

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

-Job

Spécifie un objet de travail VMM.

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

-Name

Spécifie le nom d’un objet VMM.

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

-Newest

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

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

Type:Int32
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques: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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-OnBehalfOfUserRole

Spécifie un rôle d’utilisateur. Pour obtenir un rôle d’utilisateur, utilisez la cmdlet 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
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Running

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

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

-VMMServer

Spécifie un objet serveur VMM.

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

Sorties

Job

Cette applet de commande retourne un objet Job.