---
title: "Connect-VBRWindowsGuestProductionMachine"
description: "Connects to the machine where original files and folders reside. Product Edition: Enterprise, Enterprise Plus, Veeam Universal License Connects to the machine where original files and folders reside."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/connect-vbrwindowsguestproductionmachine.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Guest OS File Recovery > Connect-VBRWindowsGuestProductionMachine"
dateModified: "2026-08-19"
---

# Connect-VBRWindowsGuestProductionMachine

## Short Description
Connects to the machine where original files and folders reside.

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

## Syntax
```
Connect-VBRWindowsGuestProductionMachine -FileRestore <FileRestore> [-GuestCredentials <CCredentials>] [<CommonParameters>]
```

## Detailed Description
Connects to the machine where original files and folders reside. You must launch this cmdlet before comparing files and folders using the [`Compare-VBRWindowsGuestItemsAttributes`](compare-vbrwindowsguestitemsattributes.md) cmdlet.

## 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">FileRestore</span></p>
        </td>
        <td>
          <p>Specifies a restore session of Microsoft Windows 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>FileRestore</code> object. To create this object, run the <a href="start-vbrwindowsfilerestore.md"><code>Start-VBRWindowsFileRestore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>FileRestore</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">GuestCredentials</span></p>
        </td>
        <td>
          <p>Specifies credentials for the original machine.</p><p><strong>Note</strong>: If you do not specify credentials, the cmdlet will try to use the credentials specified in the backup job that created the backup.</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>
    </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
### Connecting to Machine Where Files to Restore Reside

This example shows how to connect to a machine whose files you restore.

```
$backup = Get-VBRBackup -Name "WinSrv25"
$restorepoint = Get-VBRRestorePoint -Backup $backup -Name "Production VM"
$session = Start-VBRWindowsFileRestore -RestorePoint $restorepoint[1]
Connect-VBRWindowsGuestProductionMachine -FileRestore $session
```

Perform the following steps:

1. Run the [`Get-VBRBackup`](get-vbrbackup.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$backup` variable.
2. Run the [`Get-VBRRestorePoint`](get-vbrrestorepoint.md) cmdlet. Set the `$backup` variable as the `Backup` parameter value. Specify the `Name` parameter value. Save the result to the `$restorepoint` variable.

   The `Get-VBRRestorePoint` cmdlet will return an array of restore points. Mind the ordinal number of the necessary restore point (in our example, it is the second restore session in the array).

3. Run the [`Start-VBRWindowsFileRestore`](start-vbrwindowsfilerestore.md) cmdlet. Set the `$restorepoint` variable as the `RestorePoint` parameter value. Save the result to the `$session` variable.
4. Run the `Connect-VBRWindowsGuestProductionMachine` cmdlet. Set the `$session` variable as the `FileRestore` parameter value.

:::

## Related Commands

- [`Start-VBRWindowsFileRestore`](start-vbrwindowsfilerestore.md)
- [`Get-VBRCredentials`](get-vbrcredentials.md)