Get-SCJob

获取 VMM 作业对象。

语法

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

说明

Get-SCJob cmdlet 获取 VMM 服务器上的一个或多个 Virtual Machine Manager (VMM) 作业对象。 作业是按顺序执行的一系列步骤,用于在 VMM 环境中完成操作。 您可以按照指定标准来检索作业对象。

在 VMM 中,可以将一系列作业分组并将它们作为一组运行。 例如,VMM 中的复杂操作(例如创建模板)可能会合并一系列作业,称为作业组。 有关演示如何使用作业组的示例,请参阅以下 cmdlet:New-SCVMTemplate、New-SCHardwareProfile、New-SCVirtualDiskDrive、New-SCVirtualDVDDrive、New-SCVirtualMachine 和 Set-SCVirtualCOMPort。

示例

示例 1:获取所有正在运行的作业

PS C:\> Get-Job -Running

此命令检索所有正在运行的作业。

示例 2:获取所有失败的作业

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

第一个命令获取状态为 Failed 的所有作业对象,然后使用管道运算符将每个对象传递给 Format-List cmdlet,该 cmdlet 将名称、ID 和 Status 存储在$VMMJobs变量中。

第二个命令显示存储在用户$VMMJobs中的信息,在本例中为用户 (,即每个正在运行的作业的名称、ID 和状态) 。

示例 3:获取有关 VMM 作业对象的 .NET 类型、方法和属性的信息

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

此命令使用 Get-Member cmdlet 显示 Get-SCJob 的 .NET 类型、属性、方法和事件。

参数

-All

指示此 cmdlet 获取与父对象无关的所有从属对象。 例如,该命令 Get-SCVirtualDiskDrive -All 获取所有虚拟磁盘驱动器对象,而不考虑每个虚拟磁盘驱动器对象关联的虚拟机对象或模板对象。

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

-Full

指示 cmdlet 返回具有审核记录的作业对象。

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

-ID

将数字标识符指定为特定对象的全局唯一标识符或 GUID。

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

-Job

指定一个 VMM 作业对象。

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

-Name

指定 VMM 对象的名称。

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

-Newest

返回在最近指定的小时数中创建的所有作业,或返回指定的最新软件更新数。

返回过去 48 小时内创建的所有作业的示例格式: Get-SCJob -Newest 48

返回 10 个最新更新的示例格式: Get-SCUpdate -Newest 10

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

-OnBehalfOfUser

指定用户名。 此 cmdlet 代表此参数指定的用户运行。

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

-OnBehalfOfUserRole

指定用户角色。 若要获取用户角色,请使用 Get-SCUserRole cmdlet。 此 cmdlet 代表此参数指定的用户角色运行。

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

-Running

指示返回所有正在运行的作业。

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

-VMMServer

指定VMM 服务器对象。

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

输出

Job

此 cmdlet 返回 Job 对象。