Skip to main content
SnapCenter 4.9 cmdlets

Add-SmHost

Contributors

Registers a standalone host or cluster with SnapCenter.

Syntax

Add-SmHost [-HostType]  <SmOperatingSystemType>  [-HostName]  <String>  [-CredentialName]  <String>  [-Port]  <UInt16>  [-DoNotAddClusterNodes]  <>  [-SkipPreinstallChecks]  <>  [-Force]  <>

Detailed Description

Registers a standalone host or cluster with SnapCenter. You must register hosts with SnapCenter. For example, SnapCenter must be registered before you can perform any data protection jobs. In addition, if no plug-ins are installed on the host you are adding, SnapCenter remotely deploys plug-ins, or upgrades the plug-ins as needed.

Parameters

Name Description Required? Pipeline Input Default Value

HostType

Specifies the operating system of the host you are adding. Valid values are AIX, Windows, Linux, and vSphere. The default value is Windows. If you are managing a Windows VM containing RDM or VMDK storage, ensure that you add the vSphere host before creating a backup.

true

true (ByPropertyName)

HostName

Specifies the name or IP of the cluster or standalone host you want to add.

true

true (ByPropertyName)

CredentialName

Specifies the name of the account that is required to perform application-specific operations in SnapCenter. You can use a credential account to perform application-specific operations within SnapCenter, such as remotely installing plug-ins. Use the Add-SmCredential cmdlet to create a credential account.

false

true (ByPropertyName)

Port

Specifies the port you want to use for SnapCenter to host agent communication. The default is 8145. Ensure that the firewall is open on both SnapCenter and the remote host to enable host agent communication.

false

true (ByPropertyName)

DoNotAddClusterNodes

Specifies not to include all nodes in the cluster. If you set the parameter to True, then only the specified host is added. The default value is False, which means that when you provide a cluster name, all nodes in the cluster are added and managed by SnapCenter.

false

true (ByPropertyName)

False

SkipPreinstallChecks

Specifies that host registration prechecks will not be triggered.

false

true (ByPropertyName)

Force

Switch to disable validation of the host signature.

false

true (ByPropertyName)

Examples

Example 1: Registering a host with SnapCenter

 Add-SmHost -HostName C226030161613-1.srqatdom06.local -HostType Windows -DoNotAddClusterNodes -CredentialName admin

This example syntax registers the specified Windows host with SnapCenter.

			OsInfo : SMCoreContracts.SmOperatingSystemInfo
			HostName   : C226030161613-1.srqatdom06.local
			IP : 10.232.193.208,fd20:8b1e:b255:8029:19a0:6c5e:ae99:79e0
			Description:
			HostId : 5
			DomainName : srqatdom06.local
			Version:
			Port   :
			ClusterHost: False
			ClusterName:
			Members: {}
			HostStatus : eHostUp
			HostPluginInfos: {}
			ColoHost   : False
			HostConfiguration  : SMCoreContracts.SmConfiguration
			DiscoverPlugin : False
			HostUUID   :
			HostBIOSID :
			HostMaintenanceStatus  : Production
			IsNLBEnabled   : False
			VerificationServers:
			HypervisorType :
			IsHypervisorConfigured : False
			Preference : 0
			OverallStatus  : SMCoreContracts.SmHostOverallStatusInfo
			IsCatalogHost  : False
			Name   :
			Type   :
			Id :
			Host   :
			UserName   :
			Passphrase :
			Deleted: False
			Auth   : SMCoreContracts.SmAuth
			IsClone: False
			CloneLevel : 0
			Hosts  : {}
			StorageName:
			ResourceGroupNames :
			PolicyNames:
			Key: 0
			NsmObjectID: 0
			SizeOfSmObject :

Example 2: Registering a host where you deployed SnapCenter Plug-in for VMware vSphere OVA

 Add-SmHost -HostType VSphere -HostName myHostname -CredentialName vmware_admin

This example syntax registers vSphere host with SnapCenter.

			OsInfo : SMCoreContracts.SmOperatingSystemInfo
			HostName   : myHostname
			IP : 10.225.97.14
			Description:
			HostId : 1
			DomainName :
			Version:
			Port   :
			ClusterHost: False
			ClusterName:
			Members: {}
			HostStatus : eHostUp
			HostPluginInfos: {}
			ColoHost   : True
			HostConfiguration  : SMCoreContracts.SmConfiguration
			DiscoverPlugin : False
			HostUUID   :
			HostBIOSID :
			HostMaintenanceStatus  : Production
			IsNLBEnabled   : False
			VerificationServers:
			HypervisorType :
			IsHypervisorConfigured : False
			Preference : 0
			OverallStatus  : SMCoreContracts.SmHostOverallStatusInfo
			IsCatalogHost  : False
			Name   :
			Type   :
			Id :
			Host   :
			UserName   :
			Passphrase :
			Deleted: False
			Auth   : SMCoreContracts.SmAuth
			IsClone: False
			CloneLevel : 0
			Hosts  : {}
			StorageName:
			ResourceGroupNames :
			PolicyNames:
			Key: 0
			NsmObjectID: 0
			SizeOfSmObject :

Example 3: Registering an Exchange DAG with SnapCenter

 Add-SmHost -HostName EXCH2016DAG -HostType Windows -CredentialName domain_admin -Verbose

This example syntax registers the specified Exchange DAG with SnapCenter.

Example 4: Registering an AIX host with SnapCenter

 Add-SmHost -HostType AIX -HostName "aixhostname.fqdn.com" -CredentialName cred1

This example syntax registers the specified AIX host with SnapCenter.

OsInfo : SMCoreContracts.SmOperatingSystemInfo
HostName   : aixhostname.fqdn.com
IP : 10.1.0.10
Description:
HostId : 79
DomainName : fqdn.com
Version:
Port   :
ClusterHost: False
ClusterName:
Members: {}
HostStatus : eHostUp
HostPluginInfos: {}
ColoHost   : True
HostConfiguration  : SMCoreContracts.SmConfiguration
DiscoverPlugin : False
HostUUID   :
HostBIOSID :
HostMaintenanceStatus  : Production
IsNLBEnabled   : False
VerificationServers:
HypervisorType :
IsHypervisorConfigured : False
Preference : 0
OverallStatus  : SMCoreContracts.SmHostOverallStatusInfo
IsCatalogHost  : False
Name   :
Type   :
Id :
Host   :
UserName   :
Passphrase :
Deleted: False
Auth   : SMCoreContracts.SmAuth
IsClone: False
CloneLevel : 0
Hosts  : {}
StorageName:
ResourceGroupNames :
PolicyNames:
Key: 0
NsmObjectID: 0
SizeOfSmObject :