属性参考
本部分列出了 Windows Installer 定义的属性：
其他属性可由创作的数据或自定义操作指定。 名称中不包含小写字母的属性是公共属性，可以在命令行上指定。
有关安装程序属性提供的 Uninstall 注册表项值的信息，请参阅 Uninstall 注册表项。
组件位置属性
以下列表提供了有关组件位置属性的详细信息的链接。
| 属性 | 说明 |
|---|---|
|
OriginalDatabase |
安装程序将此属性设置为启动来源数据库、源上的数据库或缓存的数据库。 |
|
ParentOriginalDatabase |
安装程序为通过并发安装操作运行的安装设置此属性。 |
|
SourceDir |
包含源文件的根目录。 |
|
TARGETDIR |
为安装指定根目标目录。 在进行管理安装期间，此属性是要将安装包复制到的位置。 |
Configuration Properties
以下列表提供了有关其他可配置属性的详细信息的链接。
| 属性 | 说明 |
|---|---|
|
ACTION |
初始化安装程序后调用的初始操作。 |
|
ALLUSERS |
确定配置信息的存储位置。 |
|
ARPAUTHORIZEDCDFPREFIX |
应用程序的更新通道的 URL。 |
|
ARPCOMMENTS |
为“控制面板”中的“添加或删除程序”提供注释。 |
|
ARPCONTACT |
为“控制面板”中的“添加或删除程序”提供联系人。 |
|
ARPINSTALLLOCATION |
应用程序的主文件夹的完全限定路径。 |
|
ARPNOMODIFY |
禁用修改产品的功能。 |
|
ARPNOREMOVE |
禁用删除产品的功能。 |
|
ARPNOREPAIR |
禁用“程序”向导中的“修复”按钮。 |
|
ARPPRODUCTICON |
指定安装包的主图标。 |
|
ARPREADME |
为“控制面板”中的“添加或删除程序”提供自述文件。 |
|
ARPSIZE |
应用程序的估计大小（以 KB 为单位）。 |
|
ARPSYSTEMCOMPONENT |
防止在“添加或删除程序”列表中显示某个应用程序。 |
|
ARPURLINFOABOUT |
应用程序主页的 URL。 |
|
ARPURLUPDATEINFO |
应用程序更新信息的 URL。 |
|
AVAILABLEFREEREG |
应用程序所需的注册表空间（以 KB 为单位）。 由 AllocateRegistrySpace 操作使用。 |
|
CCP_DRIVE |
用于限定 CCP 产品的根路径。 |
|
DefaultUIFont |
用于控件的默认字体样式。 |
|
DISABLEADVTSHORTCUTS |
设置此属性会禁止生成支持按需安装的特定快捷方式。 |
|
DISABLEMEDIA |
防止安装程序将媒体源（例如 CD-ROM）注册为产品的有效源。 |
|
DISABLEROLLBACK |
禁用当前配置的回滚。 |
|
EXECUTEACTION |
ExecuteAction 启动的顶级操作。 |
|
EXECUTEMODE |
安装程序执行的执行模式。 |
|
FASTOEM |
在特定的 OEM 方案中提高安装性能。 |
|
INSTALLLEVEL |
安装功能的初始级别。 |
|
LIMITUI |
上限为“基本”的 UI 级别。 |
|
LOGACTION |
要记录的操作名称列表。 |
|
MEDIAPACKAGEPATH |
如果安装包不在 CD-ROM 的根目录中，则必须将此属性设置为相对路径。 |
|
MSIARPSETTINGSIDENTIFIER |
此可选属性包含分号分隔的注册表位置列表，应用程序将在这些位置存储用户的设置和首选项。 在 Windows Installer 4.0 中提供。 |
|
MSIDISABLEEEUI |
禁用用于安装的嵌入式用户界面。 Windows Installer 4.0 及更低版本：不支持。 |
|
MSIFASTINSTALL |
减少安装大型 Windows Installer 包所需的时间。 Windows Installer 4.5 及更低版本：不支持。 |
|
MSIINSTALLPERUSER |
请求 Windows Installer 仅为当前用户安装包。 Windows Installer 4.5 及更低版本：不支持。 |
|
MSINODISABLEMEDIA |
设置此属性可防止安装程序设置 DISABLEMEDIA 属性。 |
|
MSIENFORCEUPGRADECOMPONENTRULES |
在命令行或属性表中将此属性设置为 1（一）可以在对特定产品进行小型更新和次要升级期间应用升级组件规则。 从 Windows Installer 3.0 开始提供。 |
|
MSIUNINSTALLSUPERSEDEDCOMPONENTS |
如果将此属性设置为 1，则安装程序可以取消注册和卸载多余的组件，以防止在计算机上留下孤立组件。 Windows Installer 4.0 及更低版本：不支持。 |
|
PRIMARYFOLDER |
允许作者为安装指定主文件夹。 用于确定 PrimaryVolumePath、PrimaryVolumeSpaceAvailable、PrimaryVolumeSpaceRequired 和 PrimaryVolumeSpaceRemaining 属性的值。 |
|
特权 |
使用提升的权限运行安装。 |
|
PROMPTROLLBACKCOST |
用于安装的磁盘空间不足时要执行的操作。 |
|
REBOOT |
强制或禁止重启。 |
|
REBOOTPROMPT |
禁止向用户显示重启提示。 必须进行的任何重启会自动发生。 |
|
ROOTDRIVE |
默认的安装驱动器。 |
|
SEQUENCE |
采用顺序表架构的表。 |
|
SHORTFILENAMES |
导致使用短文件名。 |
|
TRANSFORMS |
要应用于数据库的转换列表。 |
|
TRANSFORMSATSOURCE |
向安装程序告知产品转换驻留在源中。 |
|
TRANSFORMSSECURE |
将 TRANSFORMSECURE 属性设置为 1（一）会告知安装程序，转换将本地缓存在用户计算机上的、用户对其没有写入访问权限的位置。 |
|
MsiLogFileLocation |
启用日志记录后，安装程序会将此属性的值设置为日志文件的完整路径。 此属性从 Windows Installer 4.0 开始提供。 |
|
MsiLogging |
设置 Windows Installer 包的默认日志记录模式。 此属性从 Windows Installer 4.0 开始提供。 |
|
MSIUSEREALADMINDETECTION |
将此属性设置为 1 会请求安装程序在设置 AdminUser 属性时使用实际用户信息。 此属性从 Windows Installer 4.0 开始提供。 |
日期、时间属性
| 属性 | 说明 |
|---|---|
|
日期 |
当前日期。 |
|
时间 |
当前时间。 |
功能安装选项属性
以下列表提供了有关功能安装选项属性的详细信息的链接。
| 属性 | 说明 |
|---|---|
|
ADDDEFAULT |
要在默认配置中安装的功能列表。 |
|
ADDLOCAL |
要在本地安装的功能列表。 |
|
ADDSOURCE |
要从源运行的功能列表。 |
|
ADVERTISE |
要播发的功能列表。 |
|
COMPADDDEFAULT |
要在默认配置中安装的组件列表。 |
|
COMPADDLOCAL |
要在本地安装的组件 ID 列表。 |
|
COMPADDSOURCE |
要从源媒体运行的组件 ID 列表。 |
|
FILEADDDEFAULT |
要在默认配置中安装的文件的文件键列表。 |
|
FILEADDLOCAL |
要在本地运行的文件的文件键列表。 |
|
FILEADDSOURCE |
要从源媒体运行的文件键列表。 |
|
MSIDISABLELUAPATCHING |
设置此属性可防止对应用程序进行最低特权用户 (LUA) 修补。 |
|
MsiPatchRemovalList |
在安装期间要删除的修补程序列表。 |
|
MSIRESTARTMANAGERCONTROL |
指定包是要使用重启管理器还是 FilesInUse 功能。 |
|
MSIDISABLERMRESTART |
指定应如何关闭和重启当前正在使用受更新影响的文件的应用程序或服务，以便能够安装更新。 |
|
MSIRMSHUTDOWN |
指定应如何关闭当前正在使用受更新影响的文件的应用程序或服务，以便能够安装更新。 |
|
MSIPATCHREMOVE |
设置此属性会删除修补程序。 |
|
修补程序 |
设置此属性会应用修补程序。 |
|
REINSTALL |
要重新安装的功能列表。 |
|
REINSTALLMODE |
一个字符串，其中包含用于指定要执行的重新安装类型的字母。 |
|
REMOVE |
要删除的功能列表。 |
硬件属性
以下列表提供了在启动时 Windows Installer 设置的硬件属性。
| 属性 | 说明 |
|---|---|
|
Alpha |
在 Alpha 处理器上运行时使用的数字处理器级别。 注意： 此属性已过时，Windows Installer 不支持 Alpha 平台。 |
|
BorderSide |
窗口边框的宽度（以像素为单位）。 |
|
BorderTop |
窗口边框的高度（以像素为单位）。 |
|
CaptionHeight |
正常标题区域的高度（以像素为单位）。 |
|
ColorBits |
每个像素的相邻颜色位数。 |
|
Intel |
在 Intel 处理器上运行时使用的数字处理器级别。 |
|
Intel64 |
在 Itanium 处理器上运行时使用的数字处理器级别。 |
|
Msix64 |
在 x64 处理器上运行时使用的数字处理器级别。 |
|
PhysicalMemory |
安装的 RAM 大小（以 MB 为单位）。 |
|
ScreenX |
屏幕的宽度（以像素为单位）。 |
|
ScreenY |
屏幕的高度（以像素为单位）。 |
|
TextHeight |
字符的高度（以逻辑单位数计）。 |
|
VirtualMemory |
可用页面文件空间量（以 MB 为单位）。 |
安装状态属性
以下列表提供了有关安装程序在安装期间更新的状态属性的详细信息的链接。
| 属性 | 说明 |
|---|---|
|
AFTERREBOOT |
指示先完成 ForceReboot 操作调用的重新启动指令，然后再执行当前安装。 |
|
CostingComplete |
指示磁盘空间成本计算是否已完成。 |
|
已安装 |
指示已安装产品。 |
|
MSICHECKCRCS |
仅当已设置 MSICHECKCRCS 属性时，安装程序才会对文件执行 CRC。 |
|
MsiRestartManagerSessionKey |
安装程序将此属性设置为重启管理器会话的会话密钥。 |
|
MsiRunningElevated |
当安装程序正在使用提升的权限运行时，安装程序会将此属性的值设置为 1。 |
|
MsiSystemRebootPending |
如果操作系统重启当前处于挂起状态，则安装程序会将此属性设置为 1。 |
|
MsiUIHideCancel |
当内部安装级别包括 INSTALLUILEVEL_HIDECANCEL 时，安装程序会将 MsiUIHideCancel 设置为 1。 |
|
MsiUIProgressOnly |
当内部安装级别包括 INSTALLUILEVEL_PROGRESSONLY 时，安装程序会将 MsiUIProgressOnly 设置为 1。 |
|
MsiUISourceResOnly |
当内部安装级别包括 INSTALLUILEVEL_SOURCERESONLY 时，MsiUISourceResOnly 将设置为 1（一）。 |
|
NOCOMPANYNAME |
禁止自动设置 COMPANYNAME 属性。 |
|
NOUSERNAME |
禁止自动设置 USERNAME 属性。 |
|
OutOfDiskSpace |
磁盘空间不足，无法容纳安装。 |
|
OutOfNoRbDiskSpace |
磁盘空间不足并且关闭了回滚。 |
|
Preselected |
已选择功能。 |
|
PrimaryVolumePath |
安装程序将此属性的值设置为 PRIMARYFOLDER 属性指定的卷的路径。 |
|
PrimaryVolumeSpaceAvailable |
安装程序将此属性的值设置为一个字符串，该字符串表示 PrimaryVolumePath 属性引用的卷上可用的总字节数。 |
|
PrimaryVolumeSpaceRemaining |
安装程序将此属性的值设置为一个字符串，该字符串表示在安装了所有当前选定功能的情况下，PrimaryVolumePath 属性引用的卷上剩余的总字节数。 |
|
PrimaryVolumeSpaceRequired |
安装程序将此属性的值设置为一个字符串，该字符串表示 PrimaryVolumePath 属性引用的卷上所有当前选定功能所需的总字节数。 |
|
ProductLanguage |
数据库的数字语言标识符 (LANGID)。 （必需） |
|
ReplacedInUseFiles |
如果安装程序通过已被使用的文件进行安装，则设置此属性。 |
|
RESUME |
恢复安装。 |
|
RollbackDisabled |
禁用回滚时，安装程序会设置此属性。 |
|
UILevel |
指示用户界面级别。 |
|
UpdateStarted |
如果已开始针对此安装进行系统更改，则设置此属性。 |
|
UPGRADINGPRODUCTCODE |
在升级过程删除应用程序时由安装程序设置。 |
|
VersionMsi |
安装程序将此属性设置为安装期间运行的 Windows Installer 版本。 |
操作系统属性
以下列表提供了有关在启动时安装程序设置的操作系统属性的详细信息的链接。
| 属性名称 | 简要说明 |
|---|---|
|
AdminUser |
在 Windows 2000 上，如果用户拥有管理员权限，则设置此属性。 |
|
ComputerName |
当前系统的计算机名称。 |
|
MsiNetAssemblySupport |
在支持公共语言运行时程序集的系统上，安装程序会将此属性的值设置为 fusion.dll 的文件版本。 如果操作系统不支持公共语言运行时程序集，则安装程序不会设置此属性。 |
|
MsiNTProductType |
指示 Windows 产品类型。 |
|
MsiNTSuiteBackOffice |
在 Windows 2000 及更高版本的操作系统上，仅当已安装 Microsoft BackOffice 组件时，安装程序才会将此属性设置为 1（一）。 |
|
MsiNTSuiteDataCenter |
在 Windows 2000 及更高版本的操作系统上，仅当已安装 Windows 2000 Datacenter Server 时，安装程序才会将此属性设置为 1（一）。 |
|
MsiNTSuiteEnterprise |
在 Windows 2000 及更高版本的操作系统上，仅当已安装 Windows 2000 Advanced Server 时，安装程序才会将此属性设置为 1（一）。 |
|
MsiNTSuitePersonal |
在 Windows XP 及更高版本的操作系统上，仅当操作系统为 Home（不是 Professional）时，安装程序才会将此属性设置为 1（一）。 |
|
MsiNTSuiteSmallBusiness |
在 Windows 2000 及更高版本的操作系统上，仅当已安装 Microsoft Small Business Server 时，安装程序才会将此属性设置为 1（一）。 |
|
MsiNTSuiteSmallBusinessRestricted |
在 Windows 2000 及更高版本的操作系统上，仅当已使用受限客户端许可证安装 Microsoft Small Business Server 时，安装程序才会将此属性设置为 1（一）。 |
|
MsiNTSuiteWebServer |
在 Windows 2000 及更高版本的操作系统上，如果已安装 Windows Server 2003 Web 版，则安装程序会将 MsiNTSuiteWebServer 属性设置为 1（一）。 仅在 Windows Server 2003 版 Windows Installer 中提供。 |
|
MsiTabletPC |
如果当前操作系统是 Windows XP Tablet PC Edition，则安装程序会将此属性设置为非零值。 |
|
MsiWin32AssemblySupport |
在支持 Win32 程序集的系统上，安装程序会将此属性的值设置为 sxs.dll 的文件版本。 如果操作系统不支持 Win32 程序集，则安装程序不会设置此属性。 |
|
OLEAdvtSupport |
如果 OLE 支持 Windows Installer，则设置此属性。 |
|
RedirectedDllSupport |
如果执行安装的系统支持隔离组件，则安装程序会设置 RedirectedDllSupport 属性。 |
|
RemoteAdminTS |
如果系统是运行终端服务器角色服务的远程管理服务器，则安装程序会设置 RemoteAdminTS 属性。 |
|
ServicePackLevel |
操作系统 Service Pack 的版本号。 |
|
ServicePackLevelMinor |
操作系统 Service Pack 的次要版本号。 |
|
SharedWindows |
如果系统作为共享 Windows 运行，则设置此属性。 |
|
ShellAdvtSupport |
如果 shell 支持功能播发，则设置此属性。 |
|
SystemLanguageID |
系统的默认语言标识符。 |
|
TerminalServer |
如果系统是运行终端服务器角色服务的服务器，则设置此属性。 |
|
TTCSupport |
指示操作系统是否支持使用 .ttc（TrueType 字体集合）文件。 |
|
Version9X |
Windows 操作系统的版本号。 |
|
VersionDatabase |
当前安装的数字数据库版本。 |
|
VersionNT |
操作系统的版本号。 |
|
VersionNT64 |
如果系统在 64 位计算机上运行，则此属性为操作系统的版本号。 |
|
Windows 内部版本 |
操作系统的内部版本号。 |
产品信息属性
以下列表提供了有关属性表中指定的产品特定属性的详细信息的链接。
| 属性名称 | 简要说明 |
|---|---|
|
ARPHELPLINK |
技术支持的 Internet 地址或 URL。 |
|
ARPHELPTELEPHONE |
技术支持电话号码。 |
|
DiskPrompt |
磁盘提示消息框显示的字符串。 |
|
IsAdminPackage |
如果当前安装是从通过管理安装创建的包运行的，则设置为 1（一）。 |
|
LeftUnit |
在数字左侧添加单位。 |
|
制造商 |
应用程序制造商的名称。 （必需） |
|
MediaSourceDir |
当安装使用媒体源（例如 CD-ROM）时，安装程序会将此属性设置为 1（一）。 |
|
MSIINSTANCEGUID |
如果存在此属性，则表示已将产品代码更改转换注册到产品。 |
|
MSINEWINSTANCE |
此属性指示使用实例转换安装新的产品实例。 |
|
ParentProductCode |
安装程序为并发安装操作运行的安装设置此属性。 |
|
PIDTemplate |
用作 PIDKEY 属性模板的字符串。 |
|
ProductCode |
特定产品版本的唯一标识符。 （必需） |
|
ProductName |
应用程序的用户可读名称。 （必需） |
|
ProductState |
设置为产品的已安装状态。 |
|
ProductVersion |
产品版本的字符串格式，采用数值形式。 （必需） |
|
UpgradeCode |
表示一组相关产品的 GUID。 |
摘要信息更新属性
以下属性仅由用于更新管理映像摘要信息流的 .msp 文件中的转换设置。
| 属性 | 说明 |
|---|---|
|
PATCHNEWPACKAGECODE |
此属性的值将写入到修订号摘要属性。 |
|
PATCHNEWSUMMARYCOMMENTS |
此属性的值将写入到注释摘要属性。 |
|
PATCHNEWSUMMARYSUBJECT |
此属性的值将写入到主题摘要属性。 |
系统文件夹属性
以下列表提供了有关安装程序在安装时设置的系统文件夹的详细信息的链接。
| 属性 | 说明 |
|---|---|
|
AdminToolsFolder |
包含管理工具的目录的完整路径。 |
|
AppDataFolder |
当前用户的 Roaming 文件夹的完整路径。 |
|
CommonAppDataFolder |
所有用户的应用程序数据的完整路径。 |
|
CommonFiles64Folder |
预定义的 64 位 Common Files 文件夹的完整路径。 |
|
CommonFilesFolder |
当前用户的 Common Files 文件夹的完整路径。 |
|
DesktopFolder |
Desktop 文件夹的完整路径。 |
|
FavoritesFolder |
当前用户的 Favorites 文件夹的完整路径。 |
|
FontsFolder |
Fonts 文件夹的完整路径。 |
|
LocalAppDataFolder |
包含本地（非漫游）应用程序的文件夹的完整路径。 |
|
MyPicturesFolder |
Pictures 文件夹的完整路径。 |
|
NetHoodFolder |
NetHood 文件夹的完整路径。 |
|
PersonalFolder |
当前用户的 Documents 文件夹的完整路径。 |
|
PrintHoodFolder |
PrintHood 文件夹的完整路径。 |
|
ProgramFiles64Folder |
预定义的 64 位 Program Files 文件夹的完整路径。 |
|
ProgramFilesFolder |
预定义的 32 位 Program Files 文件夹的完整路径。 |
|
ProgramMenuFolder |
Program Menu 文件夹的完整路径。 |
|
RecentFolder |
Recent 文件夹的完整路径。 |
|
SendToFolder |
当前用户的 SendTo 文件夹的完整路径。 |
|
StartMenuFolder |
Start Menu 文件夹的完整路径。 |
|
StartupFolder |
Startup 文件夹的完整路径。 |
|
System16Folder |
16 位系统 DLL 的文件夹的完整路径。 |
|
System64Folder |
预定义的 System64 文件夹的完整路径。 |
|
SystemFolder |
当前用户的 System 文件夹的完整路径。 |
|
TempFolder |
Temp 文件夹的完整路径。 |
|
TemplateFolder |
当前用户的 Template 文件夹的完整路径。 |
|
WindowsFolder |
Windows 文件夹的完整路径。 |
|
WindowsVolume |
Windows 文件夹所在的卷。 |
用户信息属性
以下列表提供了有关用户提供的信息的详细信息的链接。
| 属性 | 说明 |
|---|---|
|
AdminProperties |
在执行管理安装期间设置的属性列表。 |
|
COMPANYNAME |
执行安装的用户的组织名称。 |
|
LogonUser |
当前已登录的用户的用户名。 |
|
MsiHiddenProperties |
被阻止写入日志的属性列表。 |
|
PIDKEY |
用户输入的产品 ID 的一部分。 |
|
ProductID |
成功验证后的完整产品 ID。 |
|
UserLanguageID |
当前用户的默认语言标识符。 |
|
USERNAME |
正在执行安装的用户。 |
|
UserSID 属性 |
由安装程序根据用户的安全标识符 (SID) 设置。 |