Send-VETItem

Short Description

Sends Microsoft Teams items as attachments to emails.

Applies to

Veeam Backup for Microsoft 365

Product Edition: Community, Rental License, Subscription License

Syntax

This cmdlet provides parameter sets that allow you to:

Send a Microsoft Teams channel post.

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

Send a file published in a Microsoft Teams team channel.

Send-VETItem -To <String> [-From <String>] [-Subject <String>] [-Body <String>] [-File <VETFile[]>] [<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 email settings for Veeam Explorer for Microsoft Teams. For more information on how to specify email settings, see Set-VETMailSettings.
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
To	Specifies an email address to which Veeam Explorer for Microsoft Teams will send Microsoft Team items.	String	True	Named	False
From	Specifies an 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 email settings.	String	False	Named	False
Subject	Specifies a subject of an email message.	String	False	Named	False
Body	Specifies a body of an email message.	String	False	Named	False
Post	Specifies Microsoft Teams team channel posts. The cmdlet will send posts in the email message.	Accepts the VETPost[] object. To get this object, run the Get-VETPost cmdlet.	True	0	True (ByValue)
File	Specifies Microsoft Teams team channel files. The cmdlet will send these files in the email message.	Accepts the VETFile[] object. To get this object, run the Get-VETFile cmdlet.	True	0	True (ByValue)

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

Output Object

None.

Examples

Send-VETItem Example 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:

Get the Microsoft Teams post:

Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $org variable.
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.

Run the Send-VETItem cmdlet. Set the $post variable as the Post parameter value. Specify the To parameter value.

Send-VETItem Example 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:

Get the Microsoft Teams file:

Run the Get-VBOTeamsItemRestoreSession cmdlet. Save the result to the $session variable.
Run the Get-VETOrganization cmdlet. Set the $session variable as the Session parameter value. Specify the Name parameter value. Use the * wildcard character to substitute the timestamp. Save the result to the $org variable.
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.

Run the Send-VETItem cmdlet. Set the $file variable as the File parameter value. Specify the To parameter value.

Related Commands