Enumerar ubicaciones de recepción (ejemplo de BizTalk Server)
El ejemplo Enumerar ubicaciones de recepción demuestra cómo recuperar detalles sobre una o varias ubicaciones de recepción.
Advertencia
Las secuencias de comandos de implementación se deben quitar después de la implementación si no son necesarias. La lista de control de acceso (ACL) debe proteger y supervisar detalladamente las secuencias de comandos de administración y otras secuencias de comandos que deben permanecer.
Descripción del ejemplo
En este ejemplo se incluye una versión de Visual Basic Scripting Edition (VBScript) que accede al modelo de objetos WMI de Windows y una versión de Visual C# que accede a los objetos System.Management proporcionados por .NET Framework. Ambas versiones obtienen acceso finalmente al proveedor WMI de BizTalk Server para llevar a cabo las siguientes operaciones:
Consultar el conjunto de ubicaciones de recepción configuradas, o bien una ubicación de recepción por su nombre.
Recuperar y mostrar detalles sobre cada ubicación de recepción de interés.
Administrar errores tales como la devolución al usuario de información significativa.
Ubicación del ejemplo
Estos ejemplos se encuentran en las siguientes ubicaciones de SDK:
Versión de VBScript: <Ruta de acceso> de ejemplos\Administración\WMI\Enumerar ubicaciones de recepción\VBScript\
Versión de Visual C#: <Ruta de acceso> de ejemplos\Administración\WMI\Enumerar ubicaciones de recepción\CSharp\
En la tabla siguiente se enumeran los archivos del ejemplo y se describe su propósito.
| Archivos | Descripción |
|---|---|
| En la carpeta \VBScript: EnumRecLocs.vbs |
El archivo VBScript que recupera los detalles sobre todas las ubicaciones de recepción configuradas. |
| En la carpeta \CSharp: App.ico, AssemblyInfo.cs, BTSampleEnumerateRLs.csproj, BTSampleEnumerateRLs.sln, EnumRLs.cs |
Archivos de proyecto, de solución y de origen para generar una aplicación de línea de comandos de Visual C# que recupere los detalles de todas las ubicaciones de recepción configuradas o de una ubicación de recepción específica. |
Crear e inicializar este ejemplo
La versión de VBScript de la muestra Enumerar ubicaciones de recepción consta de un archivo de secuencias de comandos de Visual Basic que no necesita generar o inicializar.
Para generar la versión de Visual C# del ejemplo Enumerar ubicaciones de recepción
En Visual Studio, abra el archivo de solución BTSampleEnumerateRLs.sln.
En el menú Compilar , haga clic en Compilar solución.
Ejecución del ejemplo
Para ejecutar el ejemplo Enumerar ubicaciones de recepción
En una ventana de comandos, desplácese hasta una de las siguientes carpetas, en función de si va a ejecutar la versión de VBScript o la versión de Visual C# de este ejemplo, respectivamente:
<Ruta de acceso de> ejemplos\Administración\WMI\Enumerar ubicaciones de recepción\VBScript\
<Ruta de acceso de> ejemplos\Administración\WMI\Enumerar ubicaciones de recepción\CSharp\bin\Debug\
Ejecute el archivo EnumRecLocs.vbs que usa el programa Cscript, o ejecute el archivo EnumRl.exe, en función de si va a ejecutar la versión de VBScript o la versión de Visual C# de este ejemplo, respectivamente: Para la versión de Visual C#, pase uno de los dos siguientes argumentos de línea de comandos:
<ReceiveLocationName>. El nombre de la ubicación de recepción para la que se mostrarán los detalles. Si el nombre de la ubicación de recepción contiene espacios, enciérrelo entre comillas.
/?. Muestra información de ayuda.
Por ejemplo (VBScript):
cscript EnumRecLocs.vbs-O bien- (Visual C#):
EnumRl "My Receive Location #3"-O bien- (Visual C#):
EnumRl /?
Nota
La versión de VBScript de este ejemplo no acepta ningún parámetro de línea de comandos y, por lo tanto, sólo es capaz de recuperar y mostrar detalles de todas las ubicaciones de recepción configuradas.
Comentarios
Todas las tareas que puede realizar en la consola de administración de BizTalk Server también se pueden realizar mediante el script que accede al modelo de objetos WMI de Windows y mediante Visual C# que accede a los objetos System.Management proporcionados por .NET Framework.
El archivo de secuencias de comandos EnumRecLocs.vbs y el archivo de origen de Visual C# EnumRLs.cs contienen comentarios detallados con más explicaciones sobre las operaciones que realizan. Para obtener más información, vea Instrumental de administración de Windows.