ReplicationServer.InstallDistributor Метод

Определение

Пространство имен:
Microsoft.SqlServer.Replication
Сборка:
Microsoft.SqlServer.Rmo.dll

Устанавливает распределитель.

Перегрузки

Имя Описание
InstallDistributor(String, String)

Регистрирует удалённый дистрибьютор.
InstallDistributor(String, SecureString)

Регистрирует удалённый Дистрибьютор, где пароль указывается с SecureString помощью объекта.
InstallDistributor(SecureString, DistributionDatabase)

Устанавливает Distributor на текущую подключённую экземпляр Microsoft SQL Server, где пароль указывается с помощью объектаSecureString.
InstallDistributor(String, DistributionDatabase)

Устанавливает Distributor на текущую подключённую экземпляр 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, указывающее имя удалённого сервера, используемого в качестве дистрибьютора для текущего сервера Publisher. Имя сервера дистрибуции не может совпадать с именем текущего сервера.

password
String

Значение String , указывающее пароль. Это то же значение, что используется при вызове InstallDistributor(String, DistributionDatabase) у Дистрибьютора.

Комментарии

Этот метод должен быть вызван Publisher для регистрации удалёного дистрибьютора. Если Publisher и Distributor находятся на одном сервере, не стоит называть этот метод.

Перед звонком InstallDistributor(String, String)вы должны были позвонить InstallDistributor(String, DistributionDatabase) в дистрибьютор.

InstallDistributor Метод может быть вызван только членом роли фиксированного сервера системного администратора.

Этот InstallDistributor метод эквивалентен выполнению sp_adddistributor (Transact-SQL) сохранённой процедуры на Publisher для регистрации удалённого Дистрибьютора.

Применяется к

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, указывающее имя удалённого сервера, используемого в качестве дистрибьютора для текущего сервера Publisher. Имя сервера дистрибуции не может совпадать с именем текущего сервера.

password
SecureString

Значение SecureString , указывающее пароль. Это то же значение, что используется при вызове InstallDistributor(String, DistributionDatabase) у Дистрибьютора.

Комментарии

Этот метод должен быть вызван Publisher для регистрации удалёного дистрибьютора. Если Publisher и Distributor находятся на одном сервере, не стоит называть этот метод.

Перед звонком InstallDistributor(String, SecureString)вы должны были позвонить InstallDistributor(SecureString, DistributionDatabase) в дистрибьютор.

Метод InstallDistributor(String, SecureString) обеспечивает дополнительную защиту пароля во время его хранения в памяти и следует использовать вместо InstallDistributor(String, String).

InstallDistributor Метод может быть вызван только членом роли фиксированного сервера системного администратора.

Этот InstallDistributor метод эквивалентен выполнению sp_adddistributor (Transact-SQL) сохранённой процедуры на Publisher для регистрации удалённого Дистрибьютора.

Применяется к

InstallDistributor(SecureString, DistributionDatabase)

Устанавливает Distributor на текущую подключённую экземпляр 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

Это значение, SecureString представляющее пароль от distributor_admin входа, используемого для доступа к Дистрибьютору.

Примечание по безопасности: по возможности предлагайте пользователям вводить учетные данные безопасности во время выполнения. Если вам нужно хранить учетные данные, используйте криптографические услуги, http://go.microsoft.com/fwlink/?LinkId=34733 предоставляемые Windows .NET Framework.

distributionDB
DistributionDatabase

Объект, представляющий базу данных распределения, DistributionDatabase используемую Дистрибьютором.

Комментарии

Вы должны указать надёжный пароль, если password у Дистрибьютора есть удалённые издатели. Если password установлено на null, генерируется случайный пароль, и вы должны позвонить ChangeDistributorPassword для сброса пароля, когда первый удалённый Publisher зарегистрирован у Дистрибьютора.

Перегрузка этого метода должна быть вызвана у Дистрибьютора перед вызовом InstallDistributor(String, String) с удалённого сервера.

Метод InstallDistributor(SecureString, DistributionDatabase) обеспечивает дополнительную защиту пароля во время его хранения в памяти и следует использовать вместо InstallDistributor(String, DistributionDatabase).

InstallDistributor Метод может быть вызван только членом роли фиксированного сервера системного администратора.

Метод InstallDistributor эквивалентен процедуре хранения sp_adddistributor (Transact-SQL).

Применяется к

InstallDistributor(String, DistributionDatabase)

Устанавливает Distributor на текущую подключённую экземпляр 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 входа, используемый для доступа к Дистрибьютору.

Примечание по безопасности: по возможности предлагайте пользователям вводить учетные данные безопасности во время выполнения. Если вам нужно хранить учетные данные, используйте криптографические услуги, http://go.microsoft.com/fwlink/?LinkId=34733 предоставляемые Windows .NET Framework.

distributionDB
DistributionDatabase

Объект, представляющий базу данных распределения, DistributionDatabase используемую Дистрибьютором.

Исключения

ApplicationException

Когда дистрибутив уже установлен на сервере.

ArgumentException

Когда distributionDB является null, или когда password превышает 128 байт или содержит нулевые символы.

Примеры

// 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 для сброса пароля, когда первый удалённый Publisher зарегистрирован у Дистрибьютора.

Перегрузка этого метода должна быть вызвана у Дистрибьютора перед вызовом InstallDistributor с удалённого сервера.

InstallDistributor Метод может быть вызван только членом роли фиксированного сервера системного администратора.

Метод InstallDistributor эквивалентен процедуре хранения sp_adddistributor (Transact-SQL).

См. также раздел

Применяется к