Restore-VETItem - Veeam Explorers PowerShell Reference

Parameter	Description	Type	Required	Position	Accept Pipeline Input
Credential	Specifies credentials that will be used to authenticate against the Microsoft Office 365 organization.	PSCredential	True	Named	False
Channel	Specifies a Microsoft Teams team channel. The cmdlet will restore items of this channel.	Accepts the VETChannel object. To get this object, run the Get-VETChannel cmdlet.	True	0	True (ByValue)
PostsFrom	Specifies the point in time that defines the start of the period for which you want to restore posts of a Microsoft Teams channel. The cmdlet will restore posts published within the specified time period. The time when a post was published is defined by the last modification time of the post. If you use this parameter, you cannot use the AllPosts parameter.	DateTime	False	Named	False
PostsTo	Specifies the point in time that defines the end of the period for which you want to restore posts of a Microsoft Teams channel. The cmdlet will restore posts publish within the specified time period. The time when a post was published is defined by the last modification time of the post. If you use this parameter, you cannot use the AllPosts parameter.	DateTime	False	Named	False
AllPosts	Defines that the cmdlet will restore all posts of a Microsoft Teams channel. If you use this parameter, you cannot use the PostsFrom and PostsTo parameters.	SwitchParameter	False	Named	False
RestoreChangedItem	Defines that the cmdlet will restore items that have changed in the original location since the time when the backup was created.	SwitchParameter	False	Named	False
RestoreMissingItem	Defines that the cmdlet will restore items that are missing in the original location.	SwitchParameter	False	Named	False
File	Specifies Microsoft Teams team channel files. The cmdlet will restore the specified files.	Accepts the VETFile[] type. To get this object, run the Get-VETFile cmdlet.	True	0	True (ByValue)
RestoreOnlyLatestVersion	Defines that the cmdlet will restore only the latest version of a backed-up file. If you do not use this parameter, Veeam Explorer for Microsoft Teams will restore all versions of a file from the backup.	SwitchParameter	False	Named	False
Tab	Specifies Microsoft Teams channel tabs. The cmdlet will restore the specified tabs.	Accepts the VETOtherTab[] type. To get this object, run the Get-VETOtherTab cmdlet.	True	0	True (ByValue)
Team	Specifies Microsoft Teams team. The cmdlet will restore items of this team.	Accepts the VETTeam type. To get this object, run the Get-VETTeam cmdlet.	True	0	True (ByValue)
MultipleTeam	Specifies Microsoft Teams teams. The cmdlet will restore items of these teams.	Accepts the VETTeam[] type. To get this object, run the Get-VETTeam cmdlet.	True	0	True (ByValue)
RestoreMembers	Defines that the cmdlet will restore team members of the specified team along with their roles.	SwitchParameter	False	Named	False
RestoreSettings	Defines that the cmdlet will restore settings of the specified team.	SwitchParameter	False	Named	False
ApplicationId	To restore data using Multi-factor authentication. Specifies an ID of an Azure AD application. The cmdlet will use this application ID to set up a secure connection to a Microsoft organization.	Guid	True	Named	False
ApplicationCertificatePath	To restore data using Multi-factor authentication. Specifies a path to the certificate. The cmdlet will import this certificate that is located in this path to set up an encrypted connection to a Microsoft organization.	String	True	Named	False
ApplicationCertificatePassword	To restore data using Multi-factor authentication. Specifies the certificate password. The cmdlet will use this password to confirm the certificate that you want to import to an Azure AD application. This parameter is obligatory.	SecureString	True	Named	False
ImpersonationAccountName	To restore data using Multi-factor authentication. Specifies a user name of the account that will be used as a team owner account to restore a team. This may be useful if you restore a previously removed team at the time when the original team owner account does not exist in Microsoft Office 365. Use this parameter together with the ApplicationCertificatePassword parameter. If you omit this parameter, the cmdlet will restore a team using an original team owner account from the backup.	String	True	Named	False

This example shows how to restore posts of the General Microsoft Teams team channel created between 7/1/2020 10:00 AM and 8/31/2020 10:00 AM.

$credentials = Get-Credential

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$channel = Get-VETChannel -Team $team -DisplayName "General"

Restore-VETItem -Credential $credentials -Channel $channel -PostsFrom "7/1/2020 10:00 AM" -PostsTo "8/31/2020 10:00 AM"

Perform the following steps:

Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the Microsoft 365 organization. Save the result to the $credentials variable.
Get the Microsoft Teams channel:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.

Run the Restore-VETItem cmdlet. Set the $credentials variable as the Credential parameter value. Set the $channel variable as the Channel parameter value. Specify the From and To parameter values.

This example shows how to restore the General Microsoft Teams team channel with the following settings:

The cmdlet will restore changed items.
The cmdlet will restore missing items.

$credentials = Get-Credential

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$channel = Get-VETChannel -Team $team -DisplayName "General"

Restore-VETItem -Credential $credentials -Channel $channel -RestoreChangedItem -RestoreMissingItem

Perform the following steps:

Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the Microsoft 365 organization. Save the result to the $credentials variable.
Get the Microsoft Teams channel:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.

Run the Restore-VETItem cmdlet. Specify the following settings:

Set the $credentials variable as the Credential parameter value.
Set the $channel variable as the Channel parameter value.
Provide the RestoreChangedItem parameter.
Provide the RestoreMissingItem parameter.

This example shows how to restore files of a Microsoft Teams team channel with the following settings:

The cmdlet will restore files whose names contain the report keyword.
The cmdlet will restore changed items.
The cmdlet will restore missing items.

