Поставщик служб конфигурации CMPolicy

Статья
03/18/2023

В таблице ниже показано применимость Windows:

Выпуск	Windows 10	Windows 11
Домашняя	Да	Да
Pro	Да	Да
Windows SE	Нет	Да
Для бизнеса	Да	Да
Корпоративная	Да	Да
Для образовательных учреждений	Да	Да

Поставщик службы конфигурации CMPolicy определяет правила, которые диспетчер подключений использует для определения правильного подключения для запроса на подключение.

Примечание.

Этому поставщику службы конфигурации требуется доступ к возможностям ID_CAP_CSP_FOUNDATION и ID_CAP_NETWORKING_ADMIN из приложения конфигурации сети.

Каждая запись политики определяет одно или несколько приложений в сочетании с шаблоном узла. Записи политики назначается список сведений о подключении, которые диспетчер подключений использует для удовлетворения запросов на подключение, соответствующих шаблонам приложения и узла. Поставщик службы конфигурации CMPolicy может иметь несколько политик

Упорядочение политик. Явное упорядочение политик отсутствует. Общее правило заключается в том, что наиболее конкретные или конкретные сопоставления политик имеют более высокий приоритет.

Политики по умолчанию. Политики применяются в порядке их область с наиболее конкретными политиками, рассматриваемыми перед более общими политиками. Поведение телефона по умолчанию применяется ко всем приложениям и доменам и используется только в том случае, если не доступна другая, более конкретная политика. Политика по умолчанию — сначала использовать любой доступный Wi-Fi сети, а затем любой доступный APN.

Ниже показан объект управления поставщиком услуг конфигурации CMPolicy в формате дерева, который используется в подготовке клиентов Open Mobile Alliance (OMA) и OMA Управление устройствами.

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

policyName Определяет имя политики.

SID Значение идентификатора безопасности зависит от типа ClientType.

Для политик сопоставления на основе приложений универсальная платформа Windows (UWP) идентификатор безопасности — это имя семейства пакетов без фигурных скобок{}, а не приложение.

Для политик сопоставления на основе приложений, не относящихся к UWP, идентификатор продукта приложения — это идентификатор продукта приложения в формате GUID. Требуются фигурные скобки {} вокруг GUID.

Для политик сопоставления на основе узла идентификатор безопасности должен иметь значение *.

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". Например, политика, применяемая к пяти подключениям, будет содержать записи элементов с именами "Conn000", "Conn001", "Conn002", "Conn003" и "Conn004".

ConnectionID Задает уникальный идентификатор для соединения в группе подключений. Точное значение основано на параметре Type.

Для CMST_CONNECTION_NAMEукажите имя подключения. Например, если у вас есть подключение, настроенное с помощью поставщика службы конфигурации CM_CellularEntries, имя подключения может быть именем подключения. Если для NAP настроено значение "JSON1", имя подключения может быть "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}
Ethernet 10 Мбит/с	{97D3D1B3-854A-4C32-BD1C-C13069078370}
Ethernet 100 Мбит/с	{A8F4FE66-8D04-43F5-9DD2-2A85BD21029B}
Ethernet Гбит/с	{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

Добавление политики сопоставления на основе приложений. В этом примере для параметра ConnectionId типа CMST_CONNECTION_NAME задается имя соединения ("JSONConn1"), настроенного с помощью поставщика службы конфигурации CM_CellularEntries.

<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>

Добавление политики сопоставления на основе узла:

В этом примере для параметра ConnectionId типа CMST_CONNECTION_NAME задается имя соединения ("JSONConn1"), настроенного с помощью поставщика службы конфигурации CM_CellularEntries.

<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>

Пользовательские элементы Майкрософт

Элемент	Доступно
parm-query	Да
нехарактерный	Да
запрос на характеристику	Да Рекурсивный запрос: Да Запрос верхнего уровня: Да

Справочник по поставщикам служб конфигурации

Поделиться через

Поставщик служб конфигурации CMPolicy

Примеры подготовки клиентов OMA

Примеры OMA DM

Пользовательские элементы Майкрософт

Обратная связь

Дополнительные ресурсы

Поделиться через

Поставщик служб конфигурации CMPolicy

Примеры подготовки клиентов OMA

Примеры OMA DM

Пользовательские элементы Майкрософт

Связанные темы

Обратная связь

Дополнительные ресурсы