Partilhar via


Get-SCJob

Obtém objetos de trabalho do VMM.

Sintaxe

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

O cmdlet Get-SCJob obtém um ou mais objetos de trabalho do Virtual Machine Manager (VMM) no servidor VMM. Um trabalho é uma série de etapas executadas sequencialmente para concluir uma ação no ambiente do VMM. Você pode recuperar objetos de trabalho com base em critérios especificados.

No VMM, você pode agrupar uma série de trabalhos e executá-los juntos como um conjunto. Por exemplo, uma ação complexa no VMM, como a criação de um modelo, pode incorporar uma série de trabalhos, conhecidos como grupo de trabalhos. Para obter exemplos que demonstram como usar grupos de tarefas, consulte os seguintes cmdlets: New-SCVMTemplate, New-SCHardwareProfile, New-SCVirtualDiskDrive, New-SCVirtualDVDDrive, New-SCVirtualMachine e Set-SCVirtualCOMPort.

Exemplos

Exemplo 1: Obter todos os trabalhos em execução

PS C:\> Get-SCJob -Running

Este comando recupera todos os trabalhos em execução.

Exemplo 2: Obter todos os trabalhos com falha

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

O primeiro comando obtém todos os objetos de trabalho com um status de Falha e, em seguida, usa o operador de pipeline para passar cada objeto para o cmdlet Format-List, que armazena o nome, a ID e o Status na variável $VMMJobs.

O segundo comando exibe as informações armazenadas em $VMMJobs para o usuário (neste caso, que é o nome, ID e Status de cada trabalho em execução).

Exemplo 3: Obter informações sobre o tipo, métodos e propriedades do .NET de objetos de trabalho do VMM

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

Este comando usa o cmdlet Get-Member para exibir o tipo .NET, propriedades, métodos e eventos para Get-SCJob.

Parâmetros

-All

Indica que esse cmdlet obtém todos os objetos subordinados independentes do objeto pai. Por exemplo, o comando Get-SCVirtualDiskDrive -All obtém todos os objetos de unidade de disco virtual, independentemente do objeto de máquina virtual ou objeto de modelo ao qual cada objeto de unidade de disco virtual está associado.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Full

Indica que o cmdlet retorna o objeto de trabalho com um registro de auditoria.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-ID

Especifica o identificador numérico como um identificador global exclusivo, ou GUID, para um objeto específico.

Tipo:Guid
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Job

Especifica um objeto de trabalho do VMM.

Tipo:Task
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Position:0
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Newest

Retorna todos os trabalhos criados no último número especificado de horas ou retorna o número especificado de atualizações de software mais recentes.

Exemplo de formato para retornar todos os trabalhos criados nas últimas 48 horas: Get-SCJob -Newest 48

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUser

Especifica um nome de usuário. Este cmdlet opera em nome do usuário especificado por esse parâmetro.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-OnBehalfOfUserRole

Especifica uma função de usuário. Para obter uma função de usuário, use o cmdlet Get-SCUserRole. Este cmdlet opera em nome da função de usuário especificada por esse parâmetro.

Tipo:UserRole
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Running

Indica que todos os trabalhos em execução são retornados.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-VMMServer

Especifica um objeto de servidor VMM.

Tipo:ServerConnection
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Saídas

Job

Este cmdlet retorna um objeto Job.