---
title: "Get-VESPList"
description: "Returns SharePoint lists. Product: Veeam Backup & Replication, Veeam Backup for Microsoft 365 Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet provides the following parameter sets: This cmdle"
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/get-vesplist.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft SharePoint > Get-VESPList"
dateModified: "2026-08-18"
---

# Get-VESPList

## Short Description
Returns SharePoint lists.

**Product**: Veeam Backup & Replication, Veeam Backup for Microsoft 365

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

## Syntax

This cmdlet provides the following parameter sets:

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

```
Get-VESPList [-Database] <VESPDatabase> [[-Name] <String[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>OrganizationParameterSet</code></p>

```
Get-VESPList [-Organization] <VESPOrganization> [[-Name] <String[]>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>SiteParameterSet</code></p>

```
Get-VESPList [-Site] <VESPSite> [[-Name] <String[]>] [-Recurse] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns SharePoint lists.

## 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">Database</span></p>
        </td>
        <td>
          <p>Specifies a SharePoint database. The cmdlet will return SharePoint lists from this database.</p><p>Accepts the <a href="vespdatabase.md"><code>VESPDatabase</code></a> object. To get this object, run the <a href="get-vespdatabase.md"><code>Get-VESPDatabase</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vespdatabase.md"><code>VESPDatabase</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</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 an array of SharePoint list names. This cmdlet will return SharePoint lists with the specified names.</p><p>This parameter accepts wildcard characters.</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>1</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 SharePoint organization. The cmdlet will return SharePoint lists from this organization.</p><p>Accepts the <a href="vesporganization.md"><code>VESPOrganization</code></a> object. To get this object, run the <a href="get-vesporganization.md"><code>Get-VESPOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vesporganization.md"><code>VESPOrganization</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Recurse</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return all child items of the specified parent item.</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">Site</span></p>
        </td>
        <td>
          <p>Specifies a name of the SharePoint site. This cmdlet will return SharePoint lists from the specified SharePoint site.</p><p>Accepts the <a href="vespsite.md"><code>VESPSite</code></a> object. To get this object, run the <a href="get-vespsite.md"><code>Get-VESPSite</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vespsite.md"><code>VESPSite</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</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 Docs.

## Output Object
The cmdlet returns the [`VESPList`](vesplist.md)`[]` array that contains SharePoint document libraries.

## Examples

::: example
### Example 1. Getting SharePoint Lists from Backed-Up SharePoint Database [For Veeam Backup & Replication]

This example shows how to get all SharePoint lists from the `WSS_Content.mdf` backed-up SharePoint database.

```
$session = Get-VBRSharePointItemRestoreSession
$database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"
Get-VESPList -Database $database
```

Perform the following steps:

1. Run the [`Get-VBRSharePointItemRestoreSession`](get-vbrsharepointitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
2. Run the [`Get-VESPDatabase`](get-vespdatabase.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Specify the `Name` parameter value. Save the result to the `$database` variable.
3. Run the `Get-VESPList` cmdlet. Set the `$database` variable as the `Database` parameter value.

:::

::: example
### Example 2. Getting SharePoint List from SharePoint Site [For Veeam Backup & Replication]

This example shows how to get the `Color names` SharePoint list from the `Teams` SharePoint site.

```
$session = Get-VBRSharePointItemRestoreSession
$database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf"
$site = Get-VESPSite -Database $database -Name "Teams"
Get-VESPList -Site $site -Name "Color names"
```

Perform the following steps:

1. Get a SharePoint site:

   1. Run the [`Get-VBRSharePointItemRestoreSession`](get-vbrsharepointitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VESPDatabase`](get-vespdatabase.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Specify the `Name` parameter value. Save the result to the `$database` variable.
   3. Run the [`Get-VESPSite`](get-vespsite.md) cmdlet. Set the `$database` variable as the `Database` parameter value. Specify the `Name` parameter value. Save the result to the `$site` variable.

2. Run the `Get-VESPList` cmdlet. Set the `$site` variable as the `Site` parameter value. Specify the `Name` parameter value.

:::

::: example
### Example 3. Getting SharePoint List from Microsoft Organization [For Veeam Backup for Microsoft 365]

This example shows how to get the `Color names` SharePoint list from the `ABC` SharePoint organization.

```
$session = Get-VBOSharePointItemRestoreSession
$organization = Get-VESPOrganization -Session $session -Name "ABC*"
Get-VESPList -Organization $organization -Name "Color names"
```

Perform the following steps:

1. Run the [`Get-VBOSharePointItemRestoreSession`](get-vbosharepointitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
2. Run the [`Get-VESPOrganization`](get-vesporganization.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Specify the `Name` parameter value. Use the \* wildcard character to substitute the timestamp. Save the result to the `$organization` variable.
3. Run the `Get-VESPList` cmdlet. Set the `$organization` variable as the `Organization` parameter value. Specify the `Name` parameter value.

:::

::: example
### Example 4. Getting SharePoint List from SharePoint Site [For Veeam Backup for Microsoft 365]

This example shows how to get the `Color` SharePoint list from the `Team Site` SharePoint site.

```
$session = Get-VBOSharePointItemRestoreSession
$organization = Get-VESPOrganization -Session $session -Name "ABC*"
$site = Get-VESPSite -Organization $organization -Name "Teams"
Get-VESPList -Site $site -Name "Color names"
```

Perform the following steps:

1. Get a parent SharePoint site:

   1. Run the [`Get-VBOSharePointItemRestoreSession`](get-vbosharepointitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VESPOrganization`](get-vesporganization.md) cmdlet. Set the `$session` variable as the `Session` parameter value. Specify the `Name` parameter value. Use the \* wildcard character to substitute the timestamp. Save the result to the `$organization` variable.
   3. Run the [`Get-VESPSite`](get-vespsite.md) cmdlet. Set the `$organization` variable as the `Organization` parameter value. Specify the `Name` parameter value. Save the result to the `$site` variable.

2. Run the `Get-VESPList` cmdlet. Set the `$site` variable as the `Site` parameter value. Specify the `Name` parameter value.

:::

## Related Commands

- [`Get-VBOSharePointItemRestoreSession`](get-vbosharepointitemrestoresession.md)
- [`Get-VBRSharePointItemRestoreSession`](get-vbrsharepointitemrestoresession.md)
- [`Get-VESPDatabase`](get-vespdatabase.md)
- [`Get-VESPSite`](get-vespsite.md)
- [`Get-VESPOrganization`](get-vesporganization.md)