CMPolicy CSP

项目
03/18/2023

下表显示了 Windows 的适用性：

版次	Windows 10	Windows 11
Home 键	是	是
专业版	是	是
Windows SE	否	是
商用版	是	是
企业	是	是
教育	是	是

CMPolicy 配置服务提供程序定义连接管理器用于标识连接请求的正确连接的规则。

注意

此配置服务提供程序需要从网络配置应用程序访问ID_CAP_CSP_FOUNDATION和ID_CAP_NETWORKING_ADMIN功能。

每个策略条目与主机模式结合使用标识一个或多个应用程序。为策略条目分配一个连接详细信息列表，连接管理器使用该列表来满足与应用程序和主机模式匹配的连接请求。 CMPolicy 配置服务提供程序可以有多个策略

策略排序：没有策略的显式排序。一般规则是，最具体或特定的策略映射具有更高的优先级。

默认策略：策略按其范围的顺序应用，其中最具体的策略在更常规的策略之前考虑。手机的默认行为适用于所有应用程序和所有域，并且仅在没有其他更具体的策略可用时才使用。默认策略是先使用任何可用的 Wi-Fi 网络，然后使用任何可用的 APN。

下面显示了 Open Mobile Alliance (OMA) 客户端预配和 OMA 设备管理使用的树格式的 CMPolicy 配置服务提供程序管理对象。

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

policyName 定义策略的名称。

希 SID 的值取决于 ClientType。

对于通用 Windows 平台 (UWP) 基于应用的映射策略，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”开始递增。例如，应用于五个连接的策略将具有名为“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}
WLAN	{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}
以太网 10 Mbps	{97D3D1B3-854A-4C32-BD1C-C13069078370}
以太网 100 Mbps	{A8F4FE66-8D04-43F5-9DD2-2A85BD21029B}
以太网 Gbps	{556C1E6B-B8D4-448E-836D-9451BA4CCE75}

对于 CMST_CONNECTION_DEVICE_TYPE，请指定所需设备类型的 GUID。 GUID 周围的大括号 {} 是必需的。以下设备类型可用：

设备类型	GUID
手机网络设备	{F9A53167-4016-4198-9B41-86D9522DC019}
以太网	{97844272-00C7-4572-B20A-D8D861C095F2}
蓝牙	{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	是
uncharacteristic	是
characteristic-query	是递归查询：是顶级查询：是

配置服务提供程序参考

通过

CMPolicy CSP

OMA 客户端预配示例

OMA DM 示例

Microsoft 自定义元素

反馈

其他资源

通过

CMPolicy CSP

OMA 客户端预配示例

OMA DM 示例

Microsoft 自定义元素

相关主题

反馈

其他资源