---
title: "Get-VBOProxy"
description: "This cmdlet returns a list of backup proxy servers added to the Veeam Backup for Microsoft 365 backup infrastructure."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/get-vboproxy.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > Backup Proxy Servers > Get-VBOProxy"
dateModified: "2026-08-21"
---

# Get-VBOProxy

## Short Description
Returns backup proxy servers added to the Veeam Backup for Microsoft 365 infrastructure.

## Syntax

This cmdlet provides the following parameter sets:

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

```
Get-VBOProxy [-Organization <VBOOrganization>] [-ExtendedView] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ByIdParameterSet</code></p>

```
Get-VBOProxy -Id <Guid> [-ExtendedView] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>ByHostParameterSet</code></p>

```
Get-VBOProxy -Hostname <String> [-ExtendedView] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns a list of backup proxy servers added to the Veeam Backup for Microsoft 365 backup infrastructure.

## 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">ExtendedView</span></p>
        </td>
        <td>
          <p><strong>Note</strong>: This parameter will be deprecated in future versions of Veeam Backup for Microsoft 365.</p><p>Defines that the cmdlet will return all parameters of the backup proxy server (if the backup proxy server is online) or exclude from a list the <code>ThrottlingValue</code> and <code>ThreadsNumber</code> parameters.</p><p>Default: <em>False</em></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">Hostname</span></p>
        </td>
        <td>
          <p>Specifies a DNS name or an IP address of the backup proxy server that you want to get.</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">Id</span></p>
        </td>
        <td>
          <p>Specifies an ID of the backup proxy server. The cmdlet will return the backup proxy server with the specified ID.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</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">Organization</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft organization. The cmdlet will return backup proxy servers that are associated with the specified organization.</p><p>Accepts the <a href="vboorganization.md"><code>VBOOrganization</code></a> object.</p><p>To get this object, run the <a href="get-vboorganization.md"><code>Get-VBOOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboorganization.md"><code>VBOOrganization</code></a></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</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.

## Output Object
The cmdlet returns the [`VBOProxy`](vboproxy.md) object that contains a list of backup proxy servers added to the Veeam Backup for Microsoft 365 backup infrastructure.

## Examples

::: example
### Example 1: Getting All Backup Proxy Servers

This command returns all backup proxy servers that are added to the Veeam Backup for Microsoft 365 infrastructure.

```
Get-VBOProxy
```

:::

::: example
### Example 2: Getting Backup Proxy Server by ID

This command returns a backup proxy server with the ID `d96f55a4-d15d-410b-b0f0-d51d17ccdab6`.

```
Get-VBOProxy -Id d96f55a4-d15d-410b-b0f0-d51d17ccdab6
```

:::

::: example
### Example 3: Getting Backup Proxy Server by IP

This command returns a backup proxy server with the `172.17.53.53` IP address.

```
Get-VBOProxy -Hostname 172.17.53.53
```

:::

::: example
### Example 4: Getting Backup Proxy Server by Organization

This example shows how to get a backup proxy server associated with the *Columbus* organization.

```
$org = Get-VBOOrganization -Name "Columbus"
Get-VBOProxy -Organization $org
```

Perform the following steps:

1. Run the [`Get-VBOOrganization`](get-vboorganization.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$org` variable.
2. Run the `Get-VBOProxy` cmdlet. Set the `$org` variable as the `Organization` parameter value.

:::

## Related Commands

[`Get-VBOOrganization`](get-vboorganization.md)