ReplicationServer.ChangeDistributorPassword Método

Definición

Espacio de nombres:

Microsoft.SqlServer.Replication

Ensamblado:

Microsoft.SqlServer.Rmo.dll

Cambia la contraseña del distribuidor.

Sobrecargas

ChangeDistributorPassword(SecureString)	Cambia la contraseña del distribuidor, donde la nueva contraseña se proporciona como un objeto SecureString.
ChangeDistributorPassword(String)	Cambia la contraseña del distribuidor.

ChangeDistributorPassword(SecureString)

Cambia la contraseña del distribuidor, donde la nueva contraseña se proporciona como un 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

La nueva contraseña del distribuidor es un valor SecureString.

Nota de seguridad Cuando sea posible, pida a los usuarios que escriban las credenciales de seguridad en tiempo de ejecución. Si debe almacenar credenciales, use los http://go.microsoft.com/fwlink/?LinkId=34733 servicios criptográficos proporcionados por Windows .NET Framework.

Comentarios

La DistributorInstalled propiedad debe ser true para establecer esta propiedad.

El ChangeDistributorPassword(SecureString) método proporciona seguridad adicional para la contraseña mientras se almacena en memoria y se debe usar en lugar de ChangeDistributorPassword(String).

Los ChangeDistributorPassword miembros del rol fijo de servidor sysadmin pueden llamar al método en el distribuidor.

El ChangeDistributorPassword método es equivalente al procedimiento almacenado de sp_changedistributor_password (Transact-SQL).

ChangeDistributorPassword(String)

Cambia la contraseña del 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

La nueva cadena de contraseña para inicio de sesión de distributor_admin.

Nota de seguridad Cuando sea posible, pida a los usuarios que escriban las credenciales de seguridad en tiempo de ejecución. Si debe almacenar credenciales, use los http://go.microsoft.com/fwlink/?LinkId=34733 servicios criptográficos proporcionados por Windows .NET Framework.

Ejemplos

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

Comentarios

La DistributorInstalled propiedad debe ser true para establecer esta propiedad.

Los ChangeDistributorPassword miembros del rol fijo de servidor sysadmin pueden llamar al método en el distribuidor.

El ChangeDistributorPassword método es equivalente al procedimiento almacenado de sp_changedistributor_password (Transact-SQL).

Consulte también

• Cómo ver y modificar las propiedades del publicador y el distribuidor (programación RMO)