Vprotect：Hyper-V 備份失敗，並顯示 （匯出） 內部伺服器錯誤

Summary: Hyper-V 備份失敗，並顯示 vProtect 錯誤「ExternalAPIException：內部伺服器錯誤」

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Symptoms

備份失敗，並顯示 "ExternalAPIException: Internal Server Error"

檢查節點記錄中是否有如下所示的錯誤：

[2024-04-10 20:24:18.531] ERROR [pool-5-thread-6] HypervRequestSender.send:43
[e4b640a5-7784-4195-a909-6294d3763d0f] ApiException, code 500

[2024-04-10 20:24:18.531] ERROR [pool-5-thread-6] ExportTask.run:135
[e4b640a5-7784-4195-a909-6294d3763d0f] Backup task failed:

com.dell.vprotect.engine.exception.ExternalAPIException: Internal Server Error
        at com.dell.vprotect.engine.hypervisor.hyperv.HypervRequestSender.send(HypervRequestSender.java:48) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.HypervApi.createAndUploadRctMap(HypervApi.java:283) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.vmexport.DdBoostExport.createAndUploadRctMapToDdBoostAndUpdateBackupFiles(DdBoost
Export.java:221) ~[engine.jar:?]
        at com.dell.vprotect.engine.hypervisor.hyperv.vmexport.DdBoostExport.lambda$exportIncremental$6(DdBoostExport.java:163) ~[engin
e.jar:?]


檢查 Hyper-V vProtect 代理程式記錄，錯誤會類似： 

2024/04/10 20:27:06.761 [e4b640a5-7784-4195-a909-6294d3763d0f] Microsoft.Management.Infrastructure.CimException: The WS-Management service cannot process the request. The computed response packet size (585610) exceeds the maximum envelope size that is allowed (512000).
   at Microsoft.Management.Infrastructure.Internal.Operations.CimSyncEnumeratorBase`1.MoveNext()
   at System.Linq.Enumerable.SingleOrDefault[TSource](IEnumerable`1 source)
   at Microsoft.Management.Infrastructure.CimSession.InvokeMethod(String namespaceName, CimInstance instance, String methodName, CimMethodParametersCollection methodParameters, CimOperationOptions options)

Cause

預設大小 WSMan:\localhost\MaxEnvelopeSizeKb 為 500（千位元組），即 512,000 位元組。

如果代理程式嘗試透過 DDboost 比此，將引發異常。

Resolution

存取託管虛擬機器的 Hypervisor，該虛擬機器具有失敗的備份。
檢查大小 WSMan:\localhost\MaxEnvelopeSizeKb （搭配 PowerShell 擔任系統管理員）

PS C:\Users\Administrator> Get-Item -Path WSMan:\localhost\MaxEnvelopeSizeKb


   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost

Type            Name                           SourceOfValue   Value
----            ----                           -------------   -----
System.String   MaxEnvelopeSizekb                              500


PS C:\Users\Administrator>


將值從預設的 500 增加到大於要傳送的位元組數的值 

PS C:\Users\Administrator> Set-Item -Path WSMan:\localhost\MaxEnvelopeSizeKb 600
PS C:\Users\Administrator> Get-Item -Path WSMan:\localhost\MaxEnvelopeSizeKb


   WSManConfig: Microsoft.WSMan.Management\WSMan::localhost

Type            Name                           SourceOfValue   Value
----            ----                           -------------   -----
System.String   MaxEnvelopeSizekb                              600


PS C:\Users\Administrator>


重新執行備份

Affected Products

vProtect
Article Properties
Article Number: 000224451
Article Type: Solution
Last Modified: 04 May 2026
Version:  3
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.