Skip to main content
SnapCenter 5.0 cmdlets

Add-SmPlugin

Contributors

Installs or upgrades a plug-in on one or more hosts.

Syntax

Add-SmPlugin [-HostNames]  <String>  [-PluginCodes]  <UploadedPluginCode>  [-PluginVersions]  <Hashtable>  [-SkipPreinstallChecks]  <>  [-Force]  <>

Detailed Description

Installs or upgrades a plug-in on one or more hosts. You must use the Install-SmHostPackage cmdlet to install host plug-in packages and any specified plug-ins on a host before you can install or upgrade a SnapCenter plug-in using the Add-SmPlugin cmdlet.

Parameters

Name Description Required? Pipeline Input Default Value

HostNames

Specifies the hosts on which you want to install or upgrade the plug-in. You can specify one host, or multiple, comma-separated host names.Host names must be entered using the format -HostNames @("hostname") when installing to a single host, or -HostNames @("hostname1", "hostname2") when installing to multiple hosts. You can specify the hostname using either the host FQDN or IP address.

true

true (ByPropertyName)

PluginCodes

Specifies the plug-ins you want to install or upgrade. Valid values are SCSQL, SCO, SCE and hana. For custom plug-ins, the value is the custom plug-in name. For example "CustomPlugin1".

true

true (ByPropertyName)

PluginVersions

Specifies in a hash table the custom plug-in name and the version to add to a host. The PluginVersions parameter uses the format -PluginVersions @{"customplugin1" = "2.0"}

false

true (ByPropertyName)

SkipPreinstallChecks

Specifies that installation prechecks will not be triggered.

false

true (ByPropertyName)

Force

Internal switch.

false

true (ByPropertyName)

Examples

Example 1: Installing SnapCenter Plug-in for Microsoft SQL Server on a host

 Add-SmPlugin -HostNames @("mywinsrvr2012r2.mycompany.com") -PluginCodes SCSQL

This example syntax installs SnapCenter Plug-in for Microsoft SQL on the specified host.

Example 2: Installing SnapCenter Plug-in for Microsoft SQL Server on multiple hosts

 Add-SmPlugin -HostNames @("mywinsrvr2012r2.mycompany.com", "my2winsrvr2012r2.mycompany.com") -PluginCodes SCSQL

This example syntax installs SnapCenter Plug-in for SQL Server on the two specified hosts.

Example 3: Adding or upgrading a custom plugin

 Add-SmPlugin -HostNames myhostname -PluginCodes CustomPlugin -PluginVersions @{"CustomPlugin"="2.0"} -Verbose

This example syntax adds or upgrades the custom plug-in named "CustomPlugin", version 2.0 to a single host.