Compartilhar via


Referência de propriedade

Esta seção lista as propriedades definidas pelo Windows Installer:

Propriedades adicionais podem ser especificadas por meio de criação de dados ou ações personalizadas. Propriedades com nomes sem letras minúsculas são propriedades públicas e podem ser especificadas na linha de comando.

Para obter informações sobre os valores da chave de registro da desinstalação fornecidos pelas propriedades do instalador, consulte Desinstalar chave de registro.

Propriedades de local do componente

A lista a seguir fornece links para obter mais informações sobre as propriedades de local do componente.

Propriedade Descrição
OriginalDatabase
O instalador define essa propriedade para o banco de dados inicializado, o banco de dados na origem ou o armazenado em cache.
ParentOriginalDatabase
O instalador define essa propriedade para instalações executadas por uma ação de Instalação simultânea .
SourceDir
Diretório raiz que contém os arquivos de origem.
TARGETDIR
Especifica o diretório de destino raiz para a instalação. Durante uma instalação administrativa, essa propriedade é o local para copiar o pacote de instalação.

 

Configuration Properties

A lista a seguir fornece links para obter mais informações sobre outras propriedades configuráveis.

Propriedade Descrição
ACTION
Ação inicial chamada depois de inicializar o instalador.
ALLUSERS
Determina o local de armazenamento das informações de configuração.
ARPAUTHORIZEDCDFPREFIX
URL do canal de atualização para um aplicativo.
ARPCOMMENTS
Fornece comentários para Adicionar ou remover programas no Painel de controle.
ARPCONTACT
Fornece contatos para Adicionar ou remover programas no Painel de controle.
ARPINSTALLLOCATION
Caminho totalmente qualificado para a pasta primária de um aplicativo.
ARPNOMODIFY
Desabilita a funcionalidade que modifica um produto.
ARPNOREMOVE
Desabilita a funcionalidade que remove um produto.
ARPNOREPAIR
Desabilita o botão Reparar no assistente programas.
ARPPRODUCTICON
Especifica o ícone principal do pacote de instalação.
ARPREADME
Fornece um ReadMe para Adicionar ou remover programas no Painel de controle.
ARPSIZE
Tamanho estimado de um aplicativo em quilobytes.
ARPSYSTEMCOMPONENT
Impede a exibição de um aplicativo na lista Adicionar ou remover programas.
ARPURLINFOABOUT
URL para a home page de um aplicativo.
ARPURLUPDATEINFO
URL para informações de atualização de aplicativo.
AVAILABLEFREEREG
Espaço do registro (em quilobytes) exigido por um aplicativo. Usada pela ação AllocateRegistrySpace.
CCP_DRIVE
O caminho raiz para produtos qualificados para CCP.
DefaultUIFont
Estilo de fonte padrão usado para controles.
DISABLEADVTSHORTCUTS
Defina para desabilitar a geração dos atalhos específicos que dão suporte à instalação sob demanda.
DISABLEMEDIA
Impede que o instalador registre fontes de mídia como fontes válidas para o produto, como CD-ROMs.
DISABLEROLLBACK
Desabilita a reversão para a configuração atual.
EXECUTEACTION
Ação de nível superior iniciada por ExecuteAction.
EXECUTEMODE
Modo de execução que o instalador executa.
FASTOEM
Melhora o desempenho da instalação em cenários OEM específicos.
INSTALLLEVEL
Nível inicial em que os recursos são instalados.
LIMITUI
Nível de interface do usuário limitado como Básico.
LOGACTION
Lista de nomes de ação a serem registrados.
MEDIAPACKAGEPATH
Essa propriedade deverá ser definida como o caminho relativo se o pacote de instalação não estiver localizado na raiz do CD-ROM.
MSIARPSETTINGSIDENTIFIER
Essa propriedade opcional contém uma lista delimitada por ponto e vírgula dos locais do registro em que o aplicativo armazena as configurações e preferências de um usuário. Disponível no Windows Installer 4.0.
MSIDISABLEEEUI
Desabilita a interface do usuário inserida para a instalação.
Windows Installer 4.0 e versões anteriores: Sem suporte.
MSIFASTINSTALL
Reduz o tempo necessário para instalar um pacote grande do Windows Installer.
Windows Installer 4.5 e versões anteriores: Sem suporte.
MSIINSTALLPERUSER
Solicita que o Windows Installer instale o pacote somente para o usuário atual.
Windows Installer 4.5 e versões anteriores: Sem suporte.
MSINODISABLEMEDIA
Defina essa propriedade para impedir que o instalador defina a propriedade DISABLEMEDIA.
MSIENFORCEUPGRADECOMPONENTRULES
Defina essa propriedade como um (1) na linha de comando ou na Tabela de propriedades para aplicar as regras de componente de atualização durante atualizações pequenas e atualizações secundárias de um produto específico. Disponível a partir do Windows Installer 3.0.
MSIUNINSTALLSUPERSEDEDCOMPONENTS
Quando essa propriedade for definida como 1, o instalador poderá cancelar o registro e desinstalar componentes redundantes para evitar deixar componentes órfãos no computador.
Windows Installer 4.0 e versões anteriores: Sem suporte.
PRIMARYFOLDER
Permite ao autor designar uma pasta primária para uma instalação. Usado para determinar os valores das propriedades PrimaryVolumePath, PrimaryVolumeSpaceAvailable, PrimaryVolumeSpaceRequired e PrimaryVolumeSpaceRemaining.
Com privilégios
Executa uma instalação com privilégios elevados.
PROMPTROLLBACKCOST
Ação se não houver espaço em disco suficiente para a instalação.
REBOOT
Força ou suprime uma reinicialização.
REBOOTPROMPT
Suprime a exibição de prompts de reinicializações para o usuário. Todas as reinicializações necessárias ocorrem automaticamente.
ROOTDRIVE
Unidade padrão para uma instalação.
SEQUENCE
Uma tabela que tem o esquema da tabela de sequência.
SHORTFILENAMES
Faz com que nomes de arquivo curtos sejam usados.
TRANSFORMS
Lista de transformações a serem aplicadas a um banco de dados.
TRANSFORMSATSOURCE
Informa ao instalador que as transformações de um produto residem na origem.
TRANSFORMSSECURE
Definir a propriedade TRANSFORMSECURE como um (1) informa ao instalador que as transformações devem ser armazenadas em cache localmente no computador do usuário em um local onde o usuário não tenha acesso de gravação.
MsiLogFileLocation
O instalador define o valor dessa propriedade como o caminho completo do arquivo de log, quando o registro em log estiver habilitado. Essa propriedade está disponível a partir do Windows Installer 4.0.
MsiLogging
Define o modo de log padrão para o pacote do Windows Installer. Essa propriedade está disponível a partir do Windows Installer 4.0.
MSIUSEREALADMINDETECTION
Defina essa propriedade como 1 para solicitar que o instalador use informações reais do usuário ao definir a propriedade AdminUser. Essa propriedade está disponível a partir do Windows Installer 4.0.

 

