---
title: "Invoke-RebuildTopology"
description: "This cmdlet forces topology rebuild for one or more Collectors. This will cause the Collectors to re-discover their section of the VMware topology in Operations Manager."
canonical: "https://helpcenter.veeam.com/docs/mp/veshell/invoke-rebuildtopology.html"
breadcrumb: "Veeam MP VEShell Reference > VEShell Cmdlets > Invoke-RebuildTopology"
dateModified: "2026-09-10"
---

# Invoke-RebuildTopology

Forces topology rebuild for one or more Collectors.

**Applies to versions**: 8.0, 9.0, 9a

## Syntax

```
Invoke-RebuildTopology [-CollectorId] <String[]> [-VESServer <Object>] [<CommonParameters>]
```

## Detailed Description

This cmdlet forces topology rebuild for one or more Collectors.

This will cause the Collectors to re-discover their section of the VMware topology in Operations Manager. Only the topology for vSphere clusters, hosts and VMs currently allocated to this Collector will be rebuilt.

Topology rebuild should only be forced if the vCenter Server topology is not being correctly reflected in Operations Manager (for example, there are missing objects such as VMs, vSphere hosts or host components). Note that the rebuild will be cascaded and will take several collection intervals to complete.

## Parameters

### -CollectorId \<String[]\>

Specifies Ids of Collectors for which topology should be rebuilt.

::: tip

To get the list of registered Collectors, their Ids and names, use the [`Get-Collector`](get-collector.md) cmdlet.

:::

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>1</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>True (ByValue, ByPropertyName)</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### -VESServer

Specifies the Virtualization Extensions server. You can pass the following types of values:

- Name of a machine (remote or local) where the Virtualization Extensions Service runs. 

  Acceptable formats for the input value are: server name (such as "localhost" or "."), IP address (such as "172.15.19.6") and FQDN (such as "localhost.veeam.local").

- [Veeam.Psves.VesConnection](connection.md) object.

For more information, type “[get-help about_VESServerParameter](connection_parameter.md)”.

<table style="width:500px; head-row-background-color:#c5e2ff; alt-row-background-color:#f5f5f5;" class="Blue_Table">
  <tr style="vertical-align:top">
    <th colspan="2" style="height:19px;">
      <p>Description</p>
    </th>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Aliases</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Required?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Position?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>Named</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Default Value</p>
    </td>
    <td style="width:268px; height:19px;"></td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Pipeline Input?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
  <tr style="vertical-align:top">
    <td style="width:228px; height:19px;">
      <p>Accept Wildcard Characters?</p>
    </td>
    <td style="width:268px; height:19px;">
      <p>False</p>
    </td>
  </tr>
</table>

### \<CommonParameters\>

This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see [Microsoft Docs](http://go.microsoft.com/fwlink/p/?LinkID=113216).

## Notes

If the `-VESServer` parameter is not specified, the cmdlet will connect to the Virtualization Extensions Service on the local machine.

## Input

The cmdlet accepts the following types of values for the `-CollectorId` parameter:

- System.String (you can pass Collector Ids, the Id value is used exactly as it is typed)
- [Veeam.Psves.Collector](collector.md) (you can pass Collector objects)

## Output

The cmdlet returns a collection of [Veeam.Psves.RebuildTopologyTask](rebuild_topology_task.md) objects. The Status property of the object indicates the status of the rebuild topology task.

Possible values for the `Status` property are:

- *Success* — the rebuild topology task completed successfully. Topology for the Collectors will be rebuilt soon. 
- *Failed* — an error occurred. For error details, see the Description property of the object.
- *InProgress* — the rebuild topology task for the Collectors is already in progress.

## Example 1

This command forces topology rebuild for all registered Collectors.

```
Get-Collector | Invoke-RebuildTopology
```

## Example 2

This command forces topology rebuild for the “col1.veeam.local” Collector.

```
Get-Collector col1.veeam.local -SelectByName | Invoke-RebuildTopology
Status     Collector             Description                                                
------     ---------             -----------                                                
Success    col1.veeam.local      Rebuild topology was successfully scheduled.    
```