---
title: "Start-VBRLinuxGuestItemRestore"
description: "Restores Linux-based or Unix-based guest OS files. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet restores Linux-based or Unix-based guest OS files to the original or new location."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/start-vbrlinuxguestitemrestore.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Guest OS File Recovery > Start-VBRLinuxGuestItemRestore"
dateModified: "2026-08-19"
---

# Start-VBRLinuxGuestItemRestore

## Short Description
Restores Linux-based or Unix-based guest OS files.

**Product Edition**: Standard, Enterprise, Enterprise Plus, Veeam Universal License

## Syntax
```
Start-VBRLinuxGuestItemRestore -LinuxFlrObject <VBRLinuxFlrObject> -Item <VBRFLRFsItem[]>
 [-TargetDirectory <String>] [-Overwrite] [-GuestCredentials <CCredentials>] [-TargetViVm <CViVmItem>]
 [-TargetVcdVm <CVcdVmItem>] [-TargetHvVm <CHvVmItem>] [-TargetAgentMachine <VBRDiscoveredComputer>]
 [-RunAsync] [-ForceArchivedSnapshotsRestore] [<CommonParameters>]
```

## Detailed Description
This cmdlet restores Linux-based or Unix-based guest OS files to the original or new location.

## 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">ForceArchivedSnapshotsRestore</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will use archive snapshots for restore without showing warnings in the PowerShell console.</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">GuestCredentials</span></p>
        </td>
        <td>
          <p>Specifies the credentials to authenticate against the target machine.</p><p>Accepts the <code>CCredentials</code> object. To get this object, run the <a href="get-vbrcredentials.md"><code>Get-VBRCredentials</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CCredentials</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">Item</span></p>
        </td>
        <td>
          <p>Specifies the array of files and folders that are available on disks of Linux-based or Unix-based machines. The cmdlet will restore these files and folders.</p><p>Accepts the <code>VBRFLRFsItem</code>[] object. To get this object, run the <a href="get-vbrlinuxguestitem.md"><code>Get-VBRLinuxGuestItem</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRFLRFsItem[]</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">LinuxFlrObject</span></p>
        </td>
        <td>
          <p>Specifies a restore session of Linux-based or Unix-based guest OS files. The cmdlet will use this session to restore guest OS files.</p><p><strong>Note</strong>: The restore session must be started within the current PowerShell session.</p><p>Accepts the <code>VBRLinuxFlrObject</code> object. To create this object, run the <a href="start-vbrlinuxfilerestore.md"><code>Start-VBRLinuxFileRestore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRLinuxFlrObject</code></p>
        </td>
        <td style="width:10%;">
          <p>True</p>
        </td>
        <td style="width:10%;">
          <p>Named</p>
        </td>
        <td style="width:10%;">
          <p>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Overwrite</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will overwrite existing files and folders with files and folders from a backup.</p><p>If you set this parameter to the <code>$false</code> value, the cmdlet will not replace exiting files and folders. It will add the restored files and folders with the <em>_restored</em> postfix to the target machine.</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">RunAsync</span></p>
        </td>
        <td>
          <p>Defines that the command returns immediately without waiting for the task to complete.</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">TargetAgentMachine</span></p>
        </td>
        <td>
          <p>For performing restore to a Veeam Agent computer.</p><p>Specifies the target computer to which the cmdlet will restore guest OS files.</p><p>Accepts the <code>VBRDiscoveredComputer</code> object. To get this object, run the <a href="get-vbrdiscoveredcomputer.md"><code>Get-VBRDiscoveredComputer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrdiscoveredcomputer.md"><code>VBRDiscoveredComputer</code></a></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">TargetDirectory</span></p>
        </td>
        <td>
          <p>Specifies the path to a folder on the target VM to which you want to restore files.</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">TargetHvVm</span></p>
        </td>
        <td>
          <p>For performing restore to the Hyper-V platform.</p><p>Specifies the target machine to which the cmdlet will restore guest OS files.</p><p><strong>Note</strong>: This parameter will work only if source machine is restored or deleted.</p><p>Accepts the <code>CHvVmItem</code> object. To get this object, run the <a href="find-vbrhventity.md"><code>Find-VBRHvEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHvVmItem</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">TargetVcdVm</span></p>
        </td>
        <td>
          <p>For performing restore to the Cloud Director platform.</p><p>Specifies the target machine to which the cmdlet will restore guest OS files.</p><p><strong>Note</strong>: This parameter will work only if source machine is restored or deleted.</p><p>Accepts the <code>CVcdVmItem</code> object. To get this object, run the <a href="find-vbrvcloudentity.md"><code>Find-VBRvCloudEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CVcdVmItem</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">TargetViVm</span></p>
        </td>
        <td>
          <p>For performing restore to the VMware platform.</p><p>Specifies the target machine to which the cmdlet will restore guest OS files.</p><p><strong>Note</strong>: This parameter will work only if source machine is restored or deleted.</p><p>Accepts the <code>CViVmItem</code> object. To get this object, run the <a href="find-vbrvientity.md"><code>Find-VBRViEntity</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViVmItem</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>
    </table>

