This is an archive version of the document. To get the most up-to-date information, see the current version.

Find-VBRHvEntity

In this article

    Short Description

    Looks for Hyper-V hosts, VMs and volumes.

    Applies to

    Platform: Hyper-V

    Product Edition: Standard, Enterprise, Enterprise Plus

    Syntax

    Find-VBRHvEntity [-Server <CHost[]>] [-HostsAndVMs] [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

    -OR-

    Find-VBRHvEntity [-Server <CHost[]>] [-Hosts] [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

    -OR-

    Find-VBRHvEntity [-Server <CHost[]>] [-HostsAndVolumes] [-Name <String[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]

    Related Commands

    Get-VBRServer

    Detailed Description

    This cmdlet returns Hyper-V hosts, VMs and volumes managed by Veeam Backup & Replication.

    You can get the list of all Hyper-V objects in your virtual environment or look for instances directly by name.

    Run Get-VBRServer to get the list of the Hyper-V hosts.

    Return Type

    CHvHostItem

    CHvVmItem

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Server

    Specifies the host you want to look for entities on.

    You can assign multiple servers to this object.

    False

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    HostsAnd
    VMs

    Views results as hosts and VMs.

    False

    Named

    False

    False

    Hosts

    Views results as hosts.

    False

    Named

    False

    False

    HostsAnd
    Volumes

    Views results as hosts and volumes.

    False

    Named

    False

    False

    Name

    Specifies the name of the entity you want to get, or search conditions.

    You can specify multiple names separated by commas.

    False

    Named

    False

    True

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information about common parameters, see http://go.microsoft.com/fwlink/p/?LinkID=113216.

    Example 1

    This command looks for all Hyper-V objects registered on server named "Hyper-V Host". The server is obtained with Get-VBRServer and piped down.

    Get-VBRServer -Name "HvHost" | Find-VBRHvEntity

    Example 2

    This command looks for Hyper-V hosts and VMs registered on Hyper-V servers named "HvHost 01" and "HvHost 02". The servers are obtained with Get-VBRServer and piped down.

    Get-VBRServer -Name "HvHost 01", "HvHost 02" | Find-VBRHvEntity -HostsAndVMs

    Example 3

    This command directly looks for the Hyper-V server named "HvExchange".

    Find-VBRHvEntity -Name "HvExchange"