서비스 연결 도구를 사용하여 Configuration Manager

  • 아티클

적용 대상: Configuration Manager(현재 분기)

서비스 연결 지점이 오프라인 모드인 경우 서비스 연결 도구를 사용합니다. Configuration Manager 사이트 시스템 서버가 인터넷에 연결되어 있지 않은 경우에도 사용할 수 있습니다. 이 도구는 Configuration Manager 대한 최신 업데이트로 사이트를 최신 상태로 유지하는 데 도움이 될 수 있습니다.

도구를 실행하면 Configuration Manager 클라우드 서비스에 연결하고, 계층 구조에 대한 사용 정보를 업로드하고, 업데이트를 다운로드합니다. 클라우드 서비스가 환경에 대한 올바른 업데이트를 제공할 수 있도록 하려면 사용량 현황 데이터를 업로드해야 합니다.

필수 구성 요소

  • 사이트에 서비스 연결 지점이 있으며 오프라인 주문형 연결에 대해 구성합니다.

  • 관리자 권한으로 명령 프롬프트에서 도구를 실행합니다. 사용자 인터페이스가 없습니다.

  • 서비스 연결 지점 및 인터넷에 연결할 수 있는 컴퓨터에서 도구를 실행합니다. 이러한 각 컴퓨터에는 x64비트 OS가 있어야 하며 다음 구성 요소가 있어야 합니다.

    • Visual C++ 재배포 가능 패키지 x86 및 x64 파일 모두. 기본적으로 Configuration Manager 서비스 연결 지점을 호스트하는 컴퓨터에 x64 버전을 설치합니다. 이 도구에는 실행 중인 컴퓨터에서 Microsoft Visual C++ 2015-2019 재배포 가능 패키지(14.28.29914.0) 이상이 필요합니다. 이 구성 요소를 다운로드하려면 재배포 가능 최신 지원 다운로드 Microsoft Visual C++ 참조하세요.

      참고

      지원되지 않는 버전의 Configuration Manager 2107 이전 버전에서 업그레이드하는 경우 도구에는 동일한 링크에서 사용할 수 있는 Visual C++ 2013 재배포 패키지(12.0.40660.0)가 필요합니다.

    • 이 도구에는 .NET 버전 4.6.2가 필요하며 버전 4.8이 권장됩니다. 자세한 내용은 사이트 및 사이트 시스템 필수 구성 요소를 참조하세요.

  • 도구를 실행하는 데 사용하는 계정에는 다음 권한이 필요합니다.

    • 서비스 연결 지점을 호스트하는 컴퓨터의 로컬 관리자

    • 사이트 데이터베이스에 대한 읽기 권한

  • 인터넷에 액세스할 수 있는 컴퓨터와 서비스 연결 지점 간에 파일을 전송하는 방법이 필요합니다. 예를 들어 파일 및 업데이트를 저장할 수 있는 충분한 여유 공간이 있는 USB 드라이브입니다.

개요

  1. 준비: 서비스 연결 지점에서 도구를 실행합니다. 지정한 위치에 있는 .cab 파일에 사용량 현황 데이터를 넣습니다. 인터넷 연결이 있는 컴퓨터에 데이터 파일을 복사합니다.

  2. 연결: 인터넷 연결을 사용하여 컴퓨터에서 도구를 실행합니다. 사용량 현황 데이터를 업로드한 다음 Configuration Manager 업데이트를 다운로드합니다. 다운로드한 업데이트를 서비스 연결 지점에 복사합니다.

    각각 다른 계층에서 여러 데이터 파일을 한 번에 업로드할 수 있습니다. 프록시 서버와 프록시 서버에 대한 사용자를 지정할 수도 있습니다.

  3. 가져오기: 서비스 연결 지점에서 도구를 실행합니다. 업데이트를 가져오고 사이트에 추가합니다. 그런 다음 Configuration Manager 콘솔에서 해당 업데이트를 보고 설치할 수 있습니다.

