---
title: "Get-VBRLocation"
description: "This cmdlet returns geographic locations created in Veeam Backup & Replication. You can get the list of all locations or search for instances directly by name, ID or associated infrastructure components."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/get-vbrlocation.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Backup Infrastructure > Locations > Get-VBRLocation"
dateModified: "2026-08-19"
---

# Get-VBRLocation

## Short Description
Returns geographic locations created in Veeam Backup & Replication.

**Platform**: VMware, Hyper-V

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

## Syntax

This cmdlet provides the following parameter sets:

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

```
Get-VBRLocation [-Name <String[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Id</code></p>

```
Get-VBRLocation [-Id <Guid[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>Object</code></p>

```
Get-VBRLocation [-Object <Object>] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns geographic locations created in Veeam Backup & Replication. You can get the list of all locations or search for instances directly by name, ID or associated infrastructure components.

## 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">Id</span></p>
        </td>
        <td>
          <p>Specifies the array of location IDs.</p><p>The cmdlet will return locations with these IDs.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Name</span></p>
        </td>
        <td>
          <p>Specifies the array of location names.</p><p>The cmdlet will return locations with these names.</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>True (ByPropertyName)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Object</span></p>
        </td>
        <td>
          <p>Specifies the Veeam Backup & Replication infrastructure component.</p><p>The cmdlet will return a location assigned to this component.</p><p>Accepts the following objects:</p><ul><li><code>CBackupRepository</code> (backup repository). Run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet to get this object.</li><li><a href="vbrscaleoutbackuprepository.md"><code>VBRScaleOutBackupRepository</code></a> (scale-out backup repository). Run the <a href="get-vbrbackuprepository.md"><code>Get-VBRBackupRepository</code></a> cmdlet to get this object.</li><li><a href="vbrtapevault.md"><code>VBRTapeVault</code></a> (tape vault). Run the <a href="get-vbrtapevault.md"><code>Get-VBRTapeVault</code></a> cmdlet to get this object.</li><li><a href="vbrtapelibrary.md"><code>VBRTapeLibrary</code></a> (tape library). Run the <a href="get-vbrtapelibrary.md"><code>Get-VBRTapeLibrary</code></a> cmdlet to get this object.</li><li><a href="vbrcloudprovider.md"><code>VBRCloudProvider</code></a> (cloud provider). Run the <a href="get-vbrcloudprovider.md"><code>Get-VBRCloudProvider</code></a> cmdlet to get this object.</li><li><a href="vbrprotectiongroup.md"><code>VBRProtectionGroup</code></a> (protection group). Run the <a href="get-vbrprotectiongroup.md"><code>Get-VBRProtectionGroup</code></a> cmdlet to get this object.</li><li>Objects returned by the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet (VMware virtual objects).</li><li>Objects returned by the <a href="find-vbrhventity.md"><code>Find-VBRHvEntity</code></a> cmdlet (Hyper-V virtual objects)</li><li><a href="vbramazons3repository.md"><code>VBRAmazonS3Repository</code></a> (Amazon S3 object storage). Run the <a href="get-vbrobjectstoragerepository.md"><code>Get-VBRObjectStorageRepository</code></a> cmdlet to get this object.</li><li><a href="vbramazons3compatiblerepository.md"><code>VBRAmazonS3CompatibleRepository</code></a> (S3 compatible object storage). Run the <a href="get-vbrobjectstoragerepository.md"><code>Get-VBRObjectStorageRepository</code></a> cmdlet to get this object.</li><li><a href="vbrazureblobrepository.md"><code>VBRAzureBlobRepository</code></a> (Azure Blob object storage). Run the <a href="get-vbrobjectstoragerepository.md"><code>Get-VBRObjectStorageRepository</code></a> cmdlet to get this object.</li><li><a href="vbrazuredataboxrepository.md"><code>VBRAzureDataBoxRepository</code></a> (Azure Data Box storage). Run the <a href="get-vbrobjectstoragerepository.md"><code>Get-VBRObjectStorageRepository</code></a> cmdlet to get this object.</li></ul>
        </td>
        <td style="width:10%;">
          <p><code>Object</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName)</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 `VBRLocation` object that lists geographic locations created in Veeam Backup & Replication.

## Examples

::: example
### Example 1. Getting Locations by Name

This command returns locations by name.

```
Get-VBRLocation -Name "Location North", SuperLocation
```

:::

::: example
### Example 2. Getting Locations by ID

This command returns locations by ID.

```
Get-VBRLocation -Id 97e9f314-690c-410f-a1c2-acc101faa2ce, a1218a40-e863-4d38-813f-e68974c3896
```

:::

::: example
### Example 3. Getting Location Assigned to ESXi Host

This example shows how to get the location assigned to the ESXi host.

```
$esxi = Find-VBRViEntity -Name team.support.north
Get-VBRLocation -Object $esxi
```

Perform the following steps:

1. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$esxi` variable.
2. Run the `Get-VBRLocation` cmdlet. Set the `$esxi` variable as the `Object` parameter value.

:::

## Related Commands

- [`Find-VBRViEntity`](find-vbrvientity.md)
- [`Find-VBRHvEntity`](find-vbrhventity.md)