다음을 통해 공유

명령줄 매개 변수를 사용하여 SQL Server Management Studio 설치

적용 대상:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

SQL Server Management Studio 21은 SQL Server 인스턴스, Azure SQL 데이터베이스 및 Azure SQL 관리형 인스턴스를 관리하기 위한 강력한 도구입니다. 이 문서에서는 명령줄 매개 변수를 사용하여 SQL Server Management Studio 21을 설치하여 보다 사용자 지정되고 자동화된 설치 프로세스를 허용하는 방법에 대한 자세한 지침을 제공합니다. SQL Server Management Studio 21을 처음으로 설치하든 기존 설치를 업데이트하든 관계없이 이러한 지침은 목표를 달성하는 데 필요한 단계를 제공합니다.

명령줄 매개 변수

프로그래밍 방식으로 또는 명령 프롬프트에서 SSMS(SQL Server Management Studio)를 설치하는 경우 다양한 명령줄 매개 변수를 사용하여 설치를 제어하거나 사용자 지정하여 다음 작업을 수행할 수 있습니다.

  • 특정 옵션 및 동작이 미리 선택된 상태에서 클라이언트에서 설치를 시작합니다.
  • 설치 또는 업데이트 프로세스를 자동화합니다.
  • 클라이언트 머신을 설치하거나 업데이트하기 위해 제품 파일의 네트워크 레이아웃을 만들거나 유지 관리합니다.

다음 명령줄 동사 및 매개 변수는 다음 실행 파일 또는 프로그램과 함께 사용할 수 있습니다.

  • 다운로드 프로세스 및 초기 설치를 시작하는 작은 파일(예 vs_SSMS.exe: 5MB)인 설치 부트스트래퍼입니다.
  • 이미 컴퓨터에 설치되어 있으며, 폴더 C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe에 위치한 Visual Studio 설치 관리자입니다. 설치 관리자가 있는 다른 디렉터리에서 프로그래밍 방식으로 설치 관리자를 시작해야 합니다. 설치 관리자는 일반적으로 업데이트 또는 수정 명령에 사용됩니다.

이러한 각 상황에서는 모든 명령이나 매개 변수가 작동하지 않으며 특별한 주의 사항이나 예외가 문서화되어 있습니다. 또한 일부 시나리오에서는 앞에서 설명한 모든 실행 파일에 대한 액세스 권한이 없을 수 있습니다. 예를 들어 클라이언트 컴퓨터에는 SSMS가 레이아웃을 통해 설치된 경우에만 프로그래밍 방식으로 실행할 수 있는 설치 관리자가 있을 수 있습니다.

항상 선택한 채널의 최신 버전을 설치하는 SQL Server Management Studio 21의 최신 부트스트래퍼를 얻으려면 다음 표의 파일 중 하나를 다운로드합니다. 또는 SQL Server Management Studio 21의 특정 버전 또는 특정 채널을 설치하려면 SQL Server Management Studio에 대한 릴리스 기록을 참조하세요. 이 문서에는 각 서비스 릴리스에 대한 고정 버전 부트스트래퍼에 대한 링크가 있습니다.

채널 버전 부트스트래퍼
해제 21.0.0 SQL Server Management Studio

팁 (조언)

이전에 부트스트래퍼 파일을 다운로드한 경우 설치하기 전에 설치 버전을 확인할 수 있습니다. 파일 탐색기를 열고 부트스트래퍼 파일을 마우스 오른쪽 단추로 클릭하고 속성을 선택한 다음 세부 정보 탭을 선택합니다. 제품 버전 필드는 부트스트래퍼가 설치하는 채널 및 버전을 설명합니다. 버전 번호는 항상 "지정된 항목의 최신 서비스 버전"으로 읽혀야 하며 명시적으로 지정하지 않는 한 채널은 Release입니다. 제품 버전 명시가 "SQL Server Management Studio 21"인 부트스트래퍼는 릴리스 채널에서 SQL Server Management Studio 21의 최신 버전을 설치합니다.

명령 및 명령줄 매개 변수 설치, 업데이트, 수정, 복구, 제거 및 내보내기

SSMS 부트스트래퍼 또는 설치 관리자가 프로그래밍 방식으로 호출되면 제품을 설치하거나 레이아웃을 유지 관리합니다.

  • 첫 번째 매개 변수는 수행할 작업을 설명하는 명령(동사)입니다.
  • 두 개의 대시(--)를 접두사로 갖는 후속 선택적 명령줄 매개 변수는 해당 작업이 수행되는 방식을 추가로 정의합니다.

