Subscription.SynchronizationAgentProcessSecurity Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.IProcessSecurityContextPublic ReadOnly Property SynchronizationAgentProcessSecurity As IProcessSecurityContextEigenschaftswert
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.