ReplicationServer.InstallDistributor ReplicationServer.InstallDistributor ReplicationServer.InstallDistributor Method

정의

배포자를 설치합니다. Installs a Distributor.

오버로드

InstallDistributor(String, String) InstallDistributor(String, String) InstallDistributor(String, String)

원격 배포자를 등록합니다. Registers a remote Distributor.

InstallDistributor(String, SecureString) InstallDistributor(String, SecureString) InstallDistributor(String, SecureString)

SecureString 개체를 사용하여 암호가 지정된 경우 원격 배포자를 등록합니다. Registers a remote Distributor, where the password is specified using a SecureString object.

InstallDistributor(SecureString, DistributionDatabase) InstallDistributor(SecureString, DistributionDatabase) InstallDistributor(SecureString, DistributionDatabase)

현재 연결 된 Microsoft SQL Server 인스턴스에서 배포자를 설치를 사용 하 여 암호가 지정 된 위치는 SecureString 개체입니다. Installs a Distributor on the currently connected instance of Microsoft SQL Server, where the password is specified using a SecureString object.

InstallDistributor(String, DistributionDatabase) InstallDistributor(String, DistributionDatabase) InstallDistributor(String, DistributionDatabase)

현재 연결 된 Microsoft SQL Server 인스턴스에서 배포자를 설치 합니다. Installs a Distributor on the currently connected instance of Microsoft SQL Server.

예제

// Set the server and database names
string distributionDbName = "distribution";
string publisherName = publisherInstance;
string publicationDbName = "AdventureWorks2012";

DistributionDatabase distributionDb;
ReplicationServer distributor;
DistributionPublisher publisher;
ReplicationDatabase publicationDb;

// Create a connection to the server using Windows Authentication.
ServerConnection conn = new ServerConnection(publisherName);

try
{
	// Connect to the server acting as the Distributor 
	// and local Publisher.
	conn.Connect();

	// Define the distribution database at the Distributor,
	// but do not create it now.
	distributionDb = new DistributionDatabase(distributionDbName, conn);
	distributionDb.MaxDistributionRetention = 96;
	distributionDb.HistoryRetention = 120;

	// Set the Distributor properties and install the Distributor.
	// This also creates the specified distribution database.
	distributor = new ReplicationServer(conn);
	distributor.InstallDistributor((string)null, distributionDb);

	// Set the Publisher properties and install the Publisher.
	publisher = new DistributionPublisher(publisherName, conn);
	publisher.DistributionDatabase = distributionDb.Name;
	publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
	publisher.PublisherSecurity.WindowsAuthentication = true;
	publisher.Create();

	// Enable AdventureWorks2012 as a publication database.
	publicationDb = new ReplicationDatabase(publicationDbName, conn);

	publicationDb.EnabledTransPublishing = true;
	publicationDb.EnabledMergePublishing = true;
}
catch (Exception ex)
{
	// Implement appropriate error handling here.
	throw new ApplicationException("An error occured when installing distribution and publishing.", ex);
}
finally
{
	conn.Disconnect();
}

InstallDistributor(String, String) InstallDistributor(String, String) InstallDistributor(String, String)

원격 배포자를 등록합니다. Registers a remote Distributor.

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

현재 게시자 서버에 대한 배포자로 사용되는 원격 서버의 이름을 지정하는 String 값입니다. A String value that specifies the name of the remote server to be used as the Distributor for the current Publisher server. 배포 서버 이름은 현재 서버와 같을 수 없습니다. The distribution server name cannot be the same as the current server.

password
String String String

A String 암호를 지정 하는 값입니다. A String value that specifies the password. 배포자에서 InstallDistributor(String, DistributionDatabase)를 호출할 때 사용하는 값과 같습니다. This is the same value used when calling InstallDistributor(String, DistributionDatabase) at the Distributor.

설명

이 메서드는 원격 배포자를 등록 하려면 게시자에서 호출 되어야 합니다.This method must be called from a Publisher to register the remote Distributor. 게시자 및 배포자에는 동일한 서버에 있는 경우에이 메서드를 호출 해야 합니다.If the Publisher and Distributor are on the same server, you should not call this method.

호출 하기 전에 InstallDistributor(String, String)를 호출 해야 InstallDistributor(String, DistributionDatabase) 배포자에서 합니다.Before calling InstallDistributor(String, String), you must have called InstallDistributor(String, DistributionDatabase) at the Distributor.

InstallDistributor 메서드 sysadmin 고정된 서버 역할의 멤버에 따라 호출할 수 있습니다.The InstallDistributor method can only be called by a member of the sysadmin fixed server role.

