MSBTS_ServiceInstance (WMI)
開始と停止の機能を持つサービスのインスタンスを提供します。
構文
class MSBTS_ServiceInstance : MSBTS_BTSObject
メンバー
MSBTS_ServiceInstance は次の特性を定義します。
| プロパティ | 説明 |
|---|---|
| ActivationTime | サービス インスタンスのアクティブ化時間を表します。 |
| AssemblyCulture | このメッセージが属するサービス インスタンスに対応する .NET アセンブリのカルチャを表します。 |
| AssemblyName | メッセージ インスタンスに関連付けられているアセンブリの名前を表します。 |
| AssemblyPublicKeyToken | .NET アセンブリの公開キー トークンを表します。このトークンは、このメッセージが属するサービス インスタンスに対応しています。 |
| AssemblyVersion | このメッセージが属するサービス インスタンスに対応する .NET アセンブリのバージョンを表します。 |
Caption ( から継承CIM_ManagedSystemElement) |
クラスの CIM_ManagedSystemElement 詳細については、 の Windows Management Instrumentation のドキュメントを参照してください https://go.microsoft.com/fwlink/?LinkID=20245。 |
説明 (から CIM_ManagedSystemElement継承) |
クラスの CIM_ManagedSystemElement 詳細については、 の Windows Management Instrumentation のドキュメントを参照してください https://go.microsoft.com/fwlink/?LinkID=20245。 |
| ErrorCategory | サービス インスタンス中断時のエラー カテゴリを表します。 |
| ErrorDescription | サービス インスタンス中断時のエラーの説明が格納されます。 |
| ErrorID | サービス インスタンスが中断されたときのエラー コードを格納します。 |
| HostName | このキューに対応するホストの名前を表します。 |
InstallDate (から CIM_ManagedSystemElement継承) |
クラスの CIM_ManagedSystemElement 詳細については、 の Windows Management Instrumentation のドキュメントを参照してください https://go.microsoft.com/fwlink/?LinkID=20245。 |
| InstanceID | このメッセージが属するサービス インスタンスの ID を表します。 |
| MgmtDbNameOverride | BizTalk 管理データベース接続文字列の初期カタログ部分をオーバーライドし、データベース名を表します。 このプロパティはBizTalk Server用に実装されておらず、将来の使用のために予約されています。 |
| MgmtDbServerOverride | BizTalk 管理データベース接続文字列のデータ ソース部分をオーバーライドします。 このプロパティはBizTalk Server用に実装されておらず、将来の使用のために予約されています。 |
| MsgBoxDBName | メッセージ ボックス データベースの名前を表します。 |
| MsgBoxDBServerName | メッセージ ボックス データベースがある SQL Server の名前を表します。 |
Name (から CIM_ManagedSystemElement継承) |
クラスの CIM_ManagedSystemElement 詳細については、 の Windows Management Instrumentation のドキュメントを参照してください https://go.microsoft.com/fwlink/?LinkID=20245。 |
| PendingOperation | 保留中の操作がある場合に、このサービス インスタンスに対する保留中の操作の種類が格納されます。 |
| PendingOperationTime | 最後に保留された操作の時刻を表します。 |
| ServiceClass | メッセージ インスタンスに対応するサービス クラスの名前を表します。 |
| ServiceClassID | メッセージ インスタンスが属するサービス クラスの ID を表します。 |
| ServiceName | メッセージ インスタンスに対応するサービスの名前を表します。 |
| OrchestrationStatus | このメッセージが属するサービス インスタンスの状態を表します。 |
| ServiceTypeID | メッセージ インスタンスが属するサービスの種類の ID が格納されます。 |
Status (Inherited from CIM_ManagedSystemElement) |
クラスの CIM_ManagedSystemElement 詳細については、 の Windows Management Instrumentation のドキュメントを参照してください https://go.microsoft.com/fwlink/?LinkID=20245。 |
| SuspendTime | サービス インスタンスが中断された時刻を表します。 |
MSBTS_ServiceInstance は、次のメソッドを定義します。
| Method | 説明 |
|---|---|
| 再開 | 管理者がサービスのインスタンスを再開できます。 |
| [中断] | 管理者がサービスのインスタンスを中断できます。 |
| Terminate | 管理者がサービスのインスタンスを終了できます。 |
例
次の例は、MSBTS_ServiceInstance および MSBTS_MessageInstance WMI クラスに対する WMI クエリの結果を制限する方法について示しています。 これらの 2 つの WMI クラスは、結果セットを制限できる WMI コンテキスト プロパティをサポートしています。 サービス インスタンスまたはメッセージ インスタンスの数が非常に多くなる場合があるので、この方法が必要になります。 この方法は他の BizTalk WMI クラスには該当しません。WMI コンテキストをこれらのクラスには使用しないでください。
EnumAllInstances
If Err <> 0 Then
PrintWMIErrorThenExit Err.Description, Err.Number
End If
Sub EnumAllInstances
Dim Context, FromTime, UntilTime, InstSet, Query
wbemFlagReturnImmediately = 16 '0x10
Set Context = CreateObject("WbemScripting.SWbemNamedValueSet")
Set FromTime = CreateObject("WbemScripting.SWbemDateTime")
Set UntilTime = CreateObject("WbemScripting.SWbemDateTime")
FromTime.Year = 2003
UntilTime.Year = 2003
UntilTime.Month = 3
UntilTime.Day = 26
UntilTime.Hours = 19
UntilTime.Minutes = 32
Context.Add "From", FromTime.Value
Context.Add "Until", UntilTime.Value
Context.Add "IterationDelayMS", 10
Query = "SELECT * FROM MSBTS_ServiceInstance"
Set InstSet = GetObject("Winmgmts:!root\MicrosoftBizTalkServer").ExecQuery(Query, "WQL", wbemFlagReturnImmediately, Context)
If Err <> 0 Then
PrintWMIErrorThenExit Err.Description, Err.Number
End If
For Each Inst In InstSet
wscript.echo Inst.InstanceID + " " + Inst.HostName
Next
End Sub
Sub PrintWMIErrorThenExit(strErrDesc, ErrNum)
On Error Resume Next
Dim objWMIError : Set objWMIError = CreateObject("WbemScripting.SwbemLastError")
If ( TypeName(objWMIError) = "Empty" ) Then
wscript.echo strErrDesc & " (HRESULT: " & Hex(ErrNum) & ")."
Else
wscript.echo objWMIError.Description & "(HRESULT: " & Hex(ErrNum) & ")."
Set objWMIError = nothing
End If
End Sub
C# のサンプルは提供されていません。
解説
このクラスには多くのインスタンスが含まれている場合があり、これらのクラスをすべて列挙すると処理が遅くなり、メッセージ ボックス データベースのリソースが不要に消費される場合があります。 サービス インスタンスの ID がわかっている場合は、データベースの検索でその ID を使用してメッセージ インスタンスを指定してください。 たとえば、「 select * from MSBTS_ServiceInstance where ServiceInstanceID= "GUID" 」のように入力します。 WMI では WQL を解析してクエリからサービス ID を取得し、指定した ID に一致するインスタンスのみを取得します。
必要条件
ヘッダー: BTSWMISchema2K.mof または BTSWMISchemaXP.mof で宣言
名前空間: \root\MicrosoftBizTalkServer