CMPolicy CSP

아티클
03/18/2023

아래 표에서는 Windows의 적용 가능성을 보여 줍니다.

버전	Windows 10	Windows 11
Home	예	예
Pro	예	예
Windows SE	아니요	예
Business	예	예
Enterprise	예	예
Education	예	예

CMPolicy 구성 서비스 공급자는 연결 관리자 연결 요청에 대한 올바른 연결을 식별하는 데 사용하는 규칙을 정의합니다.

참고

이 구성 서비스 공급자는 네트워크 구성 애플리케이션에서 ID_CAP_CSP_FOUNDATION 및 ID_CAP_NETWORKING_ADMIN 기능에 액세스해야 합니다.

각 정책 항목은 호스트 패턴과 함께 하나 이상의 애플리케이션을 식별합니다. 정책 항목에는 연결 관리자 애플리케이션 및 호스트 패턴과 일치하는 연결 요청을 충족하는 데 사용하는 연결 세부 정보 목록이 할당됩니다. CMPolicy 구성 서비스 공급자는 여러 정책을 가질 수 있습니다.

정책 순서 지정: 정책의 명시적 순서는 없습니다. 일반적인 규칙은 가장 구체적이거나 구체적인 정책 매핑이 더 높은 우선 순위를 갖는다는 것입니다.

기본 정책: 정책은 보다 일반적인 정책 이전에 고려된 가장 구체적인 정책을 사용하여 scope 순서대로 적용됩니다. 휴대폰의 기본 동작은 모든 애플리케이션 및 모든 도메인에 적용되며 다른 특정 정책을 사용할 수 없는 경우에만 사용됩니다. 기본 정책은 사용 가능한 모든 Wi-Fi 네트워크를 먼저 사용한 다음 사용 가능한 APN을 사용하는 것입니다.

다음은 OMA(Open Mobile Alliance) 클라이언트 프로비저닝 및 OMA 장치 관리 사용하는 트리 형식의 CMPolicy 구성 서비스 공급자 관리 개체를 보여 줍니다.

./Vendor/MSFT
CMPolicy
----PolicyName
--------SID
--------ClientType
--------Host
--------OrderedConnections
--------Connections
------------ConnXXX
----------------ConnectionID
----------------Type

policyName 정책의 이름을 정의합니다.

Sid SID 값은 ClientType에 따라 달라집니다.

UWP(유니버설 Windows 플랫폼) 앱 기반 매핑 정책의 경우 SID는 애플리케이션이 아닌 중괄호{}가 없는 패키지 패밀리 이름입니다.

비 UWP 애플리케이션 기반 매핑 정책의 경우 SID는 GUID 형식의 애플리케이션 제품 ID입니다. GUID 주변의 중괄호 {} 가 필요합니다.

호스트 기반 매핑 정책의 경우 SID를 로 *설정해야 합니다.

ClientType 매핑 정책 유형을 지정합니다.

다음 목록에서는 사용 가능한 매핑 정책 유형에 대해 설명합니다.

애플리케이션 기반 매핑 정책은 애플리케이션에 적용됩니다. 이 매핑 형식을 지정하려면 값을 app사용합니다.
호스트 기반 매핑 정책은 지정된 호스트에 대한 연결을 요청하는 모든 유형의 클라이언트에 적용됩니다. 이 매핑 형식을 지정하려면 값을 *사용합니다.

호스트 호스트 패턴의 이름을 지정합니다. 호스트 이름은 연결 요청과 일치하여 사용할 올바른 정책을 선택합니다.

호스트 패턴에는 및 +두 개의 와일드카드가 * 있을 수 있습니다. 호스트 패턴은 URL 패턴이 아니며 특정 호스트에 대한 전송 또는 경로 개념이 없습니다. 예를 들어 호스트 패턴은 *.host_name.com 도메인에 대한 접두사를 일치시킬 host_name.com 수 있습니다. 호스트 패턴은 및 와 일치 www.host_name.com 하지만 와 mail.host_name.com일치하지 host_name.com않습니다.