여러 데이터 파일 업로드

  • 별도의 계층 구조에서 내보낸 모든 데이터 파일을 동일한 폴더에 배치합니다. 각 파일에 고유한 이름을 지정합니다. 필요한 경우 수동으로 이름을 바꿀 수 있습니다.

  • 도구를 실행하여 Microsoft에 데이터를 업로드하는 경우 데이터 파일이 포함된 폴더를 지정합니다.

  • 도구를 실행하여 데이터를 가져오는 경우 도구는 해당 계층 구조에 대한 데이터만 가져옵니다.

프록시 서버 지정

인터넷에 연결된 컴퓨터에 프록시 서버가 필요한 경우 도구는 기본 프록시 구성을 지원합니다. 선택적 매개 변수 -proxyserveruri 및 -proxyusername을 사용합니다. 자세한 내용은 명령줄 매개 변수를 참조하세요.

다운로드할 업데이트 유형 지정

도구는 다운로드하는 파일을 제어하는 옵션을 지원합니다. 기본적으로 이 도구는 사이트 버전에 적용되는 사용 가능한 최신 업데이트만 다운로드합니다. 핫픽스를 다운로드하지 않습니다.

이 동작을 수정하려면 다음 매개 변수 중 하나를 사용하여 다운로드하는 파일을 변경합니다.

  • -downloadall: 사이트의 버전에 관계없이 업데이트 및 핫픽스를 포함한 모든 업데이트를 다운로드합니다.

  • -downloadhotfix: 사이트의 버전에 관계없이 모든 핫픽스를 다운로드합니다.

  • -downloadsiteversion: 사이트의 버전보다 최신 버전으로 업데이트 및 핫픽스를 다운로드합니다.

    중요

    Configuration Manager 버전 2002의 알려진 문제로 인해 기본 동작이 예상대로 작동하지 않습니다. 버전 2006으로 업데이트하거나 -downloadsiteversion 매개 변수를 사용하여 버전 2002에 필요한 업데이트를 다운로드합니다.

자세한 내용은 명령줄 매개 변수를 참조하세요.

팁

도구는 데이터 파일에서 사이트의 버전을 결정합니다. 버전을 확인하려면 .cab 파일에서 사이트 버전으로 명명된 텍스트 파일을 확인합니다.

도구 사용

서비스 연결 도구는 다음 경로SMSSETUP\TOOLS\ServiceConnectionTool\ServiceConnectionTool.exe의 Configuration Manager 설치 미디어에 있습니다. 항상 사용하는 Configuration Manager 버전과 일치하는 서비스 연결 도구를 사용합니다. 이러한 모든 파일은 서비스 연결 도구가 작동하려면 동일한 폴더에 있어야 합니다.

모든 내용이 포함된 ServiceConnectionTool 폴더를 인터넷에 연결된 컴퓨터에 복사합니다.

이 절차에서 명령줄 예제에서는 다음 파일 이름 및 폴더 위치를 사용합니다. 이러한 경로 및 파일 이름을 사용할 필요가 없습니다. 환경 및 기본 설정과 일치하는 대안을 사용할 수 있습니다.

  • 서비스 연결 지점에서 Configuration Manager 설치 미디어 원본 파일의 경로입니다.C:\Source

  • 컴퓨터 간에 전송할 데이터를 저장하는 USB 드라이브의 경로: D:\USB\

  • 사이트에서 내보낸 데이터 파일의 이름: UsageData.cab

  • 도구에서 다운로드한 업데이트가 Configuration Manager 저장되는 빈 폴더의 이름입니다.UpdatePacks

준비

  1. 서비스 연결 지점을 호스트하는 컴퓨터에서 관리자 권한으로 명령 프롬프트를 열고 디렉터리를 도구 위치로 변경합니다. 예를 들면

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. 다음 명령을 실행하여 데이터 파일을 준비합니다.

    ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

    참고

    둘 이상의 계층 구조에서 동시에 데이터 파일을 업로드하는 경우 각 데이터 파일에 고유한 이름을 지정합니다. 필요한 경우 나중에 파일 이름을 바꿀 수 있습니다.

    파일의 데이터는 사이트에 대해 구성하는 진단 및 사용량 현황 데이터의 수준을 기반으로 합니다. 자세한 내용은 진단 및 사용량 현황 데이터 개요를 참조하세요. 도구를 사용하여 CSV 파일로 데이터를 내보내 콘텐츠를 볼 수 있습니다. 자세한 내용은 -export를 참조하세요.

  3. 도구에서 사용량 현황 데이터 내보내기를 완료한 후 인터넷에 액세스할 수 있는 컴퓨터에 데이터 파일을 복사합니다.

