Compartilhar via


ReplicationServer.InstallDistributor Método

Definição

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

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

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.

Exceções

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

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

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

Aplica-se a