컨텍스트 한정자 Configuration Manager

아티클
04/04/2023

컨텍스트 개체는 SMS 공급자에 추가 정보를 제공하기 위해 Configuration Manager 사용됩니다. 일반적으로 컨텍스트 한정자를 사용하여 애플리케이션 이름과 같은 SMS 공급자 컨텍스트 정보를 제공합니다. SMS 공급자 및 개별 SMS 공급자 개체에 연결할 때 컨텍스트 한정자를 사용할 수 있습니다.

관리 코드

관리형 SMS 공급자 라이브러리를 사용하는 경우 ConnectionManagerBase.Context 속성을 사용하여 컨텍스트 한정자를 지정합니다. 자세한 내용은 관리 코드를 사용하여 Configuration Manager 컨텍스트 한정자를 추가하는 방법을 참조하세요.

Vbscript

VBScript를 사용하는 경우 SWBemNamedValue 인터페이스 집합을 사용하여 컨텍스트 한정자를 명명된 값 개체의 컬렉션으로 지정합니다. 자세한 내용은 WMI를 사용하여 Configuration Manager 컨텍스트 한정자를 추가하는 방법을 참조하세요.

컨텍스트 한정자

다음 표에는 SMS 공급자에서 사용하는 컨텍스트 한정자(명명된 값)가 포함되어 있습니다. 와 같은 SessionHandle대부분의 한정자는 SMS 공급자의 특정 기능 영역에서만 사용되지만 LocaleID, 및 MachineNameApplicationName 는 애플리케이션의 용도로 사용됩니다.

컨텍스트 한정자	설명
`ApplicationName`	호출을 수행한 애플리케이션을 식별합니다.
`ContextHandle`	SMS 공급자가 캐시된 컨텍스트 한정자를 저장한 위치를 식별합니다.
`InstanceCount`	ExecQuery 및 CreateInstanceEnum에서 반환된 인스턴스 수를 제한합니다.
`LimitToCollectionIDs`	리소스 쿼리 결과를 명명된 컬렉션의 멤버로 제한합니다.
`LocaleID`	사용할 코드 페이지를 식별합니다.
`MachineName`	애플리케이션을 실행하는 컴퓨터를 식별합니다.
`QueryQualifiers`	보안 개체에 대해 쿼리를 실행할 때 SecurityVerbs 비트 플래그를 반환합니다.
`SessionHandle`	Configuration Manager 사이트 제어 파일의 애플리케이션 복사본을 식별합니다.

Applicationname

ApplicationName 컨텍스트 한정자는 호출을 수행한 애플리케이션의 이름을 식별하는 문자열 값입니다. 감사에 사용되므로 애플리케이션에 대해 를 지정 ApplicationName 해야 합니다. 애플리케이션 이름을 제공하지 않으면 알 수 없음 값이 사용됩니다. SMS_StatusMessage::RaiseErrorStatusMsg와 같은 raise status 메시지 메서드를 호출할 때 값을 제공해야 ApplicationName 합니다. 그렇지 않으면 호출이 실패합니다.

ContextHandle

ContextHandle 컨텍스트 한정자는 SMS 공급자가 캐시된 컨텍스트 한정자를 저장한 위치를 식별하는 문자열 값입니다. 관리되는 SMS 공급자는 데이터 전송을 관리합니다. VBScript를 사용하는 경우 다음 단계를 사용하여 네트워크를 통해 전달되는 데이터의 양을 줄일 수 있습니다.

SWBemNamedValue 값 집합을 만듭니다.
컨텍스트 개체에 한정자를 추가합니다. 자세한 내용은 WMI를 사용하여 Configuration Manager 컨텍스트 한정자를 추가하는 방법을 참조하세요.
GetContextHandle 메서드를 호출하여 서버에서 한정자를 캐시합니다. SMS 공급자는 GetContextHandle을 호출할 때 ExecMethod의 매개 변수로 전달하는 컨텍스트 개체를 캐시합니다.
컨텍스트 개체에서 모든 한정자를 제거합니다.
컨텍스트 개체에 ContextHandle 한정자와 값을 추가합니다.
IWbemServices에 대한 모든 호출에서 컨텍스트 개체를 전달합니다.

애플리케이션을 종료하기 전에 캐시된 한정자를 제거하려면 ClearContextHandle 메서드를 호출해야 합니다. 원하는 만큼 ContextHandle 값을 만들 수 있으며 각 값은 애플리케이션에 대한 다양한 정보를 제공합니다.

참고

컨텍스트 한정자를 캐시한 후에는 동일한 컨텍스트 한정자(다른 값)를 컨텍스트 개체에 추가하여 캐시된 값을 재정의할 수 있습니다.

