Propriedade ALLUSERS

  • Artigo

A propriedade ALLUSERS configura o contexto de instalação do pacote. O Windows Installer executa uma instalação por usuário ou instalação por computador, dependendo dos privilégios de acesso do usuário, se privilégios elevados são necessários para instalar o aplicativo, o valor da propriedade ALLUSERS, o valor da propriedade MSIINSTALLPERUSER e a versão do sistema operacional.

O valor da propriedade ALLUSERS, no momento da instalação, determina o contexto de instalação.

  • Um valor da propriedade ALLUSERS de 1 especifica o contexto de instalação por computador.

  • Um valor da propriedade ALLUSERS de uma cadeia de caracteres vazia ("") especifica o contexto de instalação por usuário.

  • Se o valor da propriedade ALLUSERS for definido como 2, o Windows Installer sempre redefinirá o valor da propriedade ALLUSERS como 1 e executará uma instalação por computador ou redefinirá o valor da propriedade ALLUSERS como uma cadeia de caracteres vazia ("") e executará uma instalação por usuário. O valor ALLUSERS=2 permite que o sistema redefina o valor de ALLUSERS e o contexto de instalação, dependendo dos privilégios do usuário e da versão do Windows.

    Windows 7: defina a propriedade ALLUSERS como 2 para usar a propriedade MSIINSTALLPERUSER para especificar o contexto de instalação. Defina a propriedade MSIINSTALLPERUSER como uma cadeia de caracteres vazia ("") para uma instalação por computador. Defina a propriedade MSIINSTALLPERUSER como 1 para uma instalação por usuário. Se o pacote tiver sido gravado seguindo as diretrizes de desenvolvimento descritas em Criação de Pacote Único, os usuários com acesso de usuário poderão instalar no contexto por usuário, sem precisar fornecer credenciais de UAC. Se o usuário tiver privilégios de acesso do usuário, o instalador executará uma instalação por computador somente se as credenciais de Administrador forem fornecidas à caixa de diálogo UAC.

    Windows Vista: defina a propriedade ALLUSERS como 2 e o Windows Installer estará em conformidade com o UAC (Controle de Conta de Usuário). Se o usuário tiver privilégios de acesso do usuário e ALLUSERS=2, o instalador executará uma instalação por computador somente se as credenciais de Administrador forem fornecidas à caixa de diálogo UAC. Se o UAC estiver habilitado e as credenciais de Administrador corretas não forem fornecidas, a instalação falhará com um erro informando que os privilégios de administrador são necessários. Se o UAC estiver desabilitado pela chave do registro, pela política de grupo ou pelo painel de controle, a caixa de diálogo UAC não será exibida e a instalação falhará com um erro informando que os privilégios de administrador são necessários.

    Windows XP: defina a propriedade ALLUSERS como 2 e o Windows Installer executará uma instalação por usuário, se o usuário tiver privilégios de acesso do usuário.

  • Se o valor da propriedade ALLUSERS não for igual a 2, o Windows Installer ignorará o valor da propriedade MSIINSTALLPERUSER.

Exemplo

  <!-- Disallow user from installing for all users -->
    <Property Id="ALLUSERS" Secure="yes"/>
    <Condition Message="Setting the ALLUSERS property is not allowed because [ProductName] is a per-user application. Setup will now exit.">
      NOT ALLUSERS
    </Condition>

Exemplo das Amostras do Windows Classic no GitHub.

Valor padrão

O contexto de instalação padrão recomendado é por usuário. Se ALLUSERS não estiver definido, o instalador fará uma instalação por usuário. Você pode verificar se a propriedade ALLUSERS não foi definida, definindo o valor como uma cadeia de caracteres vazia (""), ALLUSERS="".

Comentários

O contexto de instalação determina os valores das propriedades DesktopFolder, ProgramMenuFolder, StartMenuFolder, StartupFolder, TemplateFolder, AdminToolsFolder, ProgramFilesFolder, CommonFilesFolder, ProgramFiles64Folder e CommonFiles64Folder. O contexto de instalação determina as partes do registro onde as entradas na tabela Registry e na tabela RemoveRegistry, com -1 na coluna Root, são gravadas ou removidas.

Requisitos

Requisito Valor
Versão
 Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.

Confira também

Propriedades

MSIINSTALLPERUSER

Contexto de instalação

Criação de pacote único