Udostępnij za pośrednictwem

  • Artykuł

Metoda ReplicationServer.InstallDistributor (String, DistributionDatabase)

Installs a Distributor on the currently connected instance of Microsoft SQL Server.

Przestrzeń nazw:  Microsoft.SqlServer.Replication
Zestaw:  Microsoft.SqlServer.Rmo (w Microsoft.SqlServer.Rmo.dll)

Składnia

'Deklaracja
Public Sub InstallDistributor ( _
    password As String, _
    distributionDB As DistributionDatabase _
)
'Użycie
Dim instance As ReplicationServer
Dim password As String
Dim distributionDB As DistributionDatabase

instance.InstallDistributor(password, _
    distributionDB)

public void InstallDistributor(
    string password,
    DistributionDatabase distributionDB
)

public:
void InstallDistributor(
    String^ password, 
    DistributionDatabase^ distributionDB
)

member InstallDistributor : 
        password:string * 
        distributionDB:DistributionDatabase -> unit 

public function InstallDistributor(
    password : String, 
    distributionDB : DistributionDatabase
)

Parametry

  • password
    Typ: System.String
    Jest to hasło logowania distributor_admin, umożliwiające dostęp do dystrybutora.
    Uwaga dotycząca zabezpieczeń, gdy to możliwe, monitowanie użytkowników o wprowadzenie poświadczenia zabezpieczeń na uruchamianie czas.Jeśli poświadczenia muszą być przechowywane, za pomocą https://go.microsoft.com/fwlink/?LinkId = 34733 kryptograficznych usług świadczonych przez system Windows.NET Framework.

Wyjątki

Wyjątek Warunek
ApplicationException

Podczas dystrybucji jest już zainstalowany na serwerze.
ArgumentException

Gdy distributionDB ma wartość null, lub gdy password przekracza 128 bajtów lub zawiera znaki null.

Uwagi

Należy określić silne hasło password gdy dystrybutor ma zdalnego wydawców.Jeśli password jest zestaw do nullodwołanie o wartości null (Nothing w języku Visual Basic), jest generowany losowo hasła i musisz wywołać ChangeDistributorPassword do rezestaw hasła podczas pierwszego wydawcy zdalnego jest zarejestrowany u dystrybutora.

Należy wywołać tego przeciążenia metoda u dystrybutora przed wywoływaniem InstallDistributor z serwera zdalnego.

InstallDistributor Metoda może być wywoływana tylko przez element członkowski sysadmin stała rola serwera.

InstallDistributor Jest równoważna metoda sp_adddistributor (języka Transact-SQL)procedura składowana.

Ten obszar nazw, klasy lub element członkowski jest obsługiwany tylko w wersja 2.0.NET Framework.

Przykłady

          // Set the server and database names
            string distributionDbName = "distribution";
            string publisherName = publisherInstance;
            string publicationDbName = "AdventureWorks2008R2";

            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();
            }