---
title: "Copy-VBRLinuxGuestItem"
description: "Copies Linux-based or Unix-based guest OS files to the target host. Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License This cmdlet copies Linux-based or Unix-based guest OS files to the target host."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/copy-vbrlinuxguestitem.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Guest OS File Recovery > Copy-VBRLinuxGuestItem"
dateModified: "2026-08-19"
---

# Copy-VBRLinuxGuestItem

## Short Description
Copies Linux-based or Unix-based guest OS files to the target host.

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

## Syntax
```
Copy-VBRLinuxGuestItem -Item <VBRFLRFsItem[]> -LinuxFlrObject <VBRLinuxFlrObject> -Server <CHost>
 -TargetFolder <String> [-Datastore <VBRViDatastoreBase>] [-KeepPermissionsAndOwnership]
 [-ShareCredentials <PSCredential>] [<CommonParameters>]
```

## Detailed Description
This cmdlet copies Linux-based or Unix-based guest OS files to the target host. You can use the following types of servers and hosts as the target hosts:

- Microsoft Windows Server
- Linux Server
- VMware vSphere Server
- VMware Cloud Director Server

## 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">Datastore</span></p>
        </td>
        <td>
          <p>Specifies the datastore where the target machine will be located. The cmdlet will copy the guest OS files to the machine located in this datastore.</p><p>Accepts the <code>VBRViDatastoreBase</code> object. To create this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>VBRViDatastoreBase</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 an array of files and folders that are available on disks of Linux-based or Unix-based machines. The cmdlet will copy these files and folders.</p><p>Accepts the <code>VBRFLRFsItem</code>[] object. To create 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>True (ByPropertyName, ByValue)</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">KeepPermissionsAndOwnership</span></p>
        </td>
        <td>
          <p>Defines that the cmdlet will keep custom permissions and the ownership of the copied guest OS files.</p><p>If you do not provide this parameter, the cmdlet will restore guest OS files with default permissions and ownership.</p><p>Default: <code>False</code>.</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">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 copy guest OS files.</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>False</p>
        </td>
      </tr>
      <tr style="vertical-align:top">
        <td>
          <p class="Table_Text_Bold"><span class="Table_Text_Bold">Server</span></p>
        </td>
        <td>
          <p>Specifies a target machine to which you want to copy guest OS files.</p><p>Accepts the <code>CHost</code> object. To create this object, run the <a href="get-vbrserver.md"><code>Get-VBRServer</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CHost</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">ShareCredentials</span></p>
        </td>
        <td>
          <p>For copying guest OS files to a shared folder.</p><p>Specifies credentials that you want to use to authenticate with the target shared folder to which you copy guest OS files.</p><p>Accepts the <code>PSCredential</code> object. To create this object, run the <a href="https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.3"><code>Get-Credential</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>PSCredential</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">TargetFolder</span></p>
        </td>
        <td>
          <p>Specifies a folder in the target machine. The cmdlet will copy the guest OS files to this folder.</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>
    </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).

## Examples

::: example
### Copying Linux-Based or Unix-Based Guest OS Files to Target Host

This example shows how to copy files from the `UbuntuSrv` to the `LinSrv07` target machine.

```
$backup = Get-VBRBackup -Name "UbuntuSrv"
$restorepoint = Get-VBRRestorePoint -Backup $backup
$server = Get-VBRServer -Name "LinSrv05"
$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server
$items = Get-VBRLinuxGuestItem -LinuxFlrObject $session
$targetserver = Get-VBRServer -Name "LinSrv07"
Copy-VBRLinuxGuestItem -Item $items -LinuxFlrObject $session -TargetFolder "/home/pictures" -Server $targetserver
```

Perform the following steps:

1. Start the restore session:

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

2. Run the [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md) cmdlet. Set the `$session` variable as the `LinuxFlrObject` parameter value. Save the result to the `$items` variable.
3. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$targetserver` variable.
4. Run the `Copy-VBRLinuxGuestItem` cmdlet. Specify the following settings:

   - Set the `$items` variable as the `Item` parameter value.
   - Set the `$session` variable as the `LinuxFlrObject` parameter value.
   - Specify the `TargetFolder` parameter value.
   - Set the `$targetserver` variable as the `Server` parameter value.

:::

## Related Commands

- [`Get-VBRBackup`](get-vbrbackup.md)
- [`Get-VBRRestorePoint`](get-vbrrestorepoint.md)
- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-VBRLinuxGuestItem`](get-vbrlinuxguestitem.md)