Freigeben über


Subscription.SynchronizationAgentProcessSecurity Eigenschaft

Definition

Ruft den Sicherheitskontext ab, der verwendet wird, um das Microsoft Windows-Konto anzugeben, unter dem der Synchronisierungs-Agent-Auftrag ausgeführt wird, um das Abonnement zu synchronisieren.

public:
 property Microsoft::SqlServer::Replication::IProcessSecurityContext ^ SynchronizationAgentProcessSecurity { Microsoft::SqlServer::Replication::IProcessSecurityContext ^ get(); };
public Microsoft.SqlServer.Replication.IProcessSecurityContext SynchronizationAgentProcessSecurity { get; }
member this.SynchronizationAgentProcessSecurity : Microsoft.SqlServer.Replication.IProcessSecurityContext
Public ReadOnly Property SynchronizationAgentProcessSecurity As IProcessSecurityContext

Eigenschaftswert

Ein IProcessSecurityContext-Objekt, das ein Windows-Konto darstellt.

Beispiele

           // Define the Publisher, publication, and databases.
           string publicationName = "AdvWorksProductTran";
           string publisherName = publisherInstance;
           string subscriberName = subscriberInstance;
           string subscriptionDbName = "AdventureWorks2012Replica";
           string publicationDbName = "AdventureWorks2012";

           //Create a connection to the Publisher.
           ServerConnection conn = new ServerConnection(publisherName);

           // Create the objects that we need.
           TransPublication publication;
           TransSubscription subscription;

           try
           {
               // Connect to the Publisher.
               conn.Connect();

               // Ensure that the publication exists and that 
               // it supports push subscriptions.
               publication = new TransPublication();
               publication.Name = publicationName;
               publication.DatabaseName = publicationDbName;
               publication.ConnectionContext = conn;

               if (publication.IsExistingObject)
               {
                   if ((publication.Attributes & PublicationAttributes.AllowPush) == 0)
                   {
                       publication.Attributes |= PublicationAttributes.AllowPush;
                   }

                   // Define the push subscription.
                   subscription = new TransSubscription();
                   subscription.ConnectionContext = conn;
                   subscription.SubscriberName = subscriberName;
                   subscription.PublicationName = publicationName;
                   subscription.DatabaseName = publicationDbName;
                   subscription.SubscriptionDBName = subscriptionDbName;

                   // Specify the Windows login credentials for the Distribution Agent job.
                   subscription.SynchronizationAgentProcessSecurity.Login = winLogin;
                   subscription.SynchronizationAgentProcessSecurity.Password = winPassword;

                   // By default, subscriptions to transactional publications are synchronized 
                   // continuously, but in this case we only want to synchronize on demand.
                   subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand;

                   // Create the push subscription.
                   subscription.Create();
               }
               else
               {
                   // Do something here if the publication does not exist.
                   throw new ApplicationException(String.Format(
                       "The publication '{0}' does not exist on {1}.",
                       publicationName, publisherName));
               }
           }
           catch (Exception ex)
           {
               // Implement the appropriate error handling here.
               throw new ApplicationException(String.Format(
                   "The subscription to {0} could not be created.", publicationName), ex);
           }
           finally
           {
               conn.Disconnect();
           }
' Define the Publisher, publication, and databases.
Dim publicationName As String = "AdvWorksProductTran"
Dim publisherName As String = publisherInstance
Dim subscriberName As String = subscriberInstance
Dim subscriptionDbName As String = "AdventureWorks2012Replica"
Dim publicationDbName As String = "AdventureWorks2012"

'Create a connection to the Publisher.
Dim conn As ServerConnection = New ServerConnection(publisherName)

' Create the objects that we need.
Dim publication As TransPublication
Dim subscription As TransSubscription

