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 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 einem 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 Variable speichert.
Der zweite Befehl zeigt die in $VMMJobs gespeicherten Informationen für den Benutzer an (in diesem Fall ist der Name, die ID und der Status jedes ausgeführten Auftrags).
Beispiel 3: Abrufen von Informationen über den .NET-Typ, Methoden und Eigenschaften von VMM-Auftragsobjekten
PS C:\> Get-SCJob | Get-Member
Dieser 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.
Der Befehl Get-SCVirtualDiskDrive -All
ruft beispielsweise alle virtuellen Datenträgerlaufwerkobjekte unabhängig von dem virtuellen Computerobjekt oder vorlagenobjekt ab, 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, um die 10 neuesten Updates zurückzugeben: 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 Auftrag 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. Verwenden Sie zum Abrufen einer Benutzerrolle das Cmdlet Get-SCUserRole . Dieses Cmdlet wird im Auftrag 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.