Skip to main content
SnapCenter 5.0 cmdlets

Uninstall-SmHostPackage

Contributors

Uninstalls all host plug-in components from one or more hosts.

Syntax

Uninstall-SmHostPackage [-HostNames]  <String>  [-ApplicationCode]  <PluginCode>  [-Force]  <>

Detailed Description

Uninstalls all host plug-in components from one or more hosts. Because this cmdlet removes all host package components, you must confirm this operation before the uninstall proceeds with either Yes or No. The default is Yes.

Parameters

Name Description Required? Pipeline Input Default Value

HostNames

Name of one or more hosts from which you want to uninstall all host package components. Host names must be entered using the format -HostNames @("hostname") when uninstalling from a single host, or -HostNames @("hostname1", "hostname2") when uninstalling from multiple hosts. You can specify the hostname using either the host FQDN or IP address.

true

true (ByPropertyName)

ApplicationCode

Specifies the application code being uninstalled from the host. The valid values are SCW, SCSQL, SCO, and SCV. For custom plug-ins, enter the name of the custom plug-in.You must specify -ApplicationCode when using Oracle Real Application Clusters (RAC) to ensure that all nodes in the cluster are upgraded. If -ApplicationCode is not specified, the host package is uninstalled from only one RAC node.

false

true (ByPropertyName)

Force

false

true (ByPropertyName)

DoNotIncludeClusterNodes

Specifies that host plug-in packages are not uninstalled on cluster nodes.

false

true (ByPropertyName)

Examples

Example 1: Uninstalling all host package components from a host

 Uninstall-SmHostPackage -HostNames @("host2012r2.mycompany.com")

This example syntax removes all host package components from the specified host.

Example 2: Uninstalling all host packages from multiple hosts

 Uninstall-SmHostPackage -HostNames @("sql-1.mycompany.com", "sql-2.mycompany.com")

This example syntax uninstalls all host packages from the specified hosts.

Example 3: Uninstalling all host packages from an Oracle RAC

 Uninstall-SmHostPackage -HostNames host.example.com -ApplicationCode SCO

This example syntax uninstalled all host packages from the specified host and uses the SCO application code to ensure that packages on all RAC nodes are uninstalled.