Microsoft .NET Framework 3.0 部署自述文件
Microsoft Corporation
2006 年 7 月
目录
1.简介
备注
2.使用管理员模式设置部署 Microsoft .NET Framework 3.0
2.1 运行管理员模式设置
2.2 安装维护
3. 使用 Active Directory 部署 Microsoft .NET Framework 3.0
3.1 部署 .NET Framework 3.0 的先决条件
3.2 使用 Active Directory 部署组件
3.3 重新部署包
3.4 删除包
4. 指定 Watson 设置
5. 已知安装问题
6. 故障排除
6.1 Microsoft .NET Framework 3.0 日志文件位置
6.2. Windows Installer 错误代码
附录
1.简介
Microsoft .NET Framework 3.0 提供了两种方法来帮助部署到现场客户端:
- 管理员模式设置管理员模式设置使 IT 管理员可以通过 Microsoft Systems Management Server (SMS) 或其他软件分发工具部署.NET Framework。 IT 管理员以静默模式运行.NET Framework安装程序。 如果发生错误,安装程序将静默退出并记录错误代码。
- Active Directory 部署在 Active Directory 部署中,管理员必须将.NET Framework 3.0 安装包中的单个.msi文件添加到组策略中,以部署.msi文件的顺序。 启用组策略后,属于此组策略的任何客户端将在启动并重新连接到网络时自动安装组件。 如果发生错误,安装程序将静默退出并记录错误代码。
备注
本文档中引用的软件(包括但不限于 .NET Framework 3.0 和 Active Directory)均受许可条款和条件的约束。 下列说明假定,软件的适当被许可方已查看并接受此类许可条款和条件。 这些说明不免除此类许可协议中的任何条款和条件。
对于 Windows XP、Windows 2000 和 Windows Server 2003,必须在计算机上安装 Windows Installer 3.1。 若要下载 Windows Installer 3.1,请转到 Microsoft 下载中心网站上的 Windows Installer 3.1 可再发行组件 页面。
2.使用管理员模式设置部署 Microsoft .NET Framework 3.0
以下部署步骤适用于 Windows Server 2003 和 Windows XP。 在 Windows Vista 和代号为“Longhorn”的 Windows Server 中,.NET Framework 3.0 是操作系统的一部分。 有关为 Windows Vista 和“Longhorn”部署 .NET Framework 3.0 的信息,请参阅 Microsoft 网站上的部署过程:概述页。
2.1 运行管理员模式设置
步骤 1:检查先决条件
在运行管理员设置的此阶段之前,请确保目标计算机满足软件和硬件先决条件。 Windows Installer 3.1 是所有安装的先决条件。 下面是 .NET Framework 3.0 所需的组件列表。 如果不满足先决条件,无人参与安装将失败。
- 在 Windows Server 2003 上,需要 Service Pack 1。
- 在 Windows XP Home Edition 和 Windows XP Professional 上,需要 Service Pack 2。
- 在所有平台上,都需要 Microsoft Internet Explorer 6.0 Service Pack 1。
步骤 2:创建网络映像
在服务器上创建一个文件夹,例如 drive:\NETFX3。
从 Web 下载 .NET Framework 3.0 可再发行程序包,并将其保存在步骤 1 中创建的文件夹中。
包的下载位置为:
- (X86) winfxrc.exe
- (X64) winfxrc_x64.exe
注意 .NET Framework 3.0 仅在 Windows Server“Longhorn”上支持 IA64。
步骤 3:运行安装程序
验证 .NET Framework 3.0 可再发行程序包是否在网络上可用。
在 Windows “开始 ”菜单中,选择 “运行”。
键入下列命令:
\\computer\share\.NET Framework 3.0 setup EXE Name /q /norestart
例如:
\\server\dotnetfx3\dotnetfx3.exe /q /norestart
2.2 安装维护
可以在具有现有安装的计算机上再次运行安装程序,以访问安装程序维护功能。 用户和管理员都应从 Windows 控制面板中的“添加或删除程序”运行安装程序。 若要在维护模式下运行安装程序,用户必须对目标计算机具有管理权限。
3. 使用 Active Directory 部署 Microsoft .NET Framework 3.0
以下部署步骤适用于 Windows Server 2003 和 Windows XP。 在代号为“Longhorn”的 Windows Vista 和 Windows Server 中,.NET Framework 3.0 是操作系统的一项功能。 有关为 Windows Vista 和“Longhorn”部署 .NET Framework 3.0 的信息,请参阅这些操作系统的指南。
3.1 部署 .NET Framework 3.0 的先决条件
网络管理员必须验证所有客户端计算机是否都具有安装 .NET Framework 3.0 所需的系统组件。 如果不满足先决条件,安装将失败。
注意 必须按照列出的顺序部署所需组件。 如果以不同的顺序部署组件,则组件安装安装程序将失败。 例如,.NET Framework 2.0 要求先安装 Windows Installer 3.1,因此 Windows Installer 列在 .NET Framework 2.0 之前。 不带星号 (*) 的组件位于 NET Framework 3.0 安装包的 WCU 文件夹中。 有关如何部署这些组件的信息,请参阅 3.2 使用 Active Directory 部署组件。
以下是在 Windows Server 2003 上部署 .NET Framework 3.0 的先决条件:
- Microsoft Windows 2003 Service Pack 1*
- Microsoft .NET Framework 2.0
- Microsoft Core XML Services (MSXML) 6.0。 若要下载此组件,请转到 Microsoft 下载中心网站上的 Microsoft Core XML Services (MSXML) 6.0 页面 。
- 适用于 Microsoft DirectX 9.0 软件开发工具包的软件光栅器 (SDK)
以下是在 Windows XP 上部署 .NET Framework 3.0 的先决条件:
Microsoft Windows XP Service Pack 2*
Microsoft Internet Explorer 6.0 Service Pack 1*
Microsoft Windows Installer 3.1
Microsoft .NET Framework 2.0
适用于 Microsoft DirectX 9.0 软件开发工具包的软件光栅器 (SDK) 。
注意 可以从 Microsoft 下载中心下载 Microsoft DirectX 9.0 SDK 的软件光栅器。 选择所需的版本:
* 这些组件受其自己的许可协议约束。
3.2 使用 Active Directory 部署组件
本部分介绍如何使用 Active Directory 跨网络为特定组件部署 Windows Installer 安装包。 若要部署需要文件提取的组件,必须在目标计算机上具有管理员权限。
必须先从.exe可再发行程序包中提取单个文件,然后才能使用 Active Directory 部署应用程序。 必须从 .exe 文件中提取 Windows Installer 文件。 可能还需要提取其他文件。 例如,若要部署 .NET Framework 2.0 可再发行程序包,必须从要用于部署的 .exe 文件中提取 Netfx.msi 文件。
在 Active Directory 客户端计算机上安装 Windows Installer 安装包之前,请确保 Windows Installer 服务已在客户端计算机上。 本节中所述的过程假定所有客户端计算机上都安装了 Windows Installer 3.1。
在部署 .NET Framework 2.0 之前,请确保目标计算机满足最低配置要求。 有关详细信息,请参阅 Microsoft .NET Framework 开发人员中心的部署配置应用程序页。&
下表显示了可以使用 Active Directory 部署的组件列表。
可以使用 Active Directory 部署的表 1 组件
组件 | .exe或.msi文件位置 | 目录名称 | 组件命令 | 需要文件提取 |
---|---|---|---|---|
.NET Framework 2.0 | wcu\dotnetFramework\dotnetfx.exe | dotnetfx | dotnetfx.exe /q /c:"msiexec /qb /a netfx.msi USING_EXUIH=1 REBOOT=ReallySuppress TARGETDIR=c:\dotnetfx" |
是 |
Microsoft Core XML Services (MSXML) 6.0 | wcu\MSXML\msxml6.msi | msxml6 | msiexec /qb /a msxml6.msi TARGETDIR=c:\msxml6 |
|
适用于 Microsoft DirectX 9.0 软件开发工具包的软件光栅器 (SDK) | wcu\RGBRAST\x86\RGB9RAST_x86.msi | RGBRAST | msiexec /qb /a RGB9RAST_x86.msi REBOOT=ReallySuppress TARGETDIR=c:\RGBRAST |
|
.NET Framework 3.0 | vs_setup.msi | NETFX3 | msiexec /qb /a vs_setup.msi NOVSUI=1 TARGETDIR=c:\NETFX3 |
|
Windows Communication Foundation | wcu\WCF\Indigo.exe | WCF | indigo.exe /q /c:"msiexec /qb /a Indigo.msi REBOOT=ReallySuppress TARGETDIR=c:\Indigo" |
是 |
Windows Presentation Foundation | wcu\WPF\wpf.msi | WPF | msiexec /qb /a wpf.msi STANDALONE=no REBOOT=ReallySuppress TARGETDIR=c:\wpf |
|
Windows Workflow Foundation | wcu\WF\WF_3.0_x86.msi | WF | msiexec /qb /a WF_3.0_x86.msi ARPSYSTEMCOMPONENT=1 STANDALONE=no REBOOT=ReallySuppress TARGETDIR=c:\WF |
注意 可以通过添加来为每个组件启用日志记录
/l*
logfile的存储池分配给
msiexec
。 例如,若要包含Windows Presentation Foundation部署的日志文件,请执行以下操作:
msiexec /qb /l* WPF_x86.log /a wpf.msi STANDALONE=no REBOOT=ReallySuppress TARGETDIR=c:\wpf
对于详细日志文件,请在 命令中使用 /lv
日志文件 。
步骤 1:创建管理员安装点
注意 有关演示如何创建安装点的示例脚本,请参阅附录。
从 Web 下载 .NET Framework 3.0 可再发行程序包,并将其保存在步骤 1 中创建的 文件夹中。
包的下载位置为:
- (X86) winfxrc.exe
- (X64) winfxrc_x64.exe
注意 .NET Framework 3.0 仅在 Windows Server“Longhorn”上支持 IA64
从 .NET Framework 3.0 可再发行组件.exe文件中提取文件,以查找下面列出的组件文件。 若要提取文件,请运行以下命令:
.NET Framework 3.0 Redist EXE Name /x:ExtractionDestination
例如:
dotnetfx3.exe /x:C:\NETFX3
将组件的.exe文件或.msi文件复制到 C:\ 的根目录本地计算机上的驱动器。 (有关组件的位置,请参阅表 1.)
在 Windows 的“开始 ”菜单中,单击“ 运行 ”,然后键入
cmd
以打开 “命令” 窗口。将目录更改为 C: 驱动器的根目录。
键入以下命令以创建要在其中复制 .exe 文件的目录:
mkdir directoryName
键入相应的组件命令 (请参阅表 1) 在目录中创建安装点
关闭“命令”窗口。
打开 Windows 资源管理器并导航到 C:\directoryName ,验证是否已提取文件。
将文件夹及其所有内容移动到要用于部署的网络共享。
步骤 2:将安装包添加到 Active Directory 组策略
在 Windows “开始 ”菜单中,依次单击“ 所有程序”、“ 管理工具”和“ 组件服务”。
展开 “Active Directory 用户和计算机”。
将显示 “Active Directory 用户和计算机” 树。
右键单击域节点,然后单击“ 属性”。
在“属性”对话框中,单击“组策略”选项卡。
在“组策略对象链接”框中,选择组策略对象,然后单击“编辑”。
如果打算设置适用于计算机的策略,无论谁登录到计算机,请展开“计算机配置”\“软件设置”。
注意 确保映射到 Active Directory 服务器上的共享位置;否则,它不允许创建用于安装的包。
右键单击“ 软件安装”,单击“ 新建”,然后单击“ 包”。
在“ 打开 ”对话框中,浏览到复制部署文件夹的位置,然后选择.msi文件。
在 “部署软件 ”对话框中,单击“ 已分配 ”,然后单击“ 确定”。
单击“ 自动安装 ”,在域中的每台计算机上自动安装软件。
单击“ 确定 ”,然后关闭 “组件服务 ”控制台。
步骤 3:使用 组策略 设置提升的权限
由于大多数包仅允许计算机的本地管理员安装包,因此应使用提升的权限在组策略中播发每台计算机的包。 网络管理员可以为一个用户、一台计算机或一组用户创建策略。 有关创建特殊策略配置文件的详细信息,请参阅系统策略编辑器帮助。 有关配置策略的详细信息,请参阅组策略管理单元帮助。
在 Windows “开始 ”菜单中,依次单击“ 所有程序”、“ 管理工具”和“ 组件服务”。
展开 “Active Directory 用户和计算机”。
将显示 “Active Directory 用户和计算机” 树。
右键单击域节点,然后单击“ 属性”。
在“属性”对话框中,单击“组策略”选项卡。
在“组策略对象链接”框中,选择组策略对象,然后单击“编辑”。
打开 “计算机配置\管理模板\Windows 组件\Windows Installer” 文件夹。
在详细信息窗格中,双击“ 始终使用提升的权限安装”。
在 “属性 ”对话框中,启用策略,选择“ 已启用 ”选项以打开设置,然后单击“ 确定”。
打开 “用户配置\管理模板\Windows 组件\Windows Installer” 文件夹,然后重复步骤 7 和 8。
注意 可以使用系统策略编辑器和 Windows Installer 策略设置始终安装提升的权限策略。 必须为计算机和每个用户设置策略。 如果选择不使用组策略编辑器或系统策略编辑器,可以通过更改 Windows 注册表中的值,在每台计算机上指定相同的设置。
步骤 4:验证包是否已准备好分配给计算机
- 在 “组件名称 - 英语属性 ”对话框中,单击“ 部署 ”选项卡。
- 在 “部署类型 ”下,单击“ 已分配”。
- 在 “部署选项”下,选择何时以及如何部署组件的选项。
- 浏览其他选项卡并根据需要设置选项。 有关详细信息,请参阅对话框中提供的组策略帮助。
步骤 5:部署其他必需的组件
若要部署其他 .NET Framework 3.0,请重复步骤 1 并将 .msi 文件添加到指定的 Active Directory 组策略。
3.3 重新部署包
在某些情况下,可能需要重新部署软件包。 例如,如果升级或修改包,则可能需要这样做。
若要重新部署包,请执行以下步骤:
启动 Active Directory 用户和计算机 控制台。 为此,请在“Windows 开始 ”菜单中单击“ 管理工具”,然后单击“ Active Directory 用户和计算机”。
在控制台树中,右键单击域名,然后单击“ 属性”。
单击“组策略”选项卡,单击用于部署包的组策略对象,然后单击“编辑”。
展开“ 软件设置” 容器,其中包含用于部署包的软件安装项。
单击包含包的软件安装容器。
在组策略对象编辑器的右窗格中,右键单击程序,选择“所有任务”,然后单击“重新部署应用程序”。
您将看到下列消息:
Redeploying this application will reinstall the application everywhere it is already installed. Do you want to continue?
单击 “是” 。
关闭组策略对象编辑器,单击“确定”,然后关闭“Active Directory 用户和计算机”控制台。
3.4 删除包
删除已发布或分配的包:
- 启动 Active Directory 用户和计算机 控制台。 为此,请在“Windows 开始 ”菜单中单击“ 管理工具”,然后单击“ Active Directory 用户和计算机”。
- 在控制台树中,右键单击域名,然后单击“ 属性”。
- 单击“组策略”选项卡,单击用于部署包的组策略对象,然后单击“编辑”。
- 展开“ 软件设置” 容器,其中包含用于部署包的软件安装项。
- 单击包含包的软件安装容器。
- 在组策略对象编辑器的右窗格中,右键单击程序,选择“所有任务”,然后单击“删除”。
- 执行下列操作之一:
- 单击“ 立即从用户和计算机中卸载软件”,然后单击“ 确定”。
- 单击“ 允许用户继续使用该软件,但阻止新安装”,然后单击“ 确定”。
- 关闭组策略对象编辑器,单击“确定”,然后关闭“Active Directory 用户和计算机”控制台。
4. 指定 Watson 设置
可以通过编辑以下注册表子项来配置 Watson for .NET Framework 3.0 在各个计算机上的行为方式:
HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\PCHealth\ErrorReporting\DW\VSSetup\.NET Framework 3.0\3.0.50727
将键设置为以下值:
VSSWSectionEnabled=dword:00000001
VSSWUXEnabled=dword:00000001
5. 已知安装问题
有关已知安装问题的信息,请参阅 Microsoft .NET Framework 3.0 发行说明。
6. 故障排除
6.1 Microsoft .NET Framework 3.0 日志文件位置
.NET Framework 3.0 安装期间会生成以下日志文件:
- dd_dotnetfx3error30.txt
- dotnetfx3install30.txt
- dd_indigo_retMSInn.txt
- dd_rgb_retMSInn.txt
- dd_Wf_3.0_x86.msinn.txt
- dd_wpf_retMSInn.txt
其中 nnnn 是随机生成的后缀。
对于非英语安装,还会生成以下日志文件:
- dotnetfx3lperror30.txt
- dotnetfx3lpinstall30.txt
.NET Framework 3.0 安装期间,日志文件位于 %temp% 目录中。
对于 Active Directory 部署,请指定选项, /lv <logfile>
如 3.2 使用 Active Directory 部署组件来创建每个组件部署的日志文件中所述。
6.2. Windows 安装程序错误代码
有关错误代码的列表,请参阅 MSDN 网站上的 Windows 安装程序错误代码页 。
附录
下面是可用于创建管理员安装点的示例脚本。
set WORKFOLDER=c:\deploy
set dotNetFX3build=%WORKFOLDER%\dotnetfx3.exe
echo Creating Admin Install points for NETFX3 %PROCESSOR_ARCHITECTURE%
REM Create folders where work will be done
md %WORKFOLDER%\ext
md %WORKFOLDER%\AIP
md %WORKFOLDER%\logs
pushd %WORKFOLDER%
REM Extract the files from the NETFX3 redist SFX
call dotnetfx3.exe /q /x:%WORKFOLDER%\ext
REM ------------------------------------------------------------
REM create the .NetFX admin install point
md %WORKFOLDER%\AIP\dotnetfx_x86
call %WORKFOLDER%\ext\wcu\dotNetFramework\dotnetfx.exe /q /c:"msiexec /qb
/a netfx.msi USING_EXUIH=1 REBOOT=ReallySuppress /l*
%WORKFOLDER%\logs\netfx20_x86.log TARGETDIR=%WORKFOLDER%\AIP\dotnetfx_x86"
REM ------------------------------------------------------------
REM create the Windows Communication Foundation admin install point
md %WORKFOLDER%\AIP\WCF_x86
call %WORKFOLDER%\ext\wcu\WCF\Indigo.exe /q /c:"msiexec /qb /a indigo.msi
REBOOT=ReallySuppress /l* %WORKFOLDER%\logs\WCF_x86.log
TARGETDIR=%WORKFOLDER%\AIP\WCF_x86"
REM ------------------------------------------------------------
REM create the MSXML6 admin install point
md %WORKFOLDER%\AIP\MSXML6_x86
call msiexec /a %WORKFOLDER%\ext\wcu\MSXML\msxml6.msi /qb /l*
%WORKFOLDER%\logs\MSXML6_x86.log Targetdir=%WORKFOLDER%\AIP\MSXML6_x86
REM ------------------------------------------------------------
REM create the dotNetFX3 admin install point
md %WORKFOLDER%\AIP\NETFX3
call msiexec /a %WORKFOLDER%\VS_Setup.msi NOVSUI=1 /qb /l*
%WORKFOLDER%\logs\NETFX3_x86.log Targetdir=%WORKFOLDER%\AIP\NETFX3
REM ------------------------------------------------------------
REM create the Windows Presentation Foundation admin install point
md %WORKFOLDER%\AIP\WPF_x86
call msiexec /a %WORKFOLDER%\ext\wcu\WPF\wpf.msi /qb /l*
%WORKFOLDER%\logs\WPF_x86.log STANDALONE=no REBOOT=ReallySuppress
Targetdir=%WORKFOLDER%\AIP\WPF_x86
REM ------------------------------------------------------------
REM create the Windows Workflow Foundation admin install point
md %WORKFOLDER%\AIP\Wf_x86
call msiexec /a %WORKFOLDER%\ext\wcu\WF\Wf_3.0_x86.msi /qb /l*
%WORKFOLDER%\logs\Wf_x86.log ARPSYSTEMCOMPONENT=1 REBOOT=ReallySuppress
Targetdir=%WORKFOLDER%\AIP\Wf_x86
REM ------------------------------------------------------------
REM create the RGBRAST admin install point
md %WORKFOLDER%\AIP\RGBRAST_x86
call msiexec /a %WORKFOLDER%\ext\wcu\RGBRAST\x86\RGB9RAST_x86.msi /qb /l*
%WORKFOLDER%\logs\RGBRAST_x86.log REBOOT=ReallySuppress
Targetdir=%WORKFOLDER%\AIP\RGBRAST_x86