SnapCenter PowerShell Commands
Install-SmHostPackage
Suggest changes
PDFs
Installs or upgrades a host plug-in package on one or more hosts.
Syntax
Install-SmHostPackage [-HostNames] <String> [-PluginCodes] <UploadedPluginCode> [-PluginVersions] <Hashtable> [-InstallPath] <String> [-SkipPreinstallChecks] <SwitchParameter> [-GMSAName] <String> [-Force] <SwitchParameter>
Detailed Description
Installs or upgrades a host plug-in package on one or more hosts. When specifying multiple hosts, all hosts must have the same OS.
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 code for one or more plug-ins in the packages that you want to install. The following values are valid: SCSQL, SCO, SCW, SCE and hana.For custom plug-ins, the value is the custom plug-in name. For example "CustomPlugin1".You can use a comma-separated list of plug-in codes to install multiple plug-ins. |
true |
true (ByPropertyName) |
|
PluginVersions |
Specifies in a hash table the custom plug-in name and the version to install. The PluginVersions parameter uses the format @{"customplugin" = "4.0"} |
false |
true (ByPropertyName) |
|
InstallPath |
Specifies the plug-in installation path, if the path different from the default. |
false |
true (ByPropertyName) |
|
SkipPreinstallChecks |
Specifies that installation prechecks will not be triggered. |
false |
true (ByPropertyName) |
|
GMSAName |
Specifies that group Managed Service Account (gMSA) name will be used to run the plug-in services. |
false |
true (ByPropertyName) |
|
Force |
Internal switch. |
false |
true (ByPropertyName) |
Examples
Example 1: Installing SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on a Windows host
Install-SmHostPackage -HostNames @("host2012r2.mycompany.com") -PluginCodes SCSQL,SCW
This example syntax installs SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Windows on the specified host.
Example 2: Installing SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on multiple hosts
Install-SmHostPackage -HostNames @("sql-1.mycompany.com", "sql-2.mycompany.com") -PluginCodes SCSQL,SCW
This example syntax installs SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on multiple hosts.
Example 3: Installing a custom plug-in with SnapCenter Plug-in for Oracle and SnapCenter Plug-in for Unix on a Linux host
Install-SmHostPackage -HostNames("scspr0098708001.englab.mycompany.com") -PluginCodes CustomPlugin1,SCO -InstallPath /opt/NetApp/snapcenter/ -PluginVersions @{"customplugin1" = "2.0"}
This example syntax installs a custom plug-in along with SnapCenter Plug-in for Oracle and SnapCenter Plug-in for Unix on a Linux host.
Example 4: Installing SnapCenter Plug-in for Microsoft Exchange Server
Install-SmHostPackage -HostNames Exchange2016DAG -PluginCodes SCE,SCW -Verbose
This example syntax installs SnapCenter Plug-in for Microsoft Exchange Server on the specified host.
Example 5: Installing SnapCenter Plug-in for SAP HANA Database on the same Windows host
Install-SmHostPackage -HostNames 'Windows.Host.lab.com' -PluginCodes hana,SCW
This example syntax installs the SnapCenter Plug-in for SAP HANA Database on the same host where SnapCenter Server is installed.
Example 6: Installing SnapCenter Plug-in for SAP HANA database on a remote host
Install-SmHostPackage -HostNames 'Host.fqdn.lab.com' -PluginCodes hana
This example syntax installs the SnapCenter Plug-in for SAP HANA Database on the specified remote host (Windows and Linux).
Example 7: Installing SnapCenter Plug-in for Oracle Database on a AIX host
Install-SmHostPackage -HostNames 'aix207-193.gdl.englab.netapp.com' -PluginCodes SCO
This example syntax installs the SnapCenter Plug-in for Oracle Database on the specified AIX host. Plugin code SCC is not supported.
Example 8: Installing SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Microsoft Windows on a Windows host to run with group Managed Service Account (gMSA)
Install-SmHostPackage -HostNames 'host2012r2.NewDomain.com' -PluginCodes SCSQL,SCW -GMSAName 'NewDomain\gMSAName$'
This example syntax installs SnapCenter Plug-in for Microsoft SQL Server and SnapCenter Plug-in for Windows to run with the mentioned group Managed Service Account (gMSA) name on the specified host.