ReplicationServer.InstallDistributor Method (SecureString, DistributionDatabase)

Installs a Distributor on the currently connected instance of Microsoft SQL Server, where the password is specified using a SecureString object.

Namespace:  Microsoft.SqlServer.Replication
Assembly:  Microsoft.SqlServer.Rmo (in Microsoft.SqlServer.Rmo.dll)


Public Sub InstallDistributor ( _
    password As SecureString, _
    distributionDB As DistributionDatabase _
Dim instance As ReplicationServer
Dim password As SecureString
Dim distributionDB As DistributionDatabase

instance.InstallDistributor(password, _
public void InstallDistributor(
    SecureString password,
    DistributionDatabase distributionDB
void InstallDistributor(
    SecureString^ password, 
    DistributionDatabase^ distributionDB
member InstallDistributor : 
        password:SecureString * 
        distributionDB:DistributionDatabase -> unit 
public function InstallDistributor(
    password : SecureString, 
    distributionDB : DistributionDatabase



You must specify a strong password for password when the Distributor has remote Publishers. If password is set to nulla null reference (Nothing in Visual Basic), a random password is generated, and you must call ChangeDistributorPassword to reset the password when the first remote Publisher is registered at the Distributor.

This method overload must be called at the Distributor before calling InstallDistributor(String, String) from a remote server.

The InstallDistributor(SecureString, DistributionDatabase) method provides additional security for the password while it is stored in memory and should be used instead of InstallDistributor(String, DistributionDatabase).

The InstallDistributor method can only be called by a member of the sysadmin fixed server role.

The InstallDistributor method is equivalent to the sp_adddistributor (Transact-SQL) stored procedure.

This namespace, class, or member is supported only in version 2.0 of the .NET Framework.