`<CommonParameters>`

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see [ Microsoft Docs](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_commonparameters?view=powershell-7).

## Output Object
The cmdlet returns the `CRestoreTaskSession` object that contains setting of an operation that you perform to restore Linux-based or Unix-based guest OS files to the source machine.

## Examples

::: example
### Example 1. Restoring Linux-Based or Unix-Based Guest OS Files to Original Location

This example shows how to restore Linux-based or Unix-based guest OS files of the `UbuntuSrv` VM to the original host with the following settings:

- The cmdlet will overwrite existing files and folders.
- The cmdlet will use the `LinSrv05` machine as a helper appliance.

```
$backup = Get-VBRBackup -Name "UbuntuSrv"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$server = Get-VBRServer -Name "LinSrv05"
$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server
$root = Get-VBRLinuxGuestItem -LinuxFlrObject $session
$child = Get-VBRLinuxGuestItem -LinuxFlrObject $session -ParentItem $root
$creds = Get-VBRCredentials
Start-VBRLinuxGuestItemRestore -LinuxFlrObject $session -Item $child[3] -GuestCredentials $creds -Overwrite
```

Perform the following steps:

1. Mount the disk and get the OS files:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the [`Start-VBRLinuxFileRestore`](start-vbrlinuxfilerestore.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Set the `$server` variable as the `MountServer` parameter value. Save the result to the `$session` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Save the result to the `$root` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Set the `$root` variable as the `ParentItem` parameter value. Save the result to the `$child` variable.

     The `Get-VBRLinuxGuestItem` cmdlet will return an array of files and folders. Consider that the array numbering starts with 0. In our example, the fourth item in the array is used.

   - Run the [`Get-VBRCredentials`](get-vbrcredentials.md) cmdlet. Save the result to the `$creds` variable.

2. Run the `Start-VBRLinuxGuestItemRestore` cmdlet. Specify the following settings:

   - Set the `$session` variable as the `LinuxFlrObject` parameter value.
   - Set the `$child` variable as the `Item` parameter value.
   - Set the `$creds` variable as the `GuestCredentials` parameter value.
   - Provide the `Overwrite` parameter.

:::

::: example
### Example 2. Restoring Linux-Based or Unix-Based Guest OS Files to VMware Platform

This example shows how to restore Linux-based or Unix-based guest OS files of the `UbuntuSrv` VM to the `UbuntuSrv07` that is located on the VMware platform with the following settings:

- The cmdlet will add the restored files and folders with the `_restored` postfix to the `UbuntuSrv` VM.
- The cmdlet will use the `LinSrv05` machine as a helper appliance.

```
$backup = Get-VBRBackup -Name "UbuntuSrv"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$server = Get-VBRServer -Name "LinSrv05"
$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server
$root = Get-VBRLinuxGuestItem -LinuxFlrObject $session
$child = Get-VBRLinuxGuestItem -LinuxFlrObject $session -ParentItem $root
$targetvm = Find-VBRViEntity -Name UbuntuSrv07
Start-VBRLinuxGuestItemRestore -LinuxFlrObject $session -Item $child[3] -TargetViVm $targetvm -Overwrite
```

Perform the following steps:

1. Mount the disk and get the OS files:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the [`Start-VBRLinuxFileRestore`](start-vbrlinuxfilerestore.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Set the `$server` variable as the `MountServer` parameter value. Save the result to the `$session` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Save the result to the `$root` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Set the `$root` variable as the `ParentItem` parameter value. Save the result to the `$child` variable.

     The `Get-VBRLinuxGuestItem` cmdlet will return an array of files and folders. Consider that the array numbering starts with 0. In our example, the fourth item is used.

2. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetvm` variable.
3. Run the `Start-VBRLinuxGuestItemRestore` cmdlet. Specify the following settings:

   - Set the `$session` variable as the `LinuxFlrObject` parameter value.
   - Set the `$child` variable as the `Item` parameter value.
   - Set the `$targetvm` variable as the `TargetViVm` parameter value.
   - Provide the `Overwrite` parameter.

:::

::: example
### Example 3. Restoring Linux-Based or Unix-Based Guest OS Files to Cloud Director Platform

This example shows how to restore Linux-based or Unix-based guest OS files of the `UbuntuSrv` VM to the `UbuntuSrv04` that is located on the Cloud Director platform. The cmdlet will add the restored files and folders with the *_restored* postfix to the `UbuntuSrv04` VM.

```
$backup = Get-VBRBackup -Name "UbuntuSrv"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$mountserver = Get-VBRServer -Name "LinSrv05"
$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $mountserver
$root = Get-VBRLinuxGuestItem -LinuxFlrObject $session
$child = Get-VBRLinuxGuestItem -LinuxFlrObject $session -ParentItem $root
$targetvm = Find-VBRvCloudEntity -Name "UbuntuSrv04"
Start-VBRLinuxGuestItemRestore -LinuxFlrObject $session -Item $child[3] -TargetVcdVm $targetvm -Overwrite:$false
```

Perform the following steps:

1. Start the restore session and get the OS files:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$mountserver` variable.
   - Run the [`Start-VBRLinuxFileRestore`](start-vbrlinuxfilerestore.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Set the `$server` variable as the `MountServer` parameter value. Save the result to the `$session` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Save the result to the `$root` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Set the `$root` variable as the `ParentItem` parameter value. Save the result to the `$child` variable.

     The `Get-VBRLinuxGuestItem` cmdlet will return an array of files and folders. Consider that the array numbering starts with 0. In our example, the fourth item is used.

2. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetvm` variable.
3. Run the `Start-VBRLinuxGuestItemRestore` cmdlet. Specify the following settings:

   - Set the `$session` variable as the `LinuxFlrObject` parameter value.
   - Set the `$items` variable as the `Item` parameter value.
   - Set the `$targetvm` variable as the `TargetVcdVm` parameter value.
   - Set the `Overwrite` parameter value to `$false`.

:::

::: example
### Example 4. Restoring Linux-Based or Unix-Based Guest OS Files to Hyper-V Platform

This example shows how to restore Linux-based or Unix-based guest OS files of the `UbuntuSrv` VM to the `UbuntuSrv07` that is located on the Hyper-V platform. The cmdlet will add the restored files and folders with the *_restored* postfix to the `UbuntuSrv` VM.

```
$backup = Get-VBRBackup -Name "UbuntuSrv"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$server = Get-VBRServer -Name "LinSrv05"
$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server
$root = Get-VBRLinuxGuestItem -LinuxFlrObject $session
$child = Get-VBRLinuxGuestItem -LinuxFlrObject $session -ParentItem $root
$targetvm = Find-VBRHvEntity -HostsAndVMs -Name "UbuntuSrv07"
Start-VBRLinuxGuestItemRestore -LinuxFlrObject $session -Item $child[3] -TargetHvVm $targetvm -Overwrite:$false
```

Perform the following steps:

1. Start the restore session and get the OS files:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the [`Start-VBRLinuxFileRestore`](start-vbrlinuxfilerestore.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Set the `$server` variable as the `MountServer` parameter value. Save the result to the `$session` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Save the result to the `$root` variable.

     The `Get-VBRLinuxGuestItem` cmdlet will return an array of files and folders. Consider that the array numbering starts with 0. In our example, the fourth item is used.

   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Set the `$root` variable as the `ParentItem` parameter value. Save the result to the `$child` variable.

2. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetvm` variable.
3. Run the `Start-VBRLinuxGuestItemRestore` cmdlet. Specify the following settings:

   - Set the `$session` variable as the `LinuxFlrObject` parameter value.
   - Set the `$items` variable as the `Item` parameter value.
   - Set the `$targetvm` variable as the `TargetHvVm` parameter value.
   - Set `:$false` as the `Overwrite` parameter value.

:::

::: example
### Example 5. Restoring Veeam Agent Files to Another Veeam Agent Computer

This example shows how to restore Linux-based or Unix-based guest OS files of an `UbuntuSrv` computer to the computer in the `UbuntuAgent` protection group.

```
$backup = Get-VBRBackup -Name "UbuntuSrv"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$server = Get-VBRServer -Name "LinSrv05"
$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server
$root = Get-VBRLinuxGuestItem -LinuxFlrObject $session
$child = Get-VBRLinuxGuestItem -LinuxFlrObject $session -ParentItem $root
$group = Get-VBRProtectionGroup -Name "UbuntuAgent"
$targetmachine = Get-VBRDiscoveredComputer -ProtectionGroup $group
Start-VBRLinuxGuestItemRestore -LinuxFlrObject $session -Item $child[3] -TargetAgentMachine $targetmachine -Overwrite
```

Perform the following steps:

1. Start the restore session and get the OS files:

   - Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
   - Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Save the result to the `$restorepoint` variable.
   - Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
   - Run the [`Start-VBRLinuxFileRestore`](start-vbrlinuxfilerestore.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Set the `$server` variable as the `MountServer` parameter value. Save the result to the `$session` variable.
   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Save the result to the `$root` variable.

     The `Get-VBRLinuxGuestItem` cmdlet will return an array of files and folders. Consider that the array numbering starts with 0. In our example, the fourth item is used.

   - Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Set the `$root` variable as the `ParentItem` parameter value. Save the result to the `$child` variable.

2. Run the [`Get-VBRProtectionGroup`](get-vbrprotectiongroup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$group` variable.
3. Run the [`Get-VBRDiscoveredComputer`](get-vbrdiscoveredcomputer.md) cmdlet. Set the `$group` variable as the `ProtectionGroup` parameter value.
4. Run the `Start-VBRLinuxGuestItemRestore` cmdlet. Specify the following settings:

   - Set the `$session` variable as the `LinuxFlrObject` parameter value.
   - Set the `$child[3]` variable as the `Item` parameter value.
   - Set the `$targetmachine` variable as the `TargetAgentMachine` parameter value.
   - Specify the `Overwrite` parameter value.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrrestorepoint.md)
- [`Get-VBRServer`](get-vbrserver.md)
- [`Start-VBRLinuxFileRestore`](start-vbrlinuxfilerestore.md)
- [`Find-VBRViEntity`](find-vbrvientity.md)
- [`Find-VBRvCloudEntity`](find-vbrvcloudentity.md)
- [`Find-VBRHvEntity`](find-vbrhventity.md)