Try
    ' Connect to the Publisher.
    conn.Connect()

    ' Ensure that the publication exists and that 
    ' it supports push subscriptions.
    publication = New TransPublication()
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName
    publication.ConnectionContext = conn

    If publication.IsExistingObject Then
        If (publication.Attributes And PublicationAttributes.AllowPush) = 0 Then
            publication.Attributes = publication.Attributes _
            Or PublicationAttributes.AllowPush
        End If

        ' Define the push subscription.
        subscription = New TransSubscription()
        subscription.ConnectionContext = conn
        subscription.SubscriberName = subscriberName
        subscription.PublicationName = publicationName
        subscription.DatabaseName = publicationDbName
        subscription.SubscriptionDBName = subscriptionDbName

        ' Specify the Windows login credentials for the Distribution Agent job.
        subscription.SynchronizationAgentProcessSecurity.Login = winLogin
        subscription.SynchronizationAgentProcessSecurity.Password = winPassword

        ' By default, subscriptions to transactional publications are synchronized 
        ' continuously, but in this case we only want to synchronize on demand.
        subscription.AgentSchedule.FrequencyType = ScheduleFrequencyType.OnDemand

        ' Create the push subscription.
        subscription.Create()
    Else
        ' Do something here if the publication does not exist.
        Throw New ApplicationException(String.Format( _
         "The publication '{0}' does not exist on {1}.", _
         publicationName, publisherName))
    End If

Catch ex As Exception
    ' Implement the appropriate error handling here.
    Throw New ApplicationException(String.Format( _
        "The subscription to {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

Hinweise

Sie müssen Windows-Kontoinformationen mithilfe der von der IProcessSecurityContextSynchronizationAgentProcessSecurity -Eigenschaft zurückgegebenen Schnittstelle angeben. Dies ist nicht erforderlich, wenn das Abonnement von einem Mitglied der festen Serverrolle sysadmin auf dem Verleger erstellt wird.

Der Synchronisierungs-Agent für ein Pushabonnement stellt immer eine lokale Verbindung mit dem Verteiler her, indem die Windows-Authentifizierungsanmeldeinformationen verwendet werden, die mithilfe der SynchronizationAgentProcessSecurity -Eigenschaft angegeben werden. Informationen zu den Verbindungen, die von Agents hergestellt werden, und zu den Berechtigungen, die für diese Verbindungen erforderlich sind, finden Sie unter Replikations-Agent-Sicherheitsmodell.

Beim Konfigurieren eines Verlegers mit einem Remoteverteiler werden die für alle Parameter angegebenen Werte, einschließlich SynchronizationAgentProcessSecurity, als Nur-Text an den Verteiler gesendet. Sie sollten die Verbindung zwischen dem Verleger und dem zugehörigen Remoteverteiler verschlüsseln, bevor Sie die Create-Methode aufrufen. Weitere Informationen finden Sie unter Verschlüsseln von Verbindungen zu SQL Server.

Die SynchronizationAgentProcessSecurity Eigenschaft kann nur von Mitgliedern der festen Serverrolle sysadmin auf dem Verleger, von Mitgliedern der festen Datenbankrolle db_owner festen Datenbankrolle in der Veröffentlichungsdatenbank oder von dem Benutzer abgerufen werden, der das Abonnement erstellt hat.

Die SynchronizationAgentProcessSecurity Eigenschaft kann nur von Mitgliedern der festen Serverrolle sysadmin auf dem Verleger oder von Mitgliedern der festen Datenbankrolle db_owner festen Datenbankrolle in der Veröffentlichungsdatenbank festgelegt werden.

Das Abrufen der SynchronizationAgentProcessSecurity Eigenschaft entspricht dem Ausführen sp_helpsubscription oder sp_helpmergesubscription.

Das Festlegen von Eigenschaften für die zurückgegebene IProcessSecurityContext Schnittstelle entspricht der Ausführung sp_addsubscriptionsp_addmergesubscription, sp_changesubscription oder sp_changemergesubscription.

Gilt für:

Weitere Informationen