Send-VETItem
Short Description
Sends Microsoft Teams items as email attachments.
Product: Veeam Backup for Microsoft 365
Product Edition: Community, Rental License, Subscription License
Syntax
This cmdlet provides the following parameter sets:
-
SendPostParameterSet
|
Send-VETItem -To <String> [-From <String>] [-Subject <String>] [-Body <String>] [-Post] <VETPost[]> [<CommonParameters>] |
-
SendFileParameterSet
|
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.
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-VETMailSettingsModifies Veeam Explorer for Microsoft Teams email settings. Veeam Explorer for Microsoft Teams uses these settings to send Microsoft Teams posts and files as attachments in email messages and deliver export reports..
- Start a restore session. For more information on how to start a restore session, see
Start-VBOTeamsItemRestoreSessionStarts restore sessions to explore backed-up Microsoft Teams objects and to perform operations with these items..
|
Parameters
Parameters
|
Parameter
|
Description
|
Type
|
Required
|
Position
|
Accept Pipeline Input
|
|
Body
|
Specifies a body of an email message.
|
String
|
False
|
Named
|
False
|
|
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-VETFileReturns files published in Microsoft Teams team channels. cmdlet.
|
VETFile[]
|
True
|
0
|
True (ByValue)
|
|
From
|
Specifies an email address from which Veeam Explorer for Microsoft Teams will send Microsoft Teams items.
If this parameter is omitted, Veeam Explorer for Microsoft Teams will use the email address specified in email settings.
|
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-VETPostReturns Microsoft Teams team channel posts. cmdlet.
|
VETPost[]
|
True
|
0
|
True (ByValue)
|
|
Subject
|
Specifies a subject of an email message.
|
String
|
False
|
Named
|
False
|
|
To
|
Specifies an email address to which Veeam Explorer for Microsoft Teams will send Microsoft Teams items.
|
String
|
True
|
Named
|
False
|
<CommonParameters>
This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.
Examples
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-VBOTeamsItemRestoreSessionReturns active restore sessions started to perform operations with backed-up Microsoft Teams items. cmdlet. Save the result to the $session variable.
- Run the
Get-VETOrganizationReturns Microsoft Teams organizations added to Veeam Backup for Microsoft 365. 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-VETPostReturns Microsoft Teams team channel posts. 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.
|
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-VBOTeamsItemRestoreSessionReturns active restore sessions started to perform operations with backed-up Microsoft Teams items. cmdlet. Save the result to the $session variable.
- Run the
Get-VETOrganizationReturns Microsoft Teams organizations added to Veeam Backup for Microsoft 365. 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-VETFileReturns files published in Microsoft Teams team channels. 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
Example 1. Sending Microsoft Teams Post