ReplicationServer.InstallDistributor Method (String, DistributionDatabase)
Installs a Distributor on the currently connected instance of Microsoft SQL Server.
命名空間: Microsoft.SqlServer.Replication
組件: Microsoft.SqlServer.Rmo (in microsoft.sqlserver.rmo.dll)
語法
'宣告
Public Sub InstallDistributor ( _
password As String, _
distributionDB As DistributionDatabase _
)
public void InstallDistributor (
string password,
DistributionDatabase distributionDB
)
public:
void InstallDistributor (
String^ password,
DistributionDatabase^ distributionDB
)
public void InstallDistributor (
String password,
DistributionDatabase distributionDB
)
public function InstallDistributor (
password : String,
distributionDB : DistributionDatabase
)
參數
password
Is the password of the distributor_admin login used to access the Distributor.安全性注意事項: When possible, prompt users to enter security credentials at run time. If you must store credentials, use the cryptographic services provided by the Windows .NET Framework.
- distributionDB
A DistributionDatabase object representing the distribution database used by the Distributor.
例外
例外類型 | 狀況 |
---|---|
ApplicationException | When distribution is already installed on the server. |
ArgumentException | When distributionDB is null, or when password exceeds 128 bytes or contains null characters. |
備註
You must specify a strong password for password when the Distributor has remote Publishers. If password is set to null, a random password is generated, and you must call ChangeDistributorPassword to reset the password when the first remote Publisher is registered at the Distributor.
This method overload must be called at the Distributor before calling InstallDistributor from a remote server.
The InstallDistributor method can only be called by a member of the sysadmin fixed server role.
The InstallDistributor method is equivalent to the sp_adddistributor (Transact-SQL) stored procedure.
This namespace, class, or member is supported only in version 2.0 of the .NET Framework.
範例
// Set the server and database names
string distributionDbName = "distribution";
string publisherName = publisherInstance;
string publicationDbName = "AdventureWorks";
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 AdventureWorks 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();
}
執行緒安全性
Any public static (Shared in Microsoft Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
平台
開發平台
如需受支援的平台清單,請參閱<安裝 SQL Server 2005 的硬體和軟體需求>。
目標平台
如需受支援的平台清單,請參閱<安裝 SQL Server 2005 的硬體和軟體需求>。
請參閱
參考
ReplicationServer Class
ReplicationServer Members
Microsoft.SqlServer.Replication Namespace
其他資源
How to: Configure Publishing and Distribution (RMO Programming)