Send-VETItem

Short Description

Sends Microsoft Teams items to emails as attachments.

Applies to: Veeam Backup for Microsoft Office 365

Product Edition: Community, Standard, Enterprise, Enterprise Plus

Syntax

This cmdlet provides parameter sets that allow you to:

  • Send a Microsoft Teams channel post.

Send-VETItem -To <string> [-Post] <VETPost[]> [-From <string>] [-Subject <string>] [-Body <string>]  [<CommonParameters>]

  • Send a file published in a Microsoft Teams team channel.

Send-VETItem -To <string> [-File] <VETFile[]> [-From <string>] [-Subject <string>] [-Body <string>]  [<CommonParameters>]

Detailed Description

This cmdlet sends Microsoft Teams items as attachments in an email message.

Send-VETItem Note:

Before sending Microsoft Teams items, you must perform the following actions:

  • Specify SMTP settings for Veeam Explorer for Microsoft Teams. For more information on how to specify SMTP settings, see Set-VETSmtpSettings.
  • Start a restore session. For more information on how to start a restore session, see Start-VBOTeamsItemRestoreSession.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Accept Wildcard Characters

Post

Specifies Microsoft Teams team channel posts. The cmdlet will send posts in the email message.

Accepts the VETPost[] type. To get this object, run the Get-VETPost cmdlet.

True

0

True (ByValue)

False

File

Specifies Microsoft Teams team channel files. The cmdlet will send these files in the email message.

Accepts the VETFile[] type. To get this object, run the Get-VETFile cmdlet.

True

0

True (ByValue)

False

To

Specifies an email address to which Veeam Explorer for Microsoft Teams will send Microsoft Team items.

String

True

Named

False

False

From

Specifies the email address from which Veeam Explorer for Microsoft Teams will send Microsoft Team items.

If this parameter is omitted, Veeam Explorer for Microsoft Teams will use the email address specified in SMTP settings.

String

False

Named

False

False

Subject

Specifies a subject of an email message.

String

False

Named

False

False

Body

Specifies a body of an email message.

String

False

Named

False

False

<CommonParameters>

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

Output Object

None.

Examples

Send-VETItemExample 1. Sending Microsoft Teams Post

This example shows how to send the Announcement post to the administrator@test.local mailbox.

$session = Get-VBOTeamsItemRestoreSession

$org = Get-VETOrganization -Session $session -Name "ABC"

$post = Get-VETPost -Organization $org -Query "subject: announcement"

Send-VETItem -Post $post -To administrator@test.local

Perform the following steps:

  1. Get the Microsoft Teams post:
  1. Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
  2. Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $org variable.
  3. Run the Get-VETPost cmdlet. Set the $org variable as the Organization parameter value. Specify the Query parameter value. Save the result to the $post variable.
  1. Run the Send-VETItem cmdlet. Set the $post variable as the Post parameter value. Specify the To parameter value.

Send-VETItemExample 2. Sending Microsoft Teams File

This example shows how to send the report.txt file to the administrator@test.local mailbox.

$session = Get-VBOTeamsItemRestoreSession

$org = Get-VETOrganization -Session $session -Name "ABC"

$file = Get-VETFile -Organization $org -Query "filename: report"

Send-VETItem -File $file -To administrator@test.local

Perform the following steps:

  1. Get the Microsoft Teams file.
  1. Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
  2. Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Save the result to the $org variable.
  3. Run the Get-VETFile cmdlet. Set the $org variable as the Organization parameter value. Specify the Query parameter value. Save the result to the $file variable.
  1. Run the Send-VETItem cmdlet. Set the $file variable as the File parameter value. Specify the To parameter value.

Related Commands

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.