Help Center
Choose product document...
Veeam Backup & Replication 9.5 Update 4
PowerShell Reference

Add-VNXHost

Short Description

Adds Dell EMC VNX storage systems to Veeam Backup & Replication.

Applies to

Platform: VMware

Product Edition: Standard, Enterprise, Enterprise Plus

Storage System: Dell EMC VNX

Syntax

This cmdlet provides the following parameter sets:

  • To add storage systems by username and password

Add-VNXHost -Type <VBRVNXHostType> {VNXFile | VNXBlock | VNXe | Unity} -UserName <string> -Password <string> [-Name <string>] [-Description <string>] [-CredentialsScope <VBRVNXBlockCredentialsScope> {Global | Local | LDAP}][-Proxy <IProxy[]>] [-iSCSI] [-NFS] [-FibreChannel] [-SkipRescan] [-WhatIf] [-Confirm]  [<CommonParameters>]

  • To add storage systems by credentials

Add-VNXHost -Type <VBRVNXHostType> {VNXFile | VNXBlock | VNXe | Unity} -Credentials <CInternalCredentials> [-Name <string>] [-Description <string>] [-CredentialsScope <VBRVNXBlockCredentialsScope> {Global | Local | LDAP}][-Proxy <IProxy[]>] [-iSCSI] [-NFS] [-FibreChannel] [-SkipRescan] [-WhatIf] [-Confirm]  [<CommonParameters>]>]

Detailed Description

This cmdlet adds selected Dell EMC VNX 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-VNXHost Tip:

Use the SkipRescan parameter to skip the automatic rescan.

To rescan storage systems manually, use the following cmdlets:

  • Run Sync-VNXHost to rescan of the entire storage system.
  • Run Sync-VNXVolume to rescan selected Dell EMC VNX volumes added to backup infrastructure.

Parameters

Parameter

Description

Required

Position

Accept
Pipeline
Input

Accept
Wildcard
Characters

Type

Specifies the type of the VNX storage: VNXFile, VNXBlock, VNXe, Unity.

True

Named

False

False

UserName

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

True

Named

False

False

Password

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

True

Named

False

False

Name

Specifies the storage IP address or DNS name.

False

Named

False

False

Credentials

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

True

Named

False

False

Description

Specifies the description of the storage.

False

Named

False

False

Credentials
Scope

Used to authenticate with the VNXBlock.

Specifies the credentials scope: Global, Local, LDAP.

False

Named

False

False

Proxy

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

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

False

Named

False

False

iSCSI

Indicates that the storage works over iSCSI protocol.

False

Named

False

False

NFS

Indicates that the storage works over NFS protocol.

False

Named

False

False

FibreChannel

Indicates that the storage works over FibreChannel protocol.

False

Named

False

False

SkipRescan

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

False

Named

False

 

WhatIf

Specifies whether the cmdlet writes a message that describes the effects of running the cmdlet without actually performing any action.

False

Named

False

False

Confirm

Specifies whether the cmdlet displays a prompt that asks if the user is sure that they want to continue.

False

Named

False

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

This example shows how to add a Dell EMC VNX 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-VNXHost with the $credentials and $proxy variables.

$credentials = Get-VBRCredentials -Name "VNX Administrator"

$proxy = Get-VBRViProxy -Name 172.16.53.5

Add-VNXHost -Name 172.16.21.105 -Type VNXe -Credentials $credentials -Proxy $proxy -iSCSI

Related Commands

Get-VBRCredentials

Get-VBRViProxy

Veeam Large Logo

User Guide for VMware vSphere

User Guide for Microsoft Hyper-V

Enterprise Manager User Guide

Veeam Cloud Connect Guide

Veeam Agent Management Guide

Veeam Explorers User Guide

Backup and Restore of SQL Server Databases

Veeam Plug-ins for Enterprise Applications

PowerShell Reference

Veeam Explorers PowerShell Reference

RESTful API Reference

Required Permissions

Veeam Availability for Nutanix AHV

Veeam Backup for Microsoft Office 365 Documentation

Veeam ONE Documentation

Veeam Agent for Windows Documentation

Veeam Agent for Linux Documentation

Veeam Management Pack Documentation