Compartilhar 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 VMM (Virtual Machine Manager). Você pode atualizar a porcentagem concluída do trabalho ou definir o status do trabalho para 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 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 com falha e adiciona informações sobre o trabalho.

Parâmetros

-Completed

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

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Failed

Define o status de um trabalho externo com falha.

Tipo:SwitchParameter
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-InfoMessage

Fornece uma mensagem informativa para trabalhos externos.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Job

Especifica um objeto de trabalho do VMM.

Tipo:Task
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ProgressValue

Fornece o percentual de conclusão do progresso de um trabalho externo.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

Task

Esse cmdlet retorna um objeto Task.