Add-ThinkSystemHost

Short Description

Adds ThinkSystem storage systems to the backup infrastructure.

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

Syntax

This cmdlet provides parameter sets that allow you to:

  • Add storage systems by user name and password.

Add-ThinkSystemHost -Name <string> -UserName <string> -Password <string> [-Description <string>] [-IsHTTP <bool>] [-Port <int>] [-Proxy <IProxy[]>] [-MountServer <CHost>] [-NASProxy <VBRNASProxyServer[]>] [-SkipRescan] [-Force] [-iSCSI] [-NFS] [-FibreChannel] [-CreateRulesAutomatically] [-NASNFS] [-NASSMB] [-NASCreateRulesAutomatically] [-AgentFC] [-AgentISCSI] [-AgentProxy <VBRNASProxyServer[]>] [-EnableVMwareBackup] [-EnableNASBackup] [-EnableAgentBackup] [<CommonParameters>]

  • Add storage systems by credentials.

Add-ThinkSystemHost -Name <string> -Credentials <CInternalCredentials> [-Description <string>] [-IsHTTP <bool>] [-Port <int>] [-Proxy <IProxy[]>] [-MountServer <CHost>] [-NASProxy <VBRNASProxyServer[]>] [-SkipRescan] [-Force] [-iSCSI] [-NFS] [-FibreChannel] [-CreateRulesAutomatically] [-NASNFS] [-NASSMB] [-NASCreateRulesAutomatically] [-AgentFC] [-AgentISCSI] [-AgentProxy <VBRNASProxyServer[]>] [-EnableVMwareBackup] [-EnableNASBackup] [-EnableAgentBackup] [<CommonParameters>]

Detailed Description

This cmdlet adds selected ThinkSystem storage systems to the backup infrastructure.

When you add storage systems to your backup infrastructure, Veeam Backup & Replication performs a rescan of these 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-ThinkSystemHost Tip:

Provide the SkipRescan parameter to skip the automatic rescan.

To rescan storage systems manually, use the following cmdlets:

  • Run the Sync-NetAppHost cmdlet to rescan of the entire storage system
  • Run the Sync-NetAppVolume cmdlet to rescan selected NetApp volumes added to backup infrastructure.

Parameters

Parameter

Description

Type

Required

Position

Accept
Pipeline
Input

Name

Specifies the storage IP address or DNS name.

String

True

Named

False

Description

Specifies the description of the storage.

String

False

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

IsHTTP

If set to TRUE, HTTP protocol will be used to connect to the ThinkSystem storage. Otherwise, HTTPS protocol will be selected.

Defaul: HTTPS.

Bool

False

Named

False

Port

Specifies a port used to connect to the ThinkSystem storage. By default, port 443 is used.

Int

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

MountServer

Specifies an array of proxies you want to use with this storage. Veeam Backup & Replication will use this proxy to rescan and Backup from Storage Snapshots.

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

SkipRescan

Specifies the mount server that you want to use to work with this storage. Veeam Backup & Replication will use this server for file-level and application items restore.

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

False

Named

False

Force

Defines that the cmdlet will add a HPE 3PAR StoreServ 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

EnableNASBackup

Enables the NAS backup option.

If you provide this parameter, you will be able to integrate your storage systems with NAS file shares added to your infrastructure.

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 an array of proxies you want to use with this storage. Veeam Backup & Replication will use this proxy to rescan and Backup from Storage Snapshots.

Note: If you do not provide this parameter,  Veeam Backup & Replication  will use the 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

CreateRulesAutomatically

For the EnableVMwareBackup parameter.

Defines that the cmdlet will allow Veeam Backup & Replication to automatically create required SMB and NFS export rules on the storage system.

If you provide this parameter, the rules will be created automatically in case the proxies are unavailable.

SwitchParameter

False

Named

False

NASNFS

For the EnableNASBackup parameter.

Indicates that the storage works over the NFS protocol.

SwitchParameter

False

Named

False

NASSMB

For the EnableNASBackup parameter.

Indicates that the storage works over the SMB protocol.

SwitchParameter

False

Named

False

NASCreateRulesAutomatically

For the EnableNASBackup parameter.

Defines that the cmdlet will allow Veeam Backup & Replication to automatically create required SMB and NFS export rules on the storage system.

If you provide this parameter, the rules will be created automatically in case the proxies are unavailable.

SwitchParameter

False

Named

False

NASProxy

For the EnableNASBackup parameter.

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

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

False

Named

False

AgentFC

For the EnableAgentBackup parameter.

Indicates that the storage works over the FS 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 Microsoft Docs.

Examples

Example 1. Adding a ThinkSystem Storage System by Username and Password

This command adds a ThinkSystem storage system to the backup infrastructure using user name and password.

Add-ThinkSystemHost -Name 167.16.2.134 -UserName "Lenovo Administrator" -Password "SecurePa$$w0rd"

Example 2. Adding a ThinkSystem Storage System by Credentials

This example shows how to add a ThinkSystem storage system to the backup infrastructure using credentials.

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

$proxy = Get-VBRViProxy -Name 167.16.21.25

Add-ThinkSystemHost -Name 167.16.2.134 -Credentials $credentials -Proxy $proxy -Description "Lenovo Storage"

Perform the following steps:

  1. Run the Get-VBRCredentials cmdlet. Specify the Name parameter value. Save the result to the $credentials variable.
  2. Run the Get-VBRViProxy cmdlet. Specify the Name parameter value. Save the result to the $proxy variable.
  3. Run Add-ThinkSystemHost cmdlet. Specify the following settings:
  • Set the $credentials variable as the Credentials parameter value.
  • Set the $proxy variable as the Proxy parameter value.
  • Specify the Name and Description parameter values.

 

Related Commands