---
title: "Unpublish-VESQLDatabase"
description: "Unpublishes Microsoft SQL Server databases from the target server. Product: Veeam Backup & Replication Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet unpublishes Microsoft SQL Server databases f"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/unpublish-vesqldatabase.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft SQL Server > Unpublish-VESQLDatabase"
dateModified: "2026-08-20"
---

# Unpublish-VESQLDatabase

## Short Description
Unpublishes Microsoft SQL Server databases from the target server.

**Product**: Veeam Backup & Replication

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

## Syntax
```
Unpublish-VESQLDatabase [-Databases] <VESQLPublishedDatabase[]> [-Force] 
 [-WhatIf] [-Confirm] [<CommonParameters>]
```

## Detailed Description
This cmdlet unpublishes Microsoft SQL Server databases from the target machine with Microsoft SQL Server.

## 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">Databases</span></p>
        </td>
        <td>
          <p>Specifies the published Microsoft SQL Server databases. The cmdlet will unpublish these databases from the target server.</p><p>Accepts the <a href="vesqlpublisheddatabase.md"><code>VESQLPublishedDatabase</code></a><code>[]</code> object. To get this object, run the <a href="get-vesqlpublisheddatabase.md"><code>Get-VESQLPublishedDatabase</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vesqlpublisheddatabase.md"><code>VESQLPublishedDatabase[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Force</span></p>
        </td>
        <td>
          <p>Defines that cmdlet will show no prompt before executing the command.</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">Confirm</span></p>
        </td>
        <td>
          <p>Defines whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.</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">WhatIf</span></p>
        </td>
        <td>
          <p>Defines whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.</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>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Examples

::: example
### Unpublishing Microsoft SQL Server Database

This example shows how to unpublish a Microsoft SQL Server database.

```
$session = Get-VESQLRestoreSession
$database = Get-VESQLPublishedDatabase -Session $session[0] -Name "New SQL Database"
Unpublish-VESQLDatabase -Databases $database
```

Perform the following steps:

1. Run the [`Get-VESQLRestoreSession`](get-vesqlrestoresession.md) cmdlet. Save the result to the `$session` variable.

   The cmdlet will return an array of restore sessions. Note the ordinal number of the necessary restore session. In this example, it is the first restore session in the array.

2. Run the [`Get-VESQLPublishedDatabase`](get-vesqlpublisheddatabase.md) cmdlet. Set the `$session` variable as the `Session` parameter value and select the necessary restore session. Specify the `Name` parameter value. Save the result to the `$database` variable.
3. Run the `Unpublish-VESQLDatabase` cmdlet. Set the `$database` variable as the `Databases` parameter value.

:::

## Related Commands

- [`Get-VESQLRestoreSession`](get-vesqlrestoresession.md)
- [`Get-VESQLPublishedDatabase`](get-vesqlpublisheddatabase.md)