Partilhar via


Implantar o Visual Studio a partir de um layout em uma máquina cliente

📣 Adoraríamos ouvir o seu feedback!Por favor, reserve um momento para completar este de pesquisa e deixe-nos saber como podemos melhorar a experiência de layout. Obrigado pelo vosso apoio!

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

Instalar o Visual Studio em uma máquina 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 a partir de um layout de rede

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

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

Se o usuário selecionar itens que não estão disponíveis no layout, o instalador tentará obter esses arquivos adicionais de servidores hospedados pela Microsoft na Internet. Para se certificar de que o instalador não tenta aceder à Internet quando está a instalar o produto, utilize o interruptor --noweb. Por exemplo, use este comando para executar a instalação e impedir que a máquina 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. Certifique-se de --wait para que o instalador e o produto terminem. Ao instalar ou atualizar um cliente a partir de um layout, o instalador é sempre a primeira coisa a ser instalado ou atualizado e, em seguida, o próprio produto Visual Studio será instalado ou atualizado. Ambos estes processos precisam ser concluídos para serem considerados uma atualização bem-sucedida.

Ao executar a instalação ou atualização num 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 esteja concluída antes de retornar um código de saída. Isso é ú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 evita que as operações subsequentes sejam iniciadas prematuramente. Se você não usar --wait, o processo de vs_enterprise.exe pode sair 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 de intranet

Algumas empresas desejam hospedar o layout em um local de intranet para gerenciar melhor os gargalos de desempenho geográfico e aproveitar o cache da Web. Para implantar um layout hospedado na intranet em uma máquina cliente, um usuário com permissões de administrador deve executar um script do PowerShell elevado semelhante ao seguinte para inicializar a instalação na máquina 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 as máquinas clientes

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 solucionar erros relacionados à rede ao instalar ou usar o Visual Studio.

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

Você precisa certificar-se de que todas as máquinas cliente offline tenham os certificados corretos instalados.

Quando você instala a partir de 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 estão incluídos no layout, ele tentará adquirir os pacotes do Visual Studio do de origem de atualização, que os administradores geralmente configuram para apontar de volta para si mesmo.

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

O uso da opção --noweb geralmente corrige a mensagem de erro "Não é possível encontrar um produto que corresponda aos seguintes parâmetros".

Recursos da máquina

Certifique-se de que o caminho de instalação completo tenha menos de 80 caracteres e que a máquina tenha 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% é definida como um dos seguintes valores:

valor Resultado
0 Operação concluída com êxito
740 Elevação necessária
1001 O processo de instalação do Visual Studio está em execução
1003 O Visual Studio está em uso
1602 Operação cancelada
1618 Outra instalação em execução
1641 Operação concluída com êxito e reinicialização foi iniciada
3010 Operação concluída com êxito, mas a instalação requer reinicialização antes de poder ser usada
5003 Falha do Bootstrapper ao descarregar o instalador
5004 Operação 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 da máquina ARM
8002 Falha na pré-verificação do download em segundo plano
8003 Falha selecionável não suportada
8004 Falha no diretório de destino
8005 Verificando a falha das cargas úteis de origem
8006 Processos do Visual Studio em execução
8010 Sistema operacional não suportado. Consulte os Requisitos do sistema
-1073720687 Falha de conectividade
-1073741510 Microsoft Visual Studio Installer foi encerrado (pelo usuário ou processo externo)
Outros
(por exemplo:
-1, 1, 1603)
Ocorreu uma condição de falha - verifique os logs para obter mais informações

Obtenha suporte para implantar seu layout

Se você tiver um problema ao implantar seu layout em uma máquina cliente, queremos saber sobre isso. A melhor maneira de nos informar é usando a ferramenta Report a Problem que aparece no Visual Studio Installer e no IDE do Visual Studio. Se for um administrador de TI e não tiver o Visual Studio instalado, envie feedback de administrador de TI aqui. Quando você usa essa ferramenta, seria útil se você pudesse enviar os logs pela ferramenta VS Collect, que pode nos ajudar a diagnosticar e corrigir o problema.

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

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