ReplicationServer.ChangeDistributorPassword Метод

Определение

Изменяет пароль распространителя.

Перегрузки

ChangeDistributorPassword(SecureString)

Изменяет пароль распространителя, если новый пароль задан как объект SecureString.

ChangeDistributorPassword(String)

Изменяет пароль распространителя.

ChangeDistributorPassword(SecureString)

Изменяет пароль распространителя, если новый пароль задан как объект 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)

Параметры

password
SecureString

Новый пароль распространителя является SecureString значением.

Примечание по безопасности. Если это возможно, предложите пользователям ввести учетные данные безопасности во время выполнения. Если необходимо хранить учетные данные, используйте http://go.microsoft.com/fwlink/?LinkId=34733 криптографические службы, предоставляемые платформа .NET Framework Windows.

Комментарии

Свойство DistributorInstalled должно иметь значение true , чтобы задать это свойство.

Метод ChangeDistributorPassword(SecureString) обеспечивает дополнительную безопасность для пароля, который хранится в памяти и должен использоваться вместо ChangeDistributorPassword(String).

Метод ChangeDistributorPassword может вызываться членами предопределенной роли сервера sysadmin на распространитетеле.

Метод ChangeDistributorPassword эквивалентен хранимой процедуре sp_changedistributor_password (Transact-SQL ).

Применяется к

ChangeDistributorPassword(String)

Изменяет пароль распространителя.

public:
 void ChangeDistributorPassword(System::String ^ password);
public void ChangeDistributorPassword (string password);
member this.ChangeDistributorPassword : string -> unit
Public Sub ChangeDistributorPassword (password As String)

Параметры

password
String

Новая строка пароля для имени входа distributor_admin.

Примечание по безопасности. Если это возможно, предложите пользователям ввести учетные данные безопасности во время выполнения. Если необходимо хранить учетные данные, используйте http://go.microsoft.com/fwlink/?LinkId=34733 криптографические службы, предоставляемые платформа .NET Framework Windows.

Примеры

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

Комментарии

Свойство DistributorInstalled должно иметь значение true , чтобы задать это свойство.

Метод ChangeDistributorPassword может вызываться членами предопределенной роли сервера sysadmin на распространитетеле.

Метод ChangeDistributorPassword эквивалентен хранимой процедуре sp_changedistributor_password (Transact-SQL ).

См. также раздел

Применяется к