Implantar o Visual Studio em um computador cliente usando um layout

  • Artigo

Para implantar um layout em um computador cliente, você precisará considerar os seguintes tópicos primeiro:

Instalar o Visual Studio em um computador cliente usando um layout

Os administradores podem implantar um layout do Visual Studio em estações de trabalho cliente programaticamente como parte de um script de instalação.

Instalar usando um layout de rede

Um usuário com permissões de administrador pode instalar o Visual Studio usando um layout de rede em um modo autônomo executando o comando a seguir. Os response.json no layout fornece as configurações padrão para a instalação.

\\server\products\VS\vs_enterprise.exe --quiet --wait

Se o usuário selecionar itens que não estiverem disponíveis no layout, o instalador tentará obter esses arquivos adicionais de servidores hospedados pela Microsoft na Internet. Para garantir que o instalador não tente acessar a Internet ao instalar o produto, use a opção --noweb. Por exemplo, use este comando para executar a instalação e impedir que o computador cliente acesse a Internet:

\\server\products\VS\vs_enterprise.exe --noWeb --wait --passive --add Microsoft.VisualStudio.Workload.ManagedDesktop --add Microsoft.VisualStudio.Workload.NetWeb --includeOptional

Observação

Seja paciente. Verifique se você concluiu --wait para o instalador e para o produto. Ao instalar ou atualizar um cliente a partir de um layout, primeiro sempre será instalado ou atualizado o instalador e depois o próprio produto do Visual Studio. Esses dois processos precisam ser concluídos para uma atualização ser considerada bem-sucedida.

Ao executar a instalação ou atualização como parte de um arquivo em lote automatizado autônomo, a opção --wait é útil para garantir que o processo vs_enterprise.exe aguarde até que a instalação seja concluída antes de retornar um código de saída. Isso é útil se um administrador corporativo quiser executar ações adicionais na instalação concluída, tal como aplicar uma chave de produto a uma instalação bem-sucedida. O uso da opção --wait impede que as próximas operações sejam disparadas antecipadamente. Se você não usar --wait, o processo vs_enterprise.exe poderá ser encerrado antes que as duas partes da instalação sejam concluídas e retornará um código de saída impreciso, que não representará o estado da operação de instalação.

Instalar por meio de um local interno da intranet

Algumas empresas querem hospedar o layout em um local de intranet para gerenciar melhor gargalos de desempenho geográfico e aproveitar o cache da Web. Para implantar um layout hospedado na intranet em um computador cliente, um usuário com permissões de administrador precisa executar um script do PowerShell com privilégios elevados semelhante ao seguinte para inicializar a instalação no computador cliente.

    #Do the initial installation from the web hosted layout onto the client in an elevated PowerShell script

    #ADMIN CONFIGURATION
    #Enter layout URI here
    $LayoutUri = "http://MyCompanyIntranetSite/VS2022Enterprise/"

    #Enter bootstrapper name which is present in layout.
    $BootstrapperName = "vs_Enterprise.exe"

    #Add any arguments which you intend to send to bootstrapper.
    $Arguments = "--passive --wait"

    #SCRIPT FUNCTIONALITY
    #Forming URI for bootstrapper
    Write-Verbose "LayoutUri: $LayoutUri"
    $BootstrapperUri = "$LayoutUri/$BootstrapperName"
    Write-Verbose "BootstrapperUri: $BootstrapperUri"

    $Arguments += " --layoutUri $LayoutUri"
    Write-Verbose "Arguments: $Arguments"

    #Creating temp folder and download bootstrapper
    $VSLayoutFolderPath = Join-Path -Path $env:TEMP -ChildPath VSLayout
    $BootstrapperFile = Join-Path -Path $VSLayoutFolderPath -ChildPath $BootstrapperName
    Write-Verbose "The bootstrapper path is: $BootstrapperFile"

    if (Test-Path $VSLayoutFolderPath)
    {
    Write-Verbose "The directory exists - $VSLayoutFolderPath"
    if (Test-Path $BootstrapperFile)
    {
    Write-Verbose "Deleting file - $BootstrapperFile"
    Remove-Item $BootstrapperFile
    }
    }
    else
    {
    Write-Verbose "Creating folder - $VSLayoutFolderPath"
    New-Item -ItemType Directory -Path $VSLayoutFolderPath
    }

    Write-Verbose "Downloading bootstrapper from - $BootstrapperUri to $BootstrapperFile"
    Invoke-WebRequest -Uri $BootstrapperUri -OutFile $BootstrapperFile
    
    Write-Verbose "Starting bootstrapper -$BootstrapperFile with arguments $Arguments"
    start-process $BootstrapperFile $Arguments

