ReplicationServer.InstallDistributor Methode

  • Referenz

Definition

Namespace:
Microsoft.SqlServer.Replication
Assembly:
Microsoft.SqlServer.Rmo.dll

Installiert einen Verteiler.

Überlädt

InstallDistributor(String, String)

Registriert einen Remoteverteiler.
InstallDistributor(String, SecureString)

Registriert einen Remoteverteiler, wobei das Kennwort über ein SecureString-Objekt angegeben wird.
InstallDistributor(SecureString, DistributionDatabase)

Installiert einen Verteiler auf der derzeit verbundenen Instanz von Microsoft SQL Server, in der das Kennwort mithilfe eines SecureString -Objekts angegeben wird.
InstallDistributor(String, DistributionDatabase)

Installiert einen Verteiler auf der aktuell verbundenen Instanz von Microsoft SQL Server.

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

InstallDistributor(String, String)

Registriert einen Remoteverteiler.

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

distributionServerName
String

Ein String-Wert, der den Namen des Remoteservers angibt, der für den aktuellen Verlegerserver als Verteiler verwendet werden soll. Der Verteilungsservername darf nicht mit dem aktuellen Server übereinstimmen.

password
String

Ein String-Wert, der das Kennwort angibt. Dies ist der gleiche Wert, der beim Aufrufen von InstallDistributor(String, DistributionDatabase) auf dem Verteiler verwendet wird.

Hinweise

Diese Methode muss von einem Verleger aufgerufen werden, um den Remoteverteiler zu registrieren. Wenn sich Verleger und Verteiler auf demselben Server befinden, sollten Sie diese Methode nicht aufrufen.

Vor dem Aufrufen InstallDistributor(String, String)müssen Sie den Verteiler aufgerufen InstallDistributor(String, DistributionDatabase) haben.

Die InstallDistributor -Methode kann nur von einem Mitglied der festen Serverrolle sysadmin aufgerufen werden.

Die InstallDistributor Methode entspricht dem Ausführen der gespeicherten Prozedur sp_adddistributor (Transact-SQL) auf dem Verleger, um einen Remoteverteiler zu registrieren.

Gilt für:

InstallDistributor(String, SecureString)

Registriert einen Remoteverteiler, wobei das Kennwort über ein SecureString-Objekt angegeben wird.

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

distributionServerName
String

Ein String-Wert, der den Namen des Remoteservers angibt, der für den aktuellen Verlegerserver als Verteiler verwendet werden soll. Der Verteilungsservername darf nicht mit dem aktuellen Server übereinstimmen.

password
SecureString

Ein SecureString-Wert, der das Kennwort angibt. Dies ist der gleiche Wert, der beim Aufrufen von InstallDistributor(String, DistributionDatabase) auf dem Verteiler verwendet wird.

Hinweise

Diese Methode muss von einem Verleger aufgerufen werden, um den Remoteverteiler zu registrieren. Wenn sich Verleger und Verteiler auf demselben Server befinden, sollten Sie diese Methode nicht aufrufen.

Vor dem Aufrufen InstallDistributor(String, SecureString)müssen Sie den Verteiler aufgerufen InstallDistributor(SecureString, DistributionDatabase) haben.

Die InstallDistributor(String, SecureString) -Methode bietet zusätzliche Sicherheit für das Kennwort, während es im Arbeitsspeicher gespeichert ist und anstelle von InstallDistributor(String, String)verwendet werden sollte.

Die InstallDistributor -Methode kann nur von einem Mitglied der festen Serverrolle sysadmin aufgerufen werden.

Die InstallDistributor Methode entspricht dem Ausführen der gespeicherten Prozedur sp_adddistributor (Transact-SQL) auf dem Verleger, um einen Remoteverteiler zu registrieren.

Gilt für:

InstallDistributor(SecureString, DistributionDatabase)

Installiert einen Verteiler auf der derzeit verbundenen Instanz von Microsoft SQL Server, in der das Kennwort mithilfe eines SecureString -Objekts angegeben wird.

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

password
SecureString

Ein SecureString-Wert, der das Kennwort der distributor_admin-Anmeldung darstellt, die für den Zugriff auf den Verteiler verwendet wird.

Sicherheitshinweis: Fordern Sie Benutzer nach Möglichkeit zur Eingabe von Sicherheitsanmeldeinformationen zur Laufzeit auf. Wenn Sie Anmeldeinformationen speichern müssen, verwenden Sie die http://go.microsoft.com/fwlink/?LinkId=34733 kryptografischen Dienste, die vom Windows-.NET Framework bereitgestellt werden.

distributionDB
DistributionDatabase

Ein DistributionDatabase-Objekt, das die vom Verteiler verwendete Verteilungsdatenbank darstellt.

Hinweise

Sie müssen ein sicheres Kennwort angeben password , wenn der Verteiler Remoteverleger hat. Wenn password auf nullfestgelegt ist, wird ein zufälliges Kennwort generiert, und Sie müssen aufrufen ChangeDistributorPassword , um das Kennwort zurückzusetzen, wenn der erste Remoteverleger beim Verteiler registriert ist.

Diese Methodenüberladung muss vor dem Aufrufen InstallDistributor(String, String) von einem Remoteserver beim Verteiler aufgerufen werden.

Die InstallDistributor(SecureString, DistributionDatabase) -Methode bietet zusätzliche Sicherheit für das Kennwort, während es im Arbeitsspeicher gespeichert ist und anstelle von InstallDistributor(String, DistributionDatabase)verwendet werden sollte.

Die InstallDistributor -Methode kann nur von einem Mitglied der festen Serverrolle sysadmin aufgerufen werden.

Die InstallDistributor Methode entspricht der gespeicherten Prozedur sp_adddistributor (Transact-SQL).

Gilt für:

InstallDistributor(String, DistributionDatabase)

Installiert einen Verteiler auf der aktuell verbundenen Instanz von 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)

Parameter

password
String

Das Kennwort der distributor_admin-Anmeldung, das für den Zugriff auf den Verteiler verwendet wurde.

Sicherheitshinweis: Fordern Sie Benutzer nach Möglichkeit zur Eingabe von Sicherheitsanmeldeinformationen zur Laufzeit auf. Wenn Sie Anmeldeinformationen speichern müssen, verwenden Sie die http://go.microsoft.com/fwlink/?LinkId=34733 kryptografischen Dienste, die vom Windows-.NET Framework bereitgestellt werden.

distributionDB
DistributionDatabase

Ein DistributionDatabase-Objekt, das die vom Verteiler verwendete Verteilungsdatenbank darstellt.

Ausnahmen

ApplicationException

Wenn die Verteilung bereits auf dem Server installiert ist.

ArgumentException

Wenn distributionDB null ist oder wenn password 128 Bytes überschritten oder NULL-Zeichen enthält.

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 sicheres Kennwort angeben password , wenn der Verteiler Remoteverleger hat. Wenn password auf nullfestgelegt ist, wird ein zufälliges Kennwort generiert, und Sie müssen aufrufen ChangeDistributorPassword , um das Kennwort zurückzusetzen, wenn der erste Remoteverleger beim Verteiler registriert ist.

Diese Methodenüberladung muss vor dem Aufrufen InstallDistributor von einem Remoteserver beim Verteiler aufgerufen werden.

Die InstallDistributor -Methode kann nur von einem Mitglied der festen Serverrolle sysadmin aufgerufen werden.

Die InstallDistributor Methode entspricht der gespeicherten Prozedur sp_adddistributor (Transact-SQL).

Weitere Informationen

Gilt für: