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:
- Preparar o layout: Certifique-se de que seu layout está pronto para instalar no cliente.
- Preparar as máquinas cliente: Certifique-se de que as máquinas cliente estão prontas para instalar o Visual Studio e que os usuários têm as permissões certas.
- Configurar políticas globais na máquina cliente: Controle outros comportamentos de instalação, atualização, notificação e download do Visual Studio.
- Configurar padrões de instalação inicial do cliente: Inicialize a instalação do cliente com configurações personalizadas.
- Realize atualizações regulares: Mantenha as máquinas dos seus clientes atualizadas e seguras.
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.
Conteúdo relacionado
- Guia do administrador do Visual Studio
- Atualizar uma instalação baseada em rede do Visual Studio
- Solucionar erros relacionados à rede quando você instala ou usa o Visual Studio
- Controlar atualizações para implantações do Visual Studio baseadas em rede
- Configurar políticas para implantações corporativas do Visual Studio
- ciclo de vida do Visual Studio e suporte
- Usar parâmetros de linha de comando para instalar o Visual Studio
- Carga de Desenvolvimento do Visual Studio e IDs de Componentes
- Instalar certificados necessários para a instalação offline do Visual Studio