OrderedConnections 연결 목록이 기본 설정 순서인지 여부를 지정합니다.

값 "0"은 연결이 기본 설정 순서대로 나열되지 않도록 지정합니다. 값 "1"은 나열된 연결이 기본 설정 순서대로 표시됨을 나타냅니다.

ConnXXX 는 정책과 연결된 연결을 열거합니다. 요소 이름은 "Conn"으로 시작하고 "000"부터 증가하는 세 자리 숫자로 시작합니다. 예를 들어 5개의 연결에 적용된 정책에는 "Conn000", "Conn001", "Conn002", "Conn003", "Conn004"라는 요소 항목이 있습니다.

ConnectionID 연결 그룹 내의 연결에 대한 고유 식별자를 지정합니다. 정확한 값은 Type 매개 변수를 기반으로 합니다.

의 경우 CMST_CONNECTION_NAME연결 이름을 지정합니다. 예를 들어 CM_CellularEntries 구성 서비스 공급자를 사용하여 구성된 연결이 있는 경우 연결 이름은 연결 이름이 될 수 있습니다. NAPID를 "GPRS1"로 설정하여 구성한 경우 연결 이름은 "GPRS1@WAP"일 수 있습니다.

의 경우 CMST_CONNECTION_TYPE원하는 연결 형식에 대한 GUID를 지정합니다. GUID 주변의 중괄호 {} 가 필요합니다. 사용할 수 있는 연결 유형은 다음과 같습니다.

연결 형식	GUID
Gsm	{A05DC613-E393-40ad-AA89-CCCE04277CD9}
Cdma	{274AD55A-4A70-4E35-93B3-AE2D2E6727FC}
레거시 3GPP	{6DE4C04B-B74E-47FA-99E5-8F2097C06A92}
LTE	{2378E547-8312-46A5-905E-5C581E92693B}
Wi-Fi	{8568B401-858E-4B7B-B3DF-0FD4927F131B}
Wi-Fi 핫스팟	{072FC7DC-1D93-40D1-9BB0-2114D7D73434}

의 경우 CMST_CONNECTION_NETWORK_TYPE원하는 네트워크 유형에 대한 GUID를 지정합니다. GUID 주변의 중괄호 {} 가 필요합니다. 사용할 수 있는 네트워크 유형은 다음과 같습니다.

네트워크 유형	GUID
GPRS	{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}
1XRTT	{B1E700AE-A62F-49FF-9BBE-B880C995F27D}
EDGE	{C347F8EC-7095-423D-B838-7C7A7F38CD03}
WCDMA UMTS	{A72F04C6-9BE6-4151-B5EF-15A53E12C482}
WCDMA FOMA	{B8326098-F845-42F3-804E-8CC3FF7B50B4}
1XEVDO	{DD42DF39-EBDF-407C-8146-1685416401B2}
1XEVDV	{61BF1BFD-5218-4CD4-949C-241CA3F326F6}
HSPA HSDPA	{047F7282-BABD-4893-AA77-B8B312657F8C}
HSPA HSUPA	{1536A1C6-A4AF-423C-8884-6BDDA3656F84}
LTE	{B41CBF43-6994-46FF-9C2F-D6CA6D45889B}
EHRPD	{7CFA04A5-0F3F-445C-88A4-C86ED2AD94EA}
이더넷 10Mbps	{97D3D1B3-854A-4C32-BD1C-C13069078370}
이더넷 100Mbps	{A8F4FE66-8D04-43F5-9DD2-2A85BD21029B}
이더넷 Gbps	{556C1E6B-B8D4-448E-836D-9451BA4CCE75}

의 경우 CMST_CONNECTION_DEVICE_TYPE원하는 디바이스 유형에 대한 GUID를 지정합니다. GUID 주변의 중괄호 {} 가 필요합니다. 사용할 수 있는 디바이스 유형은 다음과 같습니다.

