This is an archive version of the document. To get the most up-to-date information, see the current version.Add-VNXHost
Short Description
Adds Dell EMC VNX storage systems to Veeam Backup & Replication.
Applies to
Platform: VMware
Product Edition: Standard, Enterprise, Enterprise Plus, Veeam Universal License
Storage System: Dell EMC VNX
Syntax
This cmdlet provides the following parameter sets:
- To add storage systems by user name and password
Add-VNXHost -Type {VNXFile | VNXBlock | VNXe | Unity} -UserName <string> -Password <string> [-Name <string>] [-Description <string>] [-CredentialsScope {Global | Local | LDAP}] [-Proxy <IProxy[]>] [-MountServer <CHost>] [-SkipRescan] [-Force] [-iSCSI] [-NFS] [-FibreChannel] [-AgentFC] [-AgentISCSI] [-AgentProxy <VBRNASProxyServer[]>] [-EnableVMwareBackup] [-EnableAgentBackup] [<CommonParameters>] |
- To add storage systems by credentials
Add-VNXHost -Type {VNXFile | VNXBlock | VNXe | Unity} -Credentials <CInternalCredentials> [-Name <string>] [-Description <string>] [-CredentialsScope {Global | Local | LDAP}] [-Proxy <IProxy[]>] [-MountServer <CHost>] [-SkipRescan] [-Force] [-iSCSI] [-NFS] [-FibreChannel] [-AgentFC] [-AgentISCSI] [-AgentProxy <VBRNASProxyServer[]>] [-EnableVMwareBackup] [-EnableAgentBackup] [<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.
|
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 |
|---|---|---|---|---|---|
Type | Specifies the type of the VNX storage: VNXFile, VNXBlock, VNXe, Unity. | VBRVNXHostType | 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 |
Name | Specifies the storage IP address or DNS name. | String | False | 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 |
CredentialsScope | Used to authenticate with the VNXBlock. Specifies the credentials scope: Global, Local, LDAP. | VBRVNXBlockCredentialsScope | 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 Dell EMC VNX 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 with this storage. If set, Veeam Backup & Replication will use the selected proxies. If not set, Veeam Backup & Replication will use automatic proxy selection. | Accepts the IProxy object. To create this object, run the Get-VBRViProxy cmdlet. | False | Named | False |
iSCSI | For the EnableVMwareBackup parameter. Indicates that the storage works over iSCSI protocol. | SwitchParameter | False | Named | False |
NFS | For the EnableVMwareBackup parameter. Indicates that the storage works over NFS protocol. | SwitchParameter | False | Named | False |
FibreChannel | For the EnableVMwareBackup parameter. Indicates that the storage works over FibreChannel protocol. | SwitchParameter | False | Named | False |
AgentFC | For the EnableAgentBackup parameter. Indicates that the storage works over the FC protocol. | SwitchParameter | False | Named | False |
AgentISCSI | For the EnableAgentBackup parameter. Indicates that the storage works over the 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 a Dell EMC VNX storage system to the backup infrastructure using credentials.
- Run Get-VBRCredentials to get a credentials record for the storage system. Save the result to the $credentials variable.
- 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.
- 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
