Delen via

Get-SCJob

  • Referentie
Module:
VirtualMachineManager

Hiermee haalt u VMM-taakobjecten op.

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

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-SCVirtualSHELLDrive, New-SCVirtualMachine en Set-SCVirtualCOMPort voor voorbeelden die laten zien hoe u taakgroepen gebruikt.

Voorbeelden

Voorbeeld 1: Alle actieve taken ophalen

PS C:\> Get-Job -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 worden bijvoorbeeld alle objecten van het virtuele schijfstation opgehaald, ongeacht het object van de virtuele machine of het sjabloonobject waaraan elk object van het virtuele schijfstation is gekoppeld.

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

-Full

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

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Job

Hiermee geeft u een VMM-taakobject op.

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

-Name

Hiermee geeft u de naam van een VMM-object.

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

-Newest

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

Voorbeeldindeling om alle taken te retourneren die in de afgelopen 48 uur zijn gemaakt: Get-SCJob -Newest 48

Voorbeeldindeling om de 10 nieuwste updates te retourneren: Get-SCUpdate -Newest 10

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

-OnBehalfOfUser

Hiermee geeft u een gebruikersnaam. Deze cmdlet werkt namens de gebruiker die met deze parameter wordt opgegeven.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Running

Geeft aan dat alle actieve taken worden geretourneerd.

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

-VMMServer

Hiermee geeft u een VMM-serverobject op.

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

Uitvoerwaarden

Job

Met deze cmdlet wordt een taakobject geretourneerd.