ReplicationServer.ChangeDistributorPassword Méthode

public:
 void ChangeDistributorPassword(System::Security::SecureString ^ password);

public void ChangeDistributorPassword (System.Security.SecureString password);

member this.ChangeDistributorPassword : System.Security.SecureString -> unit

Public Sub ChangeDistributorPassword (password As SecureString)

Paramètres

Remarques

La DistributorInstalled propriété doit être true pour définir cette propriété.

La ChangeDistributorPassword(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 ChangeDistributorPassword(String).

La ChangeDistributorPassword méthode peut être appelée par les membres du rôle serveur fixe sysadmin sur le serveur de distribution.

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

public:
 void ChangeDistributorPassword(System::String ^ password);

public void ChangeDistributorPassword (string password);

member this.ChangeDistributorPassword : string -> unit

Public Sub ChangeDistributorPassword (password As String)

Paramètres

Exemples

// Set the Distributor and distribution database names.
string distributionDbName = "distribution";
string distributorName = publisherInstance;

ReplicationServer distributor;
DistributionDatabase distributionDb;

// Create a connection to the Distributor using Windows Authentication.
ServerConnection conn = new ServerConnection(distributorName);

try
{
    // Open the connection. 
    conn.Connect();

    distributor = new ReplicationServer(conn);

    // Load Distributor properties, if it is installed.
    if (distributor.LoadProperties())
    {
        // Password supplied at runtime.
        distributor.ChangeDistributorPassword(password);
        distributor.AgentCheckupInterval = 5;

        // Save changes to the Distributor properties.
        distributor.CommitPropertyChanges();
    }
    else
    {
        throw new ApplicationException(
            String.Format("{0} is not a Distributor.", publisherInstance));
    }

    // Create an object for the distribution database 
    // using the open Distributor connection.
    distributionDb = new DistributionDatabase(distributionDbName, conn);

    // Change distribution database properties.
    if (distributionDb.LoadProperties())
    {
        // Change maximum retention period to 48 hours and history retention 
        // period to 24 hours.
        distributionDb.MaxDistributionRetention = 48;
        distributionDb.HistoryRetention = 24;

        // Save changes to the distribution database properties.
        distributionDb.CommitPropertyChanges();
    }
    else
    {
        // Do something here if the distribution database does not exist.
    }
}
catch (Exception ex)
{
    // Implement the appropriate error handling here. 
    throw new ApplicationException("An error occured when changing Distributor " +
        " or distribution database properties.", ex);
}
finally
{
    conn.Disconnect();
}

Remarques

La DistributorInstalled propriété doit être true pour définir cette propriété.

La ChangeDistributorPassword méthode peut être appelée par les membres du rôle serveur fixe sysadmin sur le serveur de distribution.

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

Voir aussi

• Procédure : afficher et modifier les propriétés des serveurs de publication et de distribution (programmation RMO)