PublisherMonitor.EnumMergeAgentSessions2(String, Int32, Boolean) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

マージエージェントセッションに関する追加情報を返します。

public:
 System::Data::DataSet ^ EnumMergeAgentSessions2(System::String ^ agentName, int sessionDuration, bool returnOnlyErrorSessions);

public System.Data.DataSet EnumMergeAgentSessions2 (string agentName, int sessionDuration, bool returnOnlyErrorSessions);

member this.EnumMergeAgentSessions2 : string * int * bool -> System.Data.DataSet

Public Function EnumMergeAgentSessions2 (agentName As String, sessionDuration As Integer, returnOnlyErrorSessions As Boolean) As DataSet

マージエージェントジョブの名前を指定する String 値です。 SynchronizationAgentName オブジェクトの MergeSubscription プロパティを使用して、この値を取得できます。

結果の制限範囲を示す現在の時刻までの時間数を指定する Int32 値です。たとえば、値 24 は、現在までの過去 24 時間の間のエージェントセッションに関する情報を返します。値 -1 は、現在までの過去 100 セッションに関する情報を返し、値 0 はすべてのセッションに関する情報を返します。

Booleanエラーが発生したセッションに関する情報のみを返すか、すべてのセッションで情報を返すかを示す値。 true の場合、エラーセッションのみが返されます。 false の場合、すべてのセッションが返されます。

DataSet

次の列を含む DataSet オブジェクトです。

列	データ型	説明
Session_id	Int32	エージェントジョブセッションの ID。
Status	Int32	エージェントの実行状態: 1 = 開始 2 = 成功 3 = 進行中 4 = アイドル 5 = 再試行 6 = 失敗
StartTime	DateTime	エージェントジョブセッションが開始した時刻です。
EndTime	DateTime	エージェントジョブセッションが完了した時刻です。
Duration	Int32	エージェントジョブセッションの累積時間 (秒) です。
UploadedCommands	Int32	エージェントジョブセッションの間にアップロードされたコマンド数です。
DownloadedCommands	Int32	エージェントジョブセッションの間にダウンロードされたコマンド数です。
ErrorMessages	Int32	エージェントジョブセッションの間に生成されたエラーメッセージの数です。
ErrorID	Int32	発生したエラーの ID です。
PercentageDone	Decimal	アクティブなセッションで既に配信された総変更数の推定割合です。
TimeRemaining	Int32	アクティブなセッションの残りの推定秒数。
CurrentPhase	Int32	アクティブなセッションの現在のフェーズです。次のいずれかの値をとります。 1 = アップロード 2 = ダウンロード
LastMessage	String	セッション中にマージエージェントによってログに記録された最後のメッセージです。

PublisherMonitor オブジェクトのプロパティがまだ読み込まれていない場合は、読み込むことが必要になる可能性があるため、このメソッドを呼び出す前にこのオブジェクトのプロパティに対する変更をすべてコミットする必要があります。

メソッドはEnumMergeAgentSessions2、ディストリビューションデータベースのまたは replmonitor 固定データベースロールのdb_ownerメンバーによってのみ呼び出すことができます。