Delen via

Get-SCJob

  • Referentie
Module:
VirtualMachineManager

Hiermee worden VMM-taakobjecten opgehaald.

Syntaxis

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

De cmdlet Get-SCJob haalt een of meer VMM-taakobjecten (Virtual Machine Manager) op de VMM-server op. Een taak is een reeks stappen die opeenvolgend worden uitgevoerd om een actie in de VMM-omgeving te voltooien. U kunt taakobjecten ophalen op basis van opgegeven criteria.

In VMM kunt u een reeks taken groeperen en deze als een set uitvoeren. Een complexe actie in VMM, zoals het maken van een sjabloon, kan bijvoorbeeld een reeks taken bevatten, ook wel een taakgroep genoemd. Zie de volgende cmdlets: New-SCVMTemplate, New-SCHardwareProfile, New-SCVirtualDiskDrive, New-SCVirtualDISKDrive, New-SCVirtual DEMONSTRERENDrive, New-SCVirtualMachine en Set-SCVirtualCOMPort.

Voorbeelden

Voorbeeld 1: Alle actieve taken ophalen

PS C:\> Get-SCJob -Running

Met deze opdracht worden alle actieve taken opgehaald.

Voorbeeld 2: Alle mislukte taken ophalen

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

Met de eerste opdracht worden alle taakobjecten met de status Mislukt opgehaald en wordt vervolgens de pijplijnoperator gebruikt om elk object door te geven aan de Format-List-cmdlet, waarin de naam, id en status worden opgeslagen in de variabele $VMMJobs.

Met de tweede opdracht worden de gegevens weergegeven die zijn opgeslagen in $VMMJobs aan de gebruiker (in dit geval de naam, id en status van elke actieve taak).

Voorbeeld 3: Informatie ophalen over het .NET-type, de methoden en eigenschappen van VMM-taakobjecten

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

Met deze opdracht wordt de cmdlet Get-Member gebruikt om het .NET-type, de eigenschappen, methoden en gebeurtenissen voor Get-SCJob-weer te geven.

Parameters

-All

Geeft aan dat met deze cmdlet alle onderliggende objecten onafhankelijk van het bovenliggende object worden opgehaald. Met de opdracht Get-SCVirtualDiskDrive -All bijvoorbeeld alle virtuele-schijfstationobjecten ophaalt, ongeacht het virtuele-machineobject of sjabloonobject waaraan elk object van het virtuele schijfstation is gekoppeld.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Full

Geeft aan dat de cmdlet het taakobject retourneert met een controlerecord.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-ID

Hiermee geeft u de numerieke id op als een globaal unieke id of GUID voor een specifiek object.

Type:Guid
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Job

Hiermee geeft u een VMM-taakobject op.

Type:Task
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Name

Hiermee geeft u de naam van een VMM-object.

Type:String
Position:0
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Newest

Retourneert alle taken die zijn gemaakt in het laatst opgegeven aantal uren of retourneert het opgegeven aantal meest recente software-updates.

Voorbeeldindeling voor het retourneren van alle taken die in de afgelopen 48 uur zijn gemaakt: Get-SCJob -Newest 48

Type:Int32
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die deze parameter opgeeft.

Type:String
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-OnBehalfOfUserRole

Hiermee geeft u een gebruikersrol op. Gebruik de cmdlet Get-SCUserRole om een gebruikersrol te verkrijgen. Deze cmdlet werkt namens de gebruikersrol die met deze parameter wordt opgegeven.

Type:UserRole
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-Running

Geeft aan dat alle actieve taken worden geretourneerd.

Type:SwitchParameter
Position:Named
Default value:None
Vereist:True
Pijplijninvoer accepteren:False
Jokertekens accepteren:False

-VMMServer

Hiermee geeft u een VMM-serverobject.

Type:ServerConnection
Position:Named
Default value:None
Vereist:False
Pijplijninvoer accepteren:True
Jokertekens accepteren:False

Uitvoerwaarden

Job

Met deze cmdlet wordt een -object geretourneerd.