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 mindestens ein VMM-Auftragsobjekt (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 auszuführen. Sie können Auftragsobjekte basierend auf angegebenen Kriterien abrufen.
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-SCJob -RunningMit diesem Befehl werden alle ausgeführten Aufträge abgerufen.
Beispiel 2: Abrufen aller fehlgeschlagenen Aufträge
PS C:\> $VMMJobs = Get-SCJob | where { $_.Status -eq "Failed" } | Format-List -Property Name, ID, Status
PS C:\> $VMMJobsDer 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 variablen $VMMJobs speichert.
Mit dem zweiten Befehl werden die informationen angezeigt, die in $VMMJobs für den Benutzer gespeichert sind (in diesem Fall ist das 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-MemberDieser Befehl verwendet das Cmdlet Get-Member, um den .NET-Typ, die 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.
Beispielsweise ruft der Befehl Get-SCVirtualDiskDrive -All alle Objekte des virtuellen Datenträgerlaufwerks ab, unabhängig vom Objekt des virtuellen Computers oder des Vorlagenobjekts, dem jedes objekt des virtuellen Datenträgerlaufwerks zugeordnet ist.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Full
Gibt an, dass das Cmdlet das Auftragsobjekt mit einem Überwachungsdatensatz zurückgibt.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-ID
Gibt den numerischen Bezeichner als global eindeutigen Bezeichner oder GUID für ein bestimmtes Objekt an.
| Typ: | Guid |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Job
Gibt ein VMM-Auftragsobjekt an.
| Typ: | Task |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Name
Gibt den Namen eines VMM-Objekts an.
| Typ: | String |
| Position: | 0 |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Newest
Gibt alle Aufträge zurück, die in der letzten angegebenen Anzahl von Stunden erstellt wurden, oder gibt die angegebene Anzahl der letzten Softwareupdates zurück.
Beispielformat zum Zurückgeben aller Aufträge, die in den letzten 48 Stunden erstellt wurden: Get-SCJob -Newest 48
| Typ: | Int32 |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OnBehalfOfUser
Gibt einen Benutzernamen an. Dieses Cmdlet wird im Auftrag des Benutzers ausgeführt, den dieser Parameter angibt.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-OnBehalfOfUserRole
Gibt eine Benutzerrolle an. Verwenden Sie zum Abrufen einer Benutzerrolle das cmdlet Get-SCUserRole. Dieses Cmdlet wird im Auftrag der Benutzerrolle ausgeführt, die dieser Parameter angibt.
| Typ: | UserRole |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Running
Gibt an, dass alle ausgeführten Aufträge zurückgegeben werden.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | True |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-VMMServer
Gibt ein VMM-Serverobjekt an.
| Typ: | ServerConnection |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | True |
| Platzhalterzeichen akzeptieren: | False |
Ausgaben
Job
Dieses Cmdlet gibt ein Job-Objekt zurück.