$credentials = Get-Credential

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$channel = Get-VETChannel -Team $team -DisplayName "General"

$file Get-VETFile -Channel $channel -Query "filename: report"

Restore-VETItem -Credential $credentials -File $file -RestoreChangedItem -RestoreMissingItem

Perform the following steps:

Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the Microsoft 365 organization. Save the result to the $credentials variable.
Get the files:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.
Run the Get-VETFile cmdlet. Set the $channel variable as the Channel parameter value. Specify the Query parameter value. Save the result to the $file variable.

Run the Restore-VETItem cmdlet. Specify the following settings:

Set the $credentials variable as the Credential parameter value.
Set the $file variable as the File parameter value.
Provide the RestoreChangedItem parameter.
Provide the RestoreMissingItem parameter.

This example shows how to restore the Website Microsoft Teams team channel tab with the following settings:

The cmdlet will restore changed items.
The cmdlet will restore missing items.

$credentials = Get-Credential

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$channel = Get-VETChannel -Team $team -DisplayName "General"

$tab = Get-VETOtherTab -Channel $channel -Query "name: website"

Restore-VETItem -Credential $credentials -Tab $tab -RestoreChangedItem -RestoreMissingItem

Perform the following steps:

Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the Microsoft 365 organization. Save the result to the $credentials variable.
Get the Microsoft Teams channel tab:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.
Run the Get-VETOtherTab cmdlet. Set the $channel variable as the Channel parameter value. Specify the Query parameter value. Save the result to the $tab variable.

Run the Restore-VETItem cmdlet. Specify the following settings:

Set the $credentials variable as the Credential parameter value.
Set the $tab variable as the Tab parameter value.
Provide the RestoreChangedItem parameter.
Provide the RestoreMissingItem parameter.

This example shows how to restore the IT Microsoft Teams team channel with the following settings:

The cmdlet will restore changed items.
The cmdlet will restore missing items.
The cmdlet will restore team members.
The cmdlet will restore team settings.

$credentials = Get-Credential

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

Restore-VETItem -Credential $credentials -Team $team -RestoreChangedItem -RestoreMissingItem -RestoreMembers -RestoreSettings

Perform the following steps:

Run the Get-Credential cmdlet to create a credential object. Type credentials that you want to use for connecting to the Microsoft 365 organization. Save the result to the $credentials variable.
Get the Microsoft Teams channel:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.

Run the Restore-VETItem cmdlet. Specify the following settings:

Set the $credentials variable as the Credential parameter value.
Set the $team variable as the Team parameter value.
Provide the RestoreChangedItem parameter.
Provide the RestoreMissingItem parameter.
Provide the RestoreMembers parameter.
Provide the RestoreSettings parameter.

This example shows how to restore the General Microsoft Teams team channel with the following settings:

The cmdlet will use the c276f9ce-e4f2-4bdf-b9f2-e6c311c2e2a5 Azure AD application ID.

The cmdlet will restore changed items.
The cmdlet will restore missing items.

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$channel = Get-VETChannel -Team $team -DisplayName "General"

Restore-VETItem -ApplicationId "c276f9ce-e4f2-4bdf-b9f2-e6c311c2e2a5" -Channel $channel -RestoreChangedItem -RestoreMissingItem

Perform the following steps:

Get the Microsoft Teams channel:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.

Run the Restore-VETItem cmdlet. Specify the following settings:

Specify the ApplicationId parameter value
Set the $channel variable as the Channel parameter value.
Provide the RestoreChangedItem parameter.
Provide the RestoreMissingItem parameter.

To set up a secure connection to a Microsoft organization, open the https://microsoft.com/devicelogin link in a browser and enter the code that you get in the PowerShell Console to authenticate to the Microsoft Office 365 server.

This example shows how to restore the General Microsoft Teams team channel with the following settings:

The cmdlet will use the c276f9ce-e4f2-4bdf-b9f2-e6c311c2e2a5 Azure AD application ID.
The cmdlet will use the certificate located at the C:\Certificate\ path.

The cmdlet will restore changed items.
The cmdlet will restore missing items.

$session = Get-VBOTeamsItemRestoreSession

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

$team = Get-VETTeam -Organization $org -DisplayName "IT"

$channel = Get-VETChannel -Team $team -DisplayName "General"

$securepassword = Read-Host -Prompt "Enter password" -AsSecureString

Enter password: ********

Restore-VETItem -ApplicationId "c276f9ce-e4f2-4bdf-b9f2-e6c311c2e2a5" -ApplicationCertificatePath "C:\Certificate\" -ApplicationCertificatePassword $securepassword -Channel $channel -RestoreChangedItem -RestoreMissingItem

Perform the following steps:

Get the Microsoft Teams channel:

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. Save the result to the $org variable.
Run the Get-VETTeam cmdlet. Set the $org variable as the Organization parameter value. Specify the DisplayName parameter value. Save the result to the $team variable.
Run the Get-VETChannel cmdlet. Set the $team variable as the Team parameter value. Specify the DisplayName parameter value. Save the result to the $channel variable.

Run the Read-Host cmdlet to specify the password. Specify the text that will show up in the password prompt window in the Prompt parameter. Provide the AsSecureString parameter to convert the password to a secure string.
Enter the password.
Run the Restore-VETItem cmdlet. Specify the following settings:

Specify the ApplicationId parameter value
Specify the ApplicationCertificatePath parameter value.
Set the $securepassword variable as the ApplicationCertificatePassword parameter value.
Set the $channel variable as the Channel parameter value.
Provide the RestoreChangedItem parameter.
Provide the RestoreMissingItem parameter.