通过

替换公钥令牌实用工具

  • 项目

此实用程序可以用从强名称程序集密钥 (.snk) 文件派生的公钥标记替换文件中的公钥标记或变量。

当开发人员编写使用 BTSTask Command-Line 引用 来部署程序集的脚本时，此实用工具可能很有用。 要想成功部署，必须提供程序集的完全限定名称，包括程序集的公钥标记。 程序集的公钥标记是从 .snk 文件中提取的，并在程序集生成时指定给它。 然而，在将程序集部署到新的环境之前，通常会使用其他公钥标记重新生成它。 因此，开发人员可能不知道部署脚本运行时程序集将使用什么公钥标记。

可以通过以下两种方法使用替换公钥标记实用程序解决此问题：

  • 方案 1. 在部署脚本中，开发人员可以使用公钥标记，也可以使用表示公钥标记的占位符。 运行脚本之前，用户可以运行替换公钥标记实用程序，以使用从 .snk 文件（用于针对目标环境生成程序集的文件）提取的公钥标记替代脚本文件中的公钥标记或占位符。

  • 方案 2. 开发人员可以将脚本配置为自动替换新的公钥令牌，如下所示：在脚本开始时，调用“替换公钥令牌”实用工具，并将其指向包含公钥令牌的 .snk 文件。 在脚本中，使用环境变量 %NEWTOKEN% 表示公钥标记。 脚本运行时，实用程序从 .snk 文件中提取公钥标记的值，并将该值设置到环境变量 %NEWTOKEN% 中。 脚本运行时，将用指定的 .snk 文件中的公钥标记来替代 %NEWTOKEN% 的每个实例。 例如：

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

在 SDK 中的位置

替换公钥标记实用程序位于：

\Program Files (x86) \Microsoft BizTalk Server <VERSION>SDK\Utilities\ReplacePublicKeyToken\。

替换公钥标记实用程序由三个文件组成：

  • ReplacePKT.bat

  • ReplacePKT.vbs

  • ReplacePKT.wsf

过程

使用以下过程，用从 .snk 文件中提取的公钥标记替换文件中公钥标记或占位符的所有实例，如方案 1 中所述。

替换文件中公钥标记或占位符的实例

  1. 确保本地计算机上具有以下所有文件：三个替换公钥标记实用程序文件（ReplacePKT.bat、ReplacePKT.vbs、ReplacePKT.wsf）、脚本文件和 .snk 文件。

  2. 在命令窗口中，将目录更改到包含替换公钥标记实用程序文件的文件夹。

  3. 在命令提示符下运行以下命令：

  4. ReplacePKT <.snk 文件> <旧的公钥令牌> <要替换的文件>

    选项 说明
    <.snk 文件> .snk 文件的完整路径，该文件中包含的公钥标记将替换现有的公钥标记或占位符 。
    <旧的公钥令牌> 要替换的公钥标记或占位符。
    <要替换的文件> 要替换的公钥标记或占位符所在文件的完整路径。

    例如：

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

    使用以下过程，自动设置脚本中使用从 .snk 文件中提取的公钥标记的环境变量，如方案 2 中所述。

设置使用公钥标记的环境变量

  1. 在脚本文件的开始处，添加以下代码行：

    ReplacePKT <filename>.snk

    其中 <filename> 是要从中派生公钥令牌的 .snk 文件的名称。

    Example: ReplacePKT.bat MyToken.snk

  2. 在脚本文件中，使用 %NEWTOKEN% 表示公钥令牌。

    例如：

    PublicKey=%NEWTOKEN%

  3. 将脚本文件传送给用户时，请将组成替换公钥标记实用程序的三个文件（ReplacePKT.bat、ReplacePKT.vbs、ReplacePKT.wsf）包括在内。 确保脚本用户在运行脚本之前将这三个文件全部复制到文件系统中的同一文件夹。

另请参阅

SDK 中的实用工具