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

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

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

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 для доступа к распространителю.

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

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).

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

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