Share via

Set-SCExternalJob

  • Riferimento
Modulo:
VirtualMachineManager

Aggiornamenti un processo esterno esistente.

Sintassi

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

Descrizione

Il cmdlet Set-SCExternalJob aggiorna i processi esterni esistenti in Virtual Machine Manager (VMM). È possibile aggiornare la percentuale completa del processo o impostare lo stato del processo su completato o non riuscito.

Per altre informazioni sui processi esterni, vedere il cmdlet New-SCExternalJob .

Esempio

Esempio 1: Impostare un processo esterno su 15% completato

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

Il primo comando ottiene l'oggetto processo esterno denominato ExternalJob01 e archivia l'oggetto nella variabile $ExternalJob.

Il secondo comando imposta il valore di stato per il processo archiviato in $ExternalJob su 15.

Esempio 2: Impostare un processo esterno su completato

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

Il primo comando ottiene l'oggetto processo esterno denominato ExternalJob02 e archivia l'oggetto nella variabile $ExternalJob.

Il secondo comando imposta lo stato del processo archiviato in $ExternalJob da completare e aggiunge informazioni sul processo.

Esempio 3: Impostare un processo esterno su non riuscito

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

Il primo comando ottiene l'oggetto processo esterno denominato ExternalJob03 e archivia l'oggetto nella variabile $ExternalJob.

Il secondo comando imposta lo stato del processo archiviato in $ExternalJob non riuscito e aggiunge informazioni sul processo.

Parametri

-Completed

Imposta lo stato di un processo esterno da completare.

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

-Failed

Imposta lo stato di un processo esterno su non riuscito.

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

-InfoMessage

Fornisce un messaggio informativo per i processi esterni.

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

-Job

Specifica un oggetto processo VMM.

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

-ProgressValue

Fornisce la percentuale completa dello stato di avanzamento di un processo esterno.

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

Output

Task

Questo cmdlet restituisce un oggetto Task .