ApplicationManager (esempio di BizTalk Server)

Articolo
10/14/2023

L'esempio ApplicationManager illustra come avviare o arrestare un'applicazione BizTalk usando gli oggetti di amministrazione.

Prerequisiti

È necessario disporre di BizTalk Server privilegi amministrativi per usare gli oggetti amministrativi in questo esempio.
L'esecuzione dello script di Windows PowerShell richiede i criteri di esecuzione di Windows PowerShell. Per altre informazioni, vedere about_Execution_Policies.

Scopo dell'esempio

Questo esempio illustra l'uso delle classi BtsCatalogExplorer e Application dallo spazio dei nomi Microsoft.BizTalk.ExplorerOM per avviare e arrestare un'applicazione BizTalk distribuita. L'esempio viene scritto in Microsoft Visual C#. In questo argomento è inoltre incluso uno script di esempio Windows PowerShell. Nell'esempio vengono illustrate le operazioni seguenti:

Connessione al database di Gestione BizTalk usando la classe BtsCatalogExplorer .
Ricerca di un'istanza dell'applicazione da BtsCatalogExplorer in base al nome dell'applicazione.
Invio di un comando di avvio o di arresto per l'applicazione.

Percorso dell'esempio

L'esempio è disponibile nel seguente percorso dell'SDK:

<Percorso> esempi\Amministrazione\ExplorerOM\ApplicationManager

Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.

File	Descrizione
Program.cs	File di origine visual C# per le operazioni illustrate in questo esempio.
ApplicationManager.sln, ApplicationManager.csproj, ApplicationManager.suo	File di soluzione e di progetto per l'esempio.

Compilazione ed esecuzione dell'esempio

Compilare questo esempio

In Visual Studio aprire il file di soluzione ApplicationManager.sln.
Nel menu Compila scegliere Compila soluzione.

Esegui questo esempio

Aprire una finestra di comando e passare alla cartella seguente:

<Percorso> esempi\Amministrazione\ExplorerOM\ApplicationManager\bin\Debug
Eseguire il file ApplicationManager.exe specificando i seguenti due argomenti della riga di comando ordinati:
- <start|stop> First argomento è l'operazione da eseguire nell'applicazione distribuita.
- <L'argomento ApplicationName> Second è il nome dell'applicazione distribuita.
  
  Ad esempio:
```
ApplicationManager.exe stop MyBizTalkApp
```
Se si esegue l'esempio con parametri della riga di comando insufficienti, viene visualizzata la sintassi. Ad esempio:
```
Usage:

ApplicationManager <start|stop> <Application Name>

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

Example: ApplicationManager start Application1
```

Esempio di script di Windows PowerShell

Il frammento di script Windows PowerShell seguente può essere usato per illustrare le stesse funzionalità delle classi 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()
        }

    }
}

Lo script prevede gli stessi argomenti della riga di comando dell'esempio Visual C#. Di seguito viene riportato un esempio di esecuzione dello script di Windows PowerShell per avviare un'applicazione BizTalk distribuita:

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

Issuing start command to MyBizTalkApp ...

Vedere anche

Admin-ExplorerOM (cartella di esempi di BizTalk Server)

Condividi tramite