Propriedades de data e hora

As propriedades Data e Hora são propriedades dinâmicas que o instalador define quando os dados são extraídos.

Propriedade Descrição
Data
A data atual.
Hora
A hora atual.

 

Propriedades de opções de instalação de recursos

A lista a seguir fornece links para obter mais informações sobre as propriedades de opções de instalação de recursos.

Propriedade Descrição
ADDDEFAULT
Lista de recursos a serem instalados na configuração padrão.
ADDLOCAL
Lista de recursos a serem instalados localmente.
ADDSOURCE
Lista de recursos a serem executados da origem.
ADVERTISE
Lista de recursos a serem anunciados.
COMPADDDEFAULT
Lista de componentes a serem instalados na configuração padrão.
COMPADDLOCAL
Lista de IDs de componente a serem instaladas localmente.
COMPADDSOURCE
Lista de IDs de componente a serem executadas da mídia de origem.
FILEADDDEFAULT
Lista de chaves de arquivo para arquivos a serem instalados na configuração padrão.
FILEADDLOCAL
Lista de chaves de arquivo para arquivos a serem executados localmente.
FILEADDSOURCE
Lista de chaves de arquivo a serem executadas da mídia de origem.
MSIDISABLELUAPATCHING
Definir essa propriedade impede a aplicação de patch de LUA (usuário com privilégios mínimos) de um aplicativo.
MsiPatchRemovalList
Lista de patches a serem removidos durante a instalação.
MSIRESTARTMANAGERCONTROL
Especifica se o pacote usa a funcionalidade Gerenciador de reinicialização ou FilesInUse.
MSIDISABLERMRESTART
Especifica como aplicativos ou serviços que estão usando arquivos afetados por uma atualização devem ser desligados e reiniciados para habilitar a instalação da atualização.
MSIRMSHUTDOWN
Especifica como aplicativos ou serviços que estão usando arquivos afetados por uma atualização devem ser desligados para habilitar a instalação da atualização.
MSIPATCHREMOVE
Definir essa propriedade remove os patches.
PATCH
Definir essa propriedade aplica um patch.
REINSTALL
Lista de recursos a serem reinstalados.
REINSTALLMODE
Uma cadeia de caracteres que contém letras que especificam o tipo de reinstalação a ser executada.
REMOVE
Lista de recursos a serem removidos.

 

