Remove Method (Aliases collection)

                    

 

Removes an alias from the Aliases collection. Also removes the alias from the Known Servers Table for the machine.

 

Syntax

object.Remove Alias

The Remove method syntax has these parts:

Part

Description

object

An object expression that evaluates to an Aliases collection.

Alias

A string containing the alias name to be removed. This may be an alternate serverID or alternate name for the server in the case of the Aliases collection obtained from the Servers.Aliases property or an alternate server path in the case of the Server.PathAliases property.

 

Remarks

Remove will attempt to remove the alias from the Aliases collection and from the underlying persistent representation. In the case of the Servers.Aliases collection this will be the ServerAliases Table. In the case of the Servers.PathAliases collection, this will be the PathAliases Table.

In order to remove the alias from the Known Servers Table, this method modifies the system registry. You may need to log in from a privileged account in order to use this and other methods that enter or modify values in the Known Servers Table.

 

Trappable Errors

In addition to generic errors (such as Out of Memory), the following errors may occur:

Error

Description

pseALIASREMOVE

Unable to remove this alias from the Server Aliases table. It may not exist.

psePATHALIASREMOVE

Unable to remove this alias from the Path Aliases table. It may not exist.

Enabling Operational Intelligence