ReplicationServer.InstallDistributor メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ディストリビューターを設置する。
オーバーロード
| 名前 | 説明 |
|---|---|
| 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 に強力なパスワードを指定する必要があります。
passwordがnullに設定されている場合、ランダムなパスワードが生成され、最初のリモート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 に強力なパスワードを指定する必要があります。
passwordがnullに設定されている場合、ランダムなパスワードが生成され、最初のリモートPublisherがディストリビューターに登録された際にパスワードをリセットするためにChangeDistributorPasswordに連絡しなければなりません。
このメソッドオーバーロードは、リモートサーバーから InstallDistributor を呼び出す前にディストリビューターで呼び出される必要があります。
InstallDistributorメソッドはシステム管理者の固定サーバーロールのメンバーのみが呼び出せます。
InstallDistributorメソッドは、sp_adddistributor(Transact-SQL)ストアドプロシージャと同等です。