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 cmdlet Set-SCExternalJob atualiza trabalhos externos existentes no VMM (Virtual Machine Manager). Você pode atualizar a porcentagem concluída do trabalho ou definir o status do trabalho como concluído ou com falha.

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

Exemplos

Exemplo 1: Definir um trabalho externo como 15% concluído

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

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

O segundo comando define o valor de progresso do trabalho armazenado em $ExternalJob como 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 obtém o objeto de trabalho externo chamado ExternalJob02 e armazena o objeto na variável $ExternalJob.

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

Exemplo 3: Definir um trabalho externo como falha

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 obtém o objeto de trabalho externo chamado ExternalJob03 e armazena o objeto na variável $ExternalJob.

O segundo comando define o status do trabalho armazenado em $ExternalJob com falha e adiciona informações sobre o trabalho.

Parâmetros

-Completed

Define o status de um trabalho externo a ser concluído.

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

-Failed

Define o status de um trabalho externo como com falha.

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

-InfoMessage

Fornece uma mensagem informativa para trabalhos externos.

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

-Job

Especifica um objeto de trabalho do VMM.

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

-ProgressValue

Fornece a porcentagem 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 retorna um objeto Task .