ReplicationServer.InstallDistributor 메서드

정의

네임스페이스:: Microsoft.SqlServer.Replication

어셈블리:: Microsoft.SqlServer.Rmo.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

배급기를 설치합니다.

오버로드

Name	Description
InstallDistributor(String, String)	원격 배급기를 등록합니다.
InstallDistributor(String, SecureString)	원격 배포기를 등록하며, 비밀번호는 객체를 SecureString 사용해 지정됩니다.
InstallDistributor(SecureString, DistributionDatabase)	현재 연결된 Microsoft SQL Server 인스턴스에 배포기를 설치하며, 비밀번호는 객체를 SecureString 통해 지정됩니다.
InstallDistributor(String, DistributionDatabase)	현재 연결된 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)

원격 배급기를 등록합니다.

public:
 void InstallDistributor(System::String ^ distributionServerName, System::String ^ password);

public void InstallDistributor(string distributionServerName, string password);

member this.InstallDistributor : string * string -> unit

Public Sub InstallDistributor (distributionServerName As String, password As String)

매개 변수

distributionServerName: String

String 현재 Publisher 서버의 배포자로 사용할 원격 서버 이름을 지정하는 값입니다. 배포 서버 이름은 현재 서버와 같아서는 안 됩니다.

password: String

String 비밀번호를 지정하는 값입니다. 이 값은 배전업체에 전화 InstallDistributor(String, DistributionDatabase) 할 때 사용하는 값과 동일합니다.

설명

이 방법은 원격 배포자를 등록하기 위해 Publisher에서 호출해야 합니다. Publisher와 Distributor가 같은 서버에 있다면 이 메서드를 호출하지 않는 것이 좋습니다.

전화 InstallDistributor(String, String)하기 전에 반드시 디스트리뷰터에 방문 InstallDistributor(String, DistributionDatabase) 했어야 합니다.

이 메서드는 InstallDistributor 시스템 관리자 고정 서버 역할의 구성원만 호출할 수 있습니다.

이 InstallDistributor 방법은 원격 배포기를 등록하기 위해 Publisher에서 sp_adddistributor(Transact-SQL) 저장 프로시저를 실행하는 것과 동등합니다.

적용 대상

InstallDistributor(String, SecureString)

원격 배포기를 등록하며, 비밀번호는 객체를 SecureString 사용해 지정됩니다.

public:
 void InstallDistributor(System::String ^ distributionServerName, System::Security::SecureString ^ password);

public void InstallDistributor(string distributionServerName, System.Security.SecureString password);

member this.InstallDistributor : string * System.Security.SecureString -> unit

Public Sub InstallDistributor (distributionServerName As String, password As SecureString)

매개 변수

distributionServerName: String

String 현재 Publisher 서버의 배포자로 사용할 원격 서버 이름을 지정하는 값입니다. 배포 서버 이름은 현재 서버와 같아서는 안 됩니다.

password: SecureString

SecureString 비밀번호를 지정하는 값입니다. 이 값은 배전업체에 전화 InstallDistributor(String, DistributionDatabase) 할 때 사용하는 값과 동일합니다.

설명

전화 InstallDistributor(String, SecureString)하기 전에 반드시 디스트리뷰터에 방문 InstallDistributor(SecureString, DistributionDatabase) 했어야 합니다.

이 InstallDistributor(String, SecureString) 방법은 비밀번호가 메모리에 저장되는 동안 추가적인 보안을 제공하며, 대신 사용해야 InstallDistributor(String, String)합니다.

이 메서드는 InstallDistributor 시스템 관리자 고정 서버 역할의 구성원만 호출할 수 있습니다.

이 InstallDistributor 방법은 원격 배포기를 등록하기 위해 Publisher에서 sp_adddistributor(Transact-SQL) 저장 프로시저를 실행하는 것과 동등합니다.

적용 대상

InstallDistributor(SecureString, DistributionDatabase)

현재 연결된 Microsoft SQL Server 인스턴스에 배포기를 설치하며, 비밀번호는 객체를 SecureString 통해 지정됩니다.

public:
 void InstallDistributor(System::Security::SecureString ^ password, Microsoft::SqlServer::Replication::DistributionDatabase ^ distributionDB);

public void InstallDistributor(System.Security.SecureString password, Microsoft.SqlServer.Replication.DistributionDatabase distributionDB);

member this.InstallDistributor : System.Security.SecureString * Microsoft.SqlServer.Replication.DistributionDatabase -> unit

Public Sub InstallDistributor (password As SecureString, distributionDB As DistributionDatabase)

매개 변수

password: SecureString

는 SecureString 배포자에 접근하는 데 사용되는 distributor_admin 로그인의 비밀번호를 나타내는 값입니다.

보안 주의사항 가능하다면 실행 시 보안 자격 증명 입력을 안내해 주세요. 자격 증명을 저장해야 한다면 Windows .NET 프레임워크에서 제공하는 암호화 서비스를 이용 http://go.microsoft.com/fwlink/?LinkId=34733 하세요.

distributionDB: DistributionDatabase

DistributionDatabase 배포자가 사용하는 배포 데이터베이스를 나타내는 객체입니다.

설명

배포사가 원격 출판사를 사용할 경우에는 password 강력한 비밀번호를 지정해야 합니다. 가 로 설정null되면 password 무작위 비밀번호가 생성되며, 첫 번째 원격 Publisher가 배포자에 등록되면 비밀번호를 재설정하기 위해 호출 ChangeDistributorPassword 해야 합니다.

이 메서드 오버로드는 원격 서버에서 호출 InstallDistributor(String, String) 하기 전에 배포자에서 호출되어야 합니다.

이 InstallDistributor(SecureString, DistributionDatabase) 방법은 비밀번호가 메모리에 저장되는 동안 추가적인 보안을 제공하며, 대신 사용해야 InstallDistributor(String, DistributionDatabase)합니다.

이 메서드는 InstallDistributor 시스템 관리자 고정 서버 역할의 구성원만 호출할 수 있습니다.

이 InstallDistributor 메서드는 sp_adddistributor (Transact-SQL) 저장 프로시저와 동등합니다.

적용 대상

InstallDistributor(String, DistributionDatabase)

현재 연결된 Microsoft SQL Server 인스턴스에 배포기를 설치합니다.

public:
 void InstallDistributor(System::String ^ password, Microsoft::SqlServer::Replication::DistributionDatabase ^ distributionDB);

public void InstallDistributor(string password, Microsoft.SqlServer.Replication.DistributionDatabase distributionDB);

member this.InstallDistributor : string * Microsoft.SqlServer.Replication.DistributionDatabase -> unit

Public Sub InstallDistributor (password As String, distributionDB As DistributionDatabase)

매개 변수

password: String

distributor_admin 로그인의 비밀번호가 배포자에 접근하는 데 사용되나요?

distributionDB: DistributionDatabase

DistributionDatabase 배포자가 사용하는 배포 데이터베이스를 나타내는 객체입니다.

예외

ApplicationException

배포판이 이미 서버에 설치되어 있을 때.

ArgumentException

distributionDB 가 null일 때, 또는 128바이트를 초과하거나 null 문자를 포함할 때 password 입니다.

예제

// 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 하기 전에 배포자에서 호출되어야 합니다.

이 메서드는 InstallDistributor 시스템 관리자 고정 서버 역할의 구성원만 호출할 수 있습니다.

이 InstallDistributor 메서드는 sp_adddistributor (Transact-SQL) 저장 프로시저와 동등합니다.

추가 정보

방법: 출판 및 배포 구성 (RMO 프로그래밍)

적용 대상