Get-SCJob

Ruft VMM-Auftragsobjekte ab.

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

Beschreibung

Das Cmdlet Get-SCJob ruft ein oder mehrere VMM-Auftragsobjekte (Virtual Machine Manager) auf dem VMM-Server ab. Ein Auftrag ist eine Reihe von Schritten, die sequenziell ausgeführt werden, um eine Aktion in der VMM-Umgebung abzuschließen. Auftragsobjekte können nach bestimmten Kriterien abgerufen werden.

In VMM können Sie eine Reihe von Aufträgen gruppieren und als Satz zusammen ausführen. Beispielsweise kann eine komplexe Aktion in VMM, z. B. das Erstellen einer Vorlage, eine Reihe von Aufträgen enthalten, die als Auftragsgruppe bezeichnet werden. Beispiele für die Verwendung von Auftragsgruppen finden Sie in den folgenden Cmdlets: New-SCVMTemplate, New-SCHardwareProfile, New-SCVirtualDiskDrive, New-SCVirtualDVDDrive, New-SCVirtualMachine und Set-SCVirtualCOMPort.

Beispiele

Beispiel 1: Abrufen aller ausgeführten Aufträge

PS C:\> Get-Job -Running

Dieser Befehl ruft alle ausgeführten Aufträge ab.

Beispiel 2: Abrufen aller fehlgeschlagenen Aufträge

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

Der erste Befehl ruft alle Auftragsobjekte mit dem Status "Fehlgeschlagen" ab und verwendet dann den Pipelineoperator, um jedes Objekt an das Cmdlet Format-List zu übergeben, das den Namen, die ID und den Status in der $VMMJobs Variablen speichert.

Der zweite Befehl zeigt die Informationen an, die im $VMMJobs für den Benutzer gespeichert sind (in diesem Fall ist dies der Name, die ID und der Status jedes ausgeführten Auftrags).

Beispiel 3: Abrufen von Informationen zum .NET-Typ, zu Methoden und Eigenschaften von VMM-Auftragsobjekten

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

Dieser Befehl verwendet das Cmdlet Get-Member , um den .NET-Typ, eigenschaften, Methoden und Ereignisse für Get-SCJob anzuzeigen.

Parameter

-All

Gibt an, dass dieses Cmdlet alle untergeordneten Objekte unabhängig vom übergeordneten Objekt abruft. Der Befehl Get-SCVirtualDiskDrive -All ruft beispielsweise alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes virtuelle Datenträgerlaufwerkobjekt zugeordnet ist.

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

-Full

Gibt an, dass das Cmdlet das Auftragsobjekt mit einem Überwachungsdatensatz zurückgibt.

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

-ID

Gibt den numerischen Bezeichner als global eindeutigen Bezeichner oder GUID für ein bestimmtes Objekt an.

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

-Job

Gibt ein VMM-Auftragsobjekt an.

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

-Name

Gibt den Namen eines VMM-Objekts an.

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

-Newest

Gibt alle Aufträge zurück, die in der letzten angegebenen Anzahl von Stunden erstellt wurden, oder gibt die angegebene Anzahl der neuesten Softwareupdates zurück.

Beispielformat zum Zurückgeben aller Aufträge, die in den letzten 48 Stunden erstellt wurden: Get-SCJob -Newest 48

Beispielformat zum Zurückgeben der neuesten Updates von 10: Get-SCUpdate -Newest 10

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

-OnBehalfOfUser

Gibt einen Benutzernamen an. Dieses Cmdlet wird im Namen des Benutzers ausgeführt, den dieser Parameter angibt.

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

-OnBehalfOfUserRole

Gibt eine Benutzerrolle an. Um eine Benutzerrolle abzurufen, verwenden Sie das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Namen der Benutzerrolle ausgeführt, die dieser Parameter angibt.

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

-Running

Gibt an, dass alle ausgeführten Aufträge zurückgegeben werden.

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

-VMMServer

Gibt ein VMM-Serverobjekt an.

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

Ausgaben

Job

Dieses Cmdlet gibt ein Job-Objekt zurück.