ReplicationServer.InstallDistributor Método

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)

Parámetros

Comentarios

Se debe llamar a este método desde un publicador para registrar el distribuidor remoto. Si el publicador y el distribuidor están en el mismo servidor, no debe llamar a este método.

Antes de llamar a InstallDistributor(String, String), debe haber llamado InstallDistributor(String, DistributionDatabase) al distribuidor.

Un InstallDistributor miembro del rol fijo de servidor sysadmin solo puede llamar al método .

El InstallDistributor método equivale a ejecutar el procedimiento almacenado de sp_adddistributor (Transact-SQL) en el publicador para registrar un distribuidor remoto.

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)

Parámetros

Comentarios

Se debe llamar a este método desde un publicador para registrar el distribuidor remoto. Si el publicador y el distribuidor están en el mismo servidor, no debe llamar a este método.

Antes de llamar a InstallDistributor(String, SecureString), debe haber llamado InstallDistributor(SecureString, DistributionDatabase) al distribuidor.

El InstallDistributor(String, SecureString) método proporciona seguridad adicional para la contraseña mientras se almacena en memoria y se debe usar en lugar de InstallDistributor(String, String).

Un InstallDistributor miembro del rol fijo de servidor sysadmin solo puede llamar al método .

El InstallDistributor método equivale a ejecutar el procedimiento almacenado de sp_adddistributor (Transact-SQL) en el publicador para registrar un distribuidor remoto.

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)

Parámetros

Comentarios

Debe especificar una contraseña segura para password cuando el distribuidor tenga publicadores remotos. Si password se establece nullen , se genera una contraseña aleatoria y debe llamar ChangeDistributorPassword a para restablecer la contraseña cuando el primer publicador remoto esté registrado en el distribuidor.

Se debe llamar a esta sobrecarga de método en el distribuidor antes de llamar InstallDistributor(String, String) desde un servidor remoto.

El InstallDistributor(SecureString, DistributionDatabase) método proporciona seguridad adicional para la contraseña mientras se almacena en memoria y se debe usar en lugar de InstallDistributor(String, DistributionDatabase).

Un InstallDistributor miembro del rol fijo de servidor sysadmin solo puede llamar al método .

El InstallDistributor método es equivalente al procedimiento almacenado de sp_adddistributor (Transact-SQL).

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)

Parámetros

Excepciones

Ejemplos

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

Comentarios

Debe especificar una contraseña segura para password cuando el distribuidor tenga publicadores remotos. Si password se establece nullen , se genera una contraseña aleatoria y debe llamar ChangeDistributorPassword a para restablecer la contraseña cuando el primer publicador remoto esté registrado en el distribuidor.

Se debe llamar a esta sobrecarga de método en el distribuidor antes de llamar InstallDistributor desde un servidor remoto.

Un InstallDistributor miembro del rol fijo de servidor sysadmin solo puede llamar al método .

El InstallDistributor método es equivalente al procedimiento almacenado de sp_adddistributor (Transact-SQL).

Consulte también

• Cómo configurar la publicación y distribución (programación de RMO)