Publication.SnapshotGenerationAgentProcessSecurity Publication.SnapshotGenerationAgentProcessSecurity Publication.SnapshotGenerationAgentProcessSecurity Property

정의

스냅숏 에이전트 작업이 실행되는 Windows 계정을 설정하는 개체를 가져옵니다. Gets an object that sets the Windows account under which the Snapshot Agent job runs.

public:
 property Microsoft::SqlServer::Replication::IProcessSecurityContext ^ SnapshotGenerationAgentProcessSecurity { Microsoft::SqlServer::Replication::IProcessSecurityContext ^ get(); };
public Microsoft.SqlServer.Replication.IProcessSecurityContext SnapshotGenerationAgentProcessSecurity { get; }
Public ReadOnly Property SnapshotGenerationAgentProcessSecurity As IProcessSecurityContext
속성 값

예제

// Set the Publisher, publication database, and publication names.
string publicationName = "AdvWorksProductTran";
string publicationDbName = "AdventureWorks2012";
string publisherName = publisherInstance;

ReplicationDatabase publicationDb;
TransPublication publication;

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


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

	// Enable the AdventureWorks2012 database for transactional publishing.
	publicationDb = new ReplicationDatabase(publicationDbName, conn);

	// If the database exists and is not already enabled, 
	// enable it for transactional publishing.
	if (publicationDb.LoadProperties())
	{
		if (!publicationDb.EnabledTransPublishing)
		{
			publicationDb.EnabledTransPublishing = true;
		}

		// If the Log Reader Agent does not exist, create it.
		if (!publicationDb.LogReaderAgentExists)
		{
			// Specify the Windows account under which the agent job runs.
			// This account will be used for the local connection to the 
			// Distributor and all agent connections that use Windows Authentication.
			publicationDb.LogReaderAgentProcessSecurity.Login = winLogin;
			publicationDb.LogReaderAgentProcessSecurity.Password = winPassword;

			// Explicitly set authentication mode for the Publisher connection
			// to the default value of Windows Authentication.
			publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = true;

			// Create the Log Reader Agent job.
			publicationDb.CreateLogReaderAgent();
		}
	}
	else
	{
		throw new ApplicationException(String.Format(
			"The {0} database does not exist at {1}.",
			publicationDb, publisherName));
	}

	// Set the required properties for the transactional publication.
	publication = new TransPublication();
	publication.ConnectionContext = conn;
	publication.Name = publicationName;
	publication.DatabaseName = publicationDbName;

	// Specify a transactional publication (the default).
	publication.Type = PublicationType.Transactional;

	// Activate the publication so that we can add subscriptions.
	publication.Status = State.Active;

             // Enable push and pull subscriptions and independent Distribition Agents.
             publication.Attributes |= PublicationAttributes.AllowPull;
             publication.Attributes |= PublicationAttributes.AllowPush;
             publication.Attributes |= PublicationAttributes.IndependentAgent;

	// Specify the Windows account under which the Snapshot Agent job runs.
	// This account will be used for the local connection to the 
	// Distributor and all agent connections that use Windows Authentication.
	publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin;
	publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword;

	// Explicitly set the security mode for the Publisher connection
	// Windows Authentication (the default).
	publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = true;

	if (!publication.IsExistingObject)
	{
		// Create the transactional publication.
		publication.Create();

		// Create a Snapshot Agent job for the publication.
		publication.CreateSnapshotAgent();
	}
	else
	{
		throw new ApplicationException(String.Format(
			"The {0} publication already exists.", publicationName));
	}
}

catch (Exception ex)
{
	// Implement custom application error handling here.
	throw new ApplicationException(String.Format(
		"The publication {0} could not be created.", publicationName), ex);
}
finally
{
	conn.Disconnect();
}
' Set the Publisher, publication database, and publication names.
Dim publicationName As String = "AdvWorksProductTran"
Dim publicationDbName As String = "AdventureWorks2012"
Dim publisherName As String = publisherInstance

