ReplicationServer.InstallDistributor Methode

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)

Parameter

Hinweise

Diese Methode muss von einem Publisher aufgerufen werden, um den entfernten Distributor zu registrieren. Wenn Publisher und Distributor auf demselben Server sind, solltest du diese Methode nicht aufrufen.

Bevor Sie anrufen InstallDistributor(String, String), müssen Sie beim Distributor angerufen InstallDistributor(String, DistributionDatabase) haben.

Die Methode InstallDistributor kann nur von einem Mitglied der Sysadmin-Fixed-Server-Rolle aufgerufen werden.

Die Methode InstallDistributor entspricht der Ausführung der sp_adddistributor (Transact-SQL) gespeicherten Prozedur am Publisher zur Registrierung eines entfernten Distributors.

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)

Parameter

Hinweise

Diese Methode muss von einem Publisher aufgerufen werden, um den entfernten Distributor zu registrieren. Wenn Publisher und Distributor auf demselben Server sind, solltest du diese Methode nicht aufrufen.

Bevor Sie anrufen InstallDistributor(String, SecureString), müssen Sie beim Distributor angerufen InstallDistributor(SecureString, DistributionDatabase) haben.

Die Methode InstallDistributor(String, SecureString) bietet zusätzliche Sicherheit für das Passwort, solange es im Speicher gespeichert ist, und sollte anstelle von InstallDistributor(String, String)verwendet werden.

Die Methode InstallDistributor kann nur von einem Mitglied der Sysadmin-Fixed-Server-Rolle aufgerufen werden.

Die Methode InstallDistributor entspricht der Ausführung der sp_adddistributor (Transact-SQL) gespeicherten Prozedur am Publisher zur Registrierung eines entfernten Distributors.

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)

Parameter

Hinweise

Sie müssen ein starkes Passwort angeben, wenn password der Distributor entfernte Publisher hat. Wenn password auf gesetzt istnull, wird ein zufälliges Passwort generiert, und Sie müssen anrufenChangeDistributorPassword, um das Passwort zurückzusetzen, wenn der erste entfernte Publisher beim Distributor registriert ist.

Diese Methodenüberlastung muss beim Verteiler aufgerufen werden, bevor sie von einem entfernten Server aufruft InstallDistributor(String, String) .

Die Methode InstallDistributor(SecureString, DistributionDatabase) bietet zusätzliche Sicherheit für das Passwort, solange es im Speicher gespeichert ist, und sollte anstelle von InstallDistributor(String, DistributionDatabase)verwendet werden.

Die Methode InstallDistributor kann nur von einem Mitglied der Sysadmin-Fixed-Server-Rolle aufgerufen werden.

Die Methode InstallDistributor ist äquivalent zum sp_adddistributor (Transact-SQL) gespeicherten Verfahren.

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)

Parameter

Ausnahmen

Beispiele

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

Hinweise

Sie müssen ein starkes Passwort angeben, wenn password der Distributor entfernte Publisher hat. Wenn password auf gesetzt istnull, wird ein zufälliges Passwort generiert, und Sie müssen anrufenChangeDistributorPassword, um das Passwort zurückzusetzen, wenn der erste entfernte Publisher beim Distributor registriert ist.

Diese Methodenüberlastung muss beim Verteiler aufgerufen werden, bevor sie von einem entfernten Server aufruft InstallDistributor .

Die Methode InstallDistributor kann nur von einem Mitglied der Sysadmin-Fixed-Server-Rolle aufgerufen werden.

Die Methode InstallDistributor ist äquivalent zum sp_adddistributor (Transact-SQL) gespeicherten Verfahren.

Weitere Informationen

• Anleitung: Konfigurieren von Publishing and Distribution (RMO-Programmierung)