This is an archive version of the document. To get the most up-to-date information, see the current version.

Send-VEODDocument

Short Description

Sends OneDrive documents as mail attachements.

Applies to Veeam Backup for Microsoft Office 365

Product Edition: Community, Rental, Subscription

Syntax

This cmdlet provides parameter sets that allow you to:

Send specific OneDrive documents.

Send-VEODDocument [-Document] <VBOOneDriveDocument[]> -To <string> [-From <string>] [-Subject <string>] [-Text <string>] [<CommonParameters>]

Send documents of a specific OneDrive user.

Send-VEODDocument [-User] <VBOOneDriveUser> -To <string> [-From <string>] [-Subject <string>] [-Text <string>] [<CommonParameters>]

Detailed Description

This cmdlet sends OneDrive documents as attachments of mail messages.

Send-VEODDocument Note:

Before sending restored OneDrive documents, you must verify that you meet the following prerequisites:

You must specify Veeam Explorer for Microsoft OneDrive SMTP settings. For more information, see the Set-VEODSmtpSettings cmdlet.
You must start a restore session. For more information, see the Start-VEODRestoreSession cmdlet.

Parameters

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Document	Specifies a OneDrive document. The cmdlet will send this document as an attachment to a mail message.	Accepts the Document object. To get this object, run the Get-VEODDocument cmdlet.	True	0	True (ByValue)
User	Specifies the name of the OneDrive user. This cmdlet will send OneDrive document of this user.	Accepts the VBOOneDriveUser object. To get this object, run the Get-VEODDocument cmdlet.	True	0	True (ByValue)
To	Specifies an email address. The cmdlet will send OneDrive document to this email address.	String	True	Named	False
From	Specifies an email address. The cmdlet will send OneDrive document from this email address. Note: If you omit this parameter, the cmdlet will use the email address specified in SMTP settings.	String	False	Named	False
Subject	Specifies the subject of an email message.	String	False	Named	False
Text	Specifies the body of an email message.	String	False	Named	False
Force	Defines that the cmdlet will skip the certificate check of the recipient. If you provide this parameter, the cmdlet will send OneDrive documents without checking whether the recipient certificate is valid. Otherwise, the cmdlet will not send OneDrive documents if the recipient certificate validation fails.	SwitchParameter	False	Named	False

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

Examples

Example 1. Sending Specific OneDrive Document

This example shows how to send the Review009.txt OneDrive document of the userAlpha user with the following settings:

The cmdlet will send the document to the user.Alpha@mail.com email address.
The subject of the message is OneDriveDoc.
The body of the message is Mail text.

$session = Get-VEODRestoreSession

$user = Get-VEODDriveUser -Session $session -Name “userAlpha”

$document = Get-VEODDocument -User $user -Name “Review009.txt” -Recurse

Send-VEODDocument -Document $document -To user.Alpha@mail.com -Subject "Subject" -Text "Mail text"

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. Set the $user variable as the User parameter value. Specify the Name and Recurse parameters Save the result to the $user variable.
Run the Send-VEODDocument cmdlet. Specify the following settings:

Set the $document variable as the Document parameter value.
Specify the To parameter value.
Specify the Subject parameter value.
Specify the Text parameter value.

Example 2. Sending OneDrive Documents of Specific User

This example shows how to send OneDrive documents of the userAlpha user with the following settings:

The cmdlet will send documents to the user.Alpha@mail.com email address.
The subject of the message is OneDriveDoc.
The body of the message is Mail text.

$session = Get-VEODRestoreSession

$user = Get-VEODUser -Session $session -Name “userAlpha”

Send-VEODDocument -User $user -To user.Alpha@mail.com -Subject "OneDriveDoc" -Text "Mail text"

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 Send-VEODDocument cmdlet. Specify the following settings:

Set the $user variable as the User parameter value.
Specify the To parameter value.
Specify the Subject parameter value.
Specify the Text parameter value.

Related Commands

Get-VEODDocument