모든 SSMS 명령줄 매개 변수는 대/소문자를 구분하지 않습니다.

구문 예제: vs_SSMS.exe [command] <optional parameters>...

명령 설명
(공백) 기본 명령은 둘 다 제품을 설치하며 모든 레이아웃 유지 관리 작업에 사용됩니다.
modify 설치된 제품을 수정합니다.
update 설치된 제품을 업데이트합니다.
updateall 설치된 모든 제품을 순차적으로 업데이트합니다. --quiet 및 --passive 매개 변수와 함께 작동합니다.
repair 설치된 제품을 복구합니다.
uninstall 설치된 제품을 제거합니다.
export 설치 구성을 *.vsconfig 파일로 내보냅니다.

중요합니다

각 고유 워크로드, 구성 요소, 또는 언어에 대해 명령줄 스위치 --add 또는 --remove를 반복해야 합니다.

매개 변수 설명
--installPath <dir> 기본 설치 명령의 경우 이 매개 변수는 선택적 클라이언트 컴퓨터에 인스턴스가 설치되는 위치를 설명합니다. 업데이트 또는 수정과 같은 다른 명령의 경우 이 매개 변수는 필수 인스턴스의 설치 디렉터리를 나타냅니다.
--productId <id> 선택적: 수정되고 --channelId와 함께 사용되는 제품 인스턴스의 ID입니다. productId은 Microsoft.VisualStudio.Product.SSMS입니다.
--channelUri 선택적: 업데이트 명령 중에 새 --channelUri 전달하여 업데이트 설정 위치를 변경할 수 있습니다. 구성 중인 SSMS 인스턴스가 명시적으로 표시되도록 매개 변수와 --installPath 페어링하는 것이 좋습니다. 구문 예제를 --channelUri 참조하세요.
--channelId <id> 채널의 ID(예: SSMS.21.SSMS.Preview)입니다. channelId은(는) 작업을 수정하기 위해 --productId 또는 --installPath와 함께 필요합니다.
--add <one or more workload or component IDs> 선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 추가할 하나 이상의 워크로드 또는 구성 요소 ID를 지정합니다. 아티팩트에서 필요한 구성 요소가 설치되어 있지만 권장 구성 요소나 선택적 구성 요소는 설치되지 않습니다. --includeRecommended 및/또는 --includeOptional 매개 변수를 사용하여 다른 구성 요소를 전역적으로 제어할 수 있습니다. 여러 워크로드 또는 구성 요소를 포함하려면 --add 명령(예: --add Workload1 --add Workload2)을 반복합니다. 세분화된 컨트롤의 경우 ID(예: ;includeRecommended 또는 ;includeOptional)에 --add Workload1;includeRecommended 또는 --add Workload2;includeRecommended;includeOptional 추가할 수 있습니다.
--all 선택적: 설치 또는 수정 명령 중에 이 매개 변수를 사용하면 제품의 모든 워크로드 및 구성 요소가 설치됩니다.
--allWorkloads 선택적: 설치 또는 수정 명령 중에 이 매개 변수는 모든 워크로드 및 구성 요소를 설치하지만 권장 구성 요소나 선택적 구성 요소는 설치하지 않습니다.
--includeRecommended 선택적: 설치 또는 수정 명령 중에 이 매개 변수에는 설치된 모든 워크로드에 대한 권장 구성 요소가 포함됩니다. 선택적 구성 요소는 포함되지 않습니다. 워크로드는 --allWorkloads 또는 --add사용하여 지정됩니다. 매개 변수를 --includeRecommended 사용하여 업데이트 설정 대화 상자를 사용하여 "업데이트에 설치된 워크로드에 권장 구성 요소를 추가"할 수 있습니다. 이 설정을 변경하려면 업데이트 설정 사용자 지정 참조하세요.
--includeOptional 선택적: 설치 또는 수정 명령 중에 이 매개 변수에는 설치된 모든 워크로드에 대한 선택적 구성 요소가 포함됩니다. 권장 구성 요소는 포함되지 않습니다. 워크로드는 --allWorkloads 또는 --add사용하여 지정됩니다.
--addProductLang <language-locale> 선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 제품과 함께 설치해야 하는 UI 언어 팩을 지정합니다. 설치가 없으면 컴퓨터 로캘에 해당하는 언어 팩을 사용합니다. 자세한 내용은 [언어 로캘 목록]을 참조하세요.
--remove <one or more workload or component IDs> 선택적: 수정 명령 중에 이 반복 가능한 매개 변수는 제거할 하나 이상의 워크로드 또는 구성 요소 ID를 지정합니다. --add 매개 변수와 비슷하게 보완하고 동작합니다.
--addProductLang <language-locale> 선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 제품과 함께 설치해야 하는 UI 언어 팩을 지정합니다. 설치가 없으면 컴퓨터 로캘에 해당하는 언어 팩을 사용합니다. 자세한 내용은 이 문서의 언어 로캘 목록 섹션을 참조하세요.
--removeProductLang <language-locale> 선택적: 설치 또는 수정 명령 중에 이 반복 가능한 매개 변수는 제품에서 제거해야 하는 UI 언어 팩을 결정합니다. --addProductLang 매개 변수와 비슷하게 보완하고 동작합니다.
--in <path> 선택 사항: 구성 설정을 포함할 수 있는 응답 파일의 URI 또는 경로입니다.
--quiet 선택적: 명령과 함께 사용되며, 이 매개 변수는 명령이 실행되는 동안 사용자 인터페이스가 표시되지 않도록 합니다. AllowStandardUserControl 정책 설정 방법에 관계없이 표준 사용자가 프로그래밍 방식으로 사용할 수 없습니다.
--passive, -p 선택적: 이 매개 변수를 사용하면 사용자 인터페이스가 비대화형 방식으로 표시됩니다. 이 매개 변수는 --quiet 매개 변수와 서로 배타적이며, 실제로 이를 무효화합니다. 또한 AllowStandardUserControl 정책 설정 방법에 관계없이 표준 사용자가 프로그래밍 방식으로 사용할 수 없습니다.
--norestart 선택적: 이 매개 변수는 --passive 또는 --quiet 매개 변수와 쌍으로 사용해야 합니다. 설치, 업데이트 또는 수정 명령을 실행하는 동안 --norestart 매개 변수를 추가하면 필요한 재부팅이 지연됩니다.
--force 선택 사항: 이 매개 변수는 SSMS 프로세스가 사용 중인 경우에도 SSMS를 강제로 닫습니다. SSMS를 강제로 닫으면 작업 손실이 발생할 수 있으므로 주의해서 사용합니다.
--installWhileDownloading 선택 사항: 설치, 업데이트 또는 수정 명령 중에 이 매개 변수를 사용하면 SSMS에서 제품을 병렬로 다운로드하고 설치할 수 있습니다. 기본 환경입니다.
--downloadThenInstall 선택 사항: 설치, 업데이트 또는 수정 명령을 수행하는 동안 이 매개 변수는 SSMS에서 파일을 설치하기 전에 모든 파일을 다운로드하도록 강제합니다. --installWhileDownloading 매개 변수와 상호 배타적입니다.
--nickname <name> 선택적: 설치 명령 중에 이 매개 변수는 설치된 제품에 할당할 애칭을 정의합니다. 애칭은 10자를 초과할 수 없습니다.
--removeOos true 선택적: 설치, 업데이트 또는 수정 명령 중에, 이 매개 변수가 true 또는 false와 함께 제공되면 Visual Studio 설치 관리자에게 지원되지 않는 상태로 전환된 모든 설치된 구성 요소를 제거해야 하는지를 지시합니다. 이 동작은 단일 이벤트에 적용할 수 있습니다. 이 동작을 영구적으로 설정하려면 나중에 설명한 명령에 이 매개 변수를 modifySettings 적용하거나 전역 정책을 구성 removeOOS 합니다. 컴퓨터를 안전하게 유지하는 데 유용합니다.
--config <path to *.vsconfig file> 선택적: 설치 또는 수정 작업 중에 --config 매개 변수를 사용하여 구성 파일을 전달하여 이전에 저장된 설치 구성 파일을 기반으로 추가할 워크로드, 구성 요소 또는 확장을 지정할 수 있습니다. 이 작업은 가산적일 뿐입니다. 파일에 지정되지 않은 항목은 제거하지 않습니다. 또한 제품에 적용되지 않는 구성 파일에 지정된 항목은 추가되지 않습니다. 구성 파일의 정규화된 경로를 지정하는 것이 좋습니다. 내보내기 작업 중에 이 매개 변수는 설치 구성 파일을 저장할 위치를 결정합니다.
--allowUnsignedExtensions 선택적: 설치 또는 수정 작업이 --passive 파일을 사용하여 --quiet 또는 --config 컨텍스트에서 실행되는 동안 구성 파일에 확장이 지정된 경우 디지털 서명 없이 확장을 로드하기 위해 이 매개 변수가 필요합니다.
--installerOnly 선택 사항: 설치 또는 업데이트 작업 중에 이 매개 변수는 Visual Studio 설치 관리자 SSMS 제품이 아닌 자체(설치 관리자)만 설치하도록 지시합니다. 해당 기능은 --update 매개 변수와 동일하지만 더 직관적입니다. 클라이언트 머신을 준비하고 미리 구성할 때 사용됩니다.
--help, --?, -h, -? 이 문서의 오프라인 버전을 표시합니다.

