New-VBREntraIDTenantItemIncludedProperty

Short Description

Defines an object with item properties or references that you want to restore.

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

Syntax

New-VBREntraIDTenantItemIncludedProperty -PropertyId <String> [-GroupId <String>] [<CommonParameters>]

Detailed Description

This cmdlet defines an object with item properties or references that you want to restore.

To get the item properties and references that you can restore, use the Compare-VBREntraIDTenantItem cmdlet. This cmdlet can also help you define if a field is a property or reference.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
GroupId	Used for reference restore. Specifies a reference type.	`String`	False	Named	False
PropertyId	Specifies different values depending on what you plan to restore: [For property restore] Specifies a property name. A property can be a surname, city and others. [For reference restore] Specifies a reference ID. A reference can be a manager, group membership and others.	`String`	True	Named	False

<CommonParameters>

This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see Microsoft Docs.

Output Object

The cmdlet returns the VBREntraIDTenantItemIncludedProperty object that defines properties that you want to restore further.

Examples

New-VBREntraIDTenantItemIncludedProperty Example 1. Defining Object with Property

This example shows how to define an object that contains a property that you further want to restore.

$tenantRestoreSession = Get-VBREntraIDTenantRestoreSession -Id "901e32ac-4c9e-4f7a-9b36-a4fd0f7248fe"

$backup = Get-VBREntraIDTenantBackup -Name "Tenant backup"

$oldRP = Get-VBREntraIDTenantRestorePoint -Backup $backup -Id "a66808bc-780e-46f2-8538-63ace3c8f9be"

$item = Get-VBREntraIDTenantItem -Backup $backup -Type User -Name "Test Admin"

$compareInfo = Compare-VBREntraIDTenantItem -Session $tenantRestoreSession -Item $item -OldRestorePoint $oldRP

$cityPropertyObj = New-VBREntraIDTenantItemIncludedProperty -PropertyId $compareInfo.Properties.PropertyName[0]

Perform the following steps:

Run the Get-VBREntraIDTenantRestoreSession cmdlet. Specify the Id parameter value. Save the result to the $tenantRestoreSession variable.
Run the Get-VBREntraIDTenantBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable.
Run the Get-VBREntraIDTenantRestorePoint cmdlet. Set the $backup variable as the Backup parameter value. Specify the Id parameter value. Save the result to the $oldRP variable.
Run the Get-VBREntraIDTenantItem cmdlet. Set the $backup variable as the Backup parameter value. Specify the Type and Name parameter value. Save the result to the $item variable.
Run the Compare-VBREntraIDTenantItem cmdlet. Specify the following settings:
- Set the $tenantRestoreSession variable as the Session parameter value.
- Set the $item variable as the Item parameter value.
- Set the $oldRP variable as the OldRestorePoint parameter value.
- Save the result to the $compareInfo variable.
Run the New-VBREntraIDTenantItemIncludedProperty cmdlet. Specify the following settings:
- Set the $compareInfo.Properties.PropertyName[0] variable as the PropertyId parameter value.
  The city property is the first in the received array of properties.
- Save the result to the $cityPropertyObj variable.

New-VBREntraIDTenantItemIncludedProperty Example 2. Defining Object with Reference

This example shows how to define an object that contains a reference that you further want to restore.