Eintragen der Orchestrierung (BizTalk Server-Beispiel)
Das Beispiel für das Eintragen der Orchestrierung zeigt, wie eine BizTalk Server-Orchestrierung für einen Host eingetragen wird.
Warnung
Bereitstellungsskripts sollten nach einer Bereitstellung entfernt werden (wenn sie nicht mehr benötigt werden). Verwaltungsskripts und andere Skripts, die vorhanden sein müssen, sollten über die Zugriffssteuerungsliste geschützt und genau überwacht werden.
Ziel des Beispiels
Dieses Beispiel umfasst eine VbScript-Version (Visual Basic Scripting Edition), die auf das WMI-Objektmodell (Windows Management Instrumentation) zugreift, und eine Visual C#-Version, die auf die vom .NET Framework bereitgestellten System.Management-Objekte zugreift. Beide Versionen greifen letztlich auf den BizTalk Server-WMI-Anbieter zu, um die folgenden Vorgänge auszuführen:
Ausführen einer Abfrage nach einer bestimmten bereitgestellten BizTalk Server-Orchestrierung, nachdem ein Orchestrierungsname und ein Assemblyname übergeben wurden.
Eintragen dieser Orchestrierung für den Standardhost.
Behandeln von Fehlern, damit sinnvolle Informationen an den Benutzer zurückgegeben werden
Speicherort dieses Beispiels
Die Beispiele sind in den folgenden SDK-Verzeichnissen gespeichert:
VBScript-Version: <Samples Path>\Admin\WMI\Enlist Orchestration\VBScript\
Visusal C#-Version: <Samples Path>\Admin\WMI\Enlist Orchestration\CSharp\
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
| Datei(en) | BESCHREIBUNG |
|---|---|
| Im Ordner \VBScript: EnlistOrch.vbs |
Eine VBScript-Datei, die Parameter annimmt, um eine Orchestrierung anzugeben, die für einen Host eingetragen werden soll. |
| Im Ordner \CSharp: App.ico, AssemblyInfo.cs, BTSampleEnumerateRLs.csproj, BTSampleEnumerateRLs.sln, EnumRLs.cs |
Projekt-, Projektmappen- und Quelldateien zum Erstellen einer Visual C#-Befehlszeilenanwendung, die Parameter annimmt, um eine Orchestrierung anzugeben, die für einen Host eingetragen werden soll. |
Erstellen und Initialisieren dieses Beispiels
Die VBScript-Version des Beispiels zum Eintragen einer Orchestrierung besteht aus einer einzigen Visual Basic-Skriptdatei, die nicht erstellt oder initialisiert werden muss.
So erstellen Sie die Visual C#-Version des Beispiels zum Eintragen einer Orchestrierung
Öffnen Sie in Visual Studio die Projektmappendatei BTSampleEnlistOrc.sln.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.
So führen Sie das Beispiel zum Eintragen einer Orchestrierung aus
Navigieren Sie in einem Befehlsfenster zu einem der folgenden Ordner, je nachdem, ob Sie die VBScript-Version bzw. die Visual C#-Version dieses Beispiels ausführen möchten:
<Beispielpfad>\Admin\WMI\Enlist Orchestration\VBScript\
<Beispielpfad>AdminWMIEnlist OrchestrationCSharpbinDebug
Führen Sie entweder mit dem Programm cscript die Datei EnlistOrch.vbs aus, oder führen Sie die Datei EnlistOrc.exe aus, je nachdem, ob Sie die VBScript-Version oder die Visual C#-Version des Beispiels ausführen möchten. Übergeben Sie in beiden Fällen die folgenden Befehlszeilenargumente:
<OrchestrationName>. Der Name der Orchestrierung, die eingetragen werden soll.
<AssemblyName>. Der Name der Assembly, in der die Orchestrierung bereitgestellt wurde. Wenn der Assemblyname Leerzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.
Beispiel: (VBScript):
cscript EnlistOrch.vbs MyBusinessOrchestration "My Business Assembly"– ODER – (Visual C#):
EnlistOrc MyBusinessOrchestration "My Business Assembly"
Kommentare
Alle Aufgaben, die Sie in der BizTalk Server-Verwaltungskonsole ausführen können, können auch mithilfe eines Skripts ausgeführt werden, das auf das Windows WMI-Objektmodell zugreift, und mithilfe von Visual C#, das auf die vom .NET Framework bereitgestellten System.Management-Objekte zugreift.
Die Skriptdatei EnlistOrch.vbs und die Visual C#-Quelldatei EnlistOrc.cs enthalten detaillierte Kommentare mit weiteren Erläuterungen zu den ausgeführten Vorgängen. Weitere Informationen finden Sie unter Windows-Verwaltungsinstrumentation.