레이아웃 명령 및 명령줄 매개 변수

레이아웃 만들기 또는 업데이트와 같은 모든 레이아웃 관리 작업은 부트스트래퍼 exe를 사용하여 실행되며 명령이 기본 설치(비어 있음)라고 가정합니다. 모든 레이아웃 관리 작업은 필요한 --layout 초기 매개 변수로 시작해야 합니다. 다음 표에는 명령줄을 사용하여 레이아웃을 만들거나 업데이트하는 데 사용할 수 있는 그 밖의 매개 변수가 설명되어 있습니다.

레이아웃 매개 변수 설명
--layout <dir> 오프라인 설치 캐시를 만들거나 업데이트할 디렉터리를 지정합니다.
--lang <one or more language-locales> 선택적: 지정된 언어를 하나 이상 사용하여 리소스 패키지가 있는 오프라인 설치 캐시를 준비하기 위해 --layout 함께 사용됩니다. 자세한 내용은 이 문서의 언어 로캘 목록 섹션을 참조하세요.
--add <one or more workload or component IDs> 선택적: 추가할 하나 이상의 워크로드 또는 구성 요소 ID입니다. 아티팩트에서 필요한 구성 요소가 설치되어 있지만 권장 구성 요소나 선택적 구성 요소는 설치되지 않습니다. --includeRecommended 및/또는 --includeOptional사용하여 전역적으로 더 많은 구성 요소를 제어할 수 있습니다. 세분화된 컨트롤의 경우 ID(예: ;includeRecommended 또는 ;includeOptional)에 --add Workload1;includeRecommended 또는 --add Workload2;includeOptional 추가할 수 있습니다.

