ReplicationServer.ChangeDistributorPassword Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Altera a senha de um Distribuidor.
Sobrecargas
ChangeDistributorPassword(SecureString) |
Altera a senha do Distribuidor, onde a nova senha é fornecida como um objeto SecureString. |
ChangeDistributorPassword(String) |
Altera a senha de um Distribuidor. |
ChangeDistributorPassword(SecureString)
Altera a senha do Distribuidor, onde a nova senha é fornecida como um objeto 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)
Parâmetros
- password
- SecureString
A nova senha do Distribuidor é um valor SecureString.
Observação de Segurança Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais, use os http://go.microsoft.com/fwlink/?LinkId=34733 serviços criptográficos fornecidos pelo Windows .NET Framework.
Comentários
A DistributorInstalled propriedade deve ser true
para definir essa propriedade.
O ChangeDistributorPassword(SecureString) método fornece segurança adicional para a senha enquanto ela é armazenada na memória e deve ser usada em vez de ChangeDistributorPassword(String).
O ChangeDistributorPassword método pode ser chamado por membros da função de servidor fixa sysadmin no Distribuidor.
O ChangeDistributorPassword método é equivalente ao procedimento armazenado sp_changedistributor_password (Transact-SQL ).
Aplica-se a
ChangeDistributorPassword(String)
Altera a senha de um Distribuidor.
public:
void ChangeDistributorPassword(System::String ^ password);
public void ChangeDistributorPassword (string password);
member this.ChangeDistributorPassword : string -> unit
Public Sub ChangeDistributorPassword (password As String)
Parâmetros
- password
- String
A cadeia de caracteres da nova senha de logon de distributor_admin.
Observação de Segurança Quando possível, solicite que os usuários insiram credenciais de segurança em tempo de execução. Se você precisar armazenar credenciais, use os http://go.microsoft.com/fwlink/?LinkId=34733 serviços criptográficos fornecidos pelo Windows .NET Framework.
Exemplos
// 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();
}
Comentários
A DistributorInstalled propriedade deve ser true
para definir essa propriedade.
O ChangeDistributorPassword método pode ser chamado por membros da função de servidor fixa sysadmin no Distribuidor.
O ChangeDistributorPassword método é equivalente ao procedimento armazenado sp_changedistributor_password (Transact-SQL ).