Propriedades de hardware

A lista a seguir identifica as propriedades de hardware que o Windows Installer define na inicialização.

Propriedade Descrição
Alpha
O nível do processador numérico ao ser executado em um processador Alfa.
Nota: Essa propriedade é obsoleta, a plataforma Alpha não tem suporte do Windows Installer.
BorderSide
A largura das bordas da janela, em pixels.
BorderTop
A altura das bordas da janela, em pixels.
CaptionHeight
A altura da área de legenda normal, em pixels.
ColorBits
O número de bits de cor adjacentes para cada pixel.
Intel
O nível do processador numérico ao executar em um processador Intel.
Intel64
O nível do processador numérico ao executar em um processador Itanium.
Msix64
O nível do processador numérico ao executar em um processador x64.
PhysicalMemory
O tamanho da RAM instalada, em megabytes.
ScreenX
A largura da tela, em pixels.
ScreenY
A altura da tela, em pixels.
TextHeight
A altura dos caracteres, em unidades lógicas.
VirtualMemory
A quantidade de espaço de arquivo de página disponível, em megabytes.

 

Propriedades de status da instalação

A lista a seguir fornece links para mais informações sobre propriedades de status que são atualizadas pelo instalador durante a instalação.

Propriedade Descrição
AFTERREBOOT
Indica que a instalação atual segue uma reinicialização invocada pela ação ForceReboot.
CostingComplete
Indica se o custo do espaço em disco está concluído.
Instalado
Indica que um produto já está instalado.
MSICHECKCRCS
O Installer fará um CRC em arquivos somente se a propriedade MSICHECKCRCS estiver definida.
MsiRestartManagerSessionKey
O Installer define essa propriedade como a chave da sessão para a sessão do Gerenciador de reinicialização.
MsiRunningElevated
O Installer define o valor dessa propriedade como 1 quando o instalador está em execução com privilégios elevados.
MsiSystemRebootPending
O Installer define essa propriedade como 1 se uma reinicialização do sistema operacional estiver pendente no momento.
MsiUIHideCancel
O Installer define MsiUIHideCancel como 1 quando o nível de instalação interno inclui INSTALLUILEVEL_HIDECANCEL.
MsiUIProgressOnly
O Installer define MsiUIProgressOnly como 1 quando o nível de instalação interno inclui INSTALLUILEVEL_PROGRESSONLY.
MsiUISourceResOnly
MsiUISourceResOnly como um (1) quando o nível de instalação interno incluir INSTALLUILEVEL_SOURCERESONLY.
NOCOMPANYNAME
Suprime a configuração automática da propriedade COMPANYNAME.
NOUSERNAME
Suprime a configuração automática da propriedade USERNAME.
OutOfDiskSpace
Espaço em disco insuficiente para acomodar a instalação.
OutOfNoRbDiskSpace
Espaço em disco insuficiente com a reversão desligada.
Preselected
Os recursos já estão selecionados.
PrimaryVolumePath
O Installer define o valor dessa propriedade como o caminho do volume designado pela propriedade PRIMARYFOLDER.
PrimaryVolumeSpaceAvailable
O Installer define o valor dessa propriedade como uma cadeia de caracteres que representa o número total de bytes disponíveis no volume que a propriedade PrimaryVolumePath referencia.
PrimaryVolumeSpaceRemaining
O Installer define o valor dessa propriedade como uma cadeia de caracteres que representa o número total de bytes restantes no volume ao qual a propriedade PrimaryVolumePath faz referência se todos os recursos selecionados atualmente estiverem instalados.
PrimaryVolumeSpaceRequired
O Installer define o valor dessa propriedade como uma cadeia de caracteres que representa o número total de bytes exigidos por todos os recursos selecionados atualmente no volume que a propriedade PrimaryVolumePath referencia.
ProductLanguage
LANGID (identificador de linguagem numérico) para o banco de dados. (NECESSÁRIO)
ReplacedInUseFiles
Defina se o instalador é instalado em um arquivo que está em uso.
RESUME
Instalação retomada.
RollbackDisabled
O instalador define essa propriedade quando a reversão está desabilitada.
UILevel
Indica o nível da interface do usuário.
UpdateStarted
Defina quando as alterações no sistema começaram para esta instalação.
UPGRADINGPRODUCTCODE
Definida pelo instalador quando uma atualização remove um aplicativo.
VersionMsi
O instalador define essa propriedade como a versão do Windows Installer que é executada durante a instalação.

 

Propriedades de sistema operacional

