---
title: "Out-TopologyTree"
description: "This cmdlet retrieves the list of clusters and hosts for the specified VMware server and displays a formatted topology tree."
canonical: "https://helpcenter.veeam.com/docs/mp/veshell/out-topologytree.html"
breadcrumb: "Veeam MP VEShell Reference > VEShell Cmdlets > Out-TopologyTree"
dateModified: "2026-09-10"
---

# Out-TopologyTree

Formats VMware server topology to a tree view form.

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

## Syntax

```
Out-TopologyTree [-Topology] <Topology> [<CommonParameters>]
```

## Detailed Description

This cmdlet retrieves the list of clusters and hosts for the specified VMware server and displays a formatted topology tree.

## Parameters

### -Topology \<Topology\>

Specifies the VMware server topology for which you want to display the formatted topology tree.

<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>

### \<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).

## Input

The cmdlet accepts the [Veeam.Psves.Topology](topology.md) object as the input value. The object is stored in the `Topology` property of the [Veeam.Psves.VMwareServer](vmware_server.md) object.

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

- [Veeam.Psves.Topology](topology.md) (you can pass a topology object)
- [Veeam.Psves.VMwareServer](vmware_server.md) (you can pass a VMware server object)

## Output

The cmdlet returns a **Veeam.Psves.Topology.FormattedTopology** object that stores the formatted topology tree.

## Example 1

This example describes how to display formatted topology for the “dev-vcenter” server.

```
Get-VMwareServer -Include dev-vcenter | Out-TopologyTree
```

## Example 2

This example describes how to display formatted topology for the “prod-vcenter” server.

The first command retrieves VMware server prod-vcenter and stores it in the $prod variable.

The second command displays formatted topology tree for the "prod-vcenter".

```
$prod = Get-VMwareServer prod-vcenter
Out-TopologyTree $prod.topology
```

You can also pass the [Veeam.Psves.VMwareServer](vmware_server.md) object referenced by the `$prod` variable through pipeline:

```
$prod | Out-TopologyTree
```

## Example 3

This command shows topology of all connected VMware servers.

```
Get-VMwareServer | Out-TopologyTree
```