---
title: "Publish-VBRBackupContent"
description: "Publishes disks from a backup or replica using the iSCSI or FUSE protocol. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet uses the iSCSI protocol when publishing the content to the Microsoft Windows-based "
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/publish-vbrbackupcontent.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Disk Publishing (Data Integration API) > Publish-VBRBackupContent"
dateModified: "2026-08-19"
---

# Publish-VBRBackupContent

## Short Description
Publishes disks from a backup or replica using the iSCSI or FUSE protocol.

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

## Syntax
```
Publish-VBRBackupContent [-RestorePoint] <COib> [-AllowedIps <String[]>] [-DiskNames <String[]>] [-RunAsync]
 [-TargetServerName <String>] [-TargetServerCredentials <CCredentials>] [-MountHostId <Guid>]
 [-Reason <String>] [-EnableFUSEProtocol] [-StorageHost <CHost>] [-ResourcePool <CViResourcePoolItem>]
 [-Folder <CViFolderItem>] [<CommonParameters>]
```

## Detailed Description
This cmdlet uses the iSCSI protocol when publishing the content to the Microsoft Windows-based host and FUSE protocol when publishing content to the Linux-based or Unix-based server. You can publish disks from backups and replicas. For the list of supported backup types, see the [Publishing Disks (Data Integration API)](https://helpcenter.veeam.com/docs/vbr/userguide/data_integration_api.html?ver=13) section in the Veeam Backup & Replication User Guide.

[For Microsoft Windows-based file systems] Depending on how you want to configure an iSCSI session, you can use one of the following mount modes:

- **Automatic** — use this mode if you want Veeam Backup & Replication to automatically configure the iSCSI initiator, start iSCSI session and allow the specified target server to access disk content. To use this option, you must specify a name (the `TargetServerName` parameter) and credentials (the `TargetServerCredentials` parameter) of the target server. For more information, see [Example 2](#example-2-publishing-disks-automatic-mode).

  ::: note

  If you want to automatically mount data to Unix-based machines, you must use the FUSE protocol (the `EnableFUSEProtocol` parameter). For more details, see Example 3.

  :::

- **Manual** — use this mode if you want to manually start an iSCSI session from any server that has access to the iSCSI Target Server (mount server). In this case, you must specify an array of IP addresses of servers that are allowed to access the iSCSI Target Server (the `AllowedIps` parameter). For more information, see [Example 1](#example-1-publishing-disks-and-giving-access-for-specific-target-server-manual-mode). 

After you started the publishing session, you can check details on this session and stop it from the PowerShell console or the Veeam Backup & Replication UI.

## 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">AllowedIps</span></p>
        </td>
        <td>
          <p>For Microsoft Windows-based file systems and the manual mount mode.</p><p>Specifies an array of IP addresses of target servers (iSCSI initiators) that are allowed to access the iSCSI Target Server (mount server).</p><p><strong>Note</strong>: This parameter is required if you do not specify the <code>TargetServerName</code> parameter. After the cmdlet finishes its work, you need to manually start the iSCSI session from any server specified in this parameter to the iSCSI Target Server.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</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">DiskNames</span></p>
        </td>
        <td>
          <p>Specifies disk names. The cmdlet will publish disks with the specified names. If you do not specify this parameter, the cmdlet will publish all disks from the backup or replica.</p>
        </td>
        <td style="width:10%;">
          <p><code>String[]</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">EnableFUSEProtocol</span></p>
        </td>
        <td>
          <p>Enables the FUSE protocol.</p><p><strong>Note</strong>: This parameter is required if you want to publish disks to a Linux-based or Unix-based server.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">Folder</span></p>
        </td>
        <td>
          <p>For restore from storage snapshots.</p><p>Specifies the folder where the temporary VM will be mounted.</p><p>If you do not specify this parameter, the cmdlet will use the default VM folder of the <code>StorageHost</code>.</p><p>Accepts the <code>CViFolderItem</code> object. To create this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViFolderItem</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">MountHostId</span></p>
        </td>
        <td>
          <p>Specifies the ID of a server that has the mount server role. The mount server acts as an intermediary between the backup repository and the target server.</p><p>If you specify the ID, the cmdlet will use the specified server as the mount server. If you do not specify the ID, the cmdlet will use the mount server associated with the backup repository where backups are stored.</p><p><strong>Note</strong>: You must add the server with this ID as the mount server to any backup repository in your backup infrastructure. For more information, see the <a href="https://helpcenter.veeam.com/docs/vbr/userguide/repository_mount_server.html?ver=13">Specify Mount Server Settings</a> section in the Veeam Backup & Replication User Guide.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</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">Reason</span></p>
        </td>
        <td>
          <p>Specifies the reason for disk publishing.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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">ResourcePool</span></p>
        </td>
        <td>
          <p>For restore from storage snapshots.</p><p>Specifies the resource pool where the temporary VM will be mounted.</p><p>If you do not specify this parameter, the cmdlet will use the default resource pool of the <code>StorageHost</code>.</p><p>Accepts the <code>CViResourcePoolItem</code> object. To create this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViResourcePoolItem</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">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies a restore point. The cmdlet will publish disks in the state stored in the specified restore point.</p><p>Accepts the <code>COib</code> object. To get this object, run the <a href="get-vbrrestorepoint.md"><code>Get-VBRRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>COib</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</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">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</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">StorageHost</span></p>
        </td>
        <td>
          <p>For restore from storage snapshots.</p><p>Specifies the ESXi host to which the storage snapshot clone will be mounted as a temporary datastore. Veeam Backup & Replication registers a temporary VM on this host and attaches the source disks to it.</p><p><strong>Note</strong>: This parameter applies only when the storage snapshot is accessed using the Direct SAN access transport mode. For other transport modes, Veeam Backup & Replicationmounts the snapshot clone to the source storage.</p><p>Accepts the <code>CHost</code> object. To create this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</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">TargetServerCredentials</span></p>
        </td>
        <td>
          <p>Specifies credentials that the cmdlet will use to authenticate against the target server.</p><p>Accepts the <code>CCredentials</code> object. To create this object, run the<a href="add-vbrcredentials.md"><code>Add-VBRCredentials</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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">TargetServerName</span></p>
        </td>
        <td>
          <p>For the automatic mount mode.</p><p>Specifies the name of the target server. The cmdlet will give the specified server access to the disk content.</p><p><strong>Note</strong>: You must specify the <code>TargetServerCredentials</code> parameter to provide credentials that Veeam Backup & Replication will use to authenticate against the target server.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</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>
    </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 `VBRBackupContent` object that contains settings of published backed-up files.

## Examples

::: example
### Example 1. Publishing Disks and Giving Access for Specific Target Server (Manual Mode)

This example shows how to allow the `198.51.100.0` server to access the content of the published disks.

```
$backup = Get-VBRBackup -Name "Webservers Backup Job"
$point = Get-VBRRestorePoint -Backup $backup -Name "Webserver03" | Sort-Object -Property CreationTime | Select -Last 1
Publish-VBRBackupContent -RestorePoint $point -AllowedIps "198.51.100.0" -RunAsync
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Specify the `Name` parameter value. Pipe the cmdlet output to the `Sort-Object` cmdlet and set the `CreationTime` value as the `Property` parameter value. Pipe the output to the `Select` cmdlet to select the last restore point. Save the result to the `$point` variable.
3. Run the `Publish-VBRBackupContent` cmdlet. Specify the following settings:

   - Set the `$point` variable as the `RestorePoint` parameter value.
   - Specify the `AllowedIps` parameter value.
   - Provide the `RunAsync` parameter.

:::

::: example
### Example 2. Publishing Disks (Automatic Mode)

This example shows how to publish disks to the `WinSrv2049` iSCSI target server.

```
$backup = Get-VBRBackup -Name "Webservers Backup Job"
$point = Get-VBRRestorePoint -Backup $backup -Name "Webserver03" | Sort-Object -Property CreationTime | Select -Last 1
$creds = Add-VBRCredentials -User "WinSrv2049\Administrator" -Password "Pa$$w0rd"
Publish-VBRBackupContent -RestorePoint $point -TargetServerName "WinSrv2049" -TargetServerCredentials $creds
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Specify the `Name` parameter value. Pipe the cmdlet output to the `Sort-Object` cmdlet and set the `CreationTime` value as the `Property` parameter value. Pipe the output to the `Select` cmdlet to select the last restore point. Save the result to the `$point` variable.
3. Run the [`Add-VBRCredentials`](add-vbrcredentials.md) cmdlet. Specify the `User` and the `Password` parameter values. Save the result to the `$creds` variable.
4. Run the `Publish-VBRBackupContent` cmdlet. Specify the following settings:

   - Set the `$point` variable as the `RestorePoint` parameter value.
   - Specify the `TargetServerName` parameter value.
   - Set the `$creds` variable as the `TargetServerCredentials` parameter value.

:::

::: example
### Example 3. Publishing Disks to Linux Server

This example shows how to publish disks to the `192.0.8.1` Linux server.

```
$backup = Get-VBRBackup -Name "LinSrv2049"
$restorepoint = Get-VBRRestorePoint -Backup $backup | Sort-Object -Property CreationTime | Select -Last 1
$creds = Get-VBRCredentials -Name "LinAdministrator"
$session = Publish-VBRBackupContent -RestorePoint $restorepoint -TargetServerName 192.0.8.1 -TargetServerCredentials $creds -EnableFUSEProtocol
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Pipe the cmdlet output to the `Sort-Object` cmdlet and set the `CreationTime` value as the `Property` parameter value. Pipe the output to the `Select` cmdlet to select the last restore point. Save the result to the `$restorepoint` variable.
3. Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$creds` variable.
4. Run the `Publish-VBRBackupContent` cmdlet. Specify the following settings:

   - Set the `$restorepoint` variable as the `RestorePoint` parameter value.
   - Specify the `TargetServerName` parameter value.
   - Set the `$creds` variable as the `TargetServerCredentials` parameter value.
   - Provide the `EnableFUSEProtocol` parameter.

:::

::: example
### Example 4. Publishing Disks and Specifying Mount Server ID

This example shows how to publish disks to the `WinSrv2049` target server and specify the mount server ID.

```
$backup = Get-VBRBackup -Name "Webservers Backup Job"
$point = Get-VBRRestorePoint -Backup $backup -Name "Webserver03" | Sort-Object -Property CreationTime | Select -Last 1
$creds = Add-VBRCredentials -User "WinSrv2049\Administrator" -Password "Pa$$w0rd"
Publish-VBRBackupContent -RestorePoint $point -TargetServerName "WinSrv2049" -TargetServerCredentials $creds -MountHostId "c3498ba3eefd4576bc0kaeb38b4e9qs5"
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Specify the `Name` parameter value. Pipe the cmdlet output to the `Sort-Object` cmdlet and set the `CreationTime` value as the `Property` parameter value. Pipe the output to the `Select` cmdlet to select the last restore point. Save the result to the `$point` variable.
3. Run the [`Add-VBRCredentials`](add-vbrcredentials.md) cmdlet. Specify the `User` parameter value. Specify the `Password` parameter value. Save the result to the `$creds` variable.
4. Run the `Publish-VBRBackupContent` cmdlet. Specify the following settings:

   - Set the `$point` variable as the `RestorePoint` parameter value.
   - Specify the `TargetServerName` parameter.
   - Set the `$creds` variable as the `TargetServerCredentials` parameter value.
   - Specify the `MountHostId` parameter.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Add-VBRCredentials`](add-vbrcredentials.md)