ApplicationManager (exemple BizTalk Server)

Article
07/21/2023

L’exemple ApplicationManager montre comment démarrer ou arrêter une application BizTalk à l’aide des objets d’administration.

Prérequis

Vous devez disposer BizTalk Server privilèges d’administration pour utiliser les objets administratifs de cet exemple.
La stratégie d'exécution de Windows PowerShell doit autoriser l'exécution des scripts. Pour plus d’informations, consultez about_Execution_Policies.

Fonctions de l'exemple

Cet exemple illustre l’utilisation des classes BtsCatalogExplorer et Application de l’espace de noms Microsoft.BizTalk.ExplorerOM pour démarrer et arrêter une application BizTalk déployée. L’exemple est écrit dans Microsoft Visual C#. Un exemple de script Windows PowerShell est également inclus dans cette rubrique. Il illustre les opérations suivantes :

Connexion à la base de données BizTalk Management à l’aide de la classe BtsCatalogExplorer .
La recherche d’une application instance à partir de BtsCatalogExplorer en fonction du nom de l’application.
soumission d'une commande de démarrage ou d'arrêt pour l'application.

Accès à l'exemple

L'exemple se trouve dans l'emplacement SDK suivant :

<Chemin d’accès> des exemples\Administration\ExplorerOM\ApplicationManager

Le tableau suivant présente les fichiers de cet exemple et décrit leur fonction.

Fichier(s)	Description
Program.cs	Fichier source Visual C# pour les opérations illustrées dans cet exemple.
ApplicationManager.sln,ApplicationManager.csproj,ApplicationManager.suo	Fichiers de projet et de solution de l'exemple.

Création et exécution de l'exemple

Générer cet exemple

Dans Visual Studio, ouvrez le fichier solution ApplicationManager.sln.
Dans le menu Générer, cliquez sur Générer la solution.

Exécuter cet exemple

Ouvrez une fenêtre de commande, puis accédez au dossier suivant :

<Chemin d’accès> des exemples\Administration\ExplorerOM\ApplicationManager\bin\Debug
Exécutez le fichier ApplicationManager.exe en indiquant les deux arguments de ligne de commande suivants dans cet ordre :
- <start|stop> Premier argument est l’opération à effectuer sur l’application déployée.
- <ApplicationName> Deuxième argument est le nom de l’application déployée.
  
  Par exemple :
```
ApplicationManager.exe stop MyBizTalkApp
```
L'exécution de l'exemple avec des paramètres de ligne de commande insuffisants affiche la syntaxe d'utilisation. Par exemple :
```
Usage:

ApplicationManager <start|stop> <Application Name>

Where:
  <Application Name> = The name of the application that needs to be changed

Example: ApplicationManager start Application1
```

Exemple de script Windows PowerShell

Le fragment de script Windows PowerShell suivant peut être utilisé pour illustrer les mêmes fonctionnalités que les classes ExplorerOM :

#=== Make sure the ExplorerOM assembly is loaded ===#

[void] [System.reflection.Assembly]::LoadWithPartialName("Microsoft.BizTalk.ExplorerOM")

#=== Connect the BizTalk Management database ===#

$Catalog = New-Object Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer
$Catalog.ConnectionString = "SERVER=.;DATABASE=BizTalkMgmtDb;Integrated Security=SSPI"

#=== Loop through applications in the catalog trying to find a name match ===#

foreach($app in $Catalog.Applications)
{
    if ($($app.Name) -ieq $args[1])
    {

        #=== The first command-line argument should be "start" or "stop" ===#

        if ($args[0] -ieq "start")
        {
            Write-Host `r`nIssuing start command to $app.Name...`r`n
            $app.Start([Microsoft.BizTalk.ExplorerOM.ApplicationStartOption] "StartAll")
            $Catalog.SaveChanges()
        }

        if ($args[0] -ieq "stop")
        {
            Write-Host `r`nIssuing stop command to $app.Name...`r`n
            $app.Stop([Microsoft.BizTalk.ExplorerOM.ApplicationStopOption] "StopAll")
            $Catalog.SaveChanges()
        }

    }
}

Le script attend les mêmes arguments de ligne de commande que l’exemple Visual C#. Voici un exemple d'exécution du script Windows PowerShell pour démarrer une application BizTalk déployée :

PS C:\> .\ApplicationManager.ps1 start MyBizTalkApp

Issuing start command to MyBizTalkApp ...

Voir aussi

Admin-ExplorerOM (dossier d’exemples BizTalk Server)

Partager via