Referência de propriedade

  • Artigo

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.