장치에 대한 사용자 지정 속성

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

많은 고객이 Configuration Manager 외부에 있지만 배포 대상 지정, 컬렉션 빌드 및 보고에 유용한 다른 데이터를 가지고 있습니다. 이 데이터는 일반적으로 비기술적이고 클라이언트에서 검색할 수 없으며 단일 외부 소스에서 가져옵니다. 예를 들어, 중앙 IT 인프라 라이브러리(ITIL) 시스템 또는 자산 데이터베이스에는 다음과 같은 장치 특성 중 일부가 있습니다.

  • 실제 위치
  • 조직 우선 순위
  • 범주
  • 비용 센터
  • 부서

버전 2107부터 관리 서비스를 사용하여 장치에 이 데이터를 설정할 수 있습니다. 사이트는 속성의 이름과 해당 값을 디바이스 사용자 지정 속성 클래스로 사이트 데이터베이스에 저장합니다. 그런 다음 보고하거나 컬렉션을 만들기 위해 Configuration Manager의 사용자 지정 속성을 사용할 수 있습니다.

버전 2111부터 Configuration Manager 콘솔에서 이러한 사용자 지정 속성을 만들고 편집할 수 있습니다. 이 새로운 사용자 인터페이스를 사용하면 이러한 속성을 보고 편집하기가 더 쉬워집니다.

참고

사용자 지정 속성 값에는 유니코드 문자를 사용할 수 있지만 속성 이름에는 사용할 수 없습니다. 자세한 내용은 Configuration Manager의 유니코드 및 ASCII 지원을 참조하세요.

필수 구성 요소

API 호출을 수행하는 계정에는 대상 장치를 포함하는 컬렉션에 대해 다음 권한이 필요합니다.

  • 속성을 설정하려면 다음을 수행합니다. 리소스 수정
  • 속성을 보려면 다음을 수행합니다. 리소스 읽기
  • 속성을 제거하려면: 리소스 삭제

UI를 통해 속성 설정

버전 2111 이상에 적용됩니다.

  1. Configuration Manager 콘솔에서 자산 및 규정 준수 작업 영역으로 이동하고 장치 노드를 선택합니다.

  2. 장치를 선택한 다음 리본에서 속성을 선택합니다.

  3. 사용자 지정 속성 탭으로 전환합니다.

  4. 금색 별 아이콘을 선택하여 새 사용자 지정 속성을 만듭니다. 속성의 이름을 제공하고 이 장치의 값을 설정합니다. 확인을 선택하여 속성을 저장합니다.

여러 값이 있는 장치의 사용자 지정 속성 탭입니다.

API를 통해 속성 설정

버전 2107 이상에 적용됩니다.

장치에 속성을 설정하려면 SetExtensionData API를 사용합니다. JSON 본문을 사용하여 URI https://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.SetExtensionData 에 대한 POST 호출을 수행합니다. 리소스 ID는 정수 값입니다(예: 16777345).

이 JSON 예제는 장치의 자산 태그 및 위치에 대해 두 개의 이름-값 쌍을 설정합니다.

{
  "ExtensionData": {
    "AssetTag":"0580255",
    "Location":"Dublin"
  }
}

속성 보기

GetExtensionData API를 사용하여 사용자 지정 속성을 봅니다.

단일 장치에서 속성을 보려면 URIhttps://<SMSProviderFQDN>/AdminService/v1.0/Device(<DeviceResourceID>)/AdminService.GetExtensionData를 GET 호출합니다.

모든 장치의 속성을 보려면 URIhttps://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.GetExtensionData를 GET로 호출합니다. 이 호출은 읽기 권한이 있는 장치에서 속성 값을 반환합니다.

속성 제거

모든 장치에서 속성 값을 제거하려면 장치 ID 없이 DeleteExtensionData API를 사용합니다. 특정 장치의 속성만 제거하려면 장치 리소스 ID를 포함합니다. URI https://<SMSProviderFQDN>/AdminService/v1.0/Device/AdminService.DeleteExtensionData에 대한 POST 호출을 합니다.

컬렉션 만들기

다음 단계를 사용하여 사용자 지정 속성에 따라 쿼리 규칙을 사용하여 컬렉션을 만듭니다.

  1. Configuration Manager 콘솔에서 컬렉션을 만듭니다.

  2. 구성원 규칙 페이지의 규칙 추가 목록에서 쿼리 규칙을 선택합니다.

  3. 쿼리 규칙 속성 창에서 쿼리의 이름을 지정합니다. 그런 다음 쿼리 문 편집을 선택합니다.

  4. 쿼리 문 속성 창에서 조건 탭으로 전환합니다. 그런 다음 황금 별표(*)를 선택하여 새 조건을 추가합니다.

  5. 조건 속성 창에서 다음 값을 선택합니다.

    • 특성 클래스: 장치 사용자 지정 속성
    • 특성: PropertyName

  6. 연산자를 선택한 다음 속성 이름을 값으로 지정합니다.

    이 시점에서 조건 속성 창은 다음 이미지와 유사하게 표시됩니다.

    장치 사용자 지정 속성 PropertyName에 대한 조건 속성 창입니다.

    확인을 선택하여 조건을 저장합니다.

  7. 단계를 반복하여 PropertyValue 특성에 대한 조건을 추가합니다.

    이 시점에서 컬렉션 쿼리 문 속성 창은 다음 이미지와 유사하게 표시됩니다.

    장치 사용자 지정 속성 조건이 모두 있는 쿼리 문 속성 창입니다.

  8. 확인 을 선택하여 모든 속성 창을 닫습니다. 그런 다음 마법사를 완료하여 컬렉션을 만듭니다.

WQL 문 예제

다음 샘플 쿼리를 사용할 수도 있습니다. 쿼리문 속성 창에서 쿼리 언어 표시 를 선택하여 쿼리문을 붙여넣습니다.

select SMS_R_SYSTEM.ResourceID,SMS_R_SYSTEM.ResourceType,SMS_R_SYSTEM.Name,SMS_R_SYSTEM.SMSUniqueIdentifier,SMS_R_SYSTEM.ResourceDomainORWorkgroup,SMS_R_SYSTEM.Client
from SMS_R_System inner join SMS_G_System_ExtensionData on SMS_G_System_ExtensionData.ResourceId = SMS_R_System.ResourceId
where SMS_G_System_ExtensionData.PropertyName = "AssetTag" and SMS_G_System_ExtensionData.PropertyValue = "0580255"

참고

증분 컬렉션 업데이트와 함께 사용자 지정 속성 WQL 문을 사용하려면 업데이트 롤업 이상과 함께 Configuration Manager 버전 2107을 사용합니다.

다음 단계

관리 서비스를 사용하는 방법

컬렉션 만들기

클라이언트를 관리하는 방법

  • Last updated on