서비스에

  1. 인터넷에 액세스할 수 있는 컴퓨터에서 관리자 권한으로 명령 프롬프트를 열고 디렉터리를 도구 위치로 변경합니다. 이 위치는 전체 ServiceConnectionTool 폴더의 복사본입니다. 예를 들어 다음과 같습니다.

    cd D:\USB\ServiceConnectionTool\

  2. 다음 명령을 실행하여 데이터 파일을 업로드하고 Configuration Manager 업데이트를 다운로드합니다.

    ServiceConnectionTool.exe -connect -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

    자세한 예제는 명령줄 매개 변수를 참조하세요.

    참고

    이 명령줄을 실행하면 다음 오류가 표시될 수 있습니다.

    처리되지 않은 예외: System.UnauthorizedAccessException: 'C:\Users\jqpublic\AppData\Local\Temp\extractmanifestcab\95F8A562.sql' 경로에 대한 액세스가 거부됩니다.

    이 오류는 무시해도 됩니다. 계속하려면 오류 창을 닫습니다.

  3. 도구에서 업데이트 다운로드를 완료한 후 서비스 연결 지점에 복사합니다.

가져오기

  1. 서비스 연결 지점을 호스트하는 컴퓨터에서 관리자 권한으로 명령 프롬프트를 열고 디렉터리를 도구 위치로 변경합니다. 예를 들면

    cd C:\Source\SMSSETUP\TOOLS\ServiceConnectionTool\

  2. 다음 명령을 실행하여 업데이트를 가져옵니다.

    ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

  3. 가져오기가 완료되면 명령 프롬프트를 닫습니다. 해당 계층 구조에 대한 업데이트만 가져옵니다.

  4. Configuration Manager 콘솔에서 관리 작업 영역으로 이동하여 업데이트 및 서비스 노드를 선택합니다. 이제 가져온 업데이트를 설치할 수 있습니다. 자세한 내용은 콘솔 내 업데이트 설치를 참조하세요.

로그 파일

  • ServiceConnectionTool.log: 서비스 연결 도구를 실행할 때마다 이 로그 파일에 씁니다. 로그 파일의 경로는 항상 도구와 동일한 위치입니다. 이 로그 파일은 사용하는 매개 변수를 기반으로 도구 사용에 대한 간단한 세부 정보를 제공합니다. 도구를 실행할 때마다 도구는 기존 로그 파일을 대체합니다.

  • ConfigMgrSetup.log: 연결 단계에서 도구는 시스템 드라이브의 루트에 있는 이 로그 파일에 씁니다. 이 로그 파일은 자세한 정보를 제공합니다. 예를 들어 도구에서 다운로드하는 파일과 해시 검사가 성공하면 됩니다.

명령줄 매개 변수

이 섹션에서는 서비스 연결 도구에 사용할 수 있는 모든 매개 변수를 사전순으로 나열합니다.

-연결

인터넷에 액세스할 수 있는 컴퓨터의 연결 단계에서 사용합니다. Configuration Manager 클라우드 서비스에 연결하여 데이터 파일을 업로드하고 업데이트를 다운로드합니다.

다음 매개 변수가 필요합니다.

  • -usagedatasrc: 업로드할 데이터 파일의 위치
  • -updatepackdest: 다운로드한 업데이트에 대한 경로

다음 선택적 매개 변수를 사용할 수도 있습니다.

  • -proxyserveruri: 프록시 서버의 FQDN
  • -proxyusername: 프록시 서버의 사용자 이름
  • -downloadall: 사이트의 버전에 관계없이 업데이트 및 핫픽스를 포함한 모든 항목을 다운로드합니다.
  • -downloadhotfix: 사이트의 버전에 관계없이 모든 핫픽스를 다운로드합니다.
  • -downloadsiteversion: 사이트의 버전보다 최신 버전이 있는 업데이트 및 핫픽스를 다운로드합니다.