InstallDistributor 를 실행 하는 것과 같습니다는 sp_adddistributor (Transact SQL) 원격 배포자를 등록 하려면 게시자에서 프로시저를 저장 합니다.The InstallDistributor method is equivalent to executing the sp_adddistributor (Transact-SQL) stored procedure at the Publisher to register a remote Distributor.

InstallDistributor(String, SecureString) InstallDistributor(String, SecureString) InstallDistributor(String, SecureString)

SecureString 개체를 사용하여 암호가 지정된 경우 원격 배포자를 등록합니다. Registers a remote Distributor, where the password is specified using a SecureString object.

public:
 void InstallDistributor(System::String ^ distributionServerName, System::Security::SecureString ^ password);
public void InstallDistributor (string distributionServerName, System.Security.SecureString password);
Public Sub InstallDistributor (distributionServerName As String, password As SecureString)
매개 변수
distributionServerName
String String String

현재 게시자 서버에 대한 배포자로 사용되는 원격 서버의 이름을 지정하는 String 값입니다. A String value that specifies the name of the remote server to be used as the Distributor for the current Publisher server. 배포 서버 이름은 현재 서버와 같을 수 없습니다. The distribution server name cannot be the same as the current server.

password
SecureString SecureString SecureString

A SecureString 암호를 지정 하는 값입니다. A SecureString value that specifies the password. 배포자에서 InstallDistributor(String, DistributionDatabase)를 호출할 때 사용하는 값과 같습니다. This is the same value used when calling InstallDistributor(String, DistributionDatabase) at the Distributor.

설명

이 메서드는 원격 배포자를 등록 하려면 게시자에서 호출 되어야 합니다.This method must be called from a Publisher to register the remote Distributor. 게시자 및 배포자에는 동일한 서버에 있는 경우에이 메서드를 호출 해야 합니다.If the Publisher and Distributor are on the same server, you should not call this method.

호출 하기 전에 InstallDistributor(String, SecureString)를 호출 해야 InstallDistributor(SecureString, DistributionDatabase) 배포자에서 합니다.Before calling InstallDistributor(String, SecureString), you must have called InstallDistributor(SecureString, DistributionDatabase) at the Distributor.

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

InstallDistributor 메서드 sysadmin 고정된 서버 역할의 멤버에 따라 호출할 수 있습니다.The InstallDistributor method can only be called by a member of the sysadmin fixed server role.

InstallDistributor 를 실행 하는 것과 같습니다는 sp_adddistributor (Transact SQL) 원격 배포자를 등록 하려면 게시자에서 프로시저를 저장 합니다.The InstallDistributor method is equivalent to executing the sp_adddistributor (Transact-SQL) stored procedure at the Publisher to register a remote Distributor.

InstallDistributor(SecureString, DistributionDatabase) InstallDistributor(SecureString, DistributionDatabase) InstallDistributor(SecureString, DistributionDatabase)

현재 연결 된 Microsoft SQL Server 인스턴스에서 배포자를 설치를 사용 하 여 암호가 지정 된 위치는 SecureString 개체입니다. Installs a Distributor on the currently connected instance of Microsoft SQL Server, where the password is specified using a SecureString object.

public:
 void InstallDistributor(System::Security::SecureString ^ password, Microsoft::SqlServer::Replication::DistributionDatabase ^ distributionDB);
public void InstallDistributor (System.Security.SecureString password, Microsoft.SqlServer.Replication.DistributionDatabase distributionDB);
Public Sub InstallDistributor (password As SecureString, distributionDB As DistributionDatabase)
매개 변수
password
SecureString SecureString SecureString

배포자에 액세스하는 데 사용되는 distributor_admin 로그인의 암호를 나타내는 SecureString 값입니다. Is a SecureString value representing the password of the distributor_admin login used to access the Distributor. 보안 참고 하면 가능한 경우 프롬프트 사용자에 게 런타임에 보안 자격 증명을 입력 하 합니다. 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.

distributionDB
DistributionDatabase DistributionDatabase DistributionDatabase

배포자에서 사용하는 배포 데이터베이스를 나타내는 DistributionDatabase 개체입니다. A DistributionDatabase object representing the distribution database used by the Distributor.

설명

에 대 한 강력한 암호를 지정 해야 password 배포자에 원격 게시자를가 하는 경우.You must specify a strong password for password when the Distributor has remote Publishers. 경우 password 로 설정 되어 null, 임의의 암호가 생성 되 고 호출 해야 ChangeDistributorPassword 배포자에서 원격 게시자를 처음 등록 될 때 암호를 재설정할 수 있습니다.If password is set to null, a random password is generated, and you must call ChangeDistributorPassword to reset the password when the first remote Publisher is registered at the Distributor.

