Partilhar via

Set-SCExternalJob

  • Referência
Módulo:
VirtualMachineManager

Atualiza um trabalho externo existente.

Sintaxe

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 Virtual Machine Manager (VMM). Você pode atualizar a porcentagem concluída do trabalho ou definir o status do trabalho como concluído ou reprovado.

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 para o trabalho armazenado no $ExternalJob para 15.

Exemplo 2: Definir um trabalho externo como 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 como 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 como falhou e adiciona informações sobre o trabalho.

Parâmetros

-Completed

Define o status de um trabalho externo como concluído.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Failed

Define o status de um trabalho externo como falha.

Tipo:SwitchParameter
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-InfoMessage

Fornece uma mensagem informativa para trabalhos externos.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Job

Especifica um objeto de trabalho do VMM.

Tipo:Task
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ProgressValue

Fornece a porcentagem concluída do progresso de um trabalho externo.

Tipo:Int32
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Saídas

Task

Este cmdlet retorna um objeto Task.