Start-VBRIrisInstanceRestore

Short Description

Starts restore of InterSystems IRIS instances.

Product Edition: Enterprise Plus, Veeam Universal License

Syntax

This cmdlet provides the following parameter sets:

OriginalLocation (Default)

Start-VBRIrisInstanceRestore -RestorePoint <Object> [-PathMapping <VBRIrisInstancePathMappingRule[]>] [-Force]

[-RunAsync] [<CommonParameters>]
RestoreToAnotherLocation

Start-VBRIrisInstanceRestore -RestorePoint <Object> -ServerName <String> -ServerCredentials <CCredentials>

[-PathMapping <VBRIrisInstancePathMappingRule[]>] [-Force] [-RunAsync] [<CommonParameters>]

Detailed Description

This cmdlet starts restore of an InterSystems IRIS instance from a backup restore point. You can restore the instance to its original location or to another server.

Parameters

Parameters
Parameter	Description	Type	Required	Position	Accept Pipeline Input
Force	Defines that the cmdlet will overwrite the data in non-empty target paths.	`SwitchParameter`	False	Named	False
PathMapping	Specifies an array of path mapping rules that redirect the InterSystems IRIS instance data to new target paths. If you do not specify this parameter, the cmdlet will restore the data to the original paths. Accepts the `VBRIrisInstancePathMappingRule[]` object. To create this object, run the `New-VBRIrisInstancePathMappingRule` cmdlet.	`VBRIrisInstancePathMappingRule[]`	False	Named	False
RestorePoint	Specifies the restore point from which you want to restore the InterSystems IRIS instance. Accepts the `Object` object. To get this object, run the `Get-VBRSnapshotRestorePoint` cmdlet.	`Object`	True	Named	True (ByPropertyName, ByValue)
RunAsync	Defines that the command returns immediately without waiting for the task to complete.	`SwitchParameter`	False	Named	False
ServerCredentials	For the `RestoreToAnotherLocation` parameter set. Specifies the credentials to authenticate against the target server. Accepts the `CCredentials` object. To get this object, run the `Get-VBRCredentials` cmdlet.	`CCredentials`	True	Named	False
ServerName	For the `RestoreToAnotherLocation` parameter set. Specifies the DNS name or IP address of the server to which you want to restore the InterSystems IRIS instance.	`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 VBRSession object that contains the InterSystems IRIS instance restore session.

Examples

Start-VBRIrisInstanceRestore Example 1. Restoring an InterSystems IRIS Instance to the Original Location

This example shows how to restore an InterSystems IRIS instance from a storage snapshot to its original location.

$rp = Get-VBRSnapshotRestorePoint -ObjectName "IRIS01"

Start-VBRIrisInstanceRestore -RestorePoint $rp[0] -Force

Perform the following steps:

Run the Get-VBRSnapshotRestorePoint cmdlet. Specify the ObjectName parameter value. Save the result to the $rp variable.
Run the Start-VBRIrisInstanceRestore cmdlet. Set the $rp variable as the RestorePoint parameter value. Provide the Force parameter.

Start-VBRIrisInstanceRestore Example 2. Restoring an InterSystems IRIS Instance to Another Server

This example shows how to restore an InterSystems IRIS instance from a storage snapshot to another server and remap its data paths.

$rp = Get-VBRSnapshotRestorePoint -ObjectName "IRIS01"

$creds = Get-VBRCredentials -Name "iris\\administrator"

$rule = New-VBRIrisInstancePathMappingRule -OriginalPath "/usr/irissys/mgr" -TargetPath "/mnt/restore/mgr"

Start-VBRIrisInstanceRestore -RestorePoint $rp[0] -ServerName "172.18.21.30" -ServerCredentials $creds -PathMapping $rule -Force

Perform the following steps:

Run the Get-VBRSnapshotRestorePoint cmdlet. Save the result to the $rp variable.
Run the Get-VBRCredentials cmdlet. Save the result to the $creds variable.
Run the New-VBRIrisInstancePathMappingRule cmdlet. Save the result to the $rule variable.
Run the Start-VBRIrisInstanceRestore cmdlet.
- Set the $rp variable as the RestorePoint parameter value.
- Specify the ServerName parameter value.
- Set the $creds variable as the ServerCredentials parameter value.
- Set the $rule variable as the PathMapping parameter value.
- Provide the Force parameter.

Start-VBRIrisInstanceRestore Example 3. Restoring an InterSystems IRIS Instance from a NAS Backup to the Original Location

This example shows how to restore an InterSystems IRIS instance from a NAS backup to its original location.

$rp = Get-VBRUnstructuredBackupRestorePoint

Start-VBRIrisInstanceRestore -RestorePoint $rp[0]

Perform the following steps:

Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Save the result to the $rp variable.
Run the Start-VBRIrisInstanceRestore cmdlet. Set the $rp variable as the RestorePoint parameter value.

Start-VBRIrisInstanceRestore Example 4. Restoring an InterSystems IRIS Instance from a NAS Backup to Another Server

This example shows how to restore an InterSystems IRIS instance from a NAS backup to another server.

$rp = Get-VBRUnstructuredBackupRestorePoint

$creds = Add-VBRCredentials -Type "Linux" -User "root" -Password "Test123!"

Start-VBRIrisInstanceRestore -RestorePoint $rp[0] -ServerName "skorhel1" -ServerCredentials $creds

Perform the following steps:

Run the Get-VBRUnstructuredBackupRestorePoint cmdlet. Save the result to the $rp variable.
Run the Add-VBRCredentials cmdlet. Specify the Type, User, and Password parameter values. Save the result to the $creds variable.
Run the Start-VBRIrisInstanceRestore cmdlet.
- Set the $rp variable as the RestorePoint parameter value.
- Specify the ServerName parameter value.
- Set the $creds variable as the ServerCredentials parameter value.