Get-VEODDocument

Short Description

Returns OneDrive documents.

Applies to

Veeam Backup for Microsoft 365

Product Edition: Community, Rental License, Subscription License

Syntax

This cmdlet provides parameter sets that allow you to:

Get documents of the specific user.

Get-VEODDocument [-User <VBOOneDriveUser>] [-Name <String[]>] [-Recurse] [<CommonParameters>]

Get all child documents of the specific document.

Get-VEODDocument [-ParentDocument <VBOOneDriveDocument>] [-Name <String[]>] [-Recurse] [<CommonParameters>]

Detailed Description

This cmdlet returns documents that are stored in the OneDrive repository.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
User	Specifies OneDrive user. This cmdlet will return documents of the specified OneDrive user.	Accepts the VBOOneDriveUser object. To get this object, run the Get-VEODUser cmdlet.	True	0	True (ByValue)
Name	Specifies a name of the document. The cmdlet will return the document with this name.	String[]	False	Named	False
Recurse	Defines that the cmdlet will return all child items of the specified parent item. Default: False	SwitchParameter	False	Named	False
ParentDocument	Specifies a parent document. The cmdlet will return the child documents of this parent document.	Accepts the VBOOneDriveDocument object.	True	0	True (ByValue)

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Output Object

The cmdlet returns the VBOOneDriveDocument object that contains documents that are stored in the OneDrive repository.

Examples

Get-VEODDocument Example 1. Getting Specified User Documents

This example shows how to get the document.txt document and its child from the userAlpha user.

$session = Get-VEODRestoreSession

$user = Get-VEODUser -Session $session -Name "userAlpha"

Get-VEODDocument -User $user -Name "document.txt" -Recurse

Perform the following steps:

Run the Get-VEODRestoreSession cmdlet. Save the result to the $session variable.
Run the Get-VEODUser cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $user variable.
Run the Get-VEODDocument cmdlet. Specify the following settings:

Set the $user variable as the User parameter value.
Specify the Name parameter value.
Provide the Recurse parameter.

Get-VEODDocument Example 2. Getting Specific Child Documents

This example shows how to get child documents from the Document parent document.

$session = Get-VEODRestoreSession

$user = Get-VEODUser -Session $session -Name "userAlpha"

$document = Get-VEODDocument -User $user -Name "Document"

Get-VEODDocument -ParentDocument $document -Name "document.txt" -Recurse

Perform the following steps:

Run the Get-VEODRestoreSession cmdlet. Save the result to the $session variable.
Run the Get-VEODUser cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $user variable.
Run the Get-VEODDocument cmdlet. Specify the User and Name parameters. Save the result to the $document variable.
Run the Get-VEODDocument cmdlet. Specify the following settings:

Set the $document variable as the ParentDocument parameter value.
Specify the Name parameter value.
Provide the Recurse parameter.

Related Commands