ReplicationServer.InstallDistributor 메서드 (String, DistributionDatabase)

  • 아티클

Installs a Distributor on the currently connected instance of Microsoft SQL Server.

네임스페이스:  Microsoft.SqlServer.Replication
어셈블리:  Microsoft.SqlServer.Rmo(Microsoft.SqlServer.Rmo.dll)

구문

‘선언
Public Sub InstallDistributor ( _
    password As String, _
    distributionDB As DistributionDatabase _
)
‘사용 방법
Dim instance As ReplicationServer 
Dim password As String 
Dim distributionDB As DistributionDatabase

instance.InstallDistributor(password, _
    distributionDB)

public void InstallDistributor(
    string password,
    DistributionDatabase distributionDB
)

public:
void InstallDistributor(
    String^ password, 
    DistributionDatabase^ distributionDB
)

member InstallDistributor : 
        password:string * 
        distributionDB:DistributionDatabase -> unit

public function InstallDistributor(
    password : String, 
    distributionDB : DistributionDatabase
)

매개 변수

  • password
    유형: System.String
    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. If you must store credentials, use the https://go.microsoft.com/fwlink/?LinkId=34733 cryptographic services provided by the Windows .NET Framework.

예외

예외 조건
ApplicationException

When distribution is already installed on the server.
ArgumentException

When distributionDB is null, or when password exceeds 128 bytes or contains null characters.

주의

You must specify a strong password for password when the Distributor has remote Publishers. If password is set to nullnull 참조(Visual Basic에서는 Nothing), a random password is generated, and you must call ChangeDistributorPassword to reset the password when the first remote Publisher is registered at the Distributor.

This method overload must be called at the Distributor before calling InstallDistributor from a remote server.

The InstallDistributor method can only be called by a member of the sysadmin fixed server role.

The InstallDistributor method is equivalent to the sp_adddistributor(Transact-SQL) stored procedure.

예

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

참고 항목

참조

ReplicationServer 클래스

InstallDistributor 오버로드

Microsoft.SqlServer.Replication 네임스페이스

관련 자료

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