ReplicationServer.ChangeDistributorPassword 方法

参考

定义

命名空间:: Microsoft.SqlServer.Replication

程序集:: Microsoft.SqlServer.Rmo.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

更改分发服务器密码。

重载

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 Windows .NET Framework提供的加密服务。

注解

属性 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 Windows .NET Framework提供的加密服务。

示例

// 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) 存储过程。

另请参阅

如何查看和修改发布服务器和分发服务器属性（RMO 编程）

适用于