Get-VBRLinuxGuestItem - Veeam Backup PowerShell Reference

Parameter	Description	Type	Required	Position	Accept Pipeline Input
LinuxFlrObject	For getting root guest OS files. Specifies a running restore session of Linux-based or Unix-based guest OS files. The cmdlet will return files and folders that are available for restore on disks when you run this session.	Accepts the VBRLinuxFlrObject object. To create this object, run the Start-VBRLinuxFileRestore cmdlet.	True	Named	True (ByValue, ByPropertyName)
Path	Specifies a path to the folder where guest OS files that you want to restore are located.	String[]	False	Named	True (ByPropertyName
ParentItem	For getting child guest OS files. Returns child folders and files that are available from backups of Linux-based or Unix-based machines.	Accepts the VBRFLRItem object. To create this object, run the Get-VBRLinuxGuestItem cmdlet.	False	Named	True (ByPropertyName)
Name	Specifies an array of names for items that are available on disks. The cmdlet will return items with these names.	String[]	False	Named	False
RecursiveSearch	Defines that the cmdlet will look for items that are added to the specified folders and to all child folders. If you provide this parameter, the cmdlet will return an array of all items that are added to Linux-based or Unix-based machines. Otherwise, the cmdlet will return an array of items that are added to the parent folder on Linux-based or Unix-based machines.	SwitchParameter	False	Named	False

This example shows how to get all root items from disks that are added to the UbuntuSrv Linux-based machine.

$backup = Get-VBRBackup -Name "UbuntuSrv"

$restorepoint = Get-VBRRestorePoint -Backup $backup

$server = Get-VBRServer -Name "LinSrv05"

$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server

Get-VBRLinuxGuestItem -LinuxFlrObject $session

Perform the following steps:

Start the restore session:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable
Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Start-VBRLinuxFileRestore cmdlet. Specify the RestorePoint and MountServer parameter values. Save the result to the $session variable.

Run the Get-VBRLinuxGuestItem cmdlet. Set the $session variable as the LinuxFlrObject parameter value.

This example shows how to get Linux-based guest OS files added to the UbuntuSrv Linux-based machine. The cmdlet will get all child items added to the /home/administrator/mydir folder.

$backup = Get-VBRBackup -Name "UbuntuSrv"

$restorepoint = Get-VBRRestorePoint -Backup $backup

$server = Get-VBRServer -Name "LinSrv05"

$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server

Get-VBRLinuxGuestItem -LinuxFlrObject $session -Path "/home/administrator/mydir"

Perform the following steps:

Start the restore session:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable
Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Start-VBRLinuxFileRestore cmdlet. Specify the RestorePoint and MountServer parameter values. Save the result to the $session variable.

Run the Get-VBRLinuxGuestItem cmdlet. Set the $session variable as the LinuxFlrObject parameter value. Specify the Path parameter value.

This example shows how to get all child items from disks that are added to the Srv2067 Unix-based machine.

$backup = Get-VBRBackup -Name "Srv2067"

$restorepoint = Get-VBRRestorePoint -Backup $backup

$server = Get-VBRServer -Name "Mount2067"

$session = Start-VBRLinuxFileRestore -RestorePoint $restorepoint -MountServer $server

$root = Get-VBRLinuxGuestItem -LinuxFlrObject $session

Get-VBRLinuxGuestItem -LinuxFlrObject $session -ParentItem $root

Perform the following steps:

Start the restore session:

Run the Get-VBRBackup cmdlet. Specify the Name parameter value. Save the result to the $backup variable
Run the Get-VBRRestorePoint cmdlet. Specify the Backup parameter value. Save the result to the $restorepoint variable.
Run the Get-VBRServer cmdlet. Specify the Name parameter value. Save the result to the $server variable.
Run the Start-VBRLinuxFileRestore cmdlet. Specify the RestorePoint and MountServer parameter values. Save the result to the $session variable.

Run the Get-VBRLinuxGuestItem cmdlet. Set the $session variable as the LinuxFlrObject parameter value. Save the result to the $root variable.

Run the Get-VBRLinuxGuestItem cmdlet. Set the $session variable as the LinuxFlrObject parameter value. Set the $root variable as the ParentItem parameter value.