A lista a seguir fornece links para obter mais informações sobre as propriedades do sistema operacional que o Installer define na inicialização.

Nome da propriedade Breve descrição
AdminUser
Defina no Windows 2000 se o usuário tiver privilégios de administrador.
ComputerName
Nome do computador do sistema atual.
MsiNetAssemblySupport
Em sistemas que dão suporte a assemblies de Common Language Runtime, o Installer define o valor dessa propriedade para a versão de arquivo do fusion.dll. O Installer não definirá essa propriedade se o sistema operacional não oferecer suporte a assemblies de Common Language Runtime.
MsiNTProductType
Especifica a chave de produto do Windows.
MsiNTSuiteBackOffice
No Windows 2000 e em sistemas operacionais posteriores, o Installer define essa propriedade como um (1) somente se os componentes do Microsoft BackOffice estiverem instalados.
MsiNTSuiteDataCenter
No Windows 2000 e em sistemas operacionais posteriores, o Installer define essa propriedade como um (1) somente se o Windows 2000 Datacenter Server estiver instalado.
MsiNTSuiteEnterprise
No Windows 2000 e em sistemas operacionais posteriores, o Installer define essa propriedade como um (1) somente se o Windows 2000 Advanced Server estiver instalado.
MsiNTSuitePersonal
No Windows XP e em sistemas operacionais posteriores, o Instalador define essa propriedade como um (1) somente se o sistema operacional for Home (não Professional).
MsiNTSuiteSmallBusiness
No Windows 2000 e em sistemas operacionais posteriores, o Installer define essa propriedade como um (1) somente se o Microsoft Small Business Server estiver instalado.
MsiNTSuiteSmallBusinessRestricted
No Windows 2000 e em sistemas operacionais posteriores, o Instalador define essa propriedade como um (1) somente se o Microsoft Small Business Server estiver instalado com a licença restrita aos clientes.
MsiNTSuiteWebServer
No Windows 2000 e em sistemas operacionais posteriores, o Instalador define a propriedade MsiNTSuiteWebServer como um (1) se a edição da Web do Windows Server 2003 estiver instalada. Disponível somente na versão do Windows Server 2003 do Windows Installer.
MsiTabletPC
O instalador define essa propriedade com um valor diferente de zero se o sistema operacional atual for Windows XP Tablet PC Edition.
MsiWin32AssemblySupport
Em sistemas que dão suporte a assemblies do Win32, o Installer define o valor dessa propriedade para a versão de arquivo do sxs.dll. O Installer não definirá essa propriedade se o sistema operacional não oferecer suporte a assemblies do Win32.
OLEAdvtSupport
Defina se o OLE dá suporte ao Windows Installer.
RedirectedDllSupport
O Installer define a propriedade RedirectedDllSupport se o sistema que executa a instalação der suporte a Componentes Isolados.
RemoteAdminTS
O Installer define a propriedade RemoteAdminTS quando o sistema é um servidor de administração remota que executa o serviço de função de Servidor de Terminal.
ServicePackLevel
O número da versão do service pack do sistema operacional.
ServicePackLevelMinor
O número da versão secundária do service pack do sistema operacional.
SharedWindows
Defina quando o sistema está operando como o Windows Compartilhado.
ShellAdvtSupport
Defina se o shell dá suporte à publicidade de recursos.
SystemLanguageID
Identificador de idioma padrão para o sistema.
TerminalServer
Defina quando o sistema é um servidor que executa o serviço de função Servidor de Terminal.
TTCSupport
Indica se o sistema operacional dá suporte ao uso de arquivos .ttc (coleções de fontes True Type).
Version9X
Número da versão do sistema operacional Windows.
VersionDatabase
Versão numérica do banco de dados da instalação atual.
VersionNT
Número da versão do sistema operacional.
VersionNT64
Número da versão do sistema operacional se o sistema estiver em execução em um computador de 64 bits.
Compilação do Windows
Número de build do sistema operacional.

 

Propriedades de informações do produto

A lista a seguir fornece links para obter mais informações sobre propriedades específicas do produto especificadas na Tabela de propriedades.

