Add-NimbleHost

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