---
title: "Add-VBRAdvancedLatencyOptions"
description: "Defines latency settings for a specific datastore. Product Edition: Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This creates the VBRAdvancedLatencyOptions object that defines latency settings for a spec"
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/add-vbradvancedlatencyoptions.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Veeam Backup & Replication Settings > Specifying I/O Control Settings > Add-VBRAdvancedLatencyOptions"
dateModified: "2026-08-19"
---

# Add-VBRAdvancedLatencyOptions

## Short Description
Defines latency settings for a specific datastore.

**Product Edition**: Enterprise Plus, Veeam Universal License

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>Vi</code></p>

```
Add-VBRAdvancedLatencyOptions -ViDatastore <VBRViDatastore> [-LatencyLimitMs <Int32>]
 [-ThrottlingIOLimitMs <Int32>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Hv</code></p>

```
Add-VBRAdvancedLatencyOptions -HvVolume <VBRHvServerVolumeObject> [-LatencyLimitMs <Int32>]
 [-ThrottlingIOLimitMs <Int32>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This creates the `VBRAdvancedLatencyOptions` object that defines latency settings for a specific datastore.

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">HvVolume</span></p>
        </td>
        <td>
          <p>Specifies the following types of datastores:</p><ul><li>Microsoft Hyper-V</li><li>Microsoft SMB3 servers</li></ul><p>The cmdlet will define latency settings for these datastores.</p><p>Accepts the <code>VBRHvServerVolumeObject</code> object. To get this object, run the <a href="get-vbrhvservervolume.md"><code>Get-VBRHvServerVolume</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRHvServerVolumeObject</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">LatencyLimitMs</span></p>
        </td>
        <td>
          <p>Specifies the I/O latency limit at which Veeam Backup & Replication will not assign new tasks that are targeted at the datastore.</p><p>Default: 20 ms.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ThrottlingIOLimitMs</span></p>
        </td>
        <td>
          <p>Specifies the I/O latency speed limit. When Veeam Backup & Replication reaches this limit, it will decrease the speed at which it either gets data from a datastore or writes data to it.</p><p>Default: 30 ms.</p>
        </td>
        <td style="width:10%;">
          <p><code>Int32</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ViDatastore</span></p>
        </td>
        <td>
          <p>Specifies the VMware datastores. The cmdlet will define latency settings for these datastores.</p><p>Accepts the <code>VBRViDatastore</code> object. To get this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDatastore</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the `VBRAdvancedLatencyOptions` object that defines latency settings for a specific datastore.

## Examples

::: example
### Example 1. Defining Latency Settings for VMware Datastore

This example shows how to set the I/O latency limit of new tasks that are targeted at the VMware datastore to `50 ms`.

```
$server = Get-VBRServer -Name esx06.tech.local
$datastore = Find-VBRViDatastore -Server $server
Add-VBRAdvancedLatencyOptions -ViDatastore $datastore -LatencyLimitMs 50
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$datastore` variable.
3. Run the `Add-VBRAdvancedLatencyOptions` cmdlet. Set the `$datastore` variable as the `ViDatastore` parameter value. Specify the `LatencyLimitMs` parameter value.

:::

::: example
### Example 2. Defining Latency Settings for Hyper-V Datastores

This example shows how to set the I/O latency speed limit to `40 ms` for The Hyper-V datastore.

```
$server = Get-VBRServer -Name hyperv09.tech.local
$volume = Get-VBRHvServerVolume -Server $server
Add-VBRAdvancedLatencyOptions -HvVolume $volume -ThrottlingIOLimitMs 40
```

Perform the following steps:

1. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
2. Run the [`Get-VBRHvServerVolume`](get-vbrhvservervolume.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Save the result to the `$volume` variable.
3. Run the `Add-VBRAdvancedLatencyOptions` cmdlet. Set the `$volume` variable as the `HvVolume` parameter value. Specify the `ThrottlingIOLimitMs` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Find-VBRViDatastore`](find-vbrvidatastore.md)
- [`Get-VBRHvServerVolume`](get-vbrhvservervolume.md)