ReplicationServer.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 .NETFramework に用意されている https://go.microsoft.com/fwlink/?LinkId=34733 暗号化サービスを使用します。
説明
このプロパティを設定するには、DistributorInstalled プロパティに true を設定する必要があります。
ChangeDistributorPassword メソッドを呼び出すことができるのは、ディストリビューター側の固定サーバー ロール sysadmin のメンバーです。
ChangeDistributorPassword メソッドは、sp_changedistributor_password (Transact-SQL) ストアド プロシージャに相当します。
使用例
// 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();
}
関連項目
参照
ChangeDistributorPassword オーバーロード
Microsoft.SqlServer.Replication 名前空間