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:
- Preparar o layout: verifique se o layout está pronto para ser instalado no cliente.
- Preparar os computadores cliente: verifique se os computadores cliente estão prontos para instalar o Visual Studio e se os usuários têm as permissões certas.
- Configurar políticas globais no computador cliente: controlar outros comportamentos de instalação, atualização, notificação e download do Visual Studio.
- Configurar os padrões iniciais de instalação do cliente: inicialize a instalação do cliente com configurações personalizadas.
- executar atualizações regulares: mantenha seus computadores cliente atualizados e seguros.
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:
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 .
Conteúdo relacionado
- guia de administrador do Visual Studio
- Atualizar uma instalação baseada em rede do Visual Studio
- Solucionar problemas de erros relacionados à rede ao instalar ou usar o Visual Studio
- Controlar atualizações para implantações do Visual Studio baseadas em rede
- Configurar políticas para implantações empresariais do Visual Studio
- Ciclo de vida e manutenção do produto Visual Studio
- Usar parâmetros de linha de comando para instalar o Visual Studio
- Carga de trabalho e IDs de componente do Visual Studio
- Instalar certificados necessários para a instalação offline do Visual Studio