Add-NimbleHost

In this article

    Short Description

    Adds HPE Nimble storage systems to Veeam Backup & Replication.

    Applies to

    Platform: VMware

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

    Syntax

    This cmdlet provides the following parameter sets:

    • To add storage systems by a user name and a password

    Add-NimbleHost -Name <string> -UserName <string> -Password <string> [-Description <string>] [-RESTAPIPort <int>] [-Proxy <IProxy[]>] [-MountServer <CHost>] [-SkipRescan] [-Force] [-iSCSI] [-FibreChannel] [-AgentFC] [-AgentISCSI] [-AgentProxy <VBRNASProxyServer[]>] [-EnableVMwareBackup] [-EnableAgentBackup]  [<CommonParameters>]

    • To add storage systems by credentials

    Add-NimbleHost -Name <string> -Credentials <CInternalCredentials> [-Description <string>] [-RESTAPIPort <int>] [-Proxy <IProxy[]>] [-MountServer <CHost>] [-SkipRescan] [-Force] [-iSCSI] [-FibreChannel] [-AgentFC] [-AgentISCSI] [-AgentProxy <VBRNASProxyServer[]>] [-EnableVMwareBackup] [-EnableAgentBackup]  [<CommonParameters>]

    Detailed Description

    This cmdlet adds selected HPE Nimble storage systems to backup infrastructure.

    When you add storage systems to your backup infrastructure, Veeam Backup & Replication performs a rescan of storage systems. During the rescan Veeam Backup & Replication retrieves information about the storage system topology and adds storage volumes to the backup infrastructure.

    For more information about the rescan, see the Adding Storage Systems section of the User Guide for VMware vSphere.

    Add-NimbleHost Tip:

    Use the SkipRescan parameter to skip the automatic rescan.

    To rescan storage systems manually, use the following cmdlets:

    Parameters

    Parameter

    Description

    Type

    Required

    Position

    Accept
    Pipeline
    Input

    Name

    Specifies the storage IP address or DNS name.

    String

    True

    Named

    False

    UserName

    Specifies the user name that you want to use for authenticating with the storage.

    String

    True

    Named

    False

    Password

    Specifies the password you want to use for authenticating with the storage.

    String

    True

    Named

    False

    Credentials

    Specifies the credentials you want to use for authenticating with the storage.

    Accepts the CInternalCredentials object. To create this object, run the Get-VBRCredentials cmdlet.

    True

    Named

    False

    Description

    Specifies the description of the storage.

    String

    False

    Named

    False

    RESTAPIPort

    For HPE Nimble OS 2.3 and later.

    Specifies the port for HPE Nimble RESTful API to communicate with storage.

    Default: 5392.

    Int.

    False

    Named

    False

    MountServer

    Specifies the mount server that you want to use to work with this storage.

    Accepts the CHost object. To create this object, run the Get-VBRServer cmdlet.

    False

    Named

    False

    SkipRescan

    Indicates that the cmdlet will not start the storage rescan automatically after you add storage systems to the backup infrastructure.

    SwitchParameter

    False

    Named

    False

    Force

    Defines that the cmdlet will add a Nimble storage system without showing warnings in the PowerShell console.

    SwitchParameter

    False

    Named

    False

    EnableVMwareBackup

    Enables the VMware backup option.

    If you provide this parameter, you will be able to use storage snapshots to backup and restore VMware vSphere VMs hosted on storage systems.

    SwitchParameter

    False

    Named

    False

    EnableAgentBackup

    Enables the Veeam Agent backup option.

    If you provide this parameter, you will be able to integrate your storage systems with Veeam Agent for Microsoft Windows installed on computers in your infrastructure.

    SwitchParameter

    False

    Named

    False

    Proxy

    For the EnableVMwareBackup parameter.

    Specifies the array of proxies you want to use to work with this storage.

    If set, Veeam Backup & Replication will use the selected proxies. If not set, Veeam Backup & Replication will use automatic proxy selection.

    IProxy

    False

    Named

    False

    FibreChannel

    For the EnableVMwareBackup parameter.

    Indicates that Veeam Backup & Replication will connect to the HPE Nimble storage over the FibreChannel protocol.

    SwitchParameter

    False

    Named

    False

    iSCSI

    For the EnableVMwareBackup parameter.

    Indicates that Veeam Backup & Replication will connect to the HPE Nimble storage over the iSCSI protocol.

    SwitchParameter

    False

    Named

    False

    AgentFC

    For the EnableAgentBackup parameter.

    Indicates that the storage works over FC protocol.

    SwitchParameter

    False

    Named

    False

    AgentISCSI

    For the EnableAgentBackup parameter.

    Indicates that the storage works over iSCSI protocol.

    SwitchParameter

    False

    Named

    False

    AgentProxy

    For the EnableAgentBackup parameter.

    Specifies an array of proxies you want to use with this storage.

    Accepts the VBRComputerFileProxyServer object. To create this object, run the Add-VBRComputerFileProxyServer cmdlet.

    False

    Named

    False

    <CommonParameters>

    This cmdlet supports Microsoft PowerShell common parameters. For more information on common parameters, see the About CommonParameters section of Microsoft Docs.

    Example

    This example shows how to add an HPE Nimble storage system to the backup infrastructure using credentials.

    1. Run Get-VBRCredentials to get a credentials record for the storage system. Save the result to the $credentials variable.
    2. Run Get-VBRViProxy to get a backup proxy that will be used for storage rescan and Backup from Storage Snapshots. Save the result to the $proxy variable.
    3. Run Add-NimbleHost with the $credentials and $proxy variables.

    $credentials = Get-VBRCredentials -Name "HPE Nimble Administrator"

    $proxy = Get-VBRViProxy -Name 172.17.53.5

    Add-NimbleHost -Name 172.17.53.38 -Credentials $credentials -Description "HPE Nimble Storage iSCSI" -Proxy $proxy -iSCSI

    Related Commands

    Get-VBRViProxy

    Get-VBRCredentials