Add Method

Adds a new alias to the collection.

Syntax

Function Add(
    AliasName As String,
    Id As String,
    [Disabled As Boolean = False]) As Alias

Parameters

AliasName

The name of the alias to be added. Use the UserAlias object's Name Property to retrieve this value.

Id

The id of the alias to be added. User the UserAlias object's Id Property to retrieve this value.

Disabled

Specify whether the alias will be disabled or enabled.

Remarks

Use this method to assign a third-party alias to the user, or to re-assign a third-party alias from one user to another. If you try to add the same alias to more than one user, an error will occur. When you add an alias to the collection, then the user will become a member of any groups that the alias belonged to.

When you re-assign an alias, the APS automatically removes the alias from the original collection. It will also delete the user if the last alias in the collection has been removed.