다음을 통해 공유


Configuration Manager 사이트 제어 파일 정보

Configuration Manager 사이트 컨트롤은 특정 사이트에 대한 설정을 정의합니다. 각 사이트에 대한 설정은 데이터베이스에 포함되며 스크립팅 언어로 작업할 때 WMI(Windows Management Instrumentation)를 통해 액세스되고 관리되는 언어로 작업할 때 관리되는 SMS 공급자 라이브러리를 통해 액세스됩니다.

참고

Configuration Manager 이전 릴리스에는 사이트 제어 파일이라고 하는 사이트 설정에 대해 처리된 실제 파일이 있었습니다. Configuration Manager 사이트 설정을 사이트 데이터베이스에 직접 저장합니다. 그러나 프로그래밍 방식으로 사이트를 구성할 때 거의 변경되지 않았습니다.

Configuration Manager 사이트 제어 파일은 각 사이트의 구성을 포함하는 ASCII 텍스트 파일(Sitectrl.ct0)입니다. 사이트 제어 파일에는 두 가지 유형이 있습니다.

  • 실제 사이트 제어 파일 - Configuration Manager 사이트 데이터베이스 및 사이트 제어 관리자의 받은 편지함에 저장된 사이트 제어 파일의 작업 복사본입니다.

  • 델타 사이트 제어 파일 - 처리할 제안된 사이트 제어 파일 변경 내용을 포함합니다.

    사이트 제어 파일은 사이트 제어 관리자 받은 편지함의 각 사이트 서버에 저장됩니다.

    기본 사이트에는 데이터베이스의 현재 사이트에 대한 사이트 제어 파일의 복사본이 있습니다. 기본 사이트에는 보조 사이트를 포함하여 계층 구조의 모든 하위 수준 사이트에 대한 사이트 제어 파일의 복사본도 있습니다.

    각 자식 사이트는 해당 사이트 제어 파일의 복사본을 부모 사이트에 전달합니다. 각 부모 사이트는 자체 및 각 자식 사이트에 대한 사이트 제어 파일의 복사본을 계층 구조에 전달합니다. 따라서 중앙 사이트의 데이터베이스에는 계층 구조의 모든 Configuration Manager 사이트의 사이트 제어 파일 복사본이 포함됩니다.

사이트 제어 파일 형식

사이트 제어 파일은 포함된 속성, 포함된 속성 목록 및 다중 문자열 목록을 포함하는 리소스 정의의 컬렉션입니다. 다음 예제에서는 클라이언트 구성 요소 정보를 정의하는 사이트 제어 파일의 섹션을 보여 줍니다. 리소스는 BEGIN_CLIENT_COMPONENT 의해 선언됩니다. 포함된 속성은 PROPERTY로 표시되며 이름과 값이 있습니다. 속성 목록은 BEGIN_PROPERTY_LIST 섹션으로 표시되며 속성 목록 이름과 여러 속성 이름 및 연결된 값을 나열합니다. 다중 문자열 목록은 BEGIN_CLIENT_REG_MULTI_STRING_LIST 표시되며 문자열 값 목록을 제공합니다.

BEGIN_CLIENT_COMPONENT  
    <SMS Client Base Components>  
    <65537>  
    SITE_KEY_FLAGS <1>  
    PROPERTY <Component Verify Interval><REG_SZ><00011700001000F0><0>  
    PROPERTY <Component Maintenance Interval (minutes)><REG_DWORD><><1500>  
    BEGIN_PROPERTY_LIST  
        <Copy Queue>  
        <(REG_DWORD)Item Lifetime=11520>  
        <(REG_DWORD)Wakeup cycle=1380>  
    END_PROPERTY_LIST  
    BEGIN_CLIENT_REG_MULTI_STRING_LIST  
        <Retry Sequence><Copy Queue>  
        SITE_KEY_FLAGS <1>  
        <15>  
        <30>  
        <60>  
        <360>  
    END_CLIENT_REG_MULTI_STRING_LIST  
