This is an archive version of the document. To get the most up-to-date information, see the
current version.
Send-VESPItem
Sends SharePoint items as attachments to emails.
Veeam Backup & Replication, Veeam Backup for Microsoft 365
Product Edition: Community, Standard, Enterprise, Enterprise Plus, Veeam Universal License
This cmdlet provides parameter sets that allow you to:
- Send a SharePoint document library.
Send-VESPItem [-DocumentLibrary] <VESPDocumentLibrary> -To <string> [-From <string>] [-Subject <string>] [-Body <string>] [<CommonParameters>] |
- Send a SharePoint document.
Send-VESPItem [-Document] <VESPDocument[]> -To <string> [-From <string>] [-Subject <string>] [-Body <string>] [<CommonParameters>] |
- Send a SharePoint attachment file.
Send-VESPItem [-Attachment] <VESPItemAttachment[]> -To <string> [-From <string>] [-Subject <string>] [-Body <string>] [<CommonParameters>] |
This cmdlet sends the following backed-up SharePoint items as email message attachments:
- SharePoint document libraries.
- SharePoint documents.
- Microsoft organization attachments.
 Note:
|
Before sending restored SharePoint organization attachments, check the following prerequisites: |
Parameter | Description | Type | Required | Position | Accept Pipeline Input |
|---|
DocumentLibrary | Specifies a SharePoint document library. The cmdlet will send send this document library as an attachment in the email message. | Accepts the VESPDocumentLibrary object. To get this object, run the Get-VESPDocumentLibrary cmdlet. | True | 0 | True (ByValue) |
From | Specifies the email address from which the cmdlet will send backed-up SharePoint data. If this parameter is omitted, the cmdlet will use the email address, specified in SMTP settings. | String | False | Named | False |
To | Specifies the email address to which the cmdlet will send restored data. | String | True | Named | False |
Subject | Specifies the subject of an email message. | String | False | Named | False |
Body | Specifies the body of an email message. | String | False | Named | False |
Document | Specifies an array of SharePoint documents that you want to send in the email message. | Accepts the VESPDocument[] object. To get this object, run the Get-VESPDocument cmdlet. | True | 0 | True (ByValue) |
Attachment | Specifies an array of SharePoint attachments that you want to send in the email message. | Accepts the VESPItemAttachment[] object. To get this object, run the Get-VESPItemAttachment cmdlet. | 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 SharePoint attachments without checking whether the recipient certificate is valid. Otherwise, the cmdlet will not send SharePoint attachments if the recipient certificate validation fails. | SwitchParameter | False | Named | False |
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Docs.
This example shows how to send the Regulations document library to the administrator@test.local mailbox. $session = Get-VBRSharePointItemRestoreSession $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf" $documentLibrary = Get-VESPDocumentLibrary -Database $database -Name "Regulations" Send-VESPItem -DocumentLibrary $documentLibrary -To administrator@test.local |
Perform the following steps: - Get the SharePoint document library:
- 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-VESPDocumentLibrary cmdlet. Set the $database variable as the Database parameter value. Specify the Name parameter value. Save the result to the $documentLibrary variable.
- Run the Send-VESPItem cmdlet. Set the $documentLibrary variable as the DocumentLibrary parameter value. Specify the To parameter value.
|
This example shows how to send the reports.txt document to the administrator@test.local mailbox. $session = Get-VBRSharePointItemRestoreSession $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf" $document = Get-VESPDocument -Database $database -Query "reports.txt" Send-VESPItem -Document $document -To administrator@test.local |
Perform the following steps: - Get the SharePoint document:
- 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-VESPDocument cmdlet. Set the $database variable as the Database parameter value. Specify the Query parameter value. Save the result to the $document variable.
- Run the Send-VESPItem cmdlet. Set the $document variable as the Document parameter value. Specify the To parameter value.
|
This example shows how to send the attachments of the Reports SharePoint item to the administrator@test.local mailbox. $session = Get-VBRSharePointItemRestoreSession $database = Get-VESPDatabase -Session $session -Name "WSS_Content.mdf" $item = Get-VESPItem -Database $database -Query "Reports" $attachment = Get-VESPItemAttachment -Item $item Send-VESPItem -Attachment $attachment -To administrator@test.local |
Perform the following steps: - Get the SharePoint item:
- 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-VESPItem cmdlet. Set the $database variable as the Database parameter value. Specify the Query parameter value. Save the result to the $item variable.
- Run the Get-VESPItemAttachment cmdlet. Set the $item variable as the Item parameter value. Save the result to the $attachment variable.
- Run the Send-VESPItem cmdlet. Set the $attachment variable as the Attachment parameter value. Specify the To parameter value.
|
This example shows how to send the Regulations document library to the administrator@test.local mailbox. $session = Get-VBOSharePointItemRestoreSession $organization = Get-VESPOrganization -Session $session -Name "ABC" $documentLibrary = Get-VESPDocumentLibrary -Organization $organization -Name "Regulations" Send-VESPItem -DocumentLibrary $documentLibrary -To administrator@test.local |
Perform the following steps: - Get the SharePoint document library:
- 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. Save the result to the $organization variable.
- Run the Get-VESPDocumentLibrary cmdlet. Set the $organization variable as the Organization parameter value. Specify the Name parameter value. Save the result to the $documentLibrary variable.
- Run the Send-VESPItem cmdlet. Set the $documentLibrary variable as the DocumentLibrary parameter value. Specify the To parameter value.
|
This example shows how to send the reports.txt document to the administrator@test.local mailbox. $session = Get-VBOSharePointItemRestoreSession $organization = Get-VESPOrganization -Session $session -Name "ABC" $document = Get-VESPDocument -Organization $organization -Query "reports.txt" Send-VESPItem -Document $document -To administrator@test.local |
Perform the following steps: - Get the SharePoint document:
- 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. Save the result to the $organization variable.
- Run the Get-VESPDocument cmdlet. Set the $organization variable as the Organization parameter value. Specify the Query parameter value. Save the result to the $document variable.
- Run the Send-VESPItem cmdlet. Set the $document variable as the Document parameter value. Specify the To parameter value.
|
This example shows how to send the attachments to the Reports SharePoint item to the administrator@test.local mailbox. $session = Get-VBOSharePointItemRestoreSession $organization = Get-VESPOrganization -Session $session -Name "ABC" $item = Get-VESPItem -Organization $organization -Query "Reports" $attachment = Get-VESPItemAttachment -Item $item Send-VESPItem -Attachment $attachment -To administrator@test.local |
Perform the following steps: - Get the SharePoint item:
- 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. Save the result to the $organization variable.
- Run the Get-VESPItem cmdlet. Set the $organization variable as the Organization parameter value. Specify the Query parameter value. Save the result to the $item variable.
- Run the Get-VESPItemAttachment cmdlet. Set the $item variable as the Item parameter value. Save the result to the $attachment variable.
- Run the Send-VESPItem cmdlet. Set the $attachment variable as the Attachment parameter value. Specify the To parameter value.
|
Related Commands
Example 1. Sending SharePoint Document Library [For Veeam Backup & Replication]