属性参考

本部分列出了 Windows Installer 定义的属性：

• 组件位置属性
• Configuration Properties
• 日期、时间属性
• 功能安装选项属性
• 硬件属性
• 安装状态属性
• 操作系统属性
• 产品信息属性
• 摘要信息更新属性
• 系统文件夹属性
• 用户信息属性

其他属性可由创作的数据或自定义操作指定。 名称中不包含小写字母的属性是公共属性，可以在命令行上指定。

有关安装程序属性提供的 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) 设置。