Export-VEADItem

Short Description

Exports backed-up Active Directory objects and containers.

Note

In Veeam Backup & Replication 13.1, this cmdlet became deprecated. Use the Start-VEADItemExport cmdlet to export Active Directory objects and containers.

Product: Veeam Backup & Replication

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

Syntax

This cmdlet provides the following parameter sets:

ItemsParameterSet

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

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

Detailed Description

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

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
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.	`VEADContainer`	True	Named	True (ByValue)
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
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.	`VEADItem[]`	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

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About Common Parameters section of Microsoft Learn.

Examples

Export-VEADItem Example 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:

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 this example, it is the fourth restore session in the array).
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.
Run the Get-VEADContainer cmdlet. Set the $domain variable as the Domain parameter value. Save the result to the $parentcontainer variable.
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.
Run the Export-VEADItem cmdlet. Set the $object variable as the Item parameter value. Specify the Path parameter value.

Export-VEADItem Example 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:

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 this example, it is the fourth restore session in the array).
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.
Run the Get-VEADContainer cmdlet. Set the $domain variable as the Domain parameter value. Note the ordinal number of the necessary container (in this example, it is the fourth container in the array). Save the result to the $container variable.
Run the Export-VEADItem cmdlet. Set the $container variable as the Container parameter value and select the necessary container. Specify the Path parameter value.