---
title: "Get-VETFile"
description: "Returns files published in Microsoft Teams team channels. Product: Veeam Backup for Microsoft 365 Product Edition: Community, Rental License, Subscription License This cmdlet provides the following parameter sets: This cmdlet returns files published "
canonical: "https://helpcenter.veeam.com/docs/vbr/explorers_powershell/get-vetfile.html"
breadcrumb: "Veeam Explorers PowerShell Reference > Veeam Explorers PowerShell Reference > Veeam Explorer for Microsoft Teams > Get-VETFile"
dateModified: "2026-08-18"
---

# Get-VETFile

## Short Description
Returns files published in Microsoft Teams team channels.

**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>QueryByChannelParameterSet</code></p>

```
Get-VETFile -Channel <VETChannel> [-Query <String>] [-Recurse] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>QueryByFileParameterSet</code></p>

```
Get-VETFile -Channel <VETChannel> -ParentFile <VETFile> [-Query <String>] [-Recurse] [<CommonParameters>]
```
  </li>
  <li>
    <p><code>QueryByOrganizationParameterSet</code></p>

```
Get-VETFile [-Query <String>] -Organization <VETOrganization[]> [<CommonParameters>]
```
  </li>
  <li>
    <p><code>QueryByTeamParameterSet</code></p>

```
Get-VETFile [-Query <String>] -Team <VETTeam> [<CommonParameters>]
```
  </li>
</ul>

## Detailed Description
This cmdlet returns files published in Microsoft Teams team channels. You can get files from the following backed-up sources:

- Microsoft Teams organization
- Microsoft Teams team
- Microsoft Teams channel

## 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">Channel</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft Teams team channel. The cmdlet will return files from 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>Named</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">Organization</span></p>
        </td>
        <td>
          <p>Specifies an array of Microsoft Teams organizations. The cmdlet will return files from these organizations.</p><p>Accepts the <a href="vetorganization.md"><code>VETOrganization</code></a><code>[]</code> object. To get this object, run the <a href="get-vetorganization.md"><code>Get-VETOrganization</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vetorganization.md"><code>VETOrganization[]</code></a></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</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">ParentFile</span></p>
        </td>
        <td>
          <p>Specifies a folder. The cmdlet will return files from this folder.</p><p>Accepts the <a href="vetfile.md"><code>VETFile</code></a> object. To get this object, run the <code>Get-VETFile</code> 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>Named</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">Query</span></p>
        </td>
        <td>
          <p>Specifies a query string for file search. The cmdlet will return files that match the search query from the specified organization, team, channel or folder.</p><p>For more information, see the <a href="https://helpcenter.veeam.com/docs/vbo365/guide/appendix_search.html?ver=8">Appendix A. Item Search Parameters</a> section of the Veeam Backup for Microsoft 365 User Guide.</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">Recurse</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will return the specified folder and all files in this folder.</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">Team</span></p>
        </td>
        <td>
          <p>Specifies a Microsoft Teams team. This cmdlet will return files from 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>Named</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 Docs.

## Output Object
The cmdlet returns the [`VETFile`](vetfile.md)`[]` array that contains Microsoft Teams files.

## Examples

::: example
### Example 1. Getting Files from Channel

This example shows how to get all files from the `General` channel.

```
$session = Get-VBOTeamsItemRestoreSession
$org = Get-VETOrganization -Session $session -Name "ABC*"
$team = Get-VETTeam -Organization $org -DisplayName "IT"
$channel = Get-VETChannel -Team $team -DisplayName "General"
Get-VETFile -Channel $channel
```

Perform the following steps:

1. Get the 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 `Get-VETFile` cmdlet. Set the `$channel` variable as the `Channel` parameter value.

:::

::: example
### Example 2. Getting Files from Organization

This example shows how to get the `report.txt` file from the `ABC` organization.

```
$session = Get-VBOTeamsItemRestoreSession
$org = Get-VETOrganization -Session $session -Name "ABC*"
Get-VETFile -Organization $org -Query "filename: report"
```

Perform the following steps:

1. Get the organization:

   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.

2. Run the `Get-VETFile` cmdlet. Set the `$org` variable as the `Organization` parameter value. Specify the `Query` parameter value.

:::

::: example
### Example 3. Getting Files from Team

This example shows how to get files from the `IT` team.

```
$session = Get-VBOTeamsItemRestoreSession
$org = Get-VETOrganization -Session $session -Name "ABC*"
$team = Get-VETTeam -Organization $org -DisplayName "IT"
Get-VETFile -Team $team
```

Perform the following steps:

1. Get the 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.

2. Run the `Get-VETFile` cmdlet. Set the `$team` variable as the `Team` parameter value.

:::

## Related Commands

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