Enumerate Receive Locations (esempio di BizTalk Server)
Nell'esempio Enumerate Receive Locations viene illustrato come recuperare informazioni dettagliate su uno o più indirizzi di ricezione.
Avviso
Dopo la distribuzione, rimuovere gli script di distribuzione se non sono necessari. Gli script di amministrazione e gli altri script da non rimuovere devono essere protetti mediante elenchi di controllo di accesso (ACL, Access Control List) e accuratamente monitorati.
Scopo dell'esempio
Questo esempio include una versione di Visual Basic Scripting Edition (VBScript) che accede al modello a oggetti WMI di Windows e una versione di Visual C# che accede agli oggetti System.Management forniti da .NET Framework. Entrambe queste versioni infine accedono al provider WMI di BizTalk Server per effettuare le seguenti operazioni:
Esecuzione di query sul set di indirizzi di ricezione configurato o su un indirizzo di ricezione specifico, di cui viene indicato il nome.
Recupero e visualizzazione di informazioni dettagliate relative a ogni indirizzo di ricezione di interesse.
Gestire gli eventuali errori in modo che all'utente vengano restituite informazioni significative.
Percorso dell'esempio
Gli esempi sono contenuti nei seguenti percorsi dell'SDK:
Versione VBScript: <Percorso> esempi\Amministrazione\WMI\Enumerate Receive Locations\VBScript\
Versione di Visual C#: <Samples Path>\Amministrazione\WMI\Enumerate Receive Locations\CSharp\
Nella seguente tabella sono riportati i file inclusi nell'esempio e ne viene descritto lo scopo.
| File | Descrizione |
|---|---|
| Nella cartella \VBScript: EnumRecLocs.vbs |
File VBScript che recupera i dettagli relativi a tutti gli indirizzi di ricezione configurati. |
| Nella cartella \CSharp: App.ico, AssemblyInfo.cs, BTSampleEnumerateRLs.csproj, BTSampleEnumerateRLs.sln, EnumRLs.cs |
File di progetto, di soluzione e di origine per la compilazione di un'applicazione da riga di comando in Visual C# che recupera i dettagli di tutti gli indirizzi di ricezione configurati o di un indirizzo di ricezione specifico. |
Compilazione e inizializzazione dell'esempio
La versione VBScript dell'esempio Enumerate Receive Locations è costituita da un singolo file di script di Visual Basic che non è necessario compilare o inizializzare.
Per compilare la versione Visual C# dell'esempio Enumerate Receive Locations
In Visual Studio aprire il file di soluzione BTSampleEnumerateRLs.sln.
Scegliere Compila soluzione dal menu Compila.
Esecuzione dell'esempio
Per eseguire l'esempio Enumerate Receive Locations
In una finestra di comando passare a una delle cartelle seguenti, a seconda che venga eseguita rispettivamente la versione VBScript o la versione Visual C# di questo esempio:
<Percorso esempi>\Amministrazione\WMI\Enumerate Receive Locations\VBScript\
<Percorso esempi>\Amministrazione\WMI\Enumerate Receive Locations\CSharp\bin\Debug\
Eseguire il file EnumRecLocs.vbs tramite il programma cscript oppure il file EnumRl.exe, a seconda che venga eseguita rispettivamente la versione VBScript o la versione Visual C# di questo esempio. Per la versione Visual C# passare uno dei due argomenti della riga di comando seguenti:
<ReceiveLocationName>. Nome dell'indirizzo di ricezione per il quale verranno visualizzati i dettagli. Se il nome dell'indirizzo di ricezione contiene spazi, racchiuderlo tra virgolette.
/?. Visualizza la Guida.
Ad esempio (VBScript):
cscript EnumRecLocs.vbs- oppure - (Visual C#):
EnumRl "My Receive Location #3"- oppure - (Visual C#):
EnumRl /?
Nota
La versione VBScript di questo esempio non accetta parametri della riga di comando, pertanto consente solo di recuperare e visualizzare dettagli relativi a tutti gli indirizzi di ricezione configurati.
Commenti
Tutte le attività che è possibile eseguire nella console di amministrazione di BizTalk Server possono essere eseguite anche tramite script che accede al modello a oggetti WMI di Windows e tramite Visual C# che accede agli oggetti System.Management forniti da .NET Framework.
Il file di script EnumRecLocs.vbs e il file di origine Visual C# EnumRLs.cs contengono commenti con spiegazioni aggiuntive sulle operazioni che eseguono. Per altre informazioni, vedere Strumentazione gestione Windows.