---
title: "Start-VBORepositoryOwnerChangeSession"
description: "This cmdlet creates and starts a session when Veeam Backup for Microsoft 365 moves a backup repository to another backup proxy server or backup proxy pool. Starting many change owner sessions may overload the NATS server resulting session failures."
canonical: "https://helpcenter.veeam.com/docs/vbo365/powershell/start-vborepositoryownerchangesession.html"
breadcrumb: "PowerShell Reference > Veeam Backup for Microsoft 365 PowerShell Reference > Backup Infrastructure > JET-based Backup Repositories and Object Storage Repositories > Start-VBORepositoryOwnerChangeSession"
dateModified: "2026-08-21"
---

# Start-VBORepositoryOwnerChangeSession

## Short Description
Creates and starts a change owner session to move a backup repository to another backup proxy server or backup proxy pool.

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>ProxyParameterSet</code></p>

```
Start-VBORepositoryOwnerChangeSession -Repository <VBORepository> [-Proxy <VBOProxy>]
 [-WaitForSessionsTimeoutMinutes <Int32>] [-ForceStopSessions] [-ForceStopSessionsTimeoutMinutes <Int32>]
 [-IgnoreConnectionTroublesToSourceLocation] [-Force] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>PoolParameterSet</code></p>

```
Start-VBORepositoryOwnerChangeSession -Repository <VBORepository> [-Pool <VBOProxyPool>]
 [-WaitForSessionsTimeoutMinutes <Int32>] [-ForceStopSessions] [-ForceStopSessionsTimeoutMinutes <Int32>]
 [-IgnoreConnectionTroublesToSourceLocation] [-Force] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet creates and starts a session when Veeam Backup for Microsoft 365 moves a backup repository to another backup proxy server or backup proxy pool.

::: note

Starting many change owner sessions may overload the NATS server resulting session failures. To prevent this, use the [`Get-VBORepositoryOwnerChangeSession`](get-vborepositoryownerchangesession.md) cmdlet to check the status of a particular change owner session and wait for each session to complete. Alternatively, you can insert a delay between change owner sessions.

:::

## 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">Force</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will start a session without showing warnings in the PowerShell console.</p><p>If you do not provide the parameter, the cmdlet will prompt you to confirm the operation.</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">ForceStopSessions</span></p>
        </td>
        <td>
          <p>Defines action that Veeam Backup for Microsoft 365 will perform if the related sessions exceed the <code>WaitForSessionsTimeoutMinutes</code> value to finish. The following values are available:</p><ul><li><code>true</code> — the related sessions are stopped, the change owner session is created and started.</li><li><code>false</code> — the change owner session is canceled.</li></ul><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">ForceStopSessionsTimeoutMinutes</span></p>
        </td>
        <td>
          <p>For the <code>ForceStopSessions</code> parameter set to <em>true</em>.</p><p>Specifies a timeout in <em>minutes</em>.</p><p>The cmdlet will use this timeout to wait for the related sessions to stop after Veeam Backup for Microsoft 365 forced them to stop.</p><p>Default: <em>10</em></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">IgnoreConnectionTroublesToSourceLocation</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will ignore the <em>Offline</em> status of a source backup proxy server.</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">Pool</span></p>
        </td>
        <td>
          <p>Specifies a backup proxy pool. The cmdlet will move an object storage repository to this backup proxy pool.</p><p>Accepts the <a href="vboproxypool.md"><code>VBOProxyPool</code></a> object.</p><p>To get this object, run the <a href="get-vboproxypool.md"><code>Get-VBOProxyPool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxypool.md"><code>VBOProxyPool</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Proxy</span></p>
        </td>
        <td>
          <p>Specifies a backup proxy server. The cmdlet will move a backup repository or an object storage repository to this backup proxy server.</p><p>Accepts the <a href="vboproxy.md"><code>VBOProxy</code></a> object.</p><p>To get this object, run the <a href="get-vboproxy.md"><code>Get-VBOProxy</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vboproxy.md"><code>VBOProxy</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Repository</span></p>
        </td>
        <td>
          <p>Specifies a backup repository or an object storage repository. The cmdlet will create and start a change owner session for this backup repository or object storage repository.</p><p>Accepts the <a href="vborepository.md"><code>VBORepository</code></a> object.</p><p>To get this object, run the <a href="get-vborepository.md"><code>Get-VBORepository</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vborepository.md"><code>VBORepository</code></a></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">WaitForSessionsTimeoutMinutes</span></p>
        </td>
        <td>
          <p>Specifies a timeout in <em>minutes</em>.</p><p>The cmdlet will use this timeout to wait for the related sessions to finish before starting the current session. Related sessions are the sessions that Veeam Backup for Microsoft 365 creates to perform different activities, such as data backup and backup copy, data management, data restore and data retrieval.</p><p>Default: <em>60</em></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>
    </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 [`VBORepositoriesOwnerChangeSession`](vborepositoriesownerchangesession.md) object that contains details on a session when Veeam Backup for Microsoft 365 moves a backup repository to another backup proxy server or backup proxy pool.

## Examples

::: example
### Starting Change Owner Session

This example shows how to start a change owner session to move the *Azure Backup* object storage repository to the *Pool1* backup proxy pool.

```
$repository = Get-VBORepository -Name "Azure Backup"
$pool = Get-VBOProxyPool -Name "Pool1"
Start-VBORepositoryOwnerChangeSession -Repository $repository -Pool $pool -ForceStopSessions
```

Perform the following steps:

1. Run the [`Get-VBORepository`](get-vborepository.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$repository` variable.
2. Run the [`Get-VBOProxyPool`](get-vboproxypool.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$pool` variable.
3. Run the `Start-VBORepositoryOwnerChangeSession` cmdlet. Set the `$repository` variable as the `Repository` parameter value. Set the `$pool` variable as the `Pool` parameter value. Provide the `ForceStopSessions` parameter.

:::

## Related Commands

- [`Get-VBORepository`](get-vborepository.md)
- [`Get-VBOProxyPool`](get-vboproxypool.md)
- [`Get-VBOProxy`](get-vboproxy.md)