참고: --add 사용하는 경우 지정된 워크로드 및 구성 요소 및 해당 종속성만 다운로드됩니다. --add 지정되지 않으면 모든 워크로드 및 구성 요소가 레이아웃에 다운로드됩니다.
--includeRecommended 선택적: 설치된 워크로드에 권장되는 구성 요소를 포함하지만 선택적 구성 요소는 포함하지 않습니다. 워크로드는 --allWorkloads 또는 --add사용하여 지정됩니다.
--includeOptional 선택적: 레이아웃에 포함되는 모든 워크로드에 대해 권장되는 및 선택적 구성 요소를 포함합니다. 워크로드가 --add으로 특정됩니다.
--wait 선택적: 프로세스는 종료 코드를 반환하기 전에 설치가 완료될 때까지 기다립니다. wait 설치가 완료되어 해당 설치의 반환 코드를 처리할 때까지 기다려야 하는 설치를 자동화할 때 유용합니다. --wait 매개 변수는 부트스트래퍼에만 전달될 수 있습니다. 설치 관리자(setup.exe)는 이를 지원하지 않습니다. 레이아웃을 업데이트할 때 유용합니다.
--config <path to *.vsconfig file> 선택 사항: 있는 경우 SSMS는 구성 파일의 콘텐츠를 사용하여 레이아웃을 구성합니다. 구성 파일의 전체 경로를 정확하게 지정해야 합니다.
--noWeb 선택 사항: 있는 경우 SSMS 설정은 레이아웃 디렉터리의 파일을 사용하여 SSMS를 설치하며 웹에서 패키지를 다운로드하지 않습니다. 사용자가 레이아웃에 없는 구성 요소를 설치하려고 하면 설치가 실패합니다. 내부 인트라넷 웹 사이트에서 호스트되는 레이아웃을 배포하려는 경우 이 매개 변수를 사용하지 마세요.

