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