ReplicationServer.InstallDistributor Méthode

Définition

Espace de noms:: Microsoft.SqlServer.Replication

Assembly:: Microsoft.SqlServer.Rmo.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Installe un distributeur.

Surcharges

Nom	Description
InstallDistributor(String, String)	Enregistre un distributeur distant.
InstallDistributor(String, SecureString)	Enregistre un distributeur distant, où le mot de passe est spécifié à l’aide d’un SecureString objet.
InstallDistributor(SecureString, DistributionDatabase)	Installe un distributeur sur l’instance actuellement connectée de Microsoft SQL Server, où le mot de passe est spécifié à l’aide d’un SecureString objet.
InstallDistributor(String, DistributionDatabase)	Installe un distributeur sur l’instance actuellement connectée de Microsoft SQL Server.

Exemples

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

Enregistre un distributeur distant.

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)

Paramètres

distributionServerName: String

Une String valeur qui spécifie le nom du serveur distant à utiliser comme distributeur pour le serveur Publisher actuel. Le nom du serveur de distribution ne peut pas être le même que celui du serveur actuel.

password: String

Une valeur qui spécifie String le mot de passe. C’est la même valeur utilisée lors d’une appel InstallDistributor(String, DistributionDatabase) chez le distributeur.

Remarques

Cette méthode doit être appelée depuis un Publisher pour enregistrer le distributeur distant. Si le Publisher et le Distributeur sont sur le même serveur, vous ne devriez pas appeler cette méthode.

Avant d’appeler InstallDistributor(String, String), vous avez dû appeler InstallDistributor(String, DistributionDatabase) le distributeur.

La InstallDistributor méthode ne peut être appelée que par un membre du rôle serveur fixe sysadmin.

La InstallDistributor méthode équivaut à exécuter la procédure stockée sp_adddistributor (Transact-SQL) au Publisher pour enregistrer un distributeur distant.

S’applique à

InstallDistributor(String, SecureString)

Enregistre un distributeur distant, où le mot de passe est spécifié à l’aide d’un SecureString objet.

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)

Paramètres

distributionServerName: String

password: SecureString

Une valeur qui spécifie SecureString le mot de passe. C’est la même valeur utilisée lors d’une appel InstallDistributor(String, DistributionDatabase) chez le distributeur.

Remarques

Avant d’appeler InstallDistributor(String, SecureString), vous avez dû appeler InstallDistributor(SecureString, DistributionDatabase) le distributeur.

La InstallDistributor(String, SecureString) méthode offre une sécurité supplémentaire pour le mot de passe lorsqu’il est stocké en mémoire et doit être utilisée à la place de InstallDistributor(String, String).

La InstallDistributor méthode ne peut être appelée que par un membre du rôle serveur fixe sysadmin.

La InstallDistributor méthode équivaut à exécuter la procédure stockée sp_adddistributor (Transact-SQL) au Publisher pour enregistrer un distributeur distant.

S’applique à

InstallDistributor(SecureString, DistributionDatabase)

Installe un distributeur sur l’instance actuellement connectée de Microsoft SQL Server, où le mot de passe est spécifié à l’aide d’un SecureString objet.

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)

Paramètres

password: SecureString

Est une SecureString valeur représentant le mot de passe du distributor_admin de connexion utilisé pour accéder au distributeur.

Note de sécurité Lorsque possible, demandez aux utilisateurs de saisir les identifiants de sécurité à l’exécution. Si vous devez stocker des identifiants, utilisez les http://go.microsoft.com/fwlink/?LinkId=34733 services cryptographiques fournis par le Windows .NET Framework.

distributionDB: DistributionDatabase

Un DistributionDatabase objet représentant la base de données de distribution utilisée par le distributeur.

Remarques

Vous devez spécifier un mot de passe fort lorsque password le distributeur dispose d’éditeurs distants. Si password est défini sur null, un mot de passe aléatoire est généré, et vous devez appeler ChangeDistributorPassword pour réinitialiser le mot de passe lorsque le premier Publisher distant est enregistré auprès du distributeur.

Cette surcharge de méthode doit être appelée au distributeur avant d’appeler InstallDistributor(String, String) depuis un serveur distant.

La InstallDistributor(SecureString, DistributionDatabase) méthode offre une sécurité supplémentaire pour le mot de passe lorsqu’il est stocké en mémoire et doit être utilisée à la place de InstallDistributor(String, DistributionDatabase).

La InstallDistributor méthode ne peut être appelée que par un membre du rôle serveur fixe sysadmin.

La InstallDistributor méthode est équivalente à la procédure stockée sp_adddistributor (Transact-SQL).

S’applique à

InstallDistributor(String, DistributionDatabase)

Installe un distributeur sur l’instance actuellement connectée 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)

Paramètres

password: String

Est-ce que le mot de passe de la connexion distributor_admin utilisé pour accéder au distributeur ?

distributionDB: DistributionDatabase

Un DistributionDatabase objet représentant la base de données de distribution utilisée par le distributeur.

Exceptions

ApplicationException

Lorsque la distribution est déjà installée sur le serveur.

ArgumentException

Lorsque distributionDB est nul, ou lorsque password dépasse 128 octets ou contient des caractères nuls.

Exemples

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

Remarques

Cette surcharge de méthode doit être appelée au distributeur avant d’appeler InstallDistributor depuis un serveur distant.

La InstallDistributor méthode ne peut être appelée que par un membre du rôle serveur fixe sysadmin.

La InstallDistributor méthode est équivalente à la procédure stockée sp_adddistributor (Transact-SQL).

Voir aussi

Comment : Configurer la publication et la distribution (RMO Programming)

S’applique à