중요: --noWeb 매개 변수는 클라이언트가 Microsoft 호스트된 서버에서 업데이트를 확인하도록 구성된 경우 인터넷에 연결된 클라이언트 컴퓨터의 Visual Studio 설치 관리자가 업데이트를 확인하는 것을 중지하지 않습니다. 이 경우 --noWeb 클라이언트가 제품 패키지를 다운로드하지 못하게 합니다.
--verify 선택적: 레이아웃의 내용을 확인합니다. 손상되었거나 누락된 모든 파일이 나열됩니다.
--fix 선택적: 레이아웃의 내용을 확인합니다. 파일이 손상되었거나 누락된 경우 다시 로드됩니다. 레이아웃을 수정하려면 인터넷 액세스가 필요합니다.
--clean <one or more paths to catalogs> 선택 사항: 최신 버전으로 업데이트되는 레이아웃에서 이전 버전의 구성 요소를 제거합니다.
고급 레이아웃 매개 변수 설명
--channelId <id> 선택적: 설치할 인스턴스에 대한 채널의 ID로, SSMS.21.SSMS.Preview같이 표시됩니다. channelId 는 설치 명령에 필요하며 지정된 경우 --installPath 다른 명령에 대해서는 무시됩니다. 자세한 내용은 구문 예제를 참조--channelId.
--channelUri <uri> 선택적: 채널 매니페스트의 URI입니다. 이 값은 업데이트 의 원본 위치를 제어하며 초기 값은 레이아웃의 response.json 파일에 구성됩니다. 업데이트를 원하지 --channelUri 않는 경우 존재하지 않는 파일(예 --channelUri C:\doesntExist.chman: )을 가리킬 수 있습니다. 이 매개 변수는 설치 명령에 사용할 수 있습니다. 다른 명령은 무시합니다.
--installChannelUri <uri> 선택적: 설치에 사용할 채널 매니페스트의 URI입니다. --channelUri으로 지정된 URI는 --installChannelUri이 지정될 때 반드시 지정되어야 하며, 이 URI는 업데이트를 감지하는 데 사용됩니다. 이 매개 변수는 설치 명령에 사용할 수 있습니다. 다른 명령은 무시합니다.
--installCatalogUri <uri> 선택적: 설치에 사용할 카탈로그 매니페스트의 URI입니다. 지정된 경우 채널 관리자는 설치 채널 매니페스트에서 URI를 사용하기 전에 이 URI에서 카탈로그 매니페스트를 다운로드하려고 시도합니다. 이 매개 변수는 레이아웃 캐시가 이미 다운로드된 제품 카탈로그를 사용하여 만들어진 오프라인 설치를 지원하는 데 사용됩니다. 이 매개 변수는 설치 명령에 사용할 수 있습니다. 다른 명령은 무시합니다.
--productId <id> 선택적: 설치된 인스턴스에 대한 제품의 ID입니다. 이 매개 변수는 일반 설치 조건에서 미리 채워집니다. productId은 Microsoft.VisualStudio.Product.SSMS입니다.
--keepLayoutVersion 선택적: 레이아웃에 포함된 제품 버전을 업데이트하지 않고 레이아웃에 변경 내용을 적용합니다.
--locale <language-locale> 선택적: 설치 관리자 자체에 대한 사용자 인터페이스의 표시 언어를 변경합니다. 설정이 유지됩니다. 자세한 내용은 이 문서의 언어 로캘 목록 섹션을 참조하세요.
--cache 선택적: 존재하는 경우, 패키지는 설치된 후에도 후속 수리를 위해 보관됩니다. 이는 후속 설치, 복구 또는 수정에 사용할 전역 정책 설정을 재정의합니다. 기본 정책은 패키지를 캐시하는 것입니다. 제거 명령에 대해서는 무시됩니다.
--nocache 선택적: 있는 경우 패키지를 설치하거나 복구한 후 삭제됩니다. 필요한 경우에만 다시 다운로드되고 사용 후 다시 삭제됩니다. 이는 후속 설치, 복구 또는 수정에 사용할 전역 정책 설정을 재정의합니다. 기본 정책은 패키지를 캐시하는 것입니다. 제거 명령에 대해서는 무시됩니다.
--noUpdateInstaller 선택 사항: 있는 경우 지정된 경우 quiet 설치 관리자가 자체적으로 업데이트되지 않도록 합니다. 설치 관리자 업데이트가 필요할 때 --noUpdateInstaller를 quiet와 함께 지정한 경우, 설치 관리자는 명령에 실패하고 0이 아닌 종료 코드를 반환합니다.
--path <name>=<path> 선택적: 설치에 대한 사용자 지정 설치 경로를 지정하는 데 사용됩니다. 지원되는 경로 이름은 공유, 캐시 및 설치됩니다.
--path cache=<path> 선택적: 지정한 위치를 사용하여 설치 파일을 다운로드합니다. 이 위치는 SSMS가 처음 설치된 경우에만 설정할 수 있습니다. 예: --path cache="C:\SSMS\cache"
--path shared=<path> 선택 사항: 병렬 SSMS 및 Visual Studio 설치를 위한 공유 파일을 포함합니다. 일부 도구 및 SDK는 이 드라이브의 위치에 설치되는 반면, 다른 도구와 SDK는 이 설정을 재정의하고 다른 드라이브에 설치할 수 있습니다. 예: --path shared="C:\VS\shared"