Preparar os computadores cliente

Permissões

Verifique se a conta do sistema ou do usuário que está executando a instalação tem acesso adequado ao compartilhamento de rede que contém o layout. Para obter mais informações, confira a página Solucionar erros relacionados à rede ao instalar ou usar o Visual Studio.

Instalar em um cliente sem acesso à Internet

Você precisa verificar se todos os computadores cliente offline têm os certificados corretos instalados.

Quando você instala usando um layout, o instalador no cliente sempre procura os pacotes do Visual Studio no local do layout. No entanto, se o instalador tentar instalar componentes que não estejam incluídos no layout, ele tentará adquirir os pacotes do Visual Studio do origem de atualização, que os administradores geralmente configuram para apontar de volta para si mesmos.

Se você quiser impedir explicitamente que o Instalador do Visual Studio tente baixar conteúdo ausente dos servidores hospedados pela Microsoft na Web, use o parâmetro --noWeb. Se --noWeb for usado e o layout estiver sem um componente que esteja selecionado para ser instalado, a instalação falhará. Além disso, se --noWeb for usado e o layout estiver hospedado nos servidores Web da intranet, não em um compartilhamento de rede de arquivos, a configuração falhará.

Usar a opção --noweb geralmente corrige a mensagem de erro "Não foi possível encontrar um produto que corresponda aos parâmetros a seguir".

Recursos do computador

Verifique se o caminho de instalação completo tem menos de 80 caracteres e se o computador tem amplo armazenamento. Uma instalação completa do Visual Studio requer no mínimo 45 a 50 GB de espaço em disco.

Códigos de erro

Se você tiver usado o parâmetro --wait, dependendo do resultado da operação, a variável de ambiente %ERRORLEVEL% será definida como um dos seguintes valores:

Valor Resultado
0 A operação foi concluída com êxito
740 Elevação necessária
1001 O processo do instalador do Visual Studio está em execução
1003 O Visual Studio está em uso
1602 A operação foi cancelada
1618 Outra instalação em execução
1641 A operação foi concluída com êxito e a reinicialização foi iniciada
3010 A operação foi concluída com êxito, mas a instalação requer a reinicialização antes de ser usada
5003 O inicializador falhou ao baixar o instalador
5004 A operação foi cancelada
5005 Erro de análise de linha de comando do inicializador
5007 A operação foi bloqueada – o computador não atende aos requisitos
8001 Falha na verificação do computador Arm
8002 Falha de pré-verificação de download em segundo plano
8003 Falha selecionável sem suporte
8004 Falha no diretório de destino
8005 Falha de verificação de conteúdo de origem
8006 Processos do Visual Studio em execução
8010 Sistema operacional sem suporte. Consulte os Requisitos do Sistema
-1073720687 Falha de conectividade
–1073741510 O Instalador do Microsoft Visual Studio foi terminado (por usuário ou processo externo)
Outro
(por exemplo:
-1, 1, 1.603)		 Condição de falha ocorreu. Verifique os logs para obter mais informações

Obter suporte para implantar o layout

Se você tiver algum problema ao implantar o layout em um computador cliente, informe-nos. A melhor maneira de nos comunicar o assunto é usando a ferramenta Relatar um Problema, exibida no Instalador do Visual Studio e no IDE do Visual Studio. Se você for um Administrador de TI e não tiver o Visual Studio instalado, poderá enviar comentários de Administração de TI aqui. Ao usar essa ferramenta, você pode enviar os logs pela ferramenta VS Collect para nos ajudar a diagnosticar e corrigir o problema.

Também oferecemos uma opção de suporte por meio de chat de instalação (somente em inglês) para problemas relacionados à instalação.

Também temos outras opções de suporte disponíveis. Confira nossa Visual Studio Developer Community.

Conteúdo relacionado