---
title: "Restore-VETItem"
description: "Restores Microsoft Teams items. Product: Veeam Backup for Microsoft 365 Product Edition: Community, Rental License, Subscription License This cmdlet provides the following parameter sets: This cmdlet allows you to restore Microsoft Teams items: You c"
canonical: "https://helpcenter.veeam.com/docs/vbo365/explorers_powershell/restore-vetitem.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft Teams > Restore-VETItem"
dateModified: "2026-08-20"
---

# Restore-VETItem

## Short Description
Restores Microsoft Teams items.

**Product**: Veeam Backup for Microsoft 365

**Product Edition**: Community, Rental License, Subscription License

## Syntax

This cmdlet provides the following parameter sets:

<ul class="syntax-sets">
  <li>
    <p><code>RestorePostParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-Channel] <VETChannel> -PostsFrom <DateTime> [-PostsTo <DateTime>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreAllPostParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-Channel] <VETChannel> [-AllPosts] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreFileParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-RestoreChangedItem] [-RestoreMissingItem] [-File] <VETFile[]>
 [-RestoreOnlyLatestVersion] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOtherTabParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-RestoreChangedItem] [-RestoreMissingItem] [-Tab] <VETOtherTab[]> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreChannelParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-Channel] <VETChannel> [-RestoreChangedItem] [-RestoreMissingItem]
 [-RestoreMembers] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreTeamParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-RestoreChangedItem] [-RestoreMissingItem] [-Team] <VETTeam>
 [-RestoreMembers] [-RestoreSettings] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreMultipleTeamsParameterSet</code></p>

