Compartilhar 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 VMM (Virtual Machine Manager) no servidor do 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 nos 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, conhecida como um grupo de trabalhos. Para obter exemplos que demonstram como usar grupos de trabalho, 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

Esse 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 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 (nesse caso, esse é o nome, a ID e o Status de cada trabalho em execução).

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

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

Esse 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 independentemente 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
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Full

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-ID

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

Tipo:Guid
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Job

Especifica um objeto de trabalho do VMM.

Tipo:Task
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Name

Especifica o nome de um objeto do VMM.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga: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.

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

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUser

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

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-OnBehalfOfUserRole

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

Tipo:UserRole
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Running

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-VMMServer

Especifica um objeto de servidor do VMM.

Tipo:ServerConnection
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Saídas

Job

Esse cmdlet retorna um objeto job .