Azure Agent cannot restore file from a backup

Hello Focagem Soluções de Gestão,

Thank you for posting your query on Microsoft Q&A platform.

Could you please share us the details asked via private message and screenshot of the exact error message.

Thanks,

Suchitra.

Hello Focagem Soluções de Gestão,

While attempting to restore files via Azure Backup (File and Folders) using the Azure Recovery Services (MARS) Agent you are experiencing below issues:

• The restore disk took a long time to mount.
• Once mounted, couldn’t access it.
• Browsing the disk resulted in an “invalid parameters” error.
• You have already updated the Azure Agent to the latest version.

I would suggest you to try again below few of the workarounds that has worked and helped others facing the same issue.

1. Install MARS Agent Version 9415 or Later
   • Download the latest version directly from Microsoft: https://aka.ms/azurebackup_agent
   • Or follow the official guide: Install MARS Agent via PowerShell
2. Re-register the Server with Fresh Vault Credentials
   • Go to your Recovery Services vault.
   • Download a new vault credentials file.
   • Open the Azure Backup Agent console and re-register the server using the new credentials.
3. Verify Scratch Folder Space
   • Ensure the scratch folder has at least 5–10% free volume space.
   • Lack of space can prevent proper disk mounting and access.
4. Exclude Antivirus Interference
   • Disable real-time antivirus scanning for:
   • cbengine.exe
   • Azure Backup folders
   • Scratch folder location
5. Enable TLS 1.2 and .NET Framework 4.5.2 or Later
   • These are required for proper agent operation.
6. Registry Fix (if restoring SQL or VM snapshots) Add the following registry key:

      [HKEY_LOCAL_MACHINE\SOFTWARE\MICROSOFT\BCDRAGENT]
      "USEVSSCOPYBACKUP"="TRUE"
   

   If this solution doesn’t resolve your issue, please reply with the following details to help investigate further:

• Are you restoring from a Recovery Services Vault or Azure Backup Server?
• Is the restore point online or offline?
• What is the exact version of the Azure Agent installed?
• Are you restoring files/folders, VMs, or SQL databases?
• Have you checked the scratch folder space and antivirus exclusions?
• Any event log entries or error codes beyond “invalid parameters”?

Thanks,

Suchitra.

Hello Focagem Soluções de Gestão

This indicates a timeout during a recovery job. Here’s how you can troubleshoot and resolve it.

To increase the recovery timeout for Azure Backup (especially when restoring large files or volumes), you need to adjust the configuration on the machine running the Microsoft Azure Recovery Services (MARS) agent. By default, the recovery mount session times out after 6 hours, which can cause failures for large restores.

Steps to Increase Recovery Timeout

1. Open Registry Editor
   • Press Win + R, type regedit, and hit Enter.
   1. Navigate to the Key

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Azure Backup\Config\CloudBackupProvider

3. Create or Modify the Value

Look for RecoveryJobTimeOut (Type: DWORD).

If it doesn’t exist, create a new DWORD value named

Set its value to the number of hours you want the recovery session to last (e.g., 12 for 12 hours).

Restart the Azure Backup Service

After updating the registry, restart the Microsoft Azure Recovery Services Agent service or reboot the machine.

If the restore still fails after increasing timeout, consider:

• Splitting the restore into smaller chunks.
• Using Instant Restore capability for faster recovery (retains snapshots locally for quick access).

Alternatively you can also try with powershell script which is mentioned below.

# Define registry path and value
$RegPath = "HKLM:\SOFTWARE\Microsoft\Windows Azure Backup\Config\CloudBackupProvider"
$ValueName = "RecoveryJobTimeOut"
$NewTimeoutHours = 12  # Change this to desired timeout in hours

# Check if the registry path exists
if (-not (Test-Path $RegPath)) {
    Write-Host "Registry path does not exist. Creating..."
    New-Item -Path $RegPath -Force | Out-Null
}

# Set or create the DWORD value
if (Get-ItemProperty -Path $RegPath -Name $ValueName -ErrorAction SilentlyContinue) {
    Write-Host "Updating existing RecoveryJobTimeOut value to $NewTimeoutHours hours..."
    Set-ItemProperty -Path $RegPath -Name $ValueName -Value $NewTimeoutHours
} else {
    Write-Host "Creating RecoveryJobTimeOut value and setting it to $NewTimeoutHours hours..."
    New-ItemProperty -Path $RegPath -Name $ValueName -PropertyType DWORD -Value $NewTimeoutHours
}

# Restart Azure Backup Service
Write-Host "Restarting Microsoft Azure Recovery Services Agent..."
Restart-Service -Name "AzureBackupAgent" -Force

Write-Host "Recovery timeout updated successfully to $NewTimeoutHours hours."
``

Try and let us know if you have further questions!!

Thanks. 

Hello Focagem Soluções de Gestão

Kindly let us know if the solution provided worked for you. If you need any further assistance, please feel free to reach out.

Thanks,

Suchitra.