적용 대상: Configuration Manager(현재 분기)
SMS 공급자는 HTTPS를 통해 API 상호 운용성 액세스(관리 서비스라고 함)를 제공합니다. 관리 서비스는 OData(Open Data) v4 프로토콜을 기반으로 하는 REST(Representational State Transfer) API입니다.
관리 서비스에는 현재 두 개의 계층 또는 경로가 있습니다.
관리 서비스 > WMI > SQL:
https://<SMSProviderFQDN>/AdminService/wmi/<ClassName>WMI 경로는 700개 이상의 클래스에 대한 GET 및 POST 명령을 모두 지원합니다.
관리 서비스 > OData/SQL:
https://<SMSProviderFQDN>/AdminService/v1.0/<ClassName>버전이 있는 이 경로(v1.0)는 새로운 Configuration Manager 기능을 지원합니다.
<ClassName> 값은 유효한 Configuration Manager 클래스 이름입니다. 관리 서비스 클래스 이름은 대/소문자를 구분합니다. 적절한 대문자를 사용해야 합니다. 예를 들면 SMS_Site와 같습니다.
시나리오
Configuration Manager는 기본적으로 다음 기능에 관리 서비스를 사용합니다.
또한 관리 서비스를 사용하여 사용자 지정 솔루션을 개발할 수 있습니다. 예를 들면 다음과 같습니다.
사이트에서 정보에 액세스하려면 사용자 지정 웹 서비스를 대체합니다.
PowerShell에서 Configuration Manager 콘솔에서 직접 실행하는 스크립트입니다. 자세한 내용은 Configuration Manager 콘솔에서 PowerShell 스크립트 만들기 및 실행을 참조하세요.
작업 순서의 PowerShell 스크립트입니다. 이 작업을 수행하면 WMI 공급자와 인터페이스하기 위해 사용자 지정 웹 서비스를 사용할 필요 없이 사이트의 정보에 액세스할 수 있습니다. 자세한 내용은 작업 순서 단계 - PowerShell 스크립트 실행을 참조하세요.
OData 커넥터 옵션을 사용하여 Power BI에서 사이트 데이터에 액세스합니다.
필수 구성 요소
SMS 공급자 역할을 호스팅하는 서버에서 다음 필수 구성 요소를 구성합니다.
버전 2006 및 이전 버전에서는 Windows 서버 역할 웹 서버(IIS)를 사용하도록 설정합니다. 버전 2010부터는 이 역할이 더 이상 필요하지 않습니다.
버전 2107부터 SMS 공급자는 .NET 버전 4.6.2가 필요하며 버전 4.8을 권장합니다. 버전 2103 이하에서 이 역할을 수행하려면 .NET 4.5 이상이 필요합니다. 자세한 내용은 사이트 및 사이트 시스템 필수 구성 요소를 참조하세요.
신뢰할 수 있는 인증서를 사용하여 보안 HTTPS 통신을 사용하도록 설정해야 할 수 있습니다. 자세한 내용은 보안 HTTPS 통신 사용을 참조하세요.
관리 서비스에 액세스하려면 사용자 계정이 Configuration Manager의 관리 사용자여야 합니다. 클라우드 관리 게이트웨이를 통해 관리 서비스에 액세스하는 경우 Microsoft Entra ID에 계정이 있어야 합니다.
SMS 공급자 및 관리 서비스의 확장성에 대한 자세한 내용은 크기 및 배율 번호를 참조하세요.
참고
Configuration Manager 콘솔이 있는 컴퓨터에서 프록시 서버를 사용하는 경우 콘솔이 관리 서비스에 연결되지 않습니다. 예를 들어 보안 노드에 액세스하려고 할 때 관리 서비스를 사용할 수 없거나 사용할 수 없다는 오류가 표시될 수 있습니다.
SmsAdminUI.log 파일에는 다음과 같은 오류가 표시됩니다.Failed to get a response for OData query.
이 문제를 해결하려면 컴퓨터에서 프록시 구성을 제거하거나 다음과 같이 구성을 변경합니다.
다음 XML 파일을 수동으로 편집합니다.
C:\Program Files (x86)\Microsoft Endpoint Manager\AdminConsole\bin\Microsoft.ConfigurationManagement.exe.config다음 옵션 중 하나를 사용하여 동작을
<defaultproxy>구성합니다.- 집합
enabled="false" - SMS 공급자의 FQDN을 에 추가합니다.
<bypasslist>
자세한 내용은 요소(네트워크 설정)를 참조하십시오
<defaultProxy>.- 집합