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:

DatabaseParameterSet

Get-VESPList [-Database] <VESPDatabase> [[-Name] <String[]>] [<CommonParameters>]
OrganizationParameterSet

Get-VESPList [-Organization] <VESPOrganization> [[-Name] <String[]>] [<CommonParameters>]
SiteParameterSet

Get-VESPList [-Site] <VESPSite> [[-Name] <String[]>] [-Recurse] [<CommonParameters>]

Detailed Description

This cmdlet returns SharePoint lists.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Database	Specifies a SharePoint database. The cmdlet will return SharePoint lists from this database. Accepts the `VESPDatabase` object. To get this object, run the `Get-VESPDatabase` cmdlet.	`VESPDatabase`	True	0	True (ByValue)
Name	Specifies an array of SharePoint list names. This cmdlet will return SharePoint lists with the specified names. This parameter accepts wildcard characters.	`String[]`	False	1	False
Organization	Specifies a SharePoint organization. The cmdlet will return SharePoint lists from this organization. Accepts the `VESPOrganization` object. To get this object, run the `Get-VESPOrganization` cmdlet.	`VESPOrganization`	True	0	True (ByValue)
Recurse	Defines that the cmdlet will return all child items of the specified parent item. Default: False	`SwitchParameter`	False	Named	False
Site	Specifies a name of the SharePoint site. This cmdlet will return SharePoint lists from the specified SharePoint site. Accepts the `VESPSite` object. To get this object, run the `Get-VESPSite` cmdlet.	`VESPSite`	True	0	True (ByValue)

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Output Object

The cmdlet returns the VESPList[] array that contains SharePoint document libraries.

Examples

Get-VESPList 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:

Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
Run the Get-VESPDatabase cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $database variable.
Run the Get-VESPList cmdlet. Set the $database variable as the Database parameter value.

Get-VESPList 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:

Get a SharePoint site:
1. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
2. Run the Get-VESPDatabase 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 cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $site variable.
Run the Get-VESPList cmdlet. Set the $site variable as the Site parameter value. Specify the Name parameter value.

Get-VESPList 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:

Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
Run the Get-VESPOrganization 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.
Run the Get-VESPList cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value.

Get-VESPList 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:

Get a parent SharePoint site:
1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
2. Run the Get-VESPOrganization 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 cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $site variable.
Run the Get-VESPList cmdlet. Set the $site variable as the Site parameter value. Specify the Name parameter value.