ReplicationServer.ChangeDistributorPassword Método

Definição

Namespace:

Microsoft.SqlServer.Replication

Assembly:

Microsoft.SqlServer.Rmo.dll

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

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

Confira também

• Como exibir e modificar as propriedades do Publicador e do Distribuidor (programação RMO)