중요: SSMS 또는 Visual Studio를 처음 설치할 때 한 번만 설정할 수 있습니다.
--path install=<path> 선택적: –-installPath동일합니다. 특히 --installPath "C:\SSMS" 및 --path install="C:\SSMS" 동일합니다. 이러한 명령 중 하나만 한 번에 사용할 수 있습니다.

ModifySettings 명령 및 명령줄 매개 변수

클라이언트 컴퓨터의 설치 관리자 또는 부트스트래퍼를 사용하고 modifySettings 명령 및 원하는 업데이트 채널을 전달하여 업데이트 설정을 수정하고 지정된 SSMS 인스턴스에 대한 업데이트 원본 위치를 프로그래밍 방식으로 구성할 수 있습니다.

명령 설명
modifySettings 특정 SSMS 인스턴스의 업데이트 설정을 수정하는 데 사용되는 동사입니다.
설정 수정 매개 변수 설명
--installPath <dir> 수행할 SSMS 인스턴스를 지정하는 데 사용하는 것이 좋습니다 .
--newChannelUri 필수: 채널 매니페스트의 URI입니다. 이 값은 업데이트 다음 원본 위치를 지정합니다. 업데이트를 원하지 --channelUri 않는 경우 존재하지 않는 파일(예 --channelUri C:\doesNotExist.chman: )을 가리킬 수 있습니다.
--channelUri 이전 채널 매니페스트의 URI입니다. 알 수 없는 경우 --installPath 사용할 수 있습니다. 반드시 --productId와 함께 사용하여 작업할 올바른 인스턴스를 식별해야 합니다.
--productId <id> 지정된 경우 --channelUri 사용해야 하며 적절한 인스턴스를 식별하는 데 사용해야 합니다. productId은 Microsoft.VisualStudio.Product.SSMS입니다.
--includeRecommended 선택 사항: modifySettings 명령 중에 이 매개 변수(true 또는 false라는 단어가 있어야 함)는 업데이트 설정 대화 상자에서 SSMS 설치 관리자에게 "업데이트 시 설치된 워크로드에 권장 구성 요소 추가" 기능을 사용하지 않도록 설정하도록 지시합니다.
--quiet 선택적: 이 매개 변수는 명령이 실행되는 동안 사용자 인터페이스가 표시되지 않도록 합니다. 표준 사용자는 프로그래밍 방식으로 사용할 수 없습니다.
--removeOos true 선택 사항: modifySettings 명령 중에 이 매개 변수(true 또는 false라는 단어가 있어야 함)는 SSMS 설치 관리자에게 지원되지 않는 상태로 전환된 설치된 모든 구성 요소를 영구적으로 제거(또는 제거하지 않음)하도록 지시합니다. 컴퓨터를 안전하게 유지하는 데 유용합니다.

구문 예제:

