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 o percentual de conclusão 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 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 com 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 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 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

Esse cmdlet retorna um objeto Task .

New-SCExternalJob