ReplicationServer.InstallDistributor Méthode

Référence

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 serveur de distribution.

Surcharges

InstallDistributor(String, String)	Inscrit un serveur de distribution distant.
InstallDistributor(String, SecureString)	Inscrit un serveur de distribution distant, où le mot de passe est spécifié à l'aide d'un objet SecureString.
InstallDistributor(SecureString, DistributionDatabase)	Installe un serveur de distribution 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 serveur de distribution 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)

Inscrit un serveur de distribution 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

Valeur String qui spécifie le nom du serveur distant à utiliser en tant que serveur de distribution pour le serveur de publication actuel. Le nom du serveur de distribution ne peut pas être le même que le nom du serveur actuel.

password: String

Valeur String qui spécifie le mot de passe. Il s'agit de la même valeur utilisée lors de l'appel de la méthode InstallDistributor(String, DistributionDatabase) sur le serveur de distribution.

Remarques

Cette méthode doit être appelée à partir d’un serveur de publication pour inscrire le serveur de distribution distant. Si le serveur de publication et le serveur de distribution se trouvent sur le même serveur, vous ne devez pas appeler cette méthode.

Avant d’appeler InstallDistributor(String, String), vous devez avoir appelé InstallDistributor(String, DistributionDatabase) sur le serveur de distribution.

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) sur le serveur de publication pour inscrire un serveur de distribution distant.

S’applique à

InstallDistributor(String, SecureString)

Inscrit un serveur de distribution distant, où le mot de passe est spécifié à l'aide d'un objet 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)

Paramètres

distributionServerName: String

password: SecureString

Valeur SecureString qui spécifie le mot de passe. Il s'agit de la même valeur utilisée lors de l'appel de la méthode InstallDistributor(String, DistributionDatabase) sur le serveur de distribution.

Remarques

Avant d’appeler InstallDistributor(String, SecureString), vous devez avoir appelé InstallDistributor(SecureString, DistributionDatabase) sur le serveur de distribution.

La InstallDistributor(String, SecureString) méthode fournit une sécurité supplémentaire pour le mot de passe lorsqu’il est stocké en mémoire et doit être utilisé à 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) sur le serveur de publication pour inscrire un serveur de distribution distant.

S’applique à

InstallDistributor(SecureString, DistributionDatabase)

Installe un serveur de distribution 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

Valeur SecureString représentant le mot de passe de la connexion distributor_admin utilisée pour accéder au serveur de distribution.

Note de sécurité Lorsque cela est possible, invitez les utilisateurs à entrer des informations d’identification de sécurité au moment de l’exécution. Si vous devez stocker des informations d’identification, utilisez les http://go.microsoft.com/fwlink/?LinkId=34733 services de chiffrement fournis par Windows .NET Framework.

distributionDB: DistributionDatabase

Objet DistributionDatabase représentant la base de données de distribution utilisée par le serveur de distribution.

Remarques

Vous devez spécifier un mot de passe fort lorsque password le serveur de distribution a des serveurs de publication 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 serveur de publication distant est inscrit sur le serveur de distribution.

Cette surcharge de méthode doit être appelée au niveau du serveur de distribution avant d’appeler InstallDistributor(String, String) à partir d’un serveur distant.

La InstallDistributor(SecureString, DistributionDatabase) méthode fournit une sécurité supplémentaire pour le mot de passe lorsqu’il est stocké en mémoire et doit être utilisé à 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 serveur de distribution 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

Mot de passe de la connexion distributor_admin utilisée pour accéder au serveur de distribution.

distributionDB: DistributionDatabase

Objet DistributionDatabase représentant la base de données de distribution utilisée par le serveur de distribution.

Exceptions

ApplicationException

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

ArgumentException

Quand distributionDB a la valeur null ou dépasse password 128 octets ou contient des caractères Null.

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 niveau du serveur de distribution avant d’appeler InstallDistributor à partir d’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

Procédure : configurer la publication et la distribution (programmation RMO)

S’applique à

ReplicationServer.InstallDistributor Méthode

Définition

Surcharges

Exemples

InstallDistributor(String, String)

Paramètres

Remarques

S’applique à

InstallDistributor(String, SecureString)

Paramètres

Remarques

S’applique à

InstallDistributor(SecureString, DistributionDatabase)

Paramètres

Remarques

S’applique à

InstallDistributor(String, DistributionDatabase)

Paramètres

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Ressources supplémentaires