ReplicationServer.ChangeDistributorPassword ReplicationServer.ChangeDistributorPassword ReplicationServer.ChangeDistributorPassword Method

정의

배포자 암호를 변경합니다. Changes the Distributor password.

오버로드

ChangeDistributorPassword(SecureString) ChangeDistributorPassword(SecureString) ChangeDistributorPassword(SecureString)

새 암호가 SecureString 개체로 제공되는 경우 배포자 암호를 변경합니다. Changes the Distributor password, where the new password is supplied as a SecureString object.

ChangeDistributorPassword(String) ChangeDistributorPassword(String) ChangeDistributorPassword(String)

배포자 암호를 변경합니다. Changes the Distributor password.

ChangeDistributorPassword(SecureString) ChangeDistributorPassword(SecureString) ChangeDistributorPassword(SecureString)

새 암호가 SecureString 개체로 제공되는 경우 배포자 암호를 변경합니다. Changes the Distributor password, where the new password is supplied as a SecureString object.

public:
 void ChangeDistributorPassword(System::Security::SecureString ^ password);
public void ChangeDistributorPassword (System.Security.SecureString password);
Public Sub ChangeDistributorPassword (password As SecureString)
매개 변수
password
SecureString SecureString SecureString

새 배포자 암호는 SecureString 값입니다. The new Distributor password is a SecureString value. 보안 참고 하면 가능한 경우 프롬프트 사용자에 게 런타임에 보안 자격 증명을 입력 하 합니다. Security Note When possible, prompt users to enter security credentials at run time. 사용 하 여 자격 증명을 저장 해야 하는 경우는 http://go.microsoft.com/fwlink/?LinkId=34733 Windows.NET Framework에서 제공 하는 암호화 서비스입니다. If you must store credentials, use the http://go.microsoft.com/fwlink/?LinkId=34733 cryptographic services provided by the Windows .NET Framework.

설명

DistributorInstalled 속성 이어야 true 이 속성을 설정 합니다.The DistributorInstalled property must be true to set this property.

ChangeDistributorPassword(SecureString) 메서드 대신 사용 해야 하 고 메모리에 저장 되는 동안 암호에 대 한 추가 보안을 제공 ChangeDistributorPassword(String)합니다.The ChangeDistributorPassword(SecureString) method provides additional security for the password while it is stored in memory and should be used instead of ChangeDistributorPassword(String).

ChangeDistributorPassword 배포자에서 sysadmin 고정된 서버 역할의 멤버에 의해 메서드를 호출할 수 있습니다.The ChangeDistributorPassword method can be called by members of the sysadmin fixed server role at the Distributor.

ChangeDistributorPassword 메서드는 sp_changedistributor_password (Transact SQL) 저장 프로시저입니다.The ChangeDistributorPassword method is equivalent to the sp_changedistributor_password (Transact-SQL) stored procedure.

ChangeDistributorPassword(String) ChangeDistributorPassword(String) ChangeDistributorPassword(String)

배포자 암호를 변경합니다. Changes the Distributor password.

public:
 void ChangeDistributorPassword(System::String ^ password);
public void ChangeDistributorPassword (string password);
Public Sub ChangeDistributorPassword (password As String)
매개 변수
password
String String String

distributor_admin 로그인을 위한 새 암호 문자열입니다. The new password string for the distributor_admin login. 보안 참고 하면 가능한 경우 프롬프트 사용자에 게 런타임에 보안 자격 증명을 입력 하 합니다. Security Note When possible, prompt users to enter security credentials at run time. 사용 하 여 자격 증명을 저장 해야 하는 경우는 http://go.microsoft.com/fwlink/?LinkId=34733 Windows.NET Framework에서 제공 하는 암호화 서비스입니다. If you must store credentials, use the http://go.microsoft.com/fwlink/?LinkId=34733 cryptographic services provided by the 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 이 속성을 설정 합니다.The DistributorInstalled property must be true to set this property.

ChangeDistributorPassword 배포자에서 sysadmin 고정된 서버 역할의 멤버에 의해 메서드를 호출할 수 있습니다.The ChangeDistributorPassword method can be called by members of the sysadmin fixed server role at the Distributor.

ChangeDistributorPassword 메서드는 sp_changedistributor_password (Transact SQL) 저장 프로시저입니다.The ChangeDistributorPassword method is equivalent to the sp_changedistributor_password (Transact-SQL) stored procedure.

추가 정보

적용 대상