ReplicationServer.ChangeDistributorPassword Méthode

Définition

Espace de noms:

Microsoft.SqlServer.Replication

Assembly:

Microsoft.SqlServer.Rmo.dll

Modifie le mot de passe du serveur de distribution.

Surcharges

ChangeDistributorPassword(SecureString)	Modifie le mot de passe du serveur de distribution, le nouveau mot de passe étant fourni sous la forme d'un objet SecureString.
ChangeDistributorPassword(String)	Modifie le mot de passe du serveur de distribution.

ChangeDistributorPassword(SecureString)

Modifie le mot de passe du serveur de distribution, le nouveau mot de passe étant fourni sous la forme d'un objet SecureString.

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

password

SecureString

Le nouveau mot de passe du serveur de distribution est une valeur SecureString.

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.

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

ChangeDistributorPassword(String)

Modifie le mot de passe du serveur de distribution.

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

public void ChangeDistributorPassword (string password);

member this.ChangeDistributorPassword : string -> unit

Public Sub ChangeDistributorPassword (password As String)

Paramètres

password

String

Nouvelle chaîne de mot de passe pour la connexion distributor_admin.

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.

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)