Compartir a través de

ReplicationServer.InstallDistributor Método

  • Referencia

Definición

Espacio de nombres:
Microsoft.SqlServer.Replication
Ensamblado:
Microsoft.SqlServer.Rmo.dll

Instala un distribuidor.

Sobrecargas

InstallDistributor(String, String)

Registra un distribuidor remoto.
InstallDistributor(String, SecureString)

Registra un distribuidor remoto, donde la contraseña se especifica utilizando un objeto SecureString.
InstallDistributor(SecureString, DistributionDatabase)

Instala un distribuidor en la instancia conectada actualmente de Microsoft SQL Server, donde se especifica la contraseña mediante un SecureString objeto .
InstallDistributor(String, DistributionDatabase)

Instala un distribuidor en la instancia conectada actualmente de Microsoft SQL Server.

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

InstallDistributor(String, String)

Registra un distribuidor remoto.

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

distributionServerName
String

Valor String que especifica el nombre del servidor remoto que se utilizará como distribuidor para el servidor del publicador actual. El nombre del servidor de distribución no puede coincidir con el del servidor actual.

password
String

Valor String que especifica la contraseña. Es el mismo valor que se utilizar para llamar a InstallDistributor(String, DistributionDatabase) en el Distribuidor.

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.

Se aplica a

InstallDistributor(String, SecureString)

Registra un distribuidor remoto, donde la contraseña se especifica utilizando un objeto 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)

Parámetros

distributionServerName
String

Valor String que especifica el nombre del servidor remoto que se utilizará como distribuidor para el servidor del publicador actual. El nombre del servidor de distribución no puede coincidir con el del servidor actual.

password
SecureString

Valor SecureString que especifica la contraseña. Es el mismo valor que se utilizar para llamar a InstallDistributor(String, DistributionDatabase) en el Distribuidor.

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.

Se aplica a

InstallDistributor(SecureString, DistributionDatabase)

Instala un distribuidor en la instancia conectada actualmente de Microsoft SQL Server, donde se especifica la contraseña mediante un SecureString objeto .

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

password
SecureString

Es un valor SecureString que representa la contraseña de inicio de sesión de distributor_admin que se utiliza para tener acceso al distribuidor.

Nota de seguridad Cuando sea posible, pida a los usuarios que escriban credenciales de seguridad en tiempo de ejecución. Si debe almacenar credenciales, use los http://go.microsoft.com/fwlink/?LinkId=34733 servicios criptográficos proporcionados por Windows .NET Framework.

distributionDB
DistributionDatabase

Objeto DistributionDatabase que representa la base de datos de distribución utilizada por el distribuidor.

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

Se aplica a

InstallDistributor(String, DistributionDatabase)

Instala un distribuidor en la instancia conectada actualmente de 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)

Parámetros

password
String

Es la contraseña del inicio de sesión de distributor_admin que se utiliza para tener acceso al distribuidor.

Nota de seguridad Cuando sea posible, pida a los usuarios que escriban credenciales de seguridad en tiempo de ejecución. Si debe almacenar credenciales, use los http://go.microsoft.com/fwlink/?LinkId=34733 servicios criptográficos proporcionados por Windows .NET Framework.

distributionDB
DistributionDatabase

Objeto DistributionDatabase que representa la base de datos de distribución utilizada por el distribuidor.

Excepciones

ApplicationException

Cuando la distribución ya está instalada en el servidor.

ArgumentException

Cuando distributionDB es null, o cuando password supera los 128 bytes o contiene caracteres NULL.

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

Se aplica a