SnapCenter PowerShell Commands
Add-SmPlugin
Suggest changes
PDFs
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.