Compartilhar via


Implantar o Visual Studio em um computador cliente usando um layout

📣adoraríamos ouvir seus comentários!Reserve um momento para concluir esta pesquisa e informe-nos como podemos melhorar a experiência de layout. Obrigado por seu apoio!

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

Instalar o Visual Studio em um computador cliente a partir de 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 de um layout de rede em um modo autônomo executando o comando a seguir. Os response.json no layout fornecem 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 quando estiver instalando 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

Nota

Seja paciente. Verifique se você concluiu --wait para o instalador e para o produto. Ao instalar ou atualizar um cliente de um layout, o instalador é sempre a primeira coisa a ser instalado ou atualizado e, em seguida, o próprio produto do Visual Studio será instalado ou atualizado. Os 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 de lote automatizado não supervisionado, a opção --wait é útil para garantir que o processo de vs_enterprise.exe aguarde até que a instalação seja concluída antes de retornar um código de saída. Isso será útil se um administrador corporativo quiser executar outras ações em uma instalação concluída, como aplicar uma chave do produto a uma instalação bem-sucedida. O uso da opção --wait impede que as operações subsequentes sejam disparadas prematuramente. Se você não usar --wait, o processo de vs_enterprise.exe poderá ser encerrado antes que ambas as partes da instalação sejam concluídas e, portanto, retornará um código de saída impreciso que não representa o estado da operação de instalação.

Instalar a partir 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 de intranet em um computador cliente, um usuário com permissões de administrador deve executar um script elevado do PowerShell 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 o usuário ou a conta do sistema que está executando a instalação tem acesso adequado ao compartilhamento de rede que contém o layout. Para obter mais informações, consulte a página sobre como solucionar erros relacionados à rede ao instalar ou usar o Visual Studio.

Instalar em um cliente que não tem acesso à Internet

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

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

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

Usar a opção --noweb geralmente corrige a mensagem de erro "Um produto que corresponde aos parâmetros a seguir não pode ser encontrado".

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 um mínimo de 45 -50 GB de espaço em disco.

Códigos de erro

Se você usou 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 Operação 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 Operação concluída com êxito e reinicialização iniciada
3010 A operação foi concluída com êxito, mas a instalação requer reinicialização antes que possa ser usada
5003 Falha do Bootstrapper ao baixar o instalador
5004 A operação foi cancelada
5005 Erro de análise de linha de comando do Bootstrapper
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 de 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 Não há suporte para o Sistema Operacional. Consulte os requisitos do sistema
-1073720687 Falha de conectividade
-1073741510 O Instalador do Microsoft Visual Studio foi encerrado (pelo usuário ou pelo processo externo)
Outro
(por exemplo:
-1, 1, 1.603)
Condição de falha - verifique os logs para obter mais informações

Obter suporte para implantar seu layout

Se você tiver um problema ao implantar seu layout em um computador cliente, queremos saber mais sobre ele. A melhor maneira de nos informar é usando a ferramenta Relatar um Problema que aparece 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 feedback do Administrador de TI aqui. Ao usar essa ferramenta, seria útil se você pudesse enviar os logs pela ferramenta VS Collect, o que pode nos ajudar a diagnosticar e corrigir o problema.

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

Também temos outras opções de suporte disponíveis. Veja a nossa Comunidade de Desenvolvedores do Visual Studio .