Uninstall-SmHostPackage
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.