ReplicationServer.InstallDistributor 方法

public:
 void InstallDistributor(System::String ^ distributionServerName, System::String ^ password);

public void InstallDistributor (string distributionServerName, string password);

member this.InstallDistributor : string * string -> unit

Public Sub InstallDistributor (distributionServerName As String, password As String)

参数

注解

必须从发布服务器调用此方法才能注册远程分发服务器。 如果发布服务器和分发服务器位于同一服务器上，则不应调用此方法。

在调用 InstallDistributor(String, String)之前，必须在分发服务器上调用 InstallDistributor(String, DistributionDatabase) 。

方法 InstallDistributor 只能由 sysadmin 固定服务器角色的成员调用。

方法 InstallDistributor 等效于在发布服务器上执行 sp_adddistributor (Transact-SQL) 存储过程来注册远程分发服务器。

public:
 void InstallDistributor(System::String ^ distributionServerName, System::Security::SecureString ^ password);

public void InstallDistributor (string distributionServerName, System.Security.SecureString password);

member this.InstallDistributor : string * System.Security.SecureString -> unit

Public Sub InstallDistributor (distributionServerName As String, password As SecureString)

参数

注解

必须从发布服务器调用此方法才能注册远程分发服务器。 如果发布服务器和分发服务器位于同一服务器上，则不应调用此方法。

在调用 InstallDistributor(String, SecureString)之前，必须在分发服务器上调用 InstallDistributor(SecureString, DistributionDatabase) 。

方法 InstallDistributor(String, SecureString) 为密码提供额外的安全性，而密码存储在内存中，应使用 而不是 InstallDistributor(String, String)。

方法 InstallDistributor 只能由 sysadmin 固定服务器角色的成员调用。

方法 InstallDistributor 等效于在发布服务器上执行 sp_adddistributor (Transact-SQL) 存储过程来注册远程分发服务器。

public:
 void InstallDistributor(System::Security::SecureString ^ password, Microsoft::SqlServer::Replication::DistributionDatabase ^ distributionDB);

public void InstallDistributor (System.Security.SecureString password, Microsoft.SqlServer.Replication.DistributionDatabase distributionDB);

member this.InstallDistributor : System.Security.SecureString * Microsoft.SqlServer.Replication.DistributionDatabase -> unit

Public Sub InstallDistributor (password As SecureString, distributionDB As DistributionDatabase)

参数

注解

当分发服务器具有远程发布服务器时，必须指定强密码 password 。 如果 password 设置为 null，则会生成随机密码，并且必须在分发服务器上注册第一个远程发布服务器时调用 ChangeDistributorPassword 以重置密码。

在从远程服务器调用之前，必须在分发服务器上调用 InstallDistributor(String, String) 此方法重载。

方法 InstallDistributor(SecureString, DistributionDatabase) 为密码提供额外的安全性，而密码存储在内存中，应使用 而不是 InstallDistributor(String, DistributionDatabase)。

方法 InstallDistributor 只能由 sysadmin 固定服务器角色的成员调用。

方法 InstallDistributor 等效于 sp_adddistributor (Transact-SQL) 存储过程。

public:
 void InstallDistributor(System::String ^ password, Microsoft::SqlServer::Replication::DistributionDatabase ^ distributionDB);

public void InstallDistributor (string password, Microsoft.SqlServer.Replication.DistributionDatabase distributionDB);

member this.InstallDistributor : string * Microsoft.SqlServer.Replication.DistributionDatabase -> unit

Public Sub InstallDistributor (password As String, distributionDB As DistributionDatabase)

参数

例外

示例

// Set the server and database names
string distributionDbName = "distribution";
string publisherName = publisherInstance;
string publicationDbName = "AdventureWorks2012";

DistributionDatabase distributionDb;
ReplicationServer distributor;
DistributionPublisher publisher;
ReplicationDatabase publicationDb;

// Create a connection to the server using Windows Authentication.
ServerConnection conn = new ServerConnection(publisherName);

try
{
    // Connect to the server acting as the Distributor 
    // and local Publisher.
    conn.Connect();

    // Define the distribution database at the Distributor,
    // but do not create it now.
    distributionDb = new DistributionDatabase(distributionDbName, conn);
    distributionDb.MaxDistributionRetention = 96;
    distributionDb.HistoryRetention = 120;

    // Set the Distributor properties and install the Distributor.
    // This also creates the specified distribution database.
    distributor = new ReplicationServer(conn);
    distributor.InstallDistributor((string)null, distributionDb);

    // Set the Publisher properties and install the Publisher.
    publisher = new DistributionPublisher(publisherName, conn);
    publisher.DistributionDatabase = distributionDb.Name;
    publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
    publisher.PublisherSecurity.WindowsAuthentication = true;
    publisher.Create();

    // Enable AdventureWorks2012 as a publication database.
    publicationDb = new ReplicationDatabase(publicationDbName, conn);

    publicationDb.EnabledTransPublishing = true;
    publicationDb.EnabledMergePublishing = true;
}
catch (Exception ex)
{
    // Implement appropriate error handling here.
    throw new ApplicationException("An error occured when installing distribution and publishing.", ex);
}
finally
{
    conn.Disconnect();
}

注解

当分发服务器具有远程发布服务器时，必须指定强密码 password 。 如果 password 设置为 null，则会生成随机密码，并且必须在分发服务器上注册第一个远程发布服务器时调用 ChangeDistributorPassword 以重置密码。

在从远程服务器调用之前，必须在分发服务器上调用 InstallDistributor 此方法重载。

方法 InstallDistributor 只能由 sysadmin 固定服务器角色的成员调用。

方法 InstallDistributor 等效于 sp_adddistributor (Transact-SQL) 存储过程。

另请参阅

• 如何配置发布和分发（RMO 编程）