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 プログラミング)