Get-VBRUnstructuredBackupTaskSession

Short Description

Returns tasks for file share and object storage backup sessions.

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

Syntax

This cmdlet provides the following parameter sets:

  • Name

    Get-VBRUnstructuredBackupTaskSession -Name <String[]> [<CommonParameters>]

  • Id

    Get-VBRUnstructuredBackupTaskSession -Id <Guid[]> [<CommonParameters>]

  • Session

    Get-VBRUnstructuredBackupTaskSession -Session <VBRUnstructuredBackupSession> [<CommonParameters>]

Detailed Description

This cmdlet returns tasks for file share and object storage backup sessions. Veeam Backup & Replication creates a separate task for each file share within a backup session.

Parameters

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Id

Specifies an array of IDs for file share and object storage backup session tasks. The cmdlet will return tasks with these IDs.

Guid[]

True

Named

False

Name

Specifies an array of file share and object storage names. The cmdlet will return tasks with these names.

String[]

True

Named

False

Session

Specifies the file share and object storage backup session. The cmdlet will return tasks that run within this session.

Accepts the VBRUnstructuredBackupSession object. To get this object, run the Get-VBRUnstructuredBackupSessionReturns backup sessions for file backup jobs and object storage backup jobs. cmdlet.

VBRUnstructuredBackupSession

True

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

VBRUnstructuredBackupTaskSession

Examples

Get-VBRUnstructuredBackupTaskSessionExample 1. Getting Backup Session Tasks for File Share by Its Name

This command returns all tasks run for the \\fileserv05\Documents file share.

Get-VBRUnstructuredBackupTaskSession -Name "\\fileserv05\Documents"

Get-VBRUnstructuredBackupTaskSessionExample 2. Getting Backup Session Tasks by Task IDs

This command returns the 49664A5F-9C55-4A1F-8E6A-1CD5705A684B and 42696B53-6FEC-4148-9354-AA9E4B52DED9 backup session tasks.

Get-VBRUnstructuredBackupTaskSession -Id ("49664A5F-9C55-4A1F-8E6A-1CD5705A684B", "42696B53-6FEC-4148-9354-AA9E4B52DED9")

Get-VBRUnstructuredBackupTaskSessionExample 3. Getting Backup Session Tasks for Backup Session

This command returns tasks that run within the 42636B53-6FEC-4148-9354-BB9E4B52DED9 backup session.

$session = Get-VBRUnstructuredBackupSession -Id "42636B53-6FEC-4148-9354-BB9E4B52DED9"

Get-VBRUnstructuredBackupTaskSession -Session $session

Perform the following steps:

  1. Run the Get-VBRUnstructuredBackupSessionReturns backup sessions for file backup jobs and object storage backup jobs. cmdlet. Specify the Id parameter value. Save the result to the $session variable.
  2. Run the Get-VBRUnstructuredBackupTaskSession cmdlet. Set the $session variable as the Session parameter value.

Get-VBRUnstructuredBackupSessionReturns backup sessions for file backup jobs and object storage backup jobs.

Page updated 2026-08-19

Page content applies to build 13.1.1.18