Nome da propriedade Breve descrição
ARPHELPLINK
Endereço de Internet ou URL para obter suporte técnico.
ARPHELPTELEPHONE
Número de telefone do suporte técnico.
DiskPrompt
Cadeia de caracteres exibida por uma caixa de mensagem solicitando um disco.
IsAdminPackage
Defina como um (1) se a instalação atual estiver em execução a partir de um pacote criado por meio de uma instalação administrativa.
LeftUnit
Coloca unidades à esquerda do número.
Fabricante
Nome do fabricante do aplicativo. (Obrigatória)
MediaSourceDir
O instalador define essa propriedade como um (1) quando a instalação usa uma fonte de mídia, como um CD-ROM.
MSIINSTANCEGUID
A presença dessa propriedade indica que uma transformação de alteração de código do produto está registrada no produto.
MSINEWINSTANCE
Essa propriedade indica a instalação de uma nova instância de um produto com transformações de instância.
ParentProductCode
O instalador define essa propriedade para instalações executadas por uma ação de Instalação simultânea.
PIDTemplate
Cadeia de caracteres usada como um modelo para a propriedade PIDKEY.
ProductCode
Um identificador exclusivo para uma versão específica do produto. (Obrigatória)
ProductName
Nome legível de um aplicativo. (Obrigatória)
ProductState
Defina como o estado instalado de um produto.
ProductVersion
Formato de cadeia de caracteres da versão do produto como um valor numérico. (Obrigatória)
UpgradeCode
Um GUID que representa um conjunto relacionado de produtos.

 

Propriedades de atualização de informações de resumo

As propriedades a seguir são definidas apenas por transformações em arquivos .msp que são usados para atualizar o fluxo de informações de resumo de uma imagem administrativa.

Propriedade Descrição
PATCHNEWPACKAGECODE
O valor dessa propriedade é gravado na propriedade Resumo do número de revisão.
PATCHNEWSUMMARYCOMMENTS
O valor dessa propriedade é gravado na propriedade Resumo de comentários.
PATCHNEWSUMMARYSUBJECT
O valor dessa propriedade é gravado na propriedade Resumo de entidades.

 

Propriedades de pasta do sistema

A lista a seguir fornece links para mais informações sobre as pastas do sistema que o instalador define na instalação.

Propriedade Descrição
AdminToolsFolder
O caminho completo para o diretório que contém ferramentas administrativas.
AppDataFolder
O caminho completo para a pasta Roaming do usuário atual.
CommonAppDataFolder
O caminho completo para os dados do aplicativo de todos os usuários.
CommonFiles64Folder
O caminho completo para a pasta predefinida de Arquivos comuns de 64 bits.
CommonFilesFolder
O caminho completo para a pasta Arquivos comuns do usuário atual.
DesktopFolder
O caminho completo para a pasta Área de Trabalho.
FavoritesFolder
O caminho completo para a pasta Favoritos do usuário atual.
FontsFolder
O caminho completo para a pasta Fontes.
LocalAppDataFolder
O caminho completo para a pasta que contém aplicativos locais (não em roaming).
MyPicturesFolder
O caminho completo para a pasta Imagens.
NetHoodFolder
O caminho completo para a pasta NetHood.
PersonalFolder
O caminho completo para a pasta Documentos do usuário atual.
PrintHoodFolder
O caminho completo para a pasta PrintHood.
ProgramFiles64Folder
O caminho completo para a pasta predefinida de Arquivos de programa de 64 bits.
ProgramFilesFolder
O caminho completo para a pasta predefinida de Arquivos de programa de 32 bits.
ProgramMenuFolder
O caminho completo para a pasta do Menu Programas.
RecentFolder
O caminho completo para a pasta Recentes.
SendToFolder
O caminho completo para a pasta SendTo do usuário atual.
StartMenuFolder
O caminho completo para a pasta do menu Iniciar.
StartupFolder
O caminho completo para a pasta Inicialização.
System16Folder
O caminho completo para a pasta de DLLs do sistema de 16 bits.
System64Folder
O caminho completo para a pasta System64 predefinida.
SystemFolder
O caminho completo para a pasta Sistema do usuário atual.
TempFolder
O caminho completo para a pasta Temporária.
TemplateFolder
O caminho completo para a pasta Modelo do usuário atual.
WindowsFolder
O caminho completo para a pasta Windows.
WindowsVolume
O volume da pasta Windows.

 

Propriedades de informações do usuário

A lista a seguir fornece links para mais informações sobre as informações fornecidas por usuários.

Propriedade Descrição
AdminProperties
Lista de propriedades definidas durante uma instalação de administração.
COMPANYNAME
Nome da organização do usuário que está executando a instalação.
LogonUser
Nome de usuário dos usuários conectados no momento.
MsiHiddenProperties
Lista de propriedades impedidas de serem gravadas no registro.
PIDKEY
Parte da ID do Produto inserida pelo usuário.
ProductID
ID completa do produto após uma validação bem-sucedida.
UserLanguageID
Identificador de idioma padrão do usuário atual.
USERNAME
O usuário que está executando a instalação.
Propriedade UserSID
Definida pelo instalador de acordo com o SID (identificador de segurança) do usuário.