Auflisten von Empfangsspeicherorten (BizTalk Server-Beispiel)
Im Beispiel zum Auflisten von Empfangsspeicherorten (Enumerate Receive Locations) wird gezeigt, wie Details zu einem oder mehreren Empfangsspeicherorten abgerufen werden.
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 Windows WMI-Objektmodell 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:
Abfrage nach den konfigurierten Empfangsspeicherorten oder einem bestimmten, mit Namen angegebenen Empfangsspeicherort
Abrufen und Anzeigen von Details zu jedem angegebenen Empfangsspeicherort
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\Enumerate Receive Locations\VBScript\
Visual C#-Version: <Samples Path>\Admin\WMI\Enumerate Receive Locations\CSharp\
In der folgenden Tabelle werden die Dateien in diesem Beispiel samt Zweck beschrieben.
| Datei(en) | BESCHREIBUNG |
|---|---|
| Im Ordner \VBScript: EnumRecLocs.vbs |
VBScript-Datei zum Abrufen von Details zu allen konfigurierten Empfangsspeicherorten |
| Im Ordner \CSharp: App.ico, AssemblyInfo.cs, BTSampleEnumerateRLs.csproj, BTSampleEnumerateRLs.sln, EnumRLs.cs |
Projekt-, Projektmappen- und Quelldateien zum Erstellen einer Visual C#-Befehlszeilenanwendung, mit der Details zu allen konfigurierten Empfangsspeicherorten oder zu einem bestimmten Empfangsspeicherort abgerufen werden |
Erstellen und Initialisieren dieses Beispiels
Die VBScript-Version des Beispiels zum Auflisten von Empfangsspeicherorten besteht aus einer einzigen Visual Basic-Skriptdatei, die nicht erstellt oder initialisiert werden muss.
So erstellen Sie die Visual C#-Version des Beispiels zum Auflisten von Empfangsspeicherorten
Öffnen Sie in Visual Studio die Projektmappendatei BTSampleEnumerateRLs.sln.
Klicken Sie im Menü Erstellen auf Projektmappe erstellen.
Ausführen dieses Beispiels
So führen Sie das Beispiel zum Auflisten von Empfangsspeicherorten aus
Navigieren Sie in einem Befehlszeilenfenster zu einem der folgenden Ordner, je nachdem, ob Sie die VBScript-Version oder die Visual C#-Version des Beispiels ausführen möchten:
<Beispielpfad>\Admin\WMI\Enumerate Receive Locations\VBScript\
<Beispielpfad>\Admin\WMI\Enumerate Receive Locations\CSharp\bin\Debug\
Führen Sie entweder mit dem Programm cscript die Datei EnumRecLocs.vbs aus, oder führen Sie die Datei EnumRl.exe aus, je nachdem, ob Sie die VBScript-Version oder die Visual C#-Version des Beispiels ausführen möchten. Übergeben Sie für die Visual C#-Version eines der beiden folgenden Befehlszeilenargumente:
<ReceiveLocationName>. Der Name des Empfangsspeicherorts, zu dem Details angezeigt werden sollen. Wenn der Name des Empfangsspeicherorts Leerzeichen enthält, muss er in Anführungszeichen eingeschlossen werden.
/?. Zeigt die Hilfe an.
Beispiel (VBScript):
cscript EnumRecLocs.vbs– ODER – (Visual C#):
EnumRl "My Receive Location #3"– ODER – (Visual C#):
EnumRl /?
Hinweis
Für die VBScript-Version des Beispiels können keine Befehlszeilenparameter verwendet werden, weshalb nur Details zu allen konfigurierten Empfangsspeicherorten abgerufen und angezeigt werden können.
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 EnumRecLocs.vbs und die Visual C#-Quelldatei EnumRLs.cs enthalten detaillierte Kommentare mit weiteren Erläuterungen zu den ausgeführten Vorgängen. Weitere Informationen finden Sie unter Windows-Verwaltungsinstrumentation.