如何:从命令行创建部署报告
更新:2007 年 11 月
可以使用命令行输入来生成部署报告。但是,必须先将应用程序关系图文件 (.ad) 分解多个应用程序定义文件 (.sdm),然后编译部署报告所需的系统定义模型 (SDM) 文档。有关更多信息,请参见 系统定义模型 (SDM) 概述。
提示: |
---|
此外,可以使用部署设计器生成部署报告,也可以使用 Visual Studio 通过自动化来生成报告。有关更多信息,请参见 如何:生成部署报告 和 如何:对部署报告使用自动化操作。 |
若要编译 SDM 文档,需要从“System Definition Model (SDM) SDK Workshop”(系统定义模型 (SDM) SDK Workshop)下载编译器。
将应用程序关系图文件分解成 .sdm 文件
在应用程序关系图文件 (.ad) 中,搜索 <sdmDocument></SdmDocument> 标记,然后将这些标记之间的内容复制到新文件中。
说明: 对于已实现的应用程序,<sdmDocument> 节不在 .ad 文件中,而是已移动到相应项目中的现有 .sdm 文件中。编译任何系统关系图文件 (.sd) 之前,请编译每个 .sdm 文件或编译 Default.sdm 文件(如果是默认系统),如本主题后面所述。
下面的代码段举例说明了 <sdmDocument> 标记中的内容:
<SdmDocument><SystemDefinitionModel xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" Name="WebApplication1" Version="1.0.0.0" Culture="en-US" DocumentLanguage="en" xmlns="https://schemas.microsoft.com/SystemDefinitionModel/2005/1"> ... </SystemDefinitionModel></SdmDocument>
使用 <SystemDefinitionModel> 标记中 Name 属性的值命名每个文件,然后添加扩展名 .sdm。
创建完这些 .sdm 文件之后,下一步是编译部署报告所需的 .sdm 文件和其他 SDM 文档。
为部署报告编译 SDM 文档
编译从 .ad 文件或 .sdmDocument 文件创建的新 .sdm 文件,但 Default.sdm 文件除外(如果已经创建)。若要编译这些文件,请使用以下格式的命令行输入:
sdmc <File name> /output <File Name.sdmDocument> /r import1 /r import2… /SearchPath <path to your files> /SearchPath <path to System.Flow.Sdmdocument and other references>
说明: 编译 SDM 文档时,使用与原始文件相同的名称和 .sdmDocument 扩展名来指定输出文件名。
对于大多数文件,只需引用在 SDM 文档中使用 <import> 标记列出的那些文档即可。但是,部署关系图文件 (.dd) file 需要一些未列出的引用(如 System.Flow.sdmDocument 和 System.Constraints.sdmDocument)以及指向其子文档的引用和这些子文档需要的所有引用。
编译所有系统关系图文件 (.sd)。
编译逻辑数据中心关系图文件 (.ldd)。
编译部署关系图文件 (.dd),然后使用必需的 /ConfigReport 开关指定部署报告的名称。如果不使用此开关,将不会生成部署报告。
说明: 编译部署关系图时,将会引用使用 <import> 标记列出的所有文档(如 System.Flow.sdmDocument 和 System.Constraints.sdmDocument),以及用来编译先前 .ad、.sd 和 .ldd 文档的所有引用。如果试图在不指定所需列表的情况下进行编译,编译器将会列出缺少的任何文档引用。但是,不要引用 System.sdmDocument,即便大多数文档在 <import> 标记中列出了它。如果引用 System.sdmDocument,编译器将会返回一个错误。
安全性
部署报告包含的数据可能包括敏感或机密的公司或机构数据。分发或释放该报告之前,应该注意这一点。