• [アーティクル]

SynchronizationAgentProcessSecurity プロパティ

同期エージェント ジョブがサブスクリプションの同期を実行する Microsoft Windows アカウントを指定するために使用されるセキュリティ コンテキストを取得します。

名前空間:  Microsoft.SqlServer.Replication
アセンブリ:  Microsoft.SqlServer.Rmo (Microsoft.SqlServer.Rmo.dll)

構文

'宣言
Public ReadOnly Property SynchronizationAgentProcessSecurity As IProcessSecurityContext
    Get
'使用
Dim instance As Subscription
Dim value As IProcessSecurityContext

value = instance.SynchronizationAgentProcessSecurity

public IProcessSecurityContext SynchronizationAgentProcessSecurity { get; }

public:
property IProcessSecurityContext^ SynchronizationAgentProcessSecurity {
    IProcessSecurityContext^ get ();
}

member SynchronizationAgentProcessSecurity : IProcessSecurityContext

function get SynchronizationAgentProcessSecurity () : IProcessSecurityContext

プロパティ値

型: Microsoft.SqlServer.Replication. . :: . .IProcessSecurityContext
Windows アカウントを表す IProcessSecurityContext オブジェクトです。

説明

SynchronizationAgentProcessSecurity プロパティによって返される IProcessSecurityContext インターフェイスを使用して、Windows アカウント情報を指定する必要があります。サブスクリプションが sysadmin 固定サーバー ロールのメンバによってパブリッシャで作成されている場合、これは必要ありません。

プッシュ サブスクリプション用の同期エージェントからディストリビュータへの接続は、常にローカルであり、SynchronizationAgentProcessSecurity プロパティを使用して指定される Windows 認証の資格情報が使用されます。エージェントによる接続と、これらの接続に必要な権限の詳細については、「レプリケーション エージェントのセキュリティ モデル」を参照してください。

パブリッシャにリモート ディストリビュータを構成するとき、パラメータに指定した値は、SynchronizationAgentProcessSecurity も含めてすべてプレーン テキストとしてディストリビュータに送信されます。Create メソッドを呼び出す前に、パブリッシャとリモート ディストリビュータ間の接続を暗号化する必要があります。詳細については、「SQL Server への接続の暗号化」を参照してください。

SynchronizationAgentProcessSecurity プロパティを取得できるのは、パブリッシャ側の固定サーバー ロール sysadmin のメンバ、パブリケーション データベースの固定データベース ロール db_owner のメンバ、またはサブスクリプションを作成したユーザーだけです。

SynchronizationAgentProcessSecurity プロパティを設定できるのは、パブリッシャ側の固定サーバー ロール sysadmin のメンバ、またはパブリケーション データベースの固定データベース ロール db_owner のメンバだけです。

SynchronizationAgentProcessSecurity プロパティを取得すると、sp_helpsubscription または sp_helpmergesubscription を実行したのと同じことになります。

返された IProcessSecurityContext インターフェイスでプロパティを設定すると、sp_addsubscription、sp_addmergesubscription、sp_changesubscription、または sp_changemergesubscription を実行したのと同じことになります。

SynchronizationAgentProcessSecurity プロパティは MicrosoftSQL Server 2005 でのみ使用できます。

この名前空間、クラス、またはメンバは、Microsoft .NET Framework 2.0 でのみサポートされています。

使用例

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

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

            // 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 = "AdventureWorksReplica"
Dim publicationDbName As String = "AdventureWorks"

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

' 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