---
title: "New-VBRViADForestDomainRestoreSpec"
description: "This cmdlet creates the VBRADForestDomainRestoreSpec object. This object defines the target settings for restoring a domain controller VM on a VMware host during a Microsoft Active Directory forest restore."
canonical: "https://helpcenter.veeam.com/docs/vbr/powershell/new-vbrviadforestdomainrestorespec.html"
breadcrumb: "Veeam PowerShell Reference > Veeam PowerShell Reference > Data Recovery > Microsoft Active Directory Forest Restore > New-VBRViADForestDomainRestoreSpec"
dateModified: "2026-08-19"
---

# New-VBRViADForestDomainRestoreSpec

## Short Description
Creates a VMware domain restore specification for a Microsoft Active Directory forest restore.

**Platform**: VMware

**Product Edition**: Veeam Universal License

## Syntax
```
New-VBRViADForestDomainRestoreSpec [-RestorePoint] <VBRADForestDomainRestorePoint> -Credentials <PSCredential>
 -Server <CHost> -ResourcePool <CViResourcePoolItem> -Datastore <CViDatastoreItem> -Folder <CViFolderItem>
 -VMName <String> [-SourceNetwork <VBRViNetworkInfo[]>] [-TargetNetwork <VBRViNetworkInfo[]>] [<CommonParameters>]
```

## Detailed Description
This cmdlet creates the [`VBRADForestDomainRestoreSpec`](vbradforestdomainrestorespec.md) object. This object defines the target settings for restoring a domain controller VM on a VMware host during a Microsoft Active Directory forest restore. Create one specification for each domain controller you want to restore. Use this object with the [`Start-VBRADForestRestore`](start-vbradforestrestore.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">Credentials</span></p>
        </td>
        <td>
          <p>Specifies the guest OS credentials of the restored domain controller.</p><p>Accepts the <code>PSCredential</code> object. To get this object, run the <a href="https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.1"><code>Get-Credential</code></a> 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">Datastore</span></p>
        </td>
        <td>
          <p>Specifies the datastore on the target ESXi host where the domain controller VM files will be stored.</p><p>Accepts the <code>CViDatastoreItem</code> object. To get this object, run the <a href="find-vbrvidatastore.md"><code>Find-VBRViDatastore</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViDatastoreItem</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">Folder</span></p>
        </td>
        <td>
          <p>Specifies the VM folder in the vCenter Server inventory where the restored domain controller VM will appear.</p><p>Accepts the <code>CViFolderItem</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>CViFolderItem</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">ResourcePool</span></p>
        </td>
        <td>
          <p>Specifies the resource pool on the target ESXi host where the domain controller VM will be placed.</p><p>Accepts the <code>CViResourcePoolItem</code> object. To get this object, run the <a href="find-vbrviresourcepool.md"><code>Find-VBRViResourcePool</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><code>CViResourcePoolItem</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">RestorePoint</span></p>
        </td>
        <td>
          <p>Specifies the domain controller restore point to use for the restore operation.</p><p>Accepts the <a href="vbradforestdomainrestorepoint.md"><code>VBRADForestDomainRestorePoint</code></a> object. To get this object, run the <a href="get-vbradforestdomainrestorepoint.md"><code>Get-VBRADForestDomainRestorePoint</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbradforestdomainrestorepoint.md"><code>VBRADForestDomainRestorePoint</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 (ByPropertyName, ByValue)</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 the VMware ESXi host on which to restore the domain controller VM.</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">SourceNetwork</span></p>
        </td>
        <td>
          <p>Specifies the array of virtual networks connected to the domain controller VM in the source environment. Use this parameter together with the <code>TargetNetwork</code> parameter to configure network mapping. The <code>SourceNetwork</code> and <code>TargetNetwork</code> arrays must contain the same number of networks. Network mapping is required when you restore the domain controller VM to a host other than the original one.</p><p>Accepts the <a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo</code></a><code>[]</code> object. To get this object, run the <a href="get-vbrviservernetworkinfo.md"><code>Get-VBRViServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo[]</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">TargetNetwork</span></p>
        </td>
        <td>
          <p>Specifies the array of virtual networks connected to the target VMware host that the domain controller VM will be mapped to. Use this parameter together with the <code>SourceNetwork</code> parameter to configure network mapping. The <code>SourceNetwork</code> and <code>TargetNetwork</code> arrays must contain the same number of networks. Network mapping is required when you restore the domain controller VM to a host other than the original one.</p><p>Accepts the <a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo</code></a><code>[]</code> object. To get this object, run the <a href="get-vbrviservernetworkinfo.md"><code>Get-VBRViServerNetworkInfo</code></a> cmdlet.</p>
        </td>
        <td style="width:10%;">
          <p><a href="vbrvinetworkinfo.md"><code>VBRViNetworkInfo[]</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">VMName</span></p>
        </td>
        <td>
          <p>Specifies the name for the restored domain controller VM. The name can contain from 1 to 81 characters.</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).

