ReplicationServer.InstallDistributor Metode

  • Referensi

Definisi

Ruang nama:
Microsoft.SqlServer.Replication
Rakitan:
Microsoft.SqlServer.Rmo.dll

Menginstal Distributor.

Overload

InstallDistributor(String, String)

Mendaftarkan Distributor jarak jauh.
InstallDistributor(String, SecureString)

Mendaftarkan Distributor jarak jauh, di mana kata sandi ditentukan menggunakan SecureString objek .
InstallDistributor(SecureString, DistributionDatabase)

Menginstal Distributor pada instans Microsoft SQL Server yang saat ini tersambung, di mana kata sandi ditentukan menggunakan SecureString objek .
InstallDistributor(String, DistributionDatabase)

Menginstal Distributor pada instans Microsoft SQL Server yang saat ini terhubung.

Contoh

// 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)

Mendaftarkan Distributor jarak jauh.

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)

Parameter

distributionServerName
String

String Nilai yang menentukan nama server jarak jauh yang akan digunakan sebagai Distributor untuk server Publisher saat ini. Nama server distribusi tidak boleh sama dengan server saat ini.

password
String

Nilai String yang menentukan kata sandi. Ini adalah nilai yang sama yang digunakan saat memanggil InstallDistributor(String, DistributionDatabase) di Distributor.

Keterangan

Metode ini harus dipanggil dari Publisher untuk mendaftarkan Distributor jarak jauh. Jika Publisher dan Distributor berada di server yang sama, Anda tidak boleh memanggil metode ini.

Sebelum memanggil InstallDistributor(String, String), Anda harus menelepon InstallDistributor(String, DistributionDatabase) di Distributor.

Metode InstallDistributor ini hanya dapat dipanggil oleh anggota peran server tetap sysadmin.

Metode InstallDistributor ini setara dengan menjalankan prosedur tersimpan sp_adddistributor (Transact-SQL) di Publisher untuk mendaftarkan Distributor jarak jauh.

Berlaku untuk

InstallDistributor(String, SecureString)

Mendaftarkan Distributor jarak jauh, di mana kata sandi ditentukan menggunakan SecureString objek .

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)

Parameter

distributionServerName
String

String Nilai yang menentukan nama server jarak jauh yang akan digunakan sebagai Distributor untuk server Publisher saat ini. Nama server distribusi tidak boleh sama dengan server saat ini.

password
SecureString

Nilai SecureString yang menentukan kata sandi. Ini adalah nilai yang sama yang digunakan saat memanggil InstallDistributor(String, DistributionDatabase) di Distributor.

Keterangan

Metode ini harus dipanggil dari Publisher untuk mendaftarkan Distributor jarak jauh. Jika Publisher dan Distributor berada di server yang sama, Anda tidak boleh memanggil metode ini.

Sebelum memanggil InstallDistributor(String, SecureString), Anda harus menelepon InstallDistributor(SecureString, DistributionDatabase) di Distributor.

Metode ini InstallDistributor(String, SecureString) memberikan keamanan tambahan untuk kata sandi saat disimpan dalam memori dan harus digunakan alih-alih InstallDistributor(String, String).

Metode InstallDistributor ini hanya dapat dipanggil oleh anggota peran server tetap sysadmin.

Metode InstallDistributor ini setara dengan menjalankan prosedur tersimpan sp_adddistributor (Transact-SQL) di Publisher untuk mendaftarkan Distributor jarak jauh.

Berlaku untuk

InstallDistributor(SecureString, DistributionDatabase)

Menginstal Distributor pada instans Microsoft SQL Server yang saat ini tersambung, di mana kata sandi ditentukan menggunakan SecureString objek .

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)

Parameter

password
SecureString

Adalah nilai yang SecureString mewakili kata sandi login distributor_admin yang digunakan untuk mengakses Distributor.

Catatan Keamanan Jika memungkinkan, minta pengguna untuk memasukkan kredensial keamanan pada durasi. Jika Anda harus menyimpan kredensial, gunakan http://go.microsoft.com/fwlink/?LinkId=34733 layanan kriptografi yang disediakan oleh .NET Framework Windows.

distributionDB
DistributionDatabase

Objek DistributionDatabase yang mewakili database distribusi yang digunakan oleh Distributor.

Keterangan

Anda harus menentukan kata sandi yang kuat ketika password Distributor memiliki Penerbit jarak jauh. Jika password diatur ke null, kata sandi acak dihasilkan, dan Anda harus memanggil ChangeDistributorPassword untuk mengatur ulang kata sandi ketika Publisher jarak jauh pertama terdaftar di Distributor.

Kelebihan beban metode ini harus dipanggil di Distributor sebelum memanggil InstallDistributor(String, String) dari server jarak jauh.

Metode ini InstallDistributor(SecureString, DistributionDatabase) memberikan keamanan tambahan untuk kata sandi saat disimpan dalam memori dan harus digunakan alih-alih InstallDistributor(String, DistributionDatabase).

Metode InstallDistributor ini hanya dapat dipanggil oleh anggota peran server tetap sysadmin.

Metode InstallDistributor ini setara dengan prosedur tersimpan sp_adddistributor (Transact-SQL ).

Berlaku untuk

InstallDistributor(String, DistributionDatabase)

Menginstal Distributor pada instans Microsoft SQL Server yang saat ini terhubung.

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)

Parameter

password
String

Apakah kata sandi login distributor_admin digunakan untuk mengakses Distributor.

Catatan Keamanan Jika memungkinkan, minta pengguna untuk memasukkan kredensial keamanan pada durasi. Jika Anda harus menyimpan kredensial, gunakan http://go.microsoft.com/fwlink/?LinkId=34733 layanan kriptografi yang disediakan oleh .NET Framework Windows.

distributionDB
DistributionDatabase

Objek DistributionDatabase yang mewakili database distribusi yang digunakan oleh Distributor.

Pengecualian

ApplicationException

Ketika distribusi sudah diinstal pada server.

ArgumentException

Ketika distributionDB null, atau jika password melebihi 128 byte atau berisi karakter null.

Contoh

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

Keterangan

Anda harus menentukan kata sandi yang kuat ketika password Distributor memiliki Penerbit jarak jauh. Jika password diatur ke null, kata sandi acak dihasilkan, dan Anda harus memanggil ChangeDistributorPassword untuk mengatur ulang kata sandi ketika Publisher jarak jauh pertama terdaftar di Distributor.

Kelebihan beban metode ini harus dipanggil di Distributor sebelum memanggil InstallDistributor dari server jarak jauh.

Metode InstallDistributor ini hanya dapat dipanggil oleh anggota peran server tetap sysadmin.

Metode InstallDistributor ini setara dengan prosedur tersimpan sp_adddistributor (Transact-SQL ).

Lihat juga

Berlaku untuk