Reemplazar la utilidad de token de clave pública

Esta utilidad se puede usar para reemplazar un token de clave pública o una variable en un archivo con un token de clave pública derivado de un archivo de clave de ensamblado de nombre seguro (.snk).

Esta utilidad puede ser útil cuando un desarrollador está escribiendo un script que usa btSTask Command-Line referencia para implementar un ensamblado. Para que la implementación se realice correctamente, se debe proporcionar el nombre completo del ensamblado, que incluye su token de clave pública. El token de clave pública de un ensamblado se extrae de un archivo .snk y se asigna al ensamblado cuando se compila. Sin embargo, antes de implementar el ensamblaje en un nuevo entorno, con frecuencia se reconstruye utilizando un token de clave pública diferente. Como resultado, es posible que el desarrollador no sepa qué token de clave pública se usará para el ensamblado cuando se ejecute el script de implementación.

Hay dos maneras de usar la utilidad Reemplazar token de clave pública para solucionar esta situación:

  • Escenario 1. En el script de implementación, el desarrollador puede usar un token de clave pública o un marcador de posición que represente el token de clave pública. Antes de ejecutar el script, un usuario puede ejecutar la utilidad Reemplazar token de clave pública para sustituir el token de clave pública o el marcador de posición en el archivo de script por el token de clave pública extraído del archivo .snk que se usó para compilar el ensamblado para el entorno de destino.

  • Escenario 2. El desarrollador puede configurar el script para sustituir automáticamente el nuevo token de clave pública, como se indica a continuación: Al principio del script, invoque la utilidad Reemplazar token de clave pública y apunte a un archivo .snk que contiene el token de clave pública. En el script, use la variable de entorno %NEWTOKEN% para representar el token de clave pública. Cuando se ejecuta el script, la utilidad extrae el valor del token de clave pública del archivo .snk y lo establece en una variable de entorno %NEWTOKEN%. Cuando se ejecuta el script, cada instancia de %NEWTOKEN% se sustituirá por el token de clave pública del archivo .snk especificado. Por ejemplo:

    ReplacePKT.bat key.snk  
...  
...  
gacutil /u Assembly, ... PublicKey=%NEWTOKEN% ...

Ubicación en el SDK

La utilidad Reemplazar token de clave pública se encuentra en:

\Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>SDK\Utilities\ReplacePublicKeyToken\.

La utilidad Reemplazar token de clave pública consta de tres archivos:

  • ReplacePKT.bat

  • ReplacePKT.vbs

  • ReplacePKT.wsf

Procedimientos

Use el procedimiento siguiente para reemplazar todas las instancias de un token de clave pública o un marcador de posición en un archivo con un token de clave pública extraído de un archivo .snk, como se describe en Escenario 1.

Para reemplazar instancias de un token de clave pública o un marcador de posición en un archivo

  1. Asegúrese de que los tres archivos de utilidad Reemplazar Token de Clave Pública (ReplacePKT.bat, ReplacePKT.vbs, ReplacePKT.wsf), el archivo de script y el archivo .snk todos estén disponibles en el equipo local.

  2. En una ventana de comandos, cambie el directorio a la carpeta que contiene los archivos de utilidad Reemplazar clave pública.

  3. Desde la línea de comandos, ejecute el siguiente comando:

  4. ReplacePKT <Archivo .snk> <token de clave pública anterior> <archivo que se va a reemplazar>

    Opción Descripción
    < archivo .snk> Ruta de acceso completa del archivo .snk que contiene el token de clave pública que desea usar para sustituir el token de clave pública existente o un marcador de posición.
    < token de clave pública anterior> Token de clave pública o marcador de posición que desea reemplazar.
    < archivo que se va a reemplazar> Ruta completa del archivo en el que desea reemplazar el token de clave pública o el marcador de posición.

    Ejemplo:

    ReplacePKT.bat C:\Tokens\MyToken.snk 12ab3456cd789e12 C:\Scripts\MyScript.vbs

    Use el procedimiento siguiente para establecer automáticamente una variable de entorno en un script que usa un token de clave pública derivado de un archivo .snk, como se describe en escenario 2.

Para establecer una variable de entorno que usa un token de clave pública

  1. Al principio del archivo de script, agregue la siguiente línea de código:

    ReplacePKT <filename>.snk

    Donde <nombre de archivo> es el nombre del archivo .snk del que se deriva el token de clave pública.

    Example: ReplacePKT.bat MyToken.snk

  2. En el archivo de script, use %NEWTOKEN% para representar el token de clave pública.

    Ejemplo:

    PublicKey=%NEWTOKEN%

  3. Al entregar el archivo de script a los usuarios, incluya los tres archivos que componen la utilidad Replace Public Key Token (ReplacePKT.bat, ReplacePKT.vbs, ReplacePKT.wsf). Asegúrese de que los usuarios del script copien todos los archivos en la misma carpeta del sistema de archivos antes de ejecutar el script.

Véase también

Utilidades en el SDK

  • Última actualización el