Bagikan melalui

Set-SCExternalJob

  • Referensi
Modul:
VirtualMachineManager

Updates pekerjaan eksternal yang sudah ada.

Sintaks

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

Deskripsi

Cmdlet Set-SCExternalJob memperbarui pekerjaan eksternal yang ada di Virtual Machine Manager (VMM). Anda dapat memperbarui persentase penyelesaian pekerjaan, atau mengatur status pekerjaan menjadi selesai atau gagal.

Untuk informasi selengkapnya tentang pekerjaan eksternal, lihat cmdlet New-SCExternalJob .

Contoh

Contoh 1: Atur pekerjaan eksternal ke 15% selesai

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

Perintah pertama mendapatkan objek pekerjaan eksternal bernama ExternalJob01 dan menyimpan objek dalam variabel $ExternalJob.

Perintah kedua menetapkan nilai kemajuan untuk pekerjaan yang disimpan di $ExternalJob menjadi 15.

Contoh 2: Mengatur pekerjaan eksternal ke selesai

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

Perintah pertama mendapatkan objek pekerjaan eksternal bernama ExternalJob02 dan menyimpan objek dalam variabel $ExternalJob.

Perintah kedua mengatur status pekerjaan yang disimpan di $ExternalJob selesai, dan menambahkan informasi tentang pekerjaan.

Contoh 3: Mengatur pekerjaan eksternal ke gagal

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

Perintah pertama mendapatkan objek pekerjaan eksternal bernama ExternalJob03 dan menyimpan objek dalam variabel $ExternalJob.

Perintah kedua mengatur status pekerjaan yang disimpan di $ExternalJob gagal, dan menambahkan informasi tentang pekerjaan.

Parameter

-Completed

Mengatur status pekerjaan eksternal yang akan diselesaikan.

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

-Failed

Mengatur status pekerjaan eksternal menjadi gagal.

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

-InfoMessage

Menyediakan pesan informasi untuk pekerjaan eksternal.

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

-Job

Menentukan objek pekerjaan VMM.

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

-ProgressValue

Memasok persentase penyelesaian kemajuan pekerjaan eksternal.

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

Output

Task

Cmdlet ini mengembalikan objek Tugas .