이 메서드 오버 로드를 호출 하기 전에 배포자에서 호출 해야 InstallDistributor(String, String) 원격 서버에서 합니다.This method overload must be called at the Distributor before calling InstallDistributor(String, String) from a remote server.

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

InstallDistributor 메서드 sysadmin 고정된 서버 역할의 멤버에 따라 호출할 수 있습니다.The InstallDistributor method can only be called by a member of the sysadmin fixed server role.

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

InstallDistributor(String, DistributionDatabase) InstallDistributor(String, DistributionDatabase) InstallDistributor(String, DistributionDatabase)

현재 연결 된 Microsoft SQL Server 인스턴스에서 배포자를 설치 합니다. Installs a Distributor on the currently connected instance of Microsoft SQL Server.

public:
 void InstallDistributor(System::String ^ password, Microsoft::SqlServer::Replication::DistributionDatabase ^ distributionDB);
public void InstallDistributor (string password, Microsoft.SqlServer.Replication.DistributionDatabase distributionDB);
Public Sub InstallDistributor (password As String, distributionDB As DistributionDatabase)
매개 변수
password
String String String

배포자에 액세스하는 데 사용되는 distributor_admin 로그인의 암호입니다. Is the password of the distributor_admin login used to access the Distributor. 보안 참고 하면 가능한 경우 프롬프트 사용자에 게 런타임에 보안 자격 증명을 입력 하 합니다. 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.

distributionDB
DistributionDatabase DistributionDatabase DistributionDatabase

배포자에서 사용하는 배포 데이터베이스를 나타내는 DistributionDatabase 개체입니다. A DistributionDatabase object representing the distribution database used by the Distributor.

예외

때 메일 서버에 이미 설치 되어 있습니다. When distribution is already installed on the server.

distributionDB 매개 변수가 null 이면 되거나 password 128 바이트를 초과 하거나 null 문자를 포함 합니다. When distributionDB is null, or when password exceeds 128 bytes or contains null characters.

예제

// Set the server and database names
string distributionDbName = "distribution";
string publisherName = publisherInstance;
string publicationDbName = "AdventureWorks2012";

DistributionDatabase distributionDb;
ReplicationServer distributor;
DistributionPublisher publisher;
ReplicationDatabase publicationDb;

// Create a connection to the server using Windows Authentication.
ServerConnection conn = new ServerConnection(publisherName);

try
{
	// Connect to the server acting as the Distributor 
	// and local Publisher.
	conn.Connect();

	// Define the distribution database at the Distributor,
	// but do not create it now.
	distributionDb = new DistributionDatabase(distributionDbName, conn);
	distributionDb.MaxDistributionRetention = 96;
	distributionDb.HistoryRetention = 120;

	// Set the Distributor properties and install the Distributor.
	// This also creates the specified distribution database.
	distributor = new ReplicationServer(conn);
	distributor.InstallDistributor((string)null, distributionDb);

	// Set the Publisher properties and install the Publisher.
	publisher = new DistributionPublisher(publisherName, conn);
	publisher.DistributionDatabase = distributionDb.Name;
	publisher.WorkingDirectory = @"\\" + publisherName + @"\repldata";
	publisher.PublisherSecurity.WindowsAuthentication = true;
	publisher.Create();

	// Enable AdventureWorks2012 as a publication database.
	publicationDb = new ReplicationDatabase(publicationDbName, conn);

	publicationDb.EnabledTransPublishing = true;
	publicationDb.EnabledMergePublishing = true;
}
catch (Exception ex)
{
	// Implement appropriate error handling here.
	throw new ApplicationException("An error occured when installing distribution and publishing.", ex);
}
finally
{
	conn.Disconnect();
}

설명

에 대 한 강력한 암호를 지정 해야 password 배포자에 원격 게시자를가 하는 경우.You must specify a strong password for password when the Distributor has remote Publishers. 경우 password 로 설정 되어 null, 임의의 암호가 생성 되 고 호출 해야 ChangeDistributorPassword 배포자에서 원격 게시자를 처음 등록 될 때 암호를 재설정할 수 있습니다.If password is set to null, a random password is generated, and you must call ChangeDistributorPassword to reset the password when the first remote Publisher is registered at the Distributor.

이 메서드 오버 로드를 호출 하기 전에 배포자에서 호출 해야 InstallDistributor 원격 서버에서 합니다.This method overload must be called at the Distributor before calling InstallDistributor from a remote server.

InstallDistributor 메서드 sysadmin 고정된 서버 역할의 멤버에 따라 호출할 수 있습니다.The InstallDistributor method can only be called by a member of the sysadmin fixed server role.

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

추가 정보

적용 대상