ReplicationServer.InstallDistributor Metodo

Riferimento

Definizione

Spazio dei nomi:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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 usando 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 è consigliabile chiamare questo metodo.

Prima di chiamare , è necessario chiamare InstallDistributor(String, String)InstallDistributor(String, DistributionDatabase) al 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 della stored procedure di sp_adddistributor (Transact-SQL) nel server di pubblicazione per registrare 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

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

Prima di chiamare , è necessario chiamare InstallDistributor(String, SecureString)InstallDistributor(SecureString, DistributionDatabase) al server di distribuzione.

Il InstallDistributor(String, SecureString) metodo fornisce una sicurezza aggiuntiva per la password mentre viene archiviata in memoria e deve essere usata anziché 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 della stored procedure di sp_adddistributor (Transact-SQL) nel server di pubblicazione per registrare 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 usando 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 di sicurezza Quando possibile, chiedere agli utenti di immettere le credenziali di sicurezza in fase di esecuzione. Se è necessario archiviare le credenziali, usare 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 e è 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 di chiamare InstallDistributor(String, String) da un server remoto.

Il InstallDistributor(SecureString, DistributionDatabase) metodo fornisce una sicurezza aggiuntiva per la password mentre viene archiviata in memoria e deve essere usata anziché InstallDistributor(String, DistributionDatabase).

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

Il InstallDistributor metodo equivale alla stored procedure 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.

distributionDB: DistributionDatabase

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

Eccezioni

ApplicationException

Quando la distribuzione è già installata nel server.

ArgumentException

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

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

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

Il InstallDistributor metodo equivale alla stored procedure sp_adddistributor (Transact-SQL).

Vedi anche

Procedura: Configurazione della pubblicazione e della distribuzione (programmazione RMO)

Si applica a

ReplicationServer.InstallDistributor Metodo

Definizione

Overload

Esempio

InstallDistributor(String, String)

Parametri

Commenti

Si applica a

InstallDistributor(String, SecureString)

Parametri

Commenti

Si applica a

InstallDistributor(SecureString, DistributionDatabase)

Parametri

Commenti

Si applica a

InstallDistributor(String, DistributionDatabase)

Parametri

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Risorse aggiuntive