---
title: "Connect-VBRServer"
description: "Connects to a Veeam backup server. This cmdlet provides the following parameter sets: This cmdlet creates connection with a local or remote Veeam backup server."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/connect-vbrserver.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Connecting to Veeam Backup Server > Connect-VBRServer"
dateModified: "2026-08-19"
---

# Connect-VBRServer

## Short Description
Connects to a Veeam backup server.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>AllParameterSets (Default)</code></p>

```
Connect-VBRServer [-Server <String>] [-Port <Int32>] [-Timeout <Int32>] [-ForceAcceptTlsCertificate] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Server</code></p>

```
Connect-VBRServer [-Server <String>] [-Port <Int32>] -User <String> -Password <String> [-Timeout <Int32>]
 [-ForceAcceptTlsCertificate] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Credentials</code></p>

```
Connect-VBRServer [-Server <String>] [-Port <Int32>] -Credential <PSCredential> [-Timeout <Int32>]
 [-ForceAcceptTlsCertificate] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>InheritConnection</code></p>

```
Connect-VBRServer [-Server <String>] [-Port <Int32>] [-Timeout <Int32>] [-ForceAcceptTlsCertificate] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates connection with a local or remote Veeam backup server. The connection starts a Veeam PowerShell session during which you can perform all operations available with Veeam PowerShell.

If you do not specify the server, the cmdlet connects to the local Veeam backup server.

If you open PowerShell from the Veeam Backup & Replication console, the cmdlet is called automatically and connects to the server to which the console is currently connected.

::: note

Only local and domain user accounts can be used for authentication. User accounts with SAML authentication are not supported.

:::

Within one PowerShell session, you can connect to one Veeam server. To connect to another Veeam server, you need to close the current session.

Run the [`Disconnect-VBRServer`](disconnect-vbrserver.md) cmdlet to stop session with the current Veeam server.

Run the [`Get-VBRServerSession`](get-vbrserversession.md) cmdlet to get information about the current session.

## 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">Credential</span></p>
        </td>
        <td>
          <p>Specifies the credentials you want to use for authenticating with the Veeam server.</p><p><strong>Note</strong>: When creating the <code>PSCredential</code> object, you must specify the user name in the <em>DOMAIN\Username</em> or UPN format.</p><p>Accepts the <code>PSCredential</code> object. To get this object, run the <a href="https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.1"><code>Get-Credential</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">ForceAcceptTlsCertificate</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will accept the backup server TLS certificate.</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">Password</span></p>
        </td>
        <td>
          <p>Specifies the password you want to use for authenticating with the Veeam server.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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">Port</span></p>
        </td>
        <td>
          <p>Specifies the port for connection.</p><p>Default: <code>443</code>.</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">Server</span></p>
        </td>
        <td>
          <p>Specifies the Veeam server to which you want to connect.</p><p>Default: <code>localhost</code>. If PowerShell is launched from the Veeam Backup & Replication console, the server is inherited from the console session.</p><p>Accepts the <code>CHost</code> object. To get this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</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">Timeout</span></p>
        </td>
        <td>
          <p>Specifies timeout in seconds for waiting for a blocked session.</p><p>Default: <code>30</code>.</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">User</span></p>
        </td>
        <td>
          <p>Specifies the user name you want to use for authenticating with the remote server.</p><p><strong>Note</strong>: You must specify the user name in the <em>DOMAIN\Username</em> or UPN format.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</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).

## Examples

::: example
### Example 1. Connecting to Veeam Backup Server as Current User

This command connects to the `192.24.125.135` Veeam backup server as a current user.

```
Connect-VBRServer -Server 192.24.125.135
```

:::

::: example
### Example 2. Connecting to Veeam Backup Server with User/Password Authentication

This command connects to the `192.24.125.135` server using the *User/Password* authentication.

```
Connect-VBRServer -Server "192.24.125.135" -User "TECH\Administrator" -Password "Password"
```

:::

::: example
### Example 3. Connecting to Veeam Backup Server Using Credentials Prompt

This example shows how to connect to the `192.24.125.135` Veeam backup server using the credentials prompt.

```
$creds = Get-Credential
Connect-VBRServer -Credential $creds -Server 192.24.125.135
```

Perform the following steps:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.1) cmdlet. The cmdlet will prompt for a user name and password. Enter the necessary values. Save the result to the `$creds` variable. 
2. Run the `Connect-VBRServer` cmdlet. Set the `$creds` variable as the `Credential` parameter value. Specify the `Server` parameter value.

:::

## Related Commands

- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-VBRLocalhost`](get-vbrlocalhost.md)
- [`Get-VBRCredentials`](get-vbrcredentials.md)
- [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.1)