MSBTS_ServiceInstance (WMI)

Article
07/21/2023

Fournit une instance d'un service, avec fonctions de démarrage et d'arrêt.

Syntaxe

  
class MSBTS_ServiceInstance : MSBTS_BTSObject

Membres

MSBTS_ServiceInstance définit les propriétés suivantes :

Propriété	Description
ActivationTime	Contient l'heure d'activation d'une instance de service.
AssemblyCulture	Contient la culture de l'assembly .NET qui correspond à l'instance de service à laquelle ce message appartient.
AssemblyName	Contient le nom de l'assembly associé à l'instance du message.
AssemblyPublicKeyToken	Contient le jeton de clé publique de l'assembly .NET qui correspond à l'instance de service à laquelle ce message appartient.
AssemblyVersion	Contient la version de l'assembly .NET qui correspond à l'instance de service à laquelle ce message appartient.
Caption (héritée de `CIM_ManagedSystemElement` )	Pour plus d’informations sur la `CIM_ManagedSystemElement` classe, consultez la documentation de Windows Management Instrumentation à l’adresse https://go.microsoft.com/fwlink/?LinkID=20245.
Description (héritée de `CIM_ManagedSystemElement`)	Pour plus d’informations sur la `CIM_ManagedSystemElement` classe, consultez la documentation de Windows Management Instrumentation à l’adresse https://go.microsoft.com/fwlink/?LinkID=20245.
ErrorCategory	Contient la catégorie d'erreur lorsque l'instance de service est interrompue.
ErrorDescription	Contient la description de l'erreur lorsque l'instance de service est interrompue.
ErrorID	Contient le code d’erreur lors de la suspension du instance de service.
HostName	Contient le nom de l'hôte qui correspond à cette file d'attente.
InstallDate (hérité de `CIM_ManagedSystemElement`)	Pour plus d’informations sur la `CIM_ManagedSystemElement` classe, consultez la documentation de Windows Management Instrumentation à l’adresse https://go.microsoft.com/fwlink/?LinkID=20245.
InstanceID	Contient l'ID de l'instance de service à laquelle appartient ce message.
MgmtDbNameOverride	Remplace la partie catalogue initiale de la chaîne de connexion à la base de données de gestion BizTalk et représente le nom de la base de données. Cette propriété n’a pas été implémentée pour BizTalk Server et est réservée à une utilisation ultérieure.
MgmtDbServerOverride	Remplace la partie source de données de la chaîne de connexion à la base de données de gestion BizTalk. Cette propriété n’a pas été implémentée pour BizTalk Server et est réservée à une utilisation ultérieure.
MsgBoxDBName	Contient le nom de la base de données MessageBox.
MsgBoxDBServerName	Contient le nom du serveur SQL Server hébergeant la base de données MessageBox.
Nom (hérité de `CIM_ManagedSystemElement`)	Pour plus d’informations sur la `CIM_ManagedSystemElement` classe, consultez la documentation de Windows Management Instrumentation à l’adresse https://go.microsoft.com/fwlink/?LinkID=20245.
PendingOperation	Contient le type d'une opération en attente (le cas échéant) pour cette instance de service.
PendingOperationTime	Contient l'heure de la dernière opération en attente.
ServiceClass	Contient le nom de la classe de service correspondant à l'instance de message.
ServiceClassID	Contient l'ID de la classe de service à laquelle appartient l'instance de message.
ServiceName	Contient le nom du service correspondant à l’instance de message.
OrchestrationStatus	Contient l'état de l'instance de service à laquelle appartient ce message.
ServiceTypeID	Contient l'ID du type de service auquel appartient l'instance de message.
État (hérité de `CIM_ManagedSystemElement`)	Pour plus d’informations sur la `CIM_ManagedSystemElement` classe, consultez la documentation de Windows Management Instrumentation à l’adresse https://go.microsoft.com/fwlink/?LinkID=20245.
SuspendTime	Contient l'heure à la quelle l'instance de service a été interrompue.

MSBTS_ServiceInstance définit les méthodes suivantes :

Méthode	Description
Reprendre	Permet à un administrateur de reprendre une instance de service.
Suspendre	Permet à un administrateur d'interrompre une instance de service.
Terminer.	Permet à un administrateur de terminer une instance de service.

Exemple

L'exemple suivant montre comment limiter les résultats des requêtes WMI effectuées sur les classes WMI MSBTS_ServiceInstance et MSBTS_MessageInstance. Ces deux classes WMI prennent en charge les propriétés de contexte WMI qui permettent de limiter un ensemble de résultats. Cette limitation est nécessaire au vu du nombre parfois important d'instances de service ou de message concernées. Ce n'est pas le cas des autres classes WMI de BizTalk et le contexte WMI ne doit pas être utilisé avec ces classes.

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

Aucun exemple C# n'est fourni.

Remarques

Cette classe peut comporter de nombreuses instances : l'énumération de toutes ces classes peut prendre du temps et consommer inutilement les ressources de la base de données MessageBox. Si l'ID de l'instance de service est connu, utilisez-le pour spécifier l'instance de message dans les recherches effectuées dans la base de données. Par exemple : select * from MSBTS_ServiceInstance where ServiceInstanceID= "GUID". WMI analysera WQL pour extraire l'ID de service à partir de la requête et récupérer uniquement les instances qui correspondent aux ID spécifiés.

Configuration requise

En-tête : déclaré dans BTSWMISchema2K.mof ou BTSWMISchemaXP.mof.

Espace de noms : inclus dans \root\MicrosoftBizTalkServer.

Partager via