共用方式為


CMPolicy CSP

下表顯示 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.commail.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
特性查詢

遞歸查詢:是

最上層查詢:是

設定服務提供者參考