InstanceCount

InstanceCount 컨텍스트 한정자는 ExecQuery 및 CreateInstanceEnum 메서드에서 반환되는 인스턴스 수를 제한하는 데 사용되는 정수 값입니다. 쿼리 또는 열거자에서 반환하려는 최대 인스턴스 수와 동일하게 설정합니다 InstanceCount . 예를 들어 를 10으로 설정 InstanceCount 하면 최대 10개의 인스턴스가 반환됩니다.

LimitToCollectionIDs

LimitToCollectionIDs 컨텍스트 한정자는 값 목록을 CollectionID 포함하는 문자열 배열입니다. 현재는 하나의 CollectionID 값만 지정할 수 있습니다. 이 한정자를 사용하여 리소스 쿼리 결과를 명명된 컬렉션의 멤버로 제한합니다. 리소스 쿼리는 SMS_Resource 또는 SMS_Group 파생된 클래스를 포함하는 쿼리입니다.

사용자에게 리소스가 속한 컬렉션에 대한 인스턴스 읽기 리소스 권한이 있어야 합니다. 컬렉션에 대한 클래스 읽기 리소스 권한이 없는 경우 컬렉션 제한을 사용해야 합니다. 그렇지 않으면 데이터가 반환되지 않습니다. 서비스 팩 1 이상 버전이 있는 SMS 2.0의 경우 이 제한은 SMS_Group 파생된 클래스에만 적용됩니다.

컬렉션을 쿼리할 때는 이 한정자를 사용할 수 없습니다.

Localeid

LocaleID 컨텍스트 한정자는 MS\x 형식의 16진수 값 또는 10진수 값을 허용하는 문자열 값입니다. 여기서 x는 로캘 ID입니다. 예를 들어 영어 LocaleID 값을 ms\0x0409 또는 ms\1033으로 입력할 수 있습니다. SMS 공급자는 Microsoft 형식을 사용하는 값만 허용합니다LocaleID. 의 locale IDs 목록은 Microsoft 의해 할당된 로캘 ID에서 찾을 수 있습니다.

미국 이외 지역의 로캘이 필요한 경우 설치를 SMS_Identification 서버 WMI 클래스LocaleID 속성에서 가져올 수 있습니다.

Machinename

MachineName 컨텍스트 한정자는 애플리케이션을 실행하는 컴퓨터를 식별하는 문자열 값입니다. 감사에 사용되므로 애플리케이션에 대해 를 지정 MachineName 해야 합니다. 컴퓨터 이름을 제공하지 않으면 알 수 없음 값이 사용됩니다. SMS_StatusMessage::RaiseRawStatusMsg와 같은 raise status 메시지 메서드를 호출할 때 MachineName 값을 제공해야 합니다. 그렇지 않으면 호출이 실패합니다.

QueryQualifiers

컨텍스트 한정자는 보안 개체(예: SMS_Site 또는 SMS_Package)에 대해 쿼리를 실행할 때 SecurityVerbs 비트 플래그를 반환하는 데 사용되는 부울 값입니다.QueryQualifiers 보안되지 않은 개체를 쿼리할 때 를 사용하면 QueryQualifiers 오류가 발생합니다. 기본적으로 SecurityVerbs 플래그는 쿼리와 함께 반환되지 않습니다. 플래그를 반환하려면 이 한정자를 만들고 값을 로 true 설정해야 합니다. 를 만들지 QueryQualifiers 않는 것은 값을 false로 설정하는 것과 같습니다.

SessionHandle

SessionHandle 컨텍스트 한정자는 GetSessionHandle 메서드의 out 매개 변수로 반환되는 문자열 값입니다. 문자열은 Configuration Manager 사이트 제어 파일의 애플리케이션 복사본을 식별하는 고유한 GUID입니다. 이 메커니즘을 사용하여 사이트 제어 파일을 수정하고 동시에 사이트 제어 파일을 수정하는 다른 애플리케이션과의 데이터 충돌을 줄여야 합니다. 값을 제공하지 SessionHandle 않으면 애플리케이션은 서로의 데이터를 덮어쓰는 애플리케이션으로부터 보호되지 않는 사이트 제어 파일의 전역 복사본을 수정합니다.

참고

관리형 SMS 공급자를 사용하는 경우 사이트 제어 파일 세션 관리가 관리됩니다.

참고 항목

관리 코드를 사용하여 Configuration Manager 컨텍스트 한정자를 추가하는 방법
WMI를 사용하여 Configuration Manager 컨텍스트 한정자를 추가하는 방법
SMS 공급자 기본 사항

다음을 통해 공유