프록시 서버 없이 연결의 예

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\ -updatepackdest D:\USB\UpdatePacks

프록시 서버와 연결의 예

ServiceConnectionTool.exe -connect -usagedatasrc D:\USB\Usagedata.cab -updatepackdest D:\USB\UpdatePacks -proxyserveruri itproxy.contoso.com -proxyusername jqpublic

사이트 버전에 해당하는 업데이트만 다운로드하기 위한 연결의 예

ServiceConnectionTool.exe -connect -downloadsiteversion -usagedatasrc D:\USB -updatepackdest D:\USB\UpdatePacks

-Dest

내보낼 CSV 파일의 경로 및 파일 이름을 지정하는 데 필요한 매개 변수입니다. 자세한 내용은 -export를 참조하세요.

-downloadall

- connect 매개 변수를 사용하여 사이트의 버전에 관계없이 업데이트 및 핫픽스를 포함한 모든 항목을 다운로드하는 선택적 매개 변수입니다. 자세한 내용은 -connect를 참조하세요.

-downloadhotfix

- connect 매개 변수가 있는 선택적 매개 변수는 사이트의 버전에 관계없이 모든 핫픽스만 다운로드합니다. 자세한 내용은 -connect를 참조하세요.

-downloadsiteversion

-connect 매개 변수가 있는 선택적 매개 변수는 사이트 버전보다 최신 버전이 있는 업데이트 및 핫픽스만 다운로드합니다. 자세한 내용은 -connect를 참조하세요.

-내보내기

준비 단계에서 를 사용하여 사용량 현황 데이터를 CSV 파일로 내보냅니다. 서비스 연결 지점에서 관리자 권한으로 실행합니다. 이 작업을 통해 Microsoft에 업로드하기 전에 사용량 현황 데이터의 내용을 검토할 수 있습니다. CSV 파일의 위치를 지정하려면 -dest 매개 변수가 필요합니다.

내보내기 예제

-export -dest D:\USB\usagedata.csv

-가져오기

서비스 연결 지점의 가져오기 단계에서 를 사용하여 사이트로 업데이트를 가져옵니다. 다운로드한 업데이트의 위치를 지정하려면 -updatepacksrc 매개 변수가 필요합니다.

가져오기의 예

ServiceConnectionTool.exe -import -updatepacksrc D:\USB\UpdatePacks

-준비

서비스 연결 지점의 준비 단계에서 를 사용하여 사이트에서 사용량 현황 데이터를 내보냅니다. 내보낸 데이터 파일의 위치를 지정하려면 -usagedatadest 매개 변수가 필요합니다.

준비 예제

ServiceConnectionTool.exe -prepare -usagedatadest D:\USB\UsageData.cab

-proxyserveruri

프록시 서버의 FQDN을 지정하는 -connect 매개 변수를 사용하는 선택적 매개 변수입니다. 자세한 내용은 -connect를 참조하세요.

-proxyusername

-connect 매개 변수를 사용하여 프록시 서버에서 인증할 사용자 이름을 지정하는 선택적 매개 변수입니다. 자세한 내용은 -connect를 참조하세요.

-updatepackdest

- connect 매개 변수를 사용하여 다운로드한 업데이트의 경로를 지정하는 데 필요한 매개 변수입니다. 자세한 내용은 -connect를 참조하세요.

-updatepacksrc

다운로드한 업데이트의 경로를 지정하기 위해 -import 매개 변수가 있는 필수 매개 변수입니다. 자세한 내용은 -import를 참조하세요.

-usagedatadest

내보낸 데이터 파일의 경로 및 파일 이름을 지정하기 위해 -prepare 매개 변수를 사용하는 필수 매개 변수입니다. 자세한 내용은 -prepare를 참조하세요.

다음 단계

콘솔 내 업데이트 설치

진단 및 사용량 현황 데이터를 보는 방법