레이아웃에서 클라이언트 머신에 Visual Studio 배포
📣 여러분의 의견을 듣고 싶습니다!이 설문 조사 완료하고 레이아웃 환경을 개선하는 방법을 알려주세요. 귀하의 지원에 감사드립니다!
클라이언트 컴퓨터에 레이아웃을 배포하려면 먼저 다음 항목을 고려해야 합니다.
- 레이아웃준비: 레이아웃이 클라이언트에 설치할 준비가 되었는지 확인합니다.
- 클라이언트 컴퓨터준비: 클라이언트 컴퓨터가 Visual Studio를 설치할 준비가 되어 있고 사용자에게 올바른 권한이 있는지 확인합니다.
- 클라이언트 컴퓨터전역 정책 구성: 다른 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
사용하지 않으면 설치의 두 부분이 모두 완료되기 전에 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를 완전히 설치하려면 최소 45 -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 Collect 도구로그를 보낼 수 있으면 도움이 됩니다.
설치 관련 문제에 대한 설치 채팅(영어만 해당) 지원 옵션도 제공합니다.
다른 지원 옵션도 사용할 수 있습니다. 우리의 Visual Studio 개발자 커뮤니티을(를) 참조하세요.
관련 콘텐츠
- Visual Studio 관리자 가이드
- Visual Studio 네트워크 기반 설치 업데이트
- Visual Studio 설치하거나 사용할 때 네트워크 관련 오류 해결
- 네트워크 기반 Visual Studio 배포 대한 업데이트 제어
- Visual Studio 엔터프라이즈 배포에 대한 정책 구성
- Visual Studio 제품 수명 주기 및 서비스
- 명령줄 매개 변수를 사용하여 Visual Studio 설치
- Visual Studio 워크로드 및 구성 요소 ID
- 필요한 인증서 설치 Visual Studio 오프라인 설치