C:\>"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" modifySettings --installPath "C:\Program Files\Microsoft SQL Server Management Studio 21\Release" --newChannelUri https://aka.ms/ssms/21/release/channel --removeOos true

 C:\>"C:\Program Files\Microsoft SQL Server Management Studio 21\Release\vs_SSMS.exe" modifySettings --channelUri https://aka.ms/ssms/21/release/channel --productId Microsoft.VisualStudio.Product.Ssms --newChannelUri \\layoutserver\share\path\channelmanifest.json --removeOos true --quiet

채널 명령 및 명령줄 매개 변수 제거

업데이트할 수 있는 채널은 클라이언트에 캐시되며 시간이 지남에 따라 복잡해질 수 있습니다. Visual Studio 설치 관리자를 열고, 사용 가능한 탭으로 이동한 다음, 제품 카드의 오른쪽 위 모서리에 있는 X를 선택하여 업데이트 채널을 수동으로 제거할 수 있습니다. removeChannel 명령을 사용하여 프로그래밍 방식으로 채널(예: 이전 레이아웃 위치)을 제거할 수 있습니다. 클라이언트 컴퓨터에서 프로그래밍 방식으로 실행 vswhere 하여 클라이언트 머신에 캐시되는 채널을 확인할 수 있습니다.

명령 설명
removeChannel 클라이언트 컴퓨터에서 채널을 제거하는 명령입니다.
removeChannel 매개 변수 설명
--channelUri 필수 이전 채널 매니페스트의 URI입니다.
--quiet 선택적 이 매개 변수는 명령이 실행되는 동안 사용자 인터페이스가 표시되지 않도록 합니다.
--passive 선택 사항 이 매개변수는 --quiet 매개변수를 대체합니다. 이로 인해 UI가 반응하지 않는 방식으로 나타납니다.

구문 예제:

"C:\Program Files (x86)\Microsoft Visual Studio\Installer\setup.exe" removeChannel --channelUri "\\\\server\\share\\layoutdirectory\\ChannelManifest.json"

winget을 사용하여 SSMS 설치 또는 수정

Windows 패키지 관리자(winget) 도구를 사용하여 winget에서 관리하는 다른 패키지와 함께 컴퓨터에 SSMS를 프로그래밍 방식으로 설치, 수정 또는 업데이트할 수 있습니다.

기본적으로 winget 은 SSMS 핵심 워크로드만 설치합니다.

구문 예제:

winget install Microsoft.SQLServerManagementStudio.21

Visual Studio 설치 관리자 작업에는 현재 관리자 권한이 필요하므로 winget 은 명령을 완료하는 데 필요한 경우 권한을 상승하라는 메시지를 표시합니다. 또한 최신 버전으로 업그레이드하려는 경우 SSMS를 닫아야 합니다.

워크로드 ID 및 구성 요소 ID 목록

SSMS 제품별로 정렬된 워크로드 및 구성 요소 ID 목록은 Visual Studio 워크로드 및 구성 요소 ID를 참조하세요.

언어 지역 설정 목록

다음 표에서는 --addProductLang 및 --removeProductLang 매개변수와 함께 사용할 수 있는 언어 로캘을 나열합니다.

언어 지역 설정 언어
cs-cz 체코어
de-de 독일어
en-us 영어
es-es 스페인어
fr-fr 프랑스어
it-it 이탈리아어
ja-jp 일본어
ko-kr 한국어
pl-pl 폴란드어
pt-br 포르투갈어 - 브라질
ru-ru 러시아어
tr-tr 터키어
zh-cn 중국어 - 간체
zh-tw 중국어 - 번체

오류 코드

작업 결과에 따라 %ERRORLEVEL% 환경 변수는 다음 값 중 하나로 설정됩니다.

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

각 작업은 %TEMP% 디렉터리에 설치 진행률을 나타내는 여러 로그 파일을 생성합니다. 날짜별로 폴더를 정렬하고 부트스트래퍼, 설치 관리자 앱 및 설치 엔진에 대한 ssms_bootstrapper, ssms_client및 ssms_setup 시작하는 파일을 찾습니다.

지원 또는 문제 해결

때로는 상황이 잘못 될 수 있습니다. SSMS 설치에 실패하는 경우 단계별 지침은 SQL Server Management Studio의 설치 및 업그레이드 문제 해결 을 참조하세요.

SSMS 개발자 커뮤니티 사이트에서 다른 알려진 문제에 대한 정보를 확인하거나, 그룹아래의 도구 필터를 사용하여 검색하고, 제품 팀에 피드백을 제공할 수 있습니다.

관련 콘텐츠