Distributor Object

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

The Distributor object represents the replication Distributor for an instance of Microsoft SQL Server.

SQL-DMO object model that shows the current object

Properties

AgentCheckupInterval Property

DistributorInstalled Property

DistributionDatabase Property

DistributorLocal Property

DistributionServer Property

HasRemoteDistributionPublisher Property

DistributorAvailable Property

IsDistributionPublisher Property

Methods

ChangeAgentProfile Method

EnumSnapshotAgentViews Method

CleanUpDistributionPublisherByName Method

EnumThirdPartyPublications Method

CreateAgentProfile Method

GetAgentsStatus Method (Distributor)

DeleteAgentProfile Method

Install Method

EnumAgentProfiles Method

Refresh Method

EnumAgentParameters Method

RemoveDefunctAnonymousSubscriptionMethod

EnumDistributionAgentViews Method

Script Method (Replication Objects)

EnumLogReaderAgentViews Method

SetUpDistributorPassword Method

EnumMergeAgentViews Method

Uninstall Method

UpdateDefaultAgentProfile Method

UpdateAgentProfile Method

Remarks

With the Distributor object, you can:

  • Install a local Distributor or configure remote distribution for a Publisher.
  • Uninstall a local Distributor or stop remote distribution.

To install a local Distributor and distribution database

  1. Create a new DistributionDatabase object.

  2. Set the Name property to the name of the new distribution database.

  3. Add the DistributionDatabase object to the DistributionDatabases collection of a connected Distributor object.

  4. Set the DistributionServer property of a connected Distributor object to the name of the local instance of SQL Server (available in the TrueName property of a connected SQLServer object).

  5. Use the Install method of the connected Distributor object.

To uninstall a local Distributor and distribution database

  • Use the Uninstall method of a connected Distributor object.

Note   The Distributor object is compatible with instances of SQL Server versions 7.0 and later. However, the Distributor2 object extends the functionality of the Distributor object for use with features that were introduced in SQL Server 2000.

See Also

Reference

Distributor2 Object

Help and Information

Getting SQL Server 2005 Assistance