Send-VESPItem

In this article

    Short Description

    Sends SharePoint items as attachments to emails.

    Applies to: Veeam Backup & Replication, Veeam Backup for Microsoft Office 365

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

    Syntax

    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>]

    Detailed Description

    This cmdlet sends the following backed-up SharePoint items as email message attachments:

    • SharePoint document libraries.
    • SharePoint documents.
    • Microsoft organization attachments.

    Send-VESPItem Note:

    Before sending restored SharePoint organization attachments, check the following prerequisites:

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept Pipeline Input

    DocumentLibrary

    Specifies a SharePoint document library. The cmdlet will send send this document librasy 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.

    Examples

    Send-VESPItemExample 1. Sending SharePoint Document Library [For Veeam Backup & Replication]

    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:

    1. Get the SharePoint document library:
    1. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. 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.
    3. 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.
    1. Run the Send-VESPItem cmdlet. Set the $documentLibrary variable as the DocumentLibrary parameter value. Specify the To parameter value.

    Send-VESPItemExample 2. Sending SharePoint Document [For Veeam Backup & Replication]

    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:

    1. Get the SharePoint document.
    1. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. 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.
    3. Run the Get-VESPDocument cmdlet. Set the $site variable as the Site parameter value. Specify the Query parameter value. Save the result to the $document variable
    1. Run the Send-VESPItem cmdlet. Set the $document variable as the Document parameter value. Specify the To parameter value.

    Send-VESPItemExample 3. Sending SharePoint Attachement [For Veeam Backup & Replication]

    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:

    1. Get the SharePoint item.
    1. Run the Get-VBRSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. 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.
    3. 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
    1. Run the Get-VESPItemAttachment cmdlet. Set the $item variable as the Item parameter value. Save the result to the $attachment variable
    2. Run the Send-VESPItem cmdlet. Set the $attachment variable as the Attachment parameter value. Specify the To parameter value.

    Send-VESPItemExample 4. Sending SharePoint Document Library [For Veeam Backup for Microsoft Office 365]

    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:

    1. Get the SharePoint document library:
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. 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.
    3. 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.
    1. Run the Send-VESPItem cmdlet. Set the $documentLibrary variable as the DocumentLibrary parameter value. Specify the To parameter value.

    Send-VESPItemExample 5. Sending SharePoint Document [For Veeam Backup for Microsoft Office 365]

    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:

    1. Get the SharePoint document.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. 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.
    3. 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.
    1. Run the Send-VESPItem cmdlet. Set the $document variable as the Document parameter value. Specify the To parameter value.

    Send-VESPItemExample 6. Sending SharePoint Attachement [For Veeam Backup for Microsoft Office 365]

    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:

    1. Get the SharePoint item.
    1. Run the Get-VBOSharePointItemRestoreSession cmdlet. Save the result to the $session variable.
    2. 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.
    3. 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.
    1. Run the Get-VESPItemAttachment cmdlet. Set the $item variable as the Item parameter value. Save the result to the $attachment variable
    2. Run the Send-VESPItem cmdlet. Set the $attachment variable as the Attachment parameter value. Specify the To parameter value.

    Related Commands