## Output Object
The cmdlet returns the [`VBRADForestDomainRestoreSpec`](vbradforestdomainrestorespec.md) object that defines the target settings for restoring a domain controller VM on a VMware host.

## Examples

::: example
### Example 1. Creating VMware Domain Restore Specification

This example shows how to create a domain restore specification for a VMware environment.

```
$forest = Get-VBRADForest
$domain = Get-VBRADForestDomain -ADForest $forest
$domainRestorePoint = Get-VBRADForestDomainRestorePoint -Domain $domain
$server = Get-VBRServer -Name "esx01.company.local"
$credentials = Get-Credential
$resourcePool = Find-VBRViResourcePool -Server $server -Name "Resources"
$datastore = Find-VBRViDatastore -Server $server -Name "Datastore01"
$folder = Find-VBRViEntity -Server $server -Name "Discovered virtual machine"
$viSpec = New-VBRViADForestDomainRestoreSpec -RestorePoint $domainRestorePoint[0] -Credentials $credentials -Server $server -ResourcePool $resourcePool -Datastore $datastore -Folder $folder -VMName "DC01-Restored"
```

Perform the following steps:

1. Run the [`Get-VBRADForest`](get-vbradforest.md) cmdlet. Save the result to the `$forest` variable.
2. Run the [`Get-VBRADForestDomain`](get-vbradforestdomain.md) cmdlet. Set the `$forest` variable as the `ADForest` parameter value. Save the result to the `$domain` variable.
3. Run the [`Get-VBRADForestDomainRestorePoint`](get-vbradforestdomainrestorepoint.md) cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$domainRestorePoint` variable. The cmdlet returns an array of restore points (points in time); this example uses the first one (`$domainRestorePoint[0]`).
4. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
5. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.1) cmdlet. Save the result to the `$credentials` variable.
6. Run the [`Find-VBRViResourcePool`](find-vbrviresourcepool.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$resourcePool` variable.
7. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$datastore` variable.
8. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
9. Run the `New-VBRViADForestDomainRestoreSpec` cmdlet. Specify the following parameters:

   - Set the `$domainRestorePoint[0]` variable as the `RestorePoint` parameter value.
   - Set the `$credentials` variable as the `Credentials` parameter value.
   - Set the `$server` variable as the `Server` parameter value.
   - Set the `$resourcePool` variable as the `ResourcePool` parameter value.
   - Set the `$datastore` variable as the `Datastore` parameter value.
   - Set the `$folder` variable as the `Folder` parameter value.
   - Specify the `VMName` parameter value.

   Save the result to the `$viSpec` variable to use it with other cmdlets.

:::

::: example
### Example 2. Creating VMware Domain Restore Specification with Network Mapping

This example shows how to create a domain restore specification with network mapping for a VMware environment.

```
$forest = Get-VBRADForest
$domain = Get-VBRADForestDomain -ADForest $forest
$domainRestorePoint = Get-VBRADForestDomainRestorePoint -Domain $domain
$server = Get-VBRServer -Name "esx01.company.local"
$credentials = Get-Credential
$resourcePool = Find-VBRViResourcePool -Server $server -Name "Resources"
$datastore = Find-VBRViDatastore -Server $server -Name "Datastore01"
$folder = Find-VBRViEntity -Server $server -Name "Discovered virtual machine"
$sourceNetwork = Get-VBRViServerNetworkInfo -Server $server | Where-Object { $_.NetworkName -eq "VM Network" }
$targetNetwork = Get-VBRViServerNetworkInfo -Server $server | Where-Object { $_.NetworkName -eq "Restore Network" }
$viSpec = New-VBRViADForestDomainRestoreSpec -RestorePoint $domainRestorePoint[0] -Credentials $credentials -Server $server -ResourcePool $resourcePool -Datastore $datastore -Folder $folder -VMName "DC01-Restored" -SourceNetwork $sourceNetwork -TargetNetwork $targetNetwork
```

Perform the following steps:

1. Run the [`Get-VBRADForest`](get-vbradforest.md) cmdlet. Save the result to the `$forest` variable.
2. Run the [`Get-VBRADForestDomain`](get-vbradforestdomain.md) cmdlet. Set the `$forest` variable as the `ADForest` parameter value. Save the result to the `$domain` variable.
3. Run the [`Get-VBRADForestDomainRestorePoint`](get-vbradforestdomainrestorepoint.md) cmdlet. Set the `$domain` variable as the `Domain` parameter value. Save the result to the `$domainRestorePoint` variable. The cmdlet returns an array of restore points (points in time); this example uses the first one (`$domainRestorePoint[0]`).
4. Run the [`Get-VBRServer`](get-vbrserver.md) cmdlet. Specify the `Name` parameter value. Save the result to the `$server` variable.
5. Run the [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.1) cmdlet. Save the result to the `$credentials` variable.
6. Run the [`Find-VBRViResourcePool`](find-vbrviresourcepool.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$resourcePool` variable.
7. Run the [`Find-VBRViDatastore`](find-vbrvidatastore.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$datastore` variable.
8. Run the [`Find-VBRViEntity`](find-vbrvientity.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Specify the `Name` parameter value. Save the result to the `$folder` variable.
9. Run the [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Filter the result by the network name. Save the result to the `$sourceNetwork` variable.
10. Run the [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md) cmdlet. Set the `$server` variable as the `Server` parameter value. Filter the result by the network name. Save the result to the `$targetNetwork` variable.
11. Run the `New-VBRViADForestDomainRestoreSpec` cmdlet. Specify the following parameters:

    - Set the `$domainRestorePoint[0]` variable as the `RestorePoint` parameter value.
    - Set the `$credentials` variable as the `Credentials` parameter value.
    - Set the `$server` variable as the `Server` parameter value.
    - Set the `$resourcePool` variable as the `ResourcePool` parameter value.
    - Set the `$datastore` variable as the `Datastore` parameter value.
    - Set the `$folder` variable as the `Folder` parameter value.
    - Specify the `VMName` parameter value.
    - Set the `$sourceNetwork` variable as the `SourceNetwork` parameter value.
    - Set the `$targetNetwork` variable as the `TargetNetwork` parameter value.

    Save the result to the `$viSpec` variable to use it with other cmdlets.

:::

## Related Commands

- [`Get-VBRADForest`](get-vbradforest.md)
- [`Get-VBRADForestDomain`](get-vbradforestdomain.md)
- [`Get-VBRADForestDomainRestorePoint`](get-vbradforestdomainrestorepoint.md)
- [`Get-VBRServer`](get-vbrserver.md)
- [`Get-Credential`](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.security/get-credential?view=powershell-7.5)
- [`Find-VBRViResourcePool`](find-vbrviresourcepool.md)
- [`Find-VBRViDatastore`](find-vbrvidatastore.md)
- [`Find-VBRViEntity`](find-vbrvientity.md)
- [`Get-VBRViServerNetworkInfo`](get-vbrviservernetworkinfo.md)
- [`Start-VBRADForestRestore`](start-vbradforestrestore.md)