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.