장치 유형	GUID
셀룰러 디바이스	{F9A53167-4016-4198-9B41-86D9522DC019}
Ethernet	{97844272-00C7-4572-B20A-D8D861C095F2}
Bluetooth	{1D793123-701A-4fd0-B6AE-9C3C57E99C2C}
가상	{EAA02CE5-9C70-4E87-97FE-55C9DEC847D4}

형식 참조되는 연결 유형을 지정합니다. 다음 목록에서는 사용 가능한 연결 유형에 대해 설명합니다.

CMST_CONNECTION_NAME – 이름으로 지정된 연결입니다.
CMST_CONNECTION_TYPE – 지정된 형식의 모든 연결입니다.
CMST_CONNECTION_NETWORK_TYPE – 지정된 네트워크 유형의 모든 연결입니다.
CMST_CONNECTION_DEVICE_TYPE – 지정된 디바이스 유형의 모든 연결입니다.

OMA 클라이언트 프로비저닝 예제

애플리케이션 기반 매핑 정책 추가 이 예제에서 CMST_CONNECTION_NAME 형식의 ConnectionId는 CM_CellularEntries 구성 서비스 공급자로 구성된 연결 이름("GPRSConn1")으로 설정됩니다.

<wap-provisioningdoc>

   <characteristic type="CM_CellularEntries">
       <characteristic type="GPRSConn1">
          <parm name="ConnectionType" value="gprs" />
             <characteristic type="DevSpecificCellular">
                <parm name="GPRSInfoAccessPointName" value="apn.adatum.com" />
         </characteristic>
          <parm name="AlwaysOn" value="0" />
          <parm name="Enabled" value="1" />
       </characteristic>
    </characteristic>

   <characteristic type="CMPolicy">
      <characteristic type="Policy1">
       <parm name="SID" value="{A05D1234-F393-9385-AA89-CD3E049367D2}" />
       <parm name="ClientType" value="app" />
       <parm name="Host" value="*.+" />
       <parm name="OrderedConnections" value="1" />
       <characteristic type="Connections">
           <characteristic type="Conn000">
               <parm name="Type" value="CMST_CONNECTION_DEVICE_TYPE" />
               <parm name="ConnectionId" value="{F9A53167-4016-4198-9B41-86D9522DC019}" />
           </characteristic>
           <characteristic type="Conn001">
               <parm name="Type" value="CMST_CONNECTION_NETWORK_TYPE" />
               <parm name="ConnectionId" value="{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}" />
           </characteristic>
           <characteristic type="Conn002">
               <parm name="Type" value="CMST_CONNECTION_NAME" />
               <parm name="ConnectionId" value="GPRSConn1" />
           </characteristic>
           <characteristic type="Conn003">
              <parm name="Type" value="CMST_CONNECTION_TYPE" />
              <parm name="ConnectionId" value="{072FC7DC-1D93-40d1-9BB0-2114D7D73434}" />
           </characteristic>
       </characteristic>
      </characteristic>
    </characteristic>
</wap-provisioningdoc>

호스트 기반 매핑 정책 추가:

이 예제에서 CMST_CONNECTION_NAME 형식의 ConnectionId는 CM_CellularEntries 구성 서비스 공급자로 구성된 연결 이름("GPRSConn1")으로 설정됩니다.

