Artykuł
07/22/2011

Metoda ReplicationServer.ChangeDistributorPassword (String)

Zmienia hasło dystrybutora.

Przestrzeń nazw: Microsoft.SqlServer.Replication
Zestaw: Microsoft.SqlServer.Rmo (w Microsoft.SqlServer.Rmo.dll)

Składnia

'Deklaracja
Public Sub ChangeDistributorPassword ( _
    password As String _
)
'Użycie
Dim instance As ReplicationServer
Dim password As String

instance.ChangeDistributorPassword(password)

public void ChangeDistributorPassword(
    string password
)

public:
void ChangeDistributorPassword(
    String^ password
)

member ChangeDistributorPassword : 
        password:string -> unit

public function ChangeDistributorPassword(
    password : String
)

Parametry

password
Typ: System.String
Nowy ciąg hasła logowania distributor_admin.
Uwaga dotycząca zabezpieczeń, gdy to możliwe, monitowanie użytkowników o wprowadzenie poświadczenia zabezpieczeń na uruchamianie czas.Jeśli poświadczenia muszą być przechowywane, za pomocą https://go.microsoft.com/fwlink/?LinkId = 34733 kryptograficznych usług świadczonych przez system Windows.NET Framework.

Uwagi

DistributorInstalled Właściwość musi być true do zestaw tej właściwości.

ChangeDistributorPassword Metoda może być wywoływana przez członków sysadmin stała rola serwera u dystrybutora.

ChangeDistributorPassword Jest równoważna metoda sp_changedistributor_password (języka Transact-SQL)procedura składowana.

Ten obszar nazw, klasy lub element członkowski jest obsługiwany tylko w wersja 2.0.NET Framework.

Przykłady

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