```
Restore-VETItem -Credential <PSCredential> [-RestoreChangedItem] [-RestoreMissingItem]
 [-MultipleTeams] <VETTeam[]> [-RestoreMembers] [-RestoreSettings] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyAllPostParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-Channel] <VETChannel> [-AllPosts] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAllPostParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-Channel] <VETChannel> [-AllPosts] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyPostParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-Channel] <VETChannel> -PostsFrom <DateTime>
 [-PostsTo <DateTime>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthPostParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-Channel] <VETChannel> -PostsFrom <DateTime> [-PostsTo <DateTime>] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyFileParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-RestoreChangedItem] [-RestoreMissingItem] [-File] <VETFile[]>
 [-RestoreOnlyLatestVersion] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthFileParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-RestoreChangedItem] [-RestoreMissingItem] [-File] <VETFile[]>
 [-RestoreOnlyLatestVersion] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyOtherTabParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-RestoreChangedItem] [-RestoreMissingItem]
 [-Tab] <VETOtherTab[]> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthOtherTabParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-RestoreChangedItem] [-RestoreMissingItem] [-Tab] <VETOtherTab[]> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyChannelParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-Channel] <VETChannel> [-RestoreChangedItem]
 [-RestoreMissingItem] [-RestoreMembers] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthChannelParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-Channel] <VETChannel> [-RestoreChangedItem] [-RestoreMissingItem]
 [-RestoreMembers] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyTeamParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-RestoreChangedItem] [-RestoreMissingItem] [-Team] <VETTeam>
 [-ImpersonationAccountName <String>] [-RestoreMembers] [-RestoreSettings] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthTeamParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-RestoreChangedItem] [-RestoreMissingItem] [-Team] <VETTeam>
 [-RestoreMembers] [-RestoreSettings] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthAppOnlyMultipleTeamsParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> -ApplicationCertificatePath <String>
 -ApplicationCertificatePassword <SecureString> [-RestoreChangedItem] [-RestoreMissingItem]
 [-MultipleTeams] <VETTeam[]> [-ImpersonationAccountName <String>] [-RestoreMembers] [-RestoreSettings] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>RestoreOAuthMultipleTeamsParameterSet</code></p>

```
Restore-VETItem -ApplicationId <Guid> [-RestoreChangedItem] [-RestoreMissingItem] [-MultipleTeams] <VETTeam[]>
 [-RestoreMembers] [-RestoreSettings] [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet allows you to restore Microsoft Teams items:

- Teams
- Channels
- Posts
- Files
- Tabs

You can restore Microsoft Teams items with one of the following authentication methods:

- Authentication methods that use legacy protocols.
- Multi-factor authentication. To restore data, the cmdlet uses a Microsoft Entra application.

::: note

To perform restore operations, you must first start a restore session. For more information on how to start a restore session, see [`Start-VBOTeamsItemRestoreSession`](start-vboteamsitemrestoresession.md).

:::

## Parameters

<table style="width:100%;" class="Blue_Table">
      <tr style="vertical-align:top">
        <th style="width:20%;">
          <p>Parameter</p>
        </th>
        <th style="width:20%;">
          <p>Description</p>
        </th>
        <th style="width:20%;">
          <p>Type</p>
        </th>
        <th style="width:10%;">
          <p>Required</p>
        </th>
        <th style="width:10%;">
          <p>Position</p>
        </th>
        <th style="width:10%;">
          <p>Accept Pipeline Input</p>
        </th>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">AllPosts</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore all posts of a Microsoft Teams channel.</p><p>Default: <em>False</em></p><p><strong>Note</strong>: If you use this parameter, you cannot use the <code>PostsFrom</code> and <code>PostsTo</code> parameters.</p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationCertificatePassword</span></p>
        </td>
        <td>
          <p>To restore data using multi-factor authentication.</p><p>Specifies the certificate password. The cmdlet will use this password to confirm the certificate that you want to import to a Microsoft Entra application.</p>
        </td>
        <td style="width:10%;">
          <p><code>SecureString</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationCertificatePath</span></p>
        </td>
        <td>
          <p>To restore data using multi-factor authentication.</p><p>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.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ApplicationId</span></p>
        </td>
        <td>
          <p>To restore data using multi-factor authentication.</p><p>Specifies a Microsoft Entra application ID. The cmdlet will use this application ID to set up a secure connection to a Microsoft organization.</p>
        </td>
        <td style="width:10%;">
          <p><code>Guid</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Channel</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft Teams team channel. The cmdlet will restore items of this channel.</p><p>Accepts the <a href="vetchannel.md"><code>VETChannel</code></a> object. To get this object, run the <a href="get-vetchannel.md"><code>Get-VETChannel</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vetchannel.md"><code>VETChannel</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Credential</span></p>
        </td>
        <td>
          <p>Specifies credentials that will be used for authenticating to the Microsoft 365 organization.</p><p>Accepts the <code>PSCredential</code> object. To get this object, run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential) cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">File</span></p>
        </td>
        <td>
          <p>Specifies Microsoft Teams team channel files. The cmdlet will restore the specified files.</p><p>Accepts the <a href="vetfile.md"><code>VETFile</code></a><code>[]</code> object. To get this object, run the <a href="get-vetfile.md"><code>Get-VETFile</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vetfile.md"><code>VETFile[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">ImpersonationAccountName</span></p>
        </td>
        <td>
          <p>To restore data using multi-factor authentication.</p><p>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 365. Use this parameter together with the <code>ApplicationCertificatePassword</code> parameter.</p><p>If you omit this parameter, the cmdlet will restore a team using an original team owner account from the backup.</p>
        </td>
        <td style="width:10%;">
          <p><code>String</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">MultipleTeams</span></p>
        </td>
        <td>
          <p>Specifies Microsoft Teams teams. The cmdlet will restore items of these teams.</p><p>Accepts the <a href="vetteam.md"><code>VETTeam</code></a><code>[]</code> object. To get this object, run the <a href="get-vetteam.md"><code>Get-VETTeam</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vetteam.md"><code>VETTeam[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PostsFrom</span></p>
        </td>
        <td>
          <p>Specifies the point in time that defines the start of the period for which you want to restore posts of a Microsoft Teams channel.</p><p>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.</p><p><strong>Note</strong>: If you use this parameter, you cannot use the <code>AllPosts</code> parameter.</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">PostsTo</span></p>
        </td>
        <td>
          <p>Specifies the point in time that defines the end of the period for which you want to restore posts of a Microsoft Teams channel.</p><p>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.</p><p><strong>Note</strong>: If you use this parameter, you cannot use the <code>AllPosts</code> parameter.</p>
        </td>
        <td style="width:10%;">
          <p><code>DateTime</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestoreChangedItem</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore items that have changed in the original location since the time when the backup was created.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestoreMembers</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore team members of the specified team along with their roles.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestoreMissingItem</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore items that are missing in the original location.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestoreOnlyLatestVersion</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore only the latest version of a backed-up file.</p><p>If you do not use this parameter, Veeam Explorer for Microsoft Teams will restore all versions of a file from the backup.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">RestoreSettings</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will restore settings of the specified team.</p><p>Default: <em>False</em></p>
        </td>
        <td style="width:10%;">
          <p><code>SwitchParameter</code></p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Tab</span></p>
        </td>
        <td>
          <p>Specifies Microsoft Teams channel tabs. The cmdlet will restore the specified tabs.</p><p>Accepts the <a href="vetothertab.md"><code>VETOtherTab</code></a><code>[]</code> object. To get this object, run the <a href="get-vetothertab.md"><code>Get-VETOtherTab</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vetothertab.md"><code>VETOtherTab[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Team</span></p>
        </td>
        <td>
          <p>Specifies Microsoft Teams team. The cmdlet will restore items of this team.</p><p>Accepts the <a href="vetteam.md"><code>VETTeam</code></a> object. To get this object, run the <a href="get-vetteam.md"><code>Get-VETTeam</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vetteam.md"><code>VETTeam</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>0</p>
        </td>
        <td style="width:10%;">
          <p>True (ByValue)</p>
        </td>
      </tr>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the [About Common Parameters](http://go.microsoft.com/fwlink/p/?LinkID=113216) section of Microsoft Learn.

## Examples

::: example
### Example 1. Restoring Microsoft Teams Posts

This example shows how to restore posts of the `General` Microsoft Teams team channel created between `7/1/2026 10:00 AM` and `8/31/2026 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/2026 10:00 AM" -PostsTo "8/31/2026 10:00 AM"
```

Perform the following steps:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/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.
2. Get the Microsoft Teams channel:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.
   4. Run the [`Get-VETChannel`](get-vetchannel.md) cmdlet. Set the `$team` variable as the `Team` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$channel` variable.

3. 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.

:::

::: example
### Example 2. Restoring Microsoft Teams Channel

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:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/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.
2. Get the Microsoft Teams channel:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.
   4. Run the [`Get-VETChannel`](get-vetchannel.md) cmdlet. Set the `$team` variable as the `Team` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$channel` variable.

3. 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.

:::

::: example
### Example 3. Restoring Microsoft Teams Files

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:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/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.
2. Get the files:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.
   4. Run the [`Get-VETChannel`](get-vetchannel.md) cmdlet. Set the `$team` variable as the `Team` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$channel` variable.
   5. Run the [`Get-VETFile`](get-vetfile.md) cmdlet. Set the `$channel` variable as the `Channel` parameter value. Specify the `Query` parameter value. Save the result to the `$file` variable.

3. 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.

:::

::: example
### Example 4. Restoring Microsoft Teams Channel Tab

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:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/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.
2. Get the Microsoft Teams channel tab:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.
   4. Run the [`Get-VETChannel`](get-vetchannel.md) cmdlet. Set the `$team` variable as the `Team` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$channel` variable.
   5. Run the [`Get-VETOtherTab`](get-vetothertab.md) cmdlet. Set the `$channel` variable as the `Channel` parameter value. Specify the `Query` parameter value. Save the result to the `$tab` variable.

3. 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.

:::

::: example
### Example 5. Restoring Microsoft Teams Team

This example shows how to restore the `IT` Microsoft Teams team 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:

1. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/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.
2. Get the Microsoft Teams team:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.

3. 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.

:::

::: example
### Example 6. Restoring Microsoft Teams Channel Using Multi-Factor Authentication with Microsoft Entra Application ID

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` Microsoft Entra 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:

1. Get the Microsoft Teams channel:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.
   4. Run the [`Get-VETChannel`](get-vetchannel.md) cmdlet. Set the `$team` variable as the `Team` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$channel` variable.

2. 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.

3. To set up a secure connection to a Microsoft organization, open the [https://microsoft.com/devicelogin](https://microsoft.com/devicelogin) link in a browser and enter the code that you get in the PowerShell Console for authenticating to the Microsoft 365 server.

:::

::: example
### Example 7. Restoring Microsoft Teams Channel Using Multi-Factor Authentication with Microsoft Entra Application Certificate

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` Microsoft Entra 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\Cert.pfx" -ApplicationCertificatePassword $securepassword -Channel $channel -RestoreChangedItem -RestoreMissingItem
```

Perform the following steps:

1. Get the Microsoft Teams channel:

   1. Run the [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md) cmdlet. Save the result to the `$session` variable.
   2. Run the [`Get-VETOrganization`](get-vetorganization.md) 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.
   3. Run the [`Get-VETTeam`](get-vetteam.md) cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$team` variable.
   4. Run the [`Get-VETChannel`](get-vetchannel.md) cmdlet. Set the `$team` variable as the `Team` parameter value. Specify the `DisplayName` parameter value. Save the result to the `$channel` variable.

2. Run the [`Read-Host`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/read-host) cmdlet to specify the password. Specify the text that will show up in the password prompt window in the `Prompt` parameter. Specify the `AsSecureString` parameter to convert the password to a secure string.
3. Enter the password.
4. 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.

:::

## Related Commands

- [`Get-VBOTeamsItemRestoreSession`](get-vboteamsitemrestoresession.md)
- [`Get-VETOrganization`](get-vetorganization.md)
- [`Get-VETTeam`](get-vetteam.md)
- [`Get-VETChannel`](get-vetchannel.md)
- [`Get-VETFile`](get-vetfile.md)
- [`Get-VETOtherTab`](get-vetothertab.md)