<wap-provisioningdoc>

   <characteristic type="CM_CellularEntries">
       <characteristic type="GPRSConn1">
          <parm name="ConnectionType" value="gprs" />
             <characteristic type="DevSpecificCellular">
                <parm name="GPRSInfoAccessPointName" value="apn.adatum.com" />
         </characteristic>
          <parm name="AlwaysOn" value="0" />
          <parm name="Enabled" value="1" />
       </characteristic>
    </characteristic>

   <characteristic type="CMPolicy">
      <characteristic type="Policy3">
       <parm name="SID" value="*" />
       <parm name="ClientType" value="*" />
       <parm name="Host" value="*.contoso.com" />
       <parm name="OrderedConnections" value="1" />
       <characteristic type="Connections">
           <characteristic type="Conn000">
               <parm name="Type" value="CMST_CONNECTION_DEVICE_TYPE" />
               <parm name="ConnectionId" value="{F9A53167-4016-4198-9B41-86D9522DC019}" />
           </characteristic>
           <characteristic type="Conn001">
               <parm name="Type" value="CMST_CONNECTION_NETWORK_TYPE" />
               <parm name="ConnectionId" value="{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}" />
           </characteristic>
           <characteristic type="Conn002">
               <parm name="Type" value="CMST_CONNECTION_NAME" />
               <parm name="ConnectionId" value="GPRSConn1" />
           </characteristic>
           <characteristic type="Conn003">
               <parm name="Type" value="CMST_CONNECTION_TYPE" />
               <parm name="ConnectionId" value="{072FC7DC-1D93-40d1-9BB0-2114D7D73434}" />
           </characteristic>
       </characteristic>
      </characteristic>
    </characteristic>

</wap-provisioningdoc>

OMA DM 예제

애플리케이션 기반 매핑 정책 추가:

<SyncML>
    <SyncBody>
        <Atomic>
    <CmdID>8000</CmdID>
    <Add>
        <CmdID>8051</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/SID</LocURI>
            </Target>
            <Data>{A05D1234-F393-9385-AA89-CD3E049367D2}</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8052</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/ClientType</LocURI>
            </Target>
            <Data>app</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8053</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/Host</LocURI>
            </Target>
            <Data>*.+</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8054</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/OrderedConnections</LocURI>
            </Target>
            <Data>1</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8055</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/Connections/Conn000/ConnectionId</LocURI>
            </Target>
            <Data>{A05DC613-E393-40AD-AA89-CCCE04277CD9}</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8056</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy4/Connections/Conn000/Type</LocURI>
            </Target>
            <Data>CMST_CONNECTION_DEVICE_TYPE</Data>
        </Item>
    </Add>
        </Atomic>
        <Final/>
    </SyncBody>
</SyncML>

호스트 기반 매핑 정책 추가:

<SyncML>
    <SyncBody>
        <Atomic>
    <CmdID>8000</CmdID>
    <Add>
        <CmdID>8049</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/SID</LocURI>
            </Target>
            <Data>*</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8050</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/ClientType</LocURI>
            </Target>
            <Data>*</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8051</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/Host</LocURI>
            </Target>
            <Data>*.contoso.com</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8052</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/OrderedConnections</LocURI>
            </Target>
            <Data>1</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8053</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/Connections/Conn000/ConnectionId</LocURI>
            </Target>
            <Data>{AFB7D659-FC1F-4EA5-BDD0-0FDA62676D96}</Data>
        </Item>
    </Add>
    <Add>
        <CmdID>8054</CmdID>
        <Item>
            <Target>
                <LocURI>./Vendor/MSFT/CMPolicy/BTHPolicy6/Connections/Conn000/Type</LocURI>
            </Target>
            <Data>CMST_CONNECTION_NETWORK_TYPE</Data>
        </Item>
    </Add>
        </Atomic>
        <Final/>
    </SyncBody>
</SyncML>

Microsoft 사용자 지정 요소

요소	사용 가능
parm-query	예
비정상적인	예
characteristic-query	예 재귀 쿼리: 예 최상위 쿼리: 예

구성 서비스 공급자 참조

다음을 통해 공유

CMPolicy CSP

OMA 클라이언트 프로비저닝 예제

OMA DM 예제

Microsoft 사용자 지정 요소

피드백

추가 리소스

다음을 통해 공유

CMPolicy CSP

OMA 클라이언트 프로비저닝 예제

OMA DM 예제

Microsoft 사용자 지정 요소

관련 항목

피드백

추가 리소스