Set-SCExternalJob

  • Referência
Módulo:
VirtualMachineManager

Atualizações um trabalho externo existente.

Syntax

Set-SCExternalJob
   [-Job] <Task>
   -ProgressValue <Int32>
   [<CommonParameters>]
Set-SCExternalJob
   [-Job] <Task>
   [-Completed]
   [-InfoMessage <String>]
   [<CommonParameters>]
Set-SCExternalJob
   [-Job] <Task>
   [-Failed]
   -InfoMessage <String>
   [<CommonParameters>]

Description

O Set-SCExternalJob cmdlet atualiza os empregos externos existentes no Virtual Machine Manager (VMM). Pode atualizar a percentagem completa do trabalho ou definir o estado do trabalho para concluído ou falhado.

Para obter mais informações sobre empregos externos, consulte o cmdlet New-SCExternalJob .

Exemplos

Exemplo 1: Definir um trabalho externo para 15% completo

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob01"
PS C:\> Set-SCExternalJob -Job $ExternalJob -ProgressValue 15

O primeiro comando recebe o objeto de trabalho externo chamado ExternalJob01 e armazena o objeto na variável $ExternalJob.

O segundo comando define o valor de progresso para o trabalho armazenado em $ExternalJob a 15.

Exemplo 2: Definir um trabalho externo para ser concluído

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob02"
PS C:\> Set-SCExternalJob -Job $ExternalJob -Completed -InfoMessage "Some information about the completed job"

O primeiro comando recebe o objeto de trabalho externo chamado ExternalJob02 e armazena o objeto na variável $ExternalJob.

O segundo comando define o estado do trabalho armazenado em $ExternalJob a ser concluído, e adiciona informações sobre o trabalho.

Exemplo 3: Definir um trabalho externo para falhar

PS C:\> $ExternalJob = Get-SCJob -Name "ExternalJob03"
PS C:\> Set-SCExternalJob -Job $ExternalJob -Failed -InfoMessage "An error message for the failed job"

O primeiro comando recebe o objeto de trabalho externo chamado ExternalJob03 e armazena o objeto na variável $ExternalJob.

O segundo comando define o estado do trabalho armazenado em $ExternalJob falhar, e adiciona informações sobre o trabalho.

Parâmetros

-Completed

Define o estado de um trabalho externo para ser concluído.

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

-Failed

Define o estatuto de um trabalho externo para falhar.

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

-InfoMessage

Fornece uma mensagem informativa para empregos externos.

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

-Job

Especifica um objeto de trabalho VMM.

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

-ProgressValue

Fornece a percentagem completa do progresso de um trabalho externo.

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

Saídas

Task

Este cmdlet devolve um objeto De tarefa .