ReplicationServer.ChangeDistributorPassword 方法

  • 参考

定义

命名空间:
Microsoft.SqlServer.Replication
程序集:
Microsoft.SqlServer.Rmo.dll

更改分发服务器密码。

重载

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

另请参阅

适用于