레이아웃에서 클라이언트 머신에 Visual Studio 배포

  • 아티클

클라이언트 컴퓨터에 레이아웃을 배포하려면 먼저 다음 항목을 고려해야 합니다.

레이아웃 설치에서 클라이언트 컴퓨터에 Visual Studio 설치

관리자는 설치 스크립트의 일부로 Visual Studio 레이아웃을 클라이언트 프로그래밍적으로 워크스테이션에 배포할 수 있습니다.

네트워크 레이아웃에서 설치

관리자 권한이 있는 사용자는 다음 명령을 실행하여 무인 모드의 네트워크 레이아웃에서 Visual Studio를 설치할 수 있습니다. 이 response.json 레이아웃에서 설치에 대한 기본 구성 설정을 제공합니다.

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

사용자가 레이아웃에서 사용할 수 없는 항목을 선택한 경우 설치 관리자는 인터넷의 Microsoft 호스팅 서버에서 이러한 추가 파일을 원본으로 가져오려 노력합니다. 설치 관리자가 제품을 설치할 때 인터넷에 액세스하지 않게 하려면 --noweb 스위치를 사용합니다. 예를들면, 이 명령을 사용하여 설치를 실행하고 클라이언트 컴퓨터가 인터넷에 액세스하지 못하도록 합니다.

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

참고 항목

조금만 기다려주세요. --wait를 사용하여 설치 관리자와 제품이 완료될 때까지 기다리세요. 레이아웃에서 클라이언트를 설치하거나 업데이트하는 경우 항상 설치 관리자가 먼저 설치 또는 업데이트된 다음 Visual Studio가 설치 또는 업데이트됩니다. 두 가지 프로세스가 모두 완료되어야 업데이트가 성공적으로 이루어진 것으로 간주됩니다.

무인 자동 배치 파일의 일환으로 설치 또는 업데이트를 실행할 때 --wait 옵션을 사용하면 설치가 완료된 후에 종료 코드를 반환할 때까지 vs_enterprise.exe 프로세스가 기다리도록 할 수 있습니다. 이는 엔터프라이즈 관리자가 완료된 설치에 대한 추가 작업을 수행하려는 경우(예: 성공적인 설치에 제품 키 적용)에 유용합니다 --wait --wait 옵션을 사용하면 후속 작업이 너무 이르게 시작되지 않도록 할 수 있습니다. --wait를 사용하지 않으면 설치의 두 가지 프로세스가 완료되기 전에 vs_enterprise.exe 프로세스가 종료될 수 있으며, 따라서 설치 작업의 진정한 상태를 나타내지 않는 부정확한 종료 코드가 반환될 수 있습니다.

내부 인트라넷 위치에서 설치

일부 기업은 지리적 성능 병목 상태를 더 잘 관리하고 웹 캐싱을 활용하기 위해 인트라넷 위치에 레이아웃을 호스트하려고 합니다. 클라이언트 컴퓨터에 인트라넷 호스트된 레이아웃을 배포하려면 관리자 권한이 있는 사용자가 다음과 유사한 관리자 권한 PowerShell 스크립트를 실행하여 클라이언트 컴퓨터에서 설치를 초기화해야 합니다.

    #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

이 클라이언트 머신 준비

사용 권한

설치를 실행하는 사용자 또는 시스템 계정에 레이아웃이 포함된 네트워크 공유에 대한 적절한 액세스 권한이 있는지 확인합니다. 자세한 내용은 Visual Studio 페이지 설치 또는 사용 시의 네트워크 관련 오류 문제 해결을 참조하세요.

인터넷에 액세스할 수 없는 클라이언트에 설치

오프라인 클라이언트 컴퓨터에 올바른 인증서가 설치되어 있는지 확인해야 합니다.

레이아웃에서 설치할 때 클라이언트의 설치 관리자는 항상 레이아웃의 위치에서 Visual Studio 패키지를 찾습니다. 그러나 설치 관리자가 레이아웃에 포함되지 않은 구성 요소를 설치하려고 하면 업데이트 원본에서 Visual Studio 패키지를 가져오려고 시도하며 관리자는 종종 자신을 가리키도록 구성합니다.

Visual Studio 설치 관리자 웹의 Microsoft 호스팅 서버에서 누락된 콘텐츠를 다운로드하지 못하도록 명시적으로 방지하려면 이 --noWeb 매개 변수를 사용할 수 있습니다. 만약 --noWeb 사용하면 설치하도록 선택된 구성요소가 레이아웃에서 누락된 경우 설치가 실패합니다. 또한 파일 네트워크 공유가 아닌 인트라넷 웹 서버에서 레이아웃을 사용하고 호스트하는 경우 --noWeb 설치가 실패합니다.

스위치를 --noweb 사용하면 "다음 매개 변수와 일치하는 제품을 찾을 수 없습니다"라는 오류 메시지가 수정되는 경우가 많습니다.

컴퓨터 리소스

전체 설치 경로가 80자 보다 적고 컴퓨터에 충분한 스토리지가 있는지 확인합니다. 전체 Visual Studio 설치에는 디스크 공간이 최소 40 -50 GB가 필요합니다.

오류 코드

--wait 매개 변수를 사용한 경우 작업 결과에 따라 %ERRORLEVEL% 환경 변수는 다음 값 중 하나로 설정됩니다.

값 결과
0 작업이 완료되었습니다.
740 권한 상승 필요
1001 Visual Studio 설치 관리자 프로세스가 실행되고 있습니다.
1003 Visual Studio가 사용 중입니다.
1602 작업이 취소되었습니다.
1618 다른 설치 실행 중
1641 작업이 성공적으로 완료되고 재부팅이 시작되었습니다.
3010 작업이 완료되었지만, 사용하려면 다시 부팅해야 합니다.
5003 부트스트래퍼가 설치 관리자를 다운로드하지 못했습니다.
5004 작업이 취소되었습니다.
5005 부트스트래퍼 명령줄 구문 분석 오류
5007 작업이 차단되었습니다. - 컴퓨터가 요구 사항에 맞지 않습니다.
8001 Arm 머신 검사 오류
8002 백그라운드 다운로드 사전 검사 오류
8003 지원 중단 선택 가능 오류
8004 대상 디렉터리 오류
8005 소스 페이로드 확인 오류
8006 Visual Studio 프로세스 실행 중
8010 운영 체제가 지원되지 않습니다. 시스템 요구 사항 참조
-1073720687 연결 실패
-1073741510 Microsoft Visual Studio 설치 관리자가 종료되었습니다(사용자 또는 외부 프로세스에 의해).
기타
(예:
-1, 1, 1603)		 오류 조건 발생 - 자세한 내용은 로그를 확인하세요.

레이아웃에 배포에 관한 지원 받기

클라이언트 컴퓨터에 레이아웃을 배포하는 데 문제가 있는 경우 이에 대해 알고 싶습니다. 가장 좋은 방법은 Visual Studio 설치 관리자와 Visual Studio IDE에 있는 문제 보고 도구를 사용하는 것입니다. 본인이 IT 관리자이고 Visual Studio가 설치되어 있지 않다면 여기에서 IT 관리자 피드백을 제출할 수 있습니다. 이 도구를 사용하는 경우 VS 수집 도구의 로그를 함께 보내 주시면 문제를 진단하고 수정하는 데 도움이 됩니다.

설치 관련 문제를 위한 설치 채팅(영어만 가능) 지원 옵션도 제공됩니다.

다른 지원 옵션도 있습니다. Visual Studio Developer Community를 참조하세요.

관련 콘텐츠