CMPolicy CSP

發行項
02/06/2024

下表顯示 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 格式的應用程式產品識別碼。 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」的 NAP，則連線名稱可能是「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-單擊-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	是
特性查詢	是遞歸查詢：是最上層查詢：是

設定服務提供者參考

CMPolicy CSP

OMA 用戶端布建範例

OMA DM 範例

Microsoft 自定義元素

意見反應

意見反應

其他資源

CMPolicy CSP

OMA 用戶端布建範例

OMA DM 範例

Microsoft 自定義元素

相關主題

意見反應

意見反應

其他資源