Subscription.CreateSyncAgentByDefault Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets whether the agent job used to synchronize the subscription is created by default.
public:
property bool CreateSyncAgentByDefault { bool get(); void set(bool value); };public bool CreateSyncAgentByDefault { get; set; }member this.CreateSyncAgentByDefault : bool with get, setPublic Property CreateSyncAgentByDefault As BooleanProperty Value
A Boolean value. If true, the agent job is created. If false, the agent job is not created.
Remarks
The CreateSyncAgentByDefault property is only used when a new subscription is created.
The default value for CreateSyncAgentByDefault is true.
When an agent job is created, metadata required by Microsoft SQL Server Agent to synchronize the subscription is stored in the MSsubscription_properties table. When you create a subscription and specify a value of false for CreateSyncAgentByDefault, a data row is not added to the MSsubscription_properties table for the subscription. In this case, many of the properties of the MergeSubscription or TransSubscription object that represent a subscription cannot be saved on the server. To persist any of the subscription properties in the MSsubscription_properties table, you must specify a value of true for CreateSyncAgentByDefault.