次の方法で共有

  • [アーティクル]

ChangeDistributorPassword メソッド (String)

ディストリビュータのパスワードを変更します。

名前空間:  Microsoft.SqlServer.Replication
アセンブリ:  Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)

構文

'宣言
Public Sub ChangeDistributorPassword ( _
    password As String _
)
'使用
Dim instance As ReplicationServer
Dim password As String

instance.ChangeDistributorPassword(password)

public void ChangeDistributorPassword(
    string password
)

public:
void ChangeDistributorPassword(
    String^ password
)

member ChangeDistributorPassword : 
        password:string -> unit 

public function ChangeDistributorPassword(
    password : String
)

パラメーター

  • password
    型: System. . :: . .String
    distributor_admin ログインの新しいパスワード文字列です。
    可能であれば、実行時にセキュリティ資格情報の入力を求めるメッセージをユーザーに対して表示します。資格情報を格納する必要がある場合は、Windows .NET Framework で提供される cryptographic services を使用します。

説明

このプロパティを設定するには、DistributorInstalled プロパティに true を設定する必要があります。

ChangeDistributorPassword メソッドを呼び出すことができるのは、ディストリビュータ側の固定サーバー ロール sysadmin のメンバです。

ChangeDistributorPassword メソッドは、sp_changedistributor_password (Transact-SQL) ストアド プロシージャに相当します。

この名前空間、クラス、またはメンバは、.NET Framework 2.0 でのみサポートされています。

使用例

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