ApplicationManager (ejemplo de BizTalk Server)

Artículo
07/21/2023

En el ejemplo ApplicationManager se muestra cómo iniciar o detener una aplicación de BizTalk mediante los objetos de administración.

Requisitos previos

Debe tener BizTalk Server privilegios administrativos para usar los objetos administrativos de este ejemplo.
El script de Windows PowerShell requiere que la directiva de ejecución de Windows PowerShell permita la ejecución de scripts. Para obtener más información, vea about_Execution_Policies.

Descripción del ejemplo

En este ejemplo se muestra cómo usar las clases BtsCatalogExplorer y Application del espacio de nombres Microsoft.BizTalk.ExplorerOM para iniciar y detener una aplicación de BizTalk implementada. El ejemplo se escribe en Microsoft Visual C#. En este tema también se incluye un script de ejemplo de Windows PowerShell. El ejemplo muestra las siguientes operaciones:

Conectarse a la base de datos de administración de BizTalk mediante la clase BtsCatalogExplorer .
Búsqueda de una instancia de aplicación de BtsCatalogExplorer basada en el nombre de la aplicación.
Envío de un comando de inicio o detención para la aplicación.

Dónde encontrar este ejemplo

El ejemplo se encuentra en la siguiente ubicación del SDK:

<Ruta de acceso de> ejemplos\Administración\ExplorerOM\ApplicationManager

En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.

Archivos	Descripción
Program.cs	Archivo de origen de Visual C# para las operaciones que se muestran en este ejemplo.
ApplicationManager.sln,ApplicationManager.csproj,ApplicationManager.suo	Archivos de solución y proyecto para el ejemplo.

Generación y ejecución del ejemplo

Compilación de este ejemplo

En Visual Studio, abra el archivo de solución ApplicationManager.sln.
En el menú Compilar , haga clic en Compilar solución.

Ejecutar esta muestra

Abra una ventana de comandos y desplácese a la siguiente carpeta:

<Ruta de acceso de> ejemplos\Administración\ExplorerOM\ApplicationManager\bin\Debug
Ejecute el archivo ApplicationManager.exe y proporcione los dos siguientes argumentos de línea de comandos en el orden indicado:
- <start|stop> Primer argumento es la operación que se va a realizar en la aplicación implementada.
- <El argumento ApplicationName> Second es el nombre de la aplicación implementada.
  
  Por ejemplo:
```
ApplicationManager.exe stop MyBizTalkApp
```
Si se ejecuta el ejemplo con parámetros de línea de comandos insuficientes, se muestra la sintaxis de uso. Por ejemplo:
```
Usage:

ApplicationManager <start|stop> <Application Name>

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

Example: ApplicationManager start Application1
```

Ejemplo de un script de Windows PowerShell

El siguiente fragmento de script de Windows PowerShell se puede usar para mostrar las mismas características de las clases 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()
        }

    }
}

El script espera los mismos argumentos de línea de comandos que el ejemplo de Visual C#. Aquí se muestra un ejemplo de ejecución del script de Windows PowerShell para iniciar una aplicación BizTalk implementada:

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

Issuing start command to MyBizTalkApp ...

Consulte también

Admin\ExplorerOM (carpeta de ejemplos de BizTalk Server)

Compartir a través de