ReplicationServer.InstallDistributor メソッド

  • リファレンス

定義

名前空間:
Microsoft.SqlServer.Replication
アセンブリ:
Microsoft.SqlServer.Rmo.dll

ディストリビューターをインストールします。

オーバーロード

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

現在のパブリッシャー サーバーのディストリビューターとして使用されるリモート サーバーの名前を指定する String 値です。 ディストリビューション サーバー名は、現在のサーバーと同じにすることはできません。

password
String

パスワードを指定する String 値です。 これは、ディストリビューター側で InstallDistributor(String, DistributionDatabase) を呼び出すときに使用される値と同じです。

注釈

リモート ディストリビューターを登録するには、このメソッドをパブリッシャーから呼び出す必要があります。 パブリッシャーとディストリビューターが同じサーバーにある場合は、このメソッドを呼び出すことができません。

InstallDistributor(String, String) を呼び出す前に、ディストリビューター側で InstallDistributor(String, DistributionDatabase) を呼び出しておく必要があります。

メソッドは InstallDistributor 、sysadmin 固定サーバー ロールのメンバーによってのみ呼び出すことができます。

メソッドは InstallDistributor 、パブリッシャーで 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

現在のパブリッシャー サーバーのディストリビューターとして使用されるリモート サーバーの名前を指定する String 値です。 ディストリビューション サーバー名は、現在のサーバーと同じにすることはできません。

password
SecureString

パスワードを指定する SecureString 値です。 これは、ディストリビューター側で InstallDistributor(String, DistributionDatabase) を呼び出すときに使用される値と同じです。

注釈

リモート ディストリビューターを登録するには、このメソッドをパブリッシャーから呼び出す必要があります。 パブリッシャーとディストリビューターが同じサーバーにある場合は、このメソッドを呼び出すことができません。

InstallDistributor(String, SecureString) を呼び出す前に、ディストリビューター側で InstallDistributor(SecureString, DistributionDatabase) を呼び出しておく必要があります。

InstallDistributor(String, SecureString) メソッドでは、パスワードがメモリに保持されている間のセキュリティが強化されています。パスワードを設定するときには、InstallDistributor(String, String) ではなく、このメソッドを使用してください。

メソッドは InstallDistributor 、sysadmin 固定サーバー ロールのメンバーによってのみ呼び出すことができます。

メソッドは InstallDistributor 、パブリッシャーで 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 Frameworkによって提供される暗号化サービスを使用http://go.microsoft.com/fwlink/?LinkId=34733します。

distributionDB
DistributionDatabase

ディストリビューターによって使用されるディストリビューション データベースを表す DistributionDatabase オブジェクトです。

注釈

ディストリビューターがリモート パブリッシャーを使用している場合、password には、強力なパスワードを指定する必要があります。 password が null に設定されている場合は、ランダムなパスワードが生成されますが、最初のリモート パブリッシャーがディストリビューターに登録されるときに ChangeDistributorPassword を呼び出して、このパスワードをリセットする必要があります。

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

InstallDistributor(SecureString, DistributionDatabase) メソッドでは、パスワードがメモリに保持されている間のセキュリティが強化されています。パスワードを設定するときには、InstallDistributor(String, DistributionDatabase) ではなく、このメソッドを使用してください。

メソッドは InstallDistributor 、sysadmin 固定サーバー ロールのメンバーによってのみ呼び出すことができます。

メソッドは 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 Frameworkによって提供される暗号化サービスを使用http://go.microsoft.com/fwlink/?LinkId=34733します。

distributionDB
DistributionDatabase

ディストリビューターによって使用されるディストリビューション データベースを表す DistributionDatabase オブジェクトです。

例外

ApplicationException

ディストリビューターがサーバーに既にインストールされている場合。

ArgumentException

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 には、強力なパスワードを指定する必要があります。 password が null に設定されている場合は、ランダムなパスワードが生成されますが、最初のリモート パブリッシャーがディストリビューターに登録されるときに ChangeDistributorPassword を呼び出して、このパスワードをリセットする必要があります。

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

メソッドは InstallDistributor 、sysadmin 固定サーバー ロールのメンバーによってのみ呼び出すことができます。

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

こちらもご覧ください

適用対象