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

Add-VSBHvApplicationGroup

In this article

    Short Description

    Creates a Hyper-V application group for SureBackup job.

    Applies to

    Platform: Hyper-V

    For VMware, run Add-VSBViApplicationGroup.

    Product Edition: Enterprise, Enterprise Plus

    Syntax

    Add-VSBHvApplicationGroup [-Name <String>] [-VmFromBackup <CHvVmItem[]>] [-RestorePoint <COib[]>] [-WarningAction <ActionPreference>] [-WarningVariable <String>] [<CommonParameters>]>]

    Related Commands

    Find-VBRHvEntity

    Get-VBRRestorePoint

    Detailed Description

    This cmdlet creates a new Hyper-V application group.

    This cmdlet provides two scenarios. You can add VMs to your application group either by searching for existing VMs or by adding a restore point containing the VMs you need.

    Note that you can set the order the VMs in the application group will be powered on when the SureBackup job starts. This may be important if any of the applications must be started prior to other. The VMs are powered in the order they were added to the VM object in this cmdlet.

    Parameters

    Parameter

    Description

    Required

    Position

    Accept
    Pipeline
    Input

    Accept
    Wildcard
    Characters

    Name

    Specifies the name you want to assign to the application group.

    False

    Named

    False

    False

    VmFrom
    Backup

    Specifies the VM(s) you want to add to the application group.

    You can assign multiple VMs to this object.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    Restore
    Point

    Specifies the restore points of the VMs you want to add to the application group.

    You can assign multiple restore points to this object.

    True

    Named

    True (ByValue,
    ByProperty
    Name)

    False

    <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 creates a new application group named "Microsoft Exchange Appgroup".The VMs that should be included into the application group are obtained with Find-VBRHvEntity and piped down. The VMs are obtained in the order they must boot when the SureBackup job starts.

    PS C:\PS> Find-VBRHvEntity -Name "DC", "DNSServer" | Add-VSBHvApplicationGroup -Name "Microsoft Exchange Appgroup"

    Example 2

    This command creates a new application group "MailServer Appgroup". The restore point object is obtained with Get-VBRRestorePoint and assigned to the variable beforehand.

    PS C:\PS> Add-VSBHvApplicationGroup -Name "MailServer Appgroup" -RestorePoint $restorepoint