Dim publicationDb As ReplicationDatabase
Dim publication As TransPublication

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

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

    ' Enable the AdventureWorks2012 database for transactional publishing.
    publicationDb = New ReplicationDatabase(publicationDbName, conn)

    ' If the database exists and is not already enabled, 
    ' enable it for transactional publishing.
    If publicationDb.LoadProperties() Then
        If Not publicationDb.EnabledTransPublishing Then
            publicationDb.EnabledTransPublishing = True
        End If

        ' If the Log Reader Agent does not exist, create it.
        If Not publicationDb.LogReaderAgentExists Then
            ' Specify the Windows account under which the agent job runs.
            ' This account will be used for the local connection to the 
            ' Distributor and all agent connections that use Windows Authentication.
            publicationDb.LogReaderAgentProcessSecurity.Login = winLogin
            publicationDb.LogReaderAgentProcessSecurity.Password = winPassword

            ' Explicitly set authentication mode for the Publisher connection
            ' to the default value of Windows Authentication.
            publicationDb.LogReaderAgentPublisherSecurity.WindowsAuthentication = True

            ' Create the Log Reader Agent job.
            publicationDb.CreateLogReaderAgent()
        End If
    Else
        Throw New ApplicationException(String.Format( _
         "The {0} database does not exist at {1}.", _
         publicationDb, publisherName))
    End If

    ' Set the required properties for the transactional publication.
    publication = New TransPublication()
    publication.ConnectionContext = conn
    publication.Name = publicationName
    publication.DatabaseName = publicationDbName

    ' Specify a transactional publication (the default).
    publication.Type = PublicationType.Transactional

    'Enable push and pull subscriptions and independent Distribition Agents.
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPull
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.AllowPush
    publication.Attributes = _
    publication.Attributes Or PublicationAttributes.IndependentAgent

    ' Activate the publication so that we can add subscriptions.
    publication.Status = State.Active

    ' Specify the Windows account under which the Snapshot Agent job runs.
    ' This account will be used for the local connection to the 
    ' Distributor and all agent connections that use Windows Authentication.
    publication.SnapshotGenerationAgentProcessSecurity.Login = winLogin
    publication.SnapshotGenerationAgentProcessSecurity.Password = winPassword

    ' Explicitly set the security mode for the Publisher connection
    ' Windows Authentication (the default).
    publication.SnapshotGenerationAgentPublisherSecurity.WindowsAuthentication = True

    If Not publication.IsExistingObject Then
        ' Create the transactional publication.
        publication.Create()

        ' Create a Snapshot Agent job for the publication.
        publication.CreateSnapshotAgent()
    Else
        Throw New ApplicationException(String.Format( _
            "The {0} publication already exists.", publicationName))
    End If
Catch ex As Exception
    ' Implement custom application error handling here.
    Throw New ApplicationException(String.Format( _
        "The publication {0} could not be created.", publicationName), ex)
Finally
    conn.Disconnect()
End Try

설명

SnapshotGenerationAgentProcessSecurity 읽기 전용 속성이입니다.SnapshotGenerationAgentProcessSecurity is a read-only property. 반환 된 속성을 사용 하 여 에이전트 보안 컨텍스트를 설정 해야 IProcessSecurityContext 개체입니다.You must set the agent security context using the properties of the returned IProcessSecurityContext object. 에이전트를 구성 하는 연결 및 해당 연결에 대 한 필요한 사용 권한에 대 한 내용은 참조 복제 에이전트 보안 모델합니다.For information about the connections that agents make and the permissions that are required for those connections, see Replication Agent Security Model.

SnapshotGenerationAgentProcessSecurity 의 구성원만 속성을 검색할 수는 sysadmin 고정된 서버 역할의 멤버 또는 게시자에는 db_owner 게시 데이터베이스의 고정된 데이터베이스 역할입니다.The SnapshotGenerationAgentProcessSecurity property can only be retrieved by members of the sysadmin fixed server role at the Publisher or by members of the db_owner fixed database role on the publication database.

반환 된 속성 IProcessSecurityContext 개체의 멤버에 의해 설정 될 수는 sysadmin 고정된 서버 역할의 멤버 또는 게시자에는 db_owner 게시 데이터베이스의 고정된 데이터베이스 역할입니다.Properties of the returned IProcessSecurityContext object can only be set by members of the sysadmin fixed server role at the Publisher or by members of the db_owner fixed database role on the publication database.

검색 된 SnapshotGenerationAgentProcessSecurity 속성은 실행 sp_helppublication_snapshot (Transact SQL)합니다.Retrieving the SnapshotGenerationAgentProcessSecurity property is equivalent to executing sp_helppublication_snapshot (Transact-SQL).

반환 된 속성을 설정 IProcessSecurityContext 개체가 실행 같으면 sp_addpublication_snapshot (Transact SQL)sp_changepublication_snapshot (Transact SQL)합니다.Setting properties of the returned IProcessSecurityContext object is equivalent to executing sp_addpublication_snapshot (Transact-SQL) and sp_changepublication_snapshot (Transact-SQL).

중요

가능한 경우 런타임 시 사용자에게 보안 자격 증명을 입력하라는 메시지가 표시됩니다.When possible, prompt users to enter security credentials at run time. 자격 증명을 저장해야 하는 경우 Windows .NET Framework에서 제공하는 암호화 서비스 를 사용합니다.If you must store credentials, use the cryptographic services provided by the Windows .NET Framework.

적용 대상

추가 정보