ReplicationServer.InstallDistributor メソッド

定義

ディストリビューターを設置する。

オーバーロード

名前 説明
InstallDistributor(String, String)

リモートのディストリビューターを登録する。

InstallDistributor(String, SecureString)

リモートディストリビューターを登録し、パスワードは SecureString オブジェクトで指定されます。

InstallDistributor(SecureString, DistributionDatabase)

現在接続されているMicrosoft SQL Serverインスタンスにディストリビュータをインストールし、パスワードはSecureStringオブジェクトで指定されます。

InstallDistributor(String, DistributionDatabase)

現在接続されているMicrosoft SQL Serverのインスタンスにディストリビュータをインストールします。

// 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();
}

InstallDistributor(String, String)

リモートのディストリビューターを登録する。

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)

パラメーター

distributionServerName
String

現在のPublisherサーバーのディストリビューターとして使うリモートサーバーの名前を指定するString値です。 配布サーバーの名前は現在のサーバーと同じであってはなりません。

password
String

パスワードを指定する String の値。 これはディストリビューターで InstallDistributor(String, DistributionDatabase) を呼ぶ際に使われる値と同じです。

注釈

この方法はリモート配信者を登録するためにPublisherから呼び出す必要があります。 PublisherとDistributorが同じサーバー上にある場合、このメソッドを呼び出すべきではありません。

InstallDistributor(String, String)に電話する前に、ディストリビューターのInstallDistributor(String, DistributionDatabase)に電話したはずです。

InstallDistributorメソッドはシステム管理者の固定サーバーロールのメンバーのみが呼び出せます。

InstallDistributorメソッドは、Publisherでリモートディストリビュータを登録するためにsp_adddistributor(Transact-SQL)ストアドプロシージャを実行するのと同等です。

適用対象

InstallDistributor(String, SecureString)

リモートディストリビューターを登録し、パスワードは SecureString オブジェクトで指定されます。

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)

パラメーター

distributionServerName
String

現在のPublisherサーバーのディストリビューターとして使うリモートサーバーの名前を指定するString値です。 配布サーバーの名前は現在のサーバーと同じであってはなりません。

password
SecureString

パスワードを指定する SecureString の値。 これはディストリビューターで InstallDistributor(String, DistributionDatabase) を呼ぶ際に使われる値と同じです。

注釈

この方法はリモート配信者を登録するためにPublisherから呼び出す必要があります。 PublisherとDistributorが同じサーバー上にある場合、このメソッドを呼び出すべきではありません。

InstallDistributor(String, SecureString)に電話する前に、ディストリビューターのInstallDistributor(SecureString, DistributionDatabase)に電話したはずです。

InstallDistributor(String, SecureString)方式はパスワードがメモリに保存されている間に追加のセキュリティを提供し、InstallDistributor(String, String)の代わりに使用すべきです。

InstallDistributorメソッドはシステム管理者の固定サーバーロールのメンバーのみが呼び出せます。

InstallDistributorメソッドは、Publisherでリモートディストリビュータを登録するためにsp_adddistributor(Transact-SQL)ストアドプロシージャを実行するのと同等です。

適用対象

InstallDistributor(SecureString, DistributionDatabase)

現在接続されているMicrosoft SQL Serverインスタンスにディストリビュータをインストールし、パスワードはSecureStringオブジェクトで指定されます。

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
SecureString

distributor_adminログインのパスワードを表す SecureString 値は、ディストリビューターにアクセスするために使われます。

セキュリティ注意事項 可能であれば、実行時にユーザーにセキュリティ認証情報の入力を促してください。 認証情報を保存する必要がある場合は、Windows .NETフレームワークが提供するhttp://go.microsoft.com/fwlink/?LinkId=34733暗号サービスを利用してください。

distributionDB
DistributionDatabase

ディストリビューターが使用する配布データベースを表す DistributionDatabase オブジェクト。

注釈

ディストリビューターがリモートの出版社を持っている場合は、 password に強力なパスワードを指定する必要があります。 passwordnullに設定されている場合、ランダムなパスワードが生成され、最初のリモートPublisherがディストリビューターに登録された際にパスワードをリセットするためにChangeDistributorPasswordに連絡しなければなりません。

このメソッドオーバーロードは、リモートサーバーから InstallDistributor(String, String) を呼び出す前にディストリビューターで呼び出される必要があります。

InstallDistributor(SecureString, DistributionDatabase)方式はパスワードがメモリに保存されている間に追加のセキュリティを提供し、InstallDistributor(String, DistributionDatabase)の代わりに使用すべきです。

InstallDistributorメソッドはシステム管理者の固定サーバーロールのメンバーのみが呼び出せます。

InstallDistributorメソッドは、sp_adddistributor(Transact-SQL)ストアドプロシージャと同等です。

適用対象

InstallDistributor(String, DistributionDatabase)

現在接続されているMicrosoft SQL Serverのインスタンスにディストリビュータをインストールします。

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)

パラメーター

password
String

ディストリビューターにアクセスするためにdistributor_adminログインのパスワードが使われていますか?

セキュリティ注意事項 可能であれば、実行時にユーザーにセキュリティ認証情報の入力を促してください。 認証情報を保存する必要がある場合は、Windows .NETフレームワークが提供するhttp://go.microsoft.com/fwlink/?LinkId=34733暗号サービスを利用してください。

distributionDB
DistributionDatabase

ディストリビューターが使用する配布データベースを表す DistributionDatabase オブジェクト。

例外

サーバーにすでに配布がインストールされている場合。

distributionDBがnullの場合、またはpasswordが128バイトを超える場合やnull文字が含まれている場合。

// 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 に強力なパスワードを指定する必要があります。 passwordnullに設定されている場合、ランダムなパスワードが生成され、最初のリモートPublisherがディストリビューターに登録された際にパスワードをリセットするためにChangeDistributorPasswordに連絡しなければなりません。

このメソッドオーバーロードは、リモートサーバーから InstallDistributor を呼び出す前にディストリビューターで呼び出される必要があります。

InstallDistributorメソッドはシステム管理者の固定サーバーロールのメンバーのみが呼び出せます。

InstallDistributorメソッドは、sp_adddistributor(Transact-SQL)ストアドプロシージャと同等です。

こちらもご覧ください

適用対象