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.