ReplicationServer.InstallDistributor Método

Referência

Definição

Namespace:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Instala o Distribuidor.

Sobrecargas

InstallDistributor(String, String)	Registra um Distribuidor remoto.
InstallDistributor(String, SecureString)	Registra um Distribuidor remoto, onde a senha é especificada usando um objeto SecureString.
InstallDistributor(SecureString, DistributionDatabase)	Instala um Distribuidor na instância atualmente conectada do Microsoft SQL Server, em que a senha é especificada usando um SecureString objeto .
InstallDistributor(String, DistributionDatabase)	Instala um Distribuidor na instância atualmente conectada do Microsoft SQL Server.

Exemplos

// 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 um 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

Um valor String que especifica o nome do servidor remoto a ser usado como o Distribuidor do servidor do Publicador atual. O nome do servidor de distribuição não pode ser igual ao do servidor atual.

password: String

Um valor String que especifica a senha. Esse é o mesmo valor usado ao chamar InstallDistributor(String, DistributionDatabase) no Distribuidor.

Comentários

Esse método deve ser chamado de um Publicador para registrar o Distribuidor remoto. Se o Publicador e o Distribuidor estiverem no mesmo servidor, você não deverá chamar esse método.

Antes de chamar InstallDistributor(String, String), você deve ter chamado InstallDistributor(String, DistributionDatabase) no Distribuidor.

O InstallDistributor método só pode ser chamado por um membro da função de servidor fixa sysadmin.

O InstallDistributor método é equivalente à execução do procedimento armazenado sp_adddistributor (Transact-SQL) no Publicador para registrar um Distribuidor remoto.

Aplica-se a

InstallDistributor(String, SecureString)

Registra um Distribuidor remoto, onde a senha é especificada usando um 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

password: SecureString

Um valor SecureString que especifica a senha. Esse é o mesmo valor usado ao chamar InstallDistributor(String, DistributionDatabase) no Distribuidor.

Comentários

Esse método deve ser chamado de um Publicador para registrar o Distribuidor remoto. Se o Publicador e o Distribuidor estiverem no mesmo servidor, você não deverá chamar esse método.

Antes de chamar InstallDistributor(String, SecureString), você deve ter chamado InstallDistributor(SecureString, DistributionDatabase) no Distribuidor.

O InstallDistributor(String, SecureString) método fornece segurança adicional para a senha enquanto ela é armazenada na memória e deve ser usada em vez de InstallDistributor(String, String).

O InstallDistributor método só pode ser chamado por um membro da função de servidor fixa sysadmin.

O InstallDistributor método é equivalente à execução do procedimento armazenado sp_adddistributor (Transact-SQL) no Publicador para registrar um Distribuidor remoto.

Aplica-se a

InstallDistributor(SecureString, DistributionDatabase)

Instala um Distribuidor na instância atualmente conectada do Microsoft SQL Server, em que a senha é especificada usando um 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

É um valor SecureString que representa a senha de logon de distributor_admin usada para acessar o Distribuidor.

Observação de Segurança Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais, use os http://go.microsoft.com/fwlink/?LinkId=34733 serviços criptográficos fornecidos pelo Windows .NET Framework.

distributionDB: DistributionDatabase

Um objeto DistributionDatabase que representa o banco de dados de distribuição usado pelo Distribuidor.

Comentários

Você deve especificar uma senha forte para password quando o Distribuidor tiver Publicadores remotos. Se password for definido nullcomo , uma senha aleatória será gerada e você deverá chamar ChangeDistributorPassword para redefinir a senha quando o primeiro Publicador remoto for registrado no Distribuidor.

Essa sobrecarga de método deve ser chamada no Distribuidor antes de chamar InstallDistributor(String, String) de um servidor remoto.

O InstallDistributor(SecureString, DistributionDatabase) método fornece segurança adicional para a senha enquanto ela é armazenada na memória e deve ser usada em vez de InstallDistributor(String, DistributionDatabase).

O InstallDistributor método só pode ser chamado por um membro da função de servidor fixa sysadmin.

O InstallDistributor método é equivalente ao procedimento armazenado sp_adddistributor (Transact-SQL ).

Aplica-se a

InstallDistributor(String, DistributionDatabase)

Instala um Distribuidor na instância atualmente conectada do 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

É a senha de logon de distributor_admin usada para acessar o Distribuidor.

distributionDB: DistributionDatabase

Um objeto DistributionDatabase que representa o banco de dados de distribuição usado pelo Distribuidor.

Exceções

ApplicationException

Quando a distribuição já estiver instalada no servidor.

ArgumentException

Quando distributionDB é nulo ou quando password excede 128 bytes ou contém caracteres nulos.

Exemplos

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

Comentários

Essa sobrecarga de método deve ser chamada no Distribuidor antes de chamar InstallDistributor de um servidor remoto.

O InstallDistributor método só pode ser chamado por um membro da função de servidor fixa sysadmin.

O InstallDistributor método é equivalente ao procedimento armazenado sp_adddistributor (Transact-SQL ).

Confira também

Como configurar a publicação e a distribuição (Programação RMO)

Aplica-se a

Compartilhar via

ReplicationServer.InstallDistributor Método

Definição

Sobrecargas

Exemplos

InstallDistributor(String, String)

Parâmetros

Comentários

Aplica-se a

InstallDistributor(String, SecureString)

Parâmetros

Comentários

Aplica-se a

InstallDistributor(SecureString, DistributionDatabase)

Parâmetros

Comentários

Aplica-se a

InstallDistributor(String, DistributionDatabase)

Parâmetros

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais