Send-VEODDocument

Short Description

Sends OneDrive documents as attachments to emails.

Product: Veeam Backup for Microsoft 365

Product Edition: Community, Rental License, Subscription License

Syntax

This cmdlet provides the following parameter sets:

Document

Send-VEODDocument [-Document] <VBOOneDriveDocument[]> [-From <String>] -To <String> [-Subject <String>]

[-Text <String>] [-Force] [<CommonParameters>]
User

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

[-Force] [<CommonParameters>]

Detailed Description

This cmdlet sends OneDrive documents as attachments of mail messages.

Note

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

You must specify Veeam Explorer for Microsoft OneDrive email settings. For more information, see Set-VEODMailSettings.
You must start a restore session. For more information, see Start-VEODRestoreSession.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Document	Specifies an array of OneDrive documents. The cmdlet will send these documents as an attachment in the email message. Accepts the `VBOOneDriveDocument[]` object. To get this object, run the `Get-VEODDocument` cmdlet.	`VBOOneDriveDocument[]`	True	0	True (ByValue)
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. Default: False	`SwitchParameter`	False	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 email settings.	`String`	False	Named	False
Subject	Specifies a subject of an email message.	`String`	False	Named	False
Text	Specifies a body of an email message.	`String`	False	Named	False
To	Specifies an email address. The cmdlet will send OneDrive document to this email address.	`String`	True	Named	False
User	Specifies a 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-VEODUser` cmdlet.	`VBOOneDriveUser`	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.

Examples

Send-VEODDocument 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-VEODUser -Session $session -Name "userAlpha"

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

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

Send-VEODDocument 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.