ReplicationServer.InstallDistributor Metodo

Definizione

Installa un server di distribuzione.

Overload

InstallDistributor(String, String)

Registra un server di distribuzione remoto.

InstallDistributor(String, SecureString)

Registra un server di distribuzione remoto, in cui la password viene specificata utilizzando un oggetto SecureString.

InstallDistributor(SecureString, DistributionDatabase)

Installa un server di distribuzione nell'istanza attualmente connessa di Microsoft SQL Server, in cui la password viene specificata utilizzando un SecureString oggetto.

InstallDistributor(String, DistributionDatabase)

Installa un server di distribuzione nell'istanza attualmente connessa di Microsoft SQL Server.

Esempio

// 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 server di distribuzione 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)

Parametri

distributionServerName
String

Valore String che specifica il nome del server remoto da utilizzare come server di distribuzione per il server di pubblicazione corrente. Il nome del server di distribuzione non può coincidere con quello del server corrente.

password
String

Valore String che specifica la password. Si tratta dello stesso valore utilizzato quando viene chiamato InstallDistributor(String, DistributionDatabase) nel server di distribuzione.

Commenti

Questo metodo deve essere chiamato da un server di pubblicazione per registrare il server di distribuzione remoto. Se il server di pubblicazione e il server di distribuzione si trovano nello stesso server, non è necessario chiamare questo metodo.

Prima InstallDistributor(String, String) di chiamare, è necessario avere chiamato InstallDistributor(String, DistributionDatabase) sul server di distribuzione.

Il InstallDistributor metodo può essere chiamato solo da un membro del ruolo predefinito del server sysadmin.

Il InstallDistributor metodo equivale all'esecuzione del Sp_adddistributor (Transact-SQL) stored procedure nel server di pubblicazione per la registrazione di un server di distribuzione remoto.

Si applica a

InstallDistributor(String, SecureString)

Registra un server di distribuzione remoto, in cui la password viene specificata utilizzando un oggetto 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)

Parametri

distributionServerName
String

Valore String che specifica il nome del server remoto da utilizzare come server di distribuzione per il server di pubblicazione corrente. Il nome del server di distribuzione non può coincidere con quello del server corrente.

password
SecureString

Valore SecureString che specifica la password. Si tratta dello stesso valore utilizzato quando viene chiamato InstallDistributor(String, DistributionDatabase) nel server di distribuzione.

Commenti

Questo metodo deve essere chiamato da un server di pubblicazione per registrare il server di distribuzione remoto. Se il server di pubblicazione e il server di distribuzione si trovano nello stesso server, non è necessario chiamare questo metodo.

Prima InstallDistributor(String, SecureString) di chiamare, è necessario avere chiamato InstallDistributor(SecureString, DistributionDatabase) sul server di distribuzione.

Il InstallDistributor(String, SecureString) metodo fornisce sicurezza aggiuntiva per la password mentre è archiviato in memoria e deve essere utilizzato al posto di InstallDistributor(String, String) .

Il InstallDistributor metodo può essere chiamato solo da un membro del ruolo predefinito del server sysadmin.

Il InstallDistributor metodo equivale all'esecuzione del Sp_adddistributor (Transact-SQL) stored procedure nel server di pubblicazione per la registrazione di un server di distribuzione remoto.

Si applica a

InstallDistributor(SecureString, DistributionDatabase)

Installa un server di distribuzione nell'istanza attualmente connessa di Microsoft SQL Server, in cui la password viene specificata utilizzando un SecureString oggetto.

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)

Parametri

password
SecureString

Valore SecureString che rappresenta la password dell'account di accesso distributor_admin utilizzata per accedere al server di distribuzione.

Nota sulla sicurezza:   se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione. Se è necessario archiviare le credenziali, utilizzare i http://go.microsoft.com/fwlink/?LinkId=34733 servizi di crittografia forniti da Windows .NET Framework.

distributionDB
DistributionDatabase

Oggetto DistributionDatabase che rappresenta il database di distribuzione utilizzato dal server di distribuzione.

Commenti

È necessario specificare una password complessa per password quando il server di distribuzione dispone di server di pubblicazione remoti. Se password è impostato su null , viene generata una password casuale ed è necessario chiamare ChangeDistributorPassword per reimpostare la password quando il primo server di pubblicazione remoto viene registrato nel server di distribuzione.

Questo overload del metodo deve essere chiamato nel server di distribuzione prima InstallDistributor(String, String) di chiamare da un server remoto.

Il InstallDistributor(SecureString, DistributionDatabase) metodo fornisce sicurezza aggiuntiva per la password mentre è archiviato in memoria e deve essere utilizzato al posto di InstallDistributor(String, DistributionDatabase) .

Il InstallDistributor metodo può essere chiamato solo da un membro del ruolo predefinito del server sysadmin.

Il InstallDistributor metodo è equivalente al stored procedure di Sp_adddistributor (Transact-SQL) .

Si applica a

InstallDistributor(String, DistributionDatabase)

Installa un server di distribuzione nell'istanza attualmente connessa di 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)

Parametri

password
String

Password dell'account di accesso distributor_admin utilizzata per accedere al server di distribuzione.

Nota sulla sicurezza:   se possibile, richiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione. Se è necessario archiviare le credenziali, utilizzare i http://go.microsoft.com/fwlink/?LinkId=34733 servizi di crittografia forniti da Windows .NET Framework.

distributionDB
DistributionDatabase

Oggetto DistributionDatabase che rappresenta il database di distribuzione utilizzato dal server di distribuzione.

Eccezioni

Quando la distribuzione è già installata nel server.

Quando distributionDB è null o quando password supera 128 byte o contiene caratteri null.

Esempio

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

Commenti

È necessario specificare una password complessa per password quando il server di distribuzione dispone di server di pubblicazione remoti. Se password è impostato su null , viene generata una password casuale ed è necessario chiamare ChangeDistributorPassword per reimpostare la password quando il primo server di pubblicazione remoto viene registrato nel server di distribuzione.

Questo overload del metodo deve essere chiamato nel server di distribuzione prima InstallDistributor di chiamare da un server remoto.

Il InstallDistributor metodo può essere chiamato solo da un membro del ruolo predefinito del server sysadmin.

Il InstallDistributor metodo è equivalente al stored procedure di Sp_adddistributor (Transact-SQL) .

Vedi anche

Si applica a