Export-VEADItem

Short Description

Exports backed-up Active Directory objects and containers.

Applies to

Veeam Backup & Replication

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Export Active Directory objects.

Export-VEADItem -Item <VEADItem[]> -Path <String> [-Force <SwitchParameter>] [<CommonParameters>]

  • Export Active Directory containers.

Export-VEADItem -Container <VEADContainer> -Path <String> [-Force <SwitchParameter>] [<CommonParameters>]

Detailed Description

This cmdlet exports backed-up Active Directory objects and containers.

Parameters

Parameter

Description

Type

Required

Position

Accept Pipeline Input

Item

For export of Active Directory objects.

Specifies an array of Active Directory objects. The cmdlet will export these objects.

Accepts the VEADItem[] object. To get this object, run the Get-VEADItem cmdlet.

True

Named

True (ByValue)

Container

For export of Active Directory containers.

Specifies an Active Directory container. The cmdlet will export that container.

Accepts the VEADContainer object. To get this object, run the Get-VEADContainer cmdlet.

True

Named

True (ByValue)

Path

Specifies the target path. The cmdlet will export Active Directory objects and containers to the location specified in this path.

String

True

Named

False

Force

Defines that the cmdlet will overwrite the existing Active Directory objects and containers with objects and containers from backup.

If you do not provide this parameter, the cmdlet will keep the existing version of Active Directory objects and containers.

Note: The cmdlet will show no prompt before executing the command.

SwitchParameter

False

Named

False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

Examples

Export-VEADItemExample 1. Exporting Active Directory Objects

This example shows how to export backed-up Active Directory objects.

$session = Get-VEADRestoreSession

$domain = Get-VEADDomain -Session $session[3]

$parentcontainer = Get-VEADContainer -Domain $domain

$object = Get-VEADItem -Container $parentcontainer[3]

Export-VEADItem -Item $object -Path "C:\AD objects"

Perform the following steps:

  1. Run the Get-VEADRestoreSession cmdlet. Save the result to the $session variable.

The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in our example, it is the fourth restore session in the array).

  1. Run the Get-VEADDomain cmdlet. Set the $session variable as the Session parameter value and select the necessary restore session. Save the result to the $domain variable.
  2. Run the Get-VEADContainer cmdlet. Set the $domain variable as the Domain parameter value. Save the result to the $parentcontainer variable.
  3. Run the Get-VEADItem cmdlet. Set the $parentcontainer variable as the Container parameter value and specify the ordinal number of the parent container. Save the result to the $object variable.
  4. Run the Export-VEADItem cmdlet. Set the $object variable as the Item parameter value. Specify the Path parameter value.

Export-VEADItemExample 2. Exporting Active Directory Container

This example shows how to export a backed-up Active Directory container.

$session = Get-VEADRestoreSession

$domain = Get-VEADDomain -Session $session[3]

$container = Get-VEADContainer -Domain $domain

Export-VEADItem -Container $container[3] -Path "C:\AD objects"

Perform the following steps:

  1. Run the Get-VEADRestoreSession cmdlet. Save the result to the $session variable.

The cmdlet will return an array of active restore sessions. Note the ordinal number of the necessary restore session (in our example, it is the fourth restore session in the array).

  1. Run the Get-VEADDomain cmdlet. Set the $session variable as the Session parameter value and select the necessary restore session. Save the result to the $domain variable.
  2. Run the Get-VEADContainer cmdlet. Set the $domain variable as the Domain parameter value. Note the ordinal number of the necessary container (in our example, it is the fourth container in the array). Save the result to the $container variable.
  3. Run the Export-VEADItem cmdlet. Set the $container variable as the Container parameter value and select the necessary container. Specify the Path parameter value.

Related Commands

Page updated 3/8/2024

Page content applies to build 12.1.2.172