END_CLIENT_COMPONENT  

공급자에는 사이트 제어 파일의 리소스를 나타내는 여러 WMI(Windows Management Instrumentation) 클래스가 있습니다. 예를 들어 SMS_SCI_Component 서버 WMI 클래스는 Configuration Manager 사이트 서버에 저장된 서버 구성 요소에 대한 정보를 보유합니다. 이러한 클래스는 SMS_SiteControlItem 서버 WMI 클래스에서 파생됩니다. 자세한 내용은 Configuration Manager 사이트 구성 서버 WMI 클래스 [참조]를 참조하세요.

다음 예제는 SMS_SCI_ClientConfig 서버 WMI 클래스에 대한 선언입니다.

Class SMS_SCI_ClientConfig : SMS_SiteControlItem   
{  
     String ClientConfigName;  
     UInt32 FileType;  
     UInt32 Flags;  
     String ItemName;  
     String ItemType;  
     String Platforms[];  
     SMS_EmbeddedPropertyList PropLists[];  
     SMS_EmbeddedProperty Props[];  
     SMS_Client_Reg_MultiString_List RegMultiStringLists[];  
     String SiteCode;  
};  

선언에는 포함된 속성, 속성 목록 및 다중 문자열 목록 선언에 대한 선언이 포함됩니다.

다음 클래스를 사용하여 포함된 속성, 속성 목록 및 다중 문자열 목록에 액세스합니다.

유형 WMI 클래스
Embedded 속성 SMS_EmbeddedProperty 서버 WMI 클래스
포함된 속성 목록 SMS_EmbeddedPropertyList 서버 WMI 클래스 (배열)
다중 문자열 목록 SMS_Client_Reg_MultiString_List 서버 WMI 클래스 (배열)

이 설명서에는 포함된 속성에 대해 설명하는 다음 항목이 있습니다.

Configuration Manager 사이트 제어 파일 포함된 속성 목록을 읽는 방법

사이트 제어 파일 사용

사이트 제어 파일에 액세스하는 방법은 WMI 또는 관리되는 공급자를 사용하는지에 따라 다릅니다.

WMI

WMI를 사용하는 경우 클래스 메서드를 SMS_SiteControlFile 사용하여 사이트 제어 파일의 변경 내용을 관리합니다. 사이트 제어 파일에 쓰기는 사용자가 제공하는 세션 컨텍스트 정보를 사용하여 관리됩니다. 이는 여러 애플리케이션에 대해 사이트 제어 파일에 대한 동시 쓰기를 사용하도록 설정하는 데 사용됩니다. 자세한 내용은 WMI를 사용하여 Configuration Manager 사이트 제어 파일에 대한 읽기 및 쓰기 방법을 참조하세요. 사이트 제어 파일에서만 읽는 경우 세션을 설정하지 않고 쿼리할 수 있습니다.

관리되는 공급자

거의 모든 경우에 관리되는 Configuration Manager 라이브러리가 이를 처리하므로 코드가 Configuration Manager 사이트 제어 파일에 대한 변경 내용을 잠그거나 커밋할 필요가 없습니다. 따라서 Configuration Manager 사이트 제어 파일을 프로그래밍하는 것은 기본적으로 Configuration Manager 개체 프로그래밍과 동일합니다. 이는 명시적으로 세션 핸들을 가져와서 변경한 내용을 커밋해야 하는 WMI를 통해 Configuration Manager 사이트 제어 파일에 액세스하는 경우와 다릅니다.

자세한 내용은 관리 코드를 사용하여 Configuration Manager 사이트 제어 파일에 읽고 쓰는 방법을 참조하세요.

참고 항목

관리 코드를 사용하여 Configuration Manager 사이트 제어 파일에 읽고 쓰는 방법
WMI를 사용하여 Configuration Manager 사이트 제어 파일에 읽고 쓰는 방법