ReplicationServer.UninstallDistributor(Boolean) Method

Definition

Uninstalls replication publishing and distribution on the currently connected instance of SQL Server.

public:
 void UninstallDistributor(bool force);
public void UninstallDistributor (bool force);
member this.UninstallDistributor : bool -> unit
Public Sub UninstallDistributor (force As Boolean)

Parameters

force
Boolean

A Boolean value that specifies whether or not replication objects are removed from the server, even if a remote Distributor cannot be reached. If true, the publishing and Distributor configuration at the current server is uninstalled regardless of whether or not dependent publishing and distribution objects are uninstalled. If false, all dependent publishing and distribution objects are dropped before the Distributor is uninstalled.

Examples

myDist.UninstallDistributor(false);  

Remarks

Before calling UninstallDistributor, you must first perform the following tasks:

  1. Delete all subscriptions. For more information, see How to: Delete a Push Subscription (RMO Programming) and How to: Delete a Pull Subscription (RMO Programming).

  2. Delete all publications. For more information, see How to: Delete a Publication (RMO Programming).

  3. Drop any distribution databases. For more information, see How to: Disable Publishing and Distribution (RMO Programming).

The UninstallDistributor method can only be called by members of the sysadmin fixed server role.

The UninstallDistributor method is equivalent to executing the sp_dropdistributor (Transact-SQL) stored procedure.

Applies to