CMPolicyEnterprise-Konfigurationsdienstanbieter

  • Artikel

Die folgende Tabelle zeigt die Anwendbarkeit von Windows:

Edition Windows 10 Windows 11
Home Nein Nein
Vorteil Nein Nein
Windows SE Nein Nein
Business Nein Nein
Unternehmen Nein Nein
Bildung Nein Nein

Der CMPolicyEnterprise-Konfigurationsdienstanbieter wird vom Unternehmen verwendet, um Regeln zu definieren, die der Verbindungs-Manager verwendet, um die richtige Verbindung für eine Verbindungsanforderung zu identifizieren.

Hinweis

Dieser Konfigurationsdienstanbieter erfordert, dass über eine Netzwerkkonfigurationsanwendung auf die ID_CAP_CSP_FOUNDATION- und ID_CAP_NETWORKING_ADMIN-Funktionen zugegriffen werden kann.

Jeder Richtlinieneintrag identifiziert eine oder mehrere Anwendungen in Kombination mit einem Hostmuster. Dem Richtlinieneintrag wird eine Liste von Verbindungsdetails zugewiesen, die Verbindungs-Manager verwendet, um Verbindungsanforderungen zu erfüllen, die den Anwendungs- und Hostmustern entsprechen. CMPolicyEnterprise-Konfigurationsdienstanbieter kann über mehrere Richtlinien verfügen

Jeder Richtlinieneintrag identifiziert eine oder mehrere Anwendungen in Kombination mit einem Hostmuster. Dem Richtlinieneintrag wird eine Liste von Verbindungsdetails zugewiesen, die Verbindungs-Manager verwendet, um Verbindungsanforderungen zu erfüllen, die den Anwendungs- und Hostmustern entsprechen. CMPolicyEnterprise-Konfigurationsdienstanbieter kann über mehrere Richtlinien verfügen

Richtlinienreihenfolge: Es gibt keine explizite Reihenfolge der Richtlinien. Die allgemeine Regel ist, dass die konkretsten oder spezifischsten Richtlinienzuordnungen eine höhere Priorität haben.

Standardrichtlinien: Richtlinien werden in der Reihenfolge ihres Umfangs angewendet, wobei die spezifischsten Richtlinien vor den allgemeineren Richtlinien berücksichtigt werden. Das Standardverhalten des Telefons gilt für alle Anwendungen und alle Domänen und wird nur verwendet, wenn keine andere, spezifischere Richtlinie verfügbar ist. Die Standardrichtlinie besteht darin, zuerst alle verfügbaren Wi-Fi Netzwerk und dann alle verfügbaren APNs zu verwenden.

Im Folgenden wird das CmPolicyEnterprise-Konfigurationsdienstanbieterverwaltungsobjekt im Strukturformat dargestellt, das sowohl von der Open Mobile Alliance (OMA)-Clientbereitstellung als auch von OMA Geräteverwaltung verwendet wird.

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

Policyname Definiert den Namen der Richtlinie.

SID Der Wert von SID hängt vom ClientType ab.

Bei Universelle Windows-Plattform App-basierten Zuordnungsrichtlinien (UWP) ist SID der Paketfamilienname ohne geschweifte Klammern{}, nicht die Anwendung.

Bei anwendungsbasierten Zuordnungsrichtlinien ohne UWP ist SID die Anwendungsprodukt-ID im GUID-Format. Die geschweiften Klammern {} um die GUID sind erforderlich.

Für hostbasierte Zuordnungsrichtlinien muss die SID auf *festgelegt werden.

ClientType Gibt den Typ der Zuordnungsrichtlinie an.

In der folgenden Liste werden die verfügbaren Zuordnungsrichtlinientypen beschrieben:

  • Anwendungsbasierte Zuordnungsrichtlinien werden auf Anwendungen angewendet. Um diesen Zuordnungstyp anzugeben, verwenden Sie den Wert app.

  • Hostbasierte Zuordnungsrichtlinien werden auf alle Typen von Clients angewendet, die Verbindungen mit angegebenen Hosts anfordern. Um diesen Zuordnungstyp anzugeben, verwenden Sie den Wert *.

Host Gibt den Namen eines Hostmusters an. Der Hostname wird mit der Verbindungsanforderung abgeglichen, um die richtige Richtlinie auszuwählen.

Das Hostmuster kann zwei Wildcards aufweisen: "*" und "+". Das Hostmuster ist kein URL-Muster, und es gibt kein Konzept von Transport oder Pfaden auf dem jeweiligen Host. Das Hostmuster kann z. B. "*.host_name.com" lauten, um ein beliebiges Präfix mit den host_name.com Domänen abzugleichen. Das Hostmuster entspricht "www.host_name.com" und "mail.host_name.com", aber es entspricht nicht "host_name.com".

OrderedConnections Gibt an, ob sich die Liste der Verbindungen in der bevorzugten Reihenfolge befindet.

Der Wert "0" gibt an, dass die Verbindungen nicht in der bevorzugten Reihenfolge aufgeführt sind. Der Wert "1" gibt an, dass die aufgeführten Verbindungen in der bevorzugten Reihenfolge vorliegen.

ConnXXX

Listet die verbindungen auf, die der Richtlinie zugeordnet sind. Elementnamen beginnen mit "Conn", gefolgt von drei Ziffern, die ab "000" inkrementiert werden. Beispielsweise würde eine Richtlinie, die auf fünf Verbindungen angewendet wurde, Elementeinträge mit den Namen "Conn000", "Conn001", "Conn002", "Conn003" und "Conn004" enthalten.

ConnectionID Gibt einen eindeutigen Bezeichner für eine Verbindung innerhalb einer Gruppe von Verbindungen an. Der genaue Wert basiert auf dem Type-Parameter.

CMST_CONNECTION_NAMEGeben Sie für den Verbindungsnamen an. Wenn Sie beispielsweise eine Verbindung mithilfe des CM_CellularEntries Konfigurationsdienstanbieters konfiguriert haben, kann der Verbindungsname der Name der Verbindung sein. Wenn Sie einen NAP konfiguriert haben, bei dem die NAPID auf "GPRS1" festgelegt ist, kann der Verbindungsname "GPRS1@WAP" lauten.

CMST_CONNECTION_TYPEGeben Sie für die GUID für den gewünschten Verbindungstyp an. Die geschweiften Klammern {} um die GUID sind erforderlich. Die folgenden Verbindungstypen sind verfügbar:

Verbindungstyp GUID
GSM {A05DC613-E393-40ad-AA89-CCCE04277CD9}
CDMA {274AD55A-4A70-4E35-93B3-AE2D2E6727FC}
Legacy 3GPP {6DE4C04B-B74E-47FA-99E5-8F2097C06A92}
LTE {2378E547-8312-46A5-905E-5C581E92693B}
WLAN {8568B401-858E-4B7B-B3DF-0FD4927F131B}
Wi-Fi Hotspot {072FC7DC-1D93-40D1-9BB0-2114D7D73434}

CMST_CONNECTION_NETWORK_TYPEGeben Sie für die GUID für den gewünschten Netzwerktyp an. Die geschweiften Klammern {} um die GUID sind erforderlich. Die folgenden Netzwerktypen sind verfügbar:

Netzwerktyp 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 MBit/s {97D3D1B3-854A-4C32-BD1C-C13069078370}
Ethernet 100 MBit/s {A8F4FE66-8D04-43F5-9DD2-2A85BD21029B}
Ethernet-GBit/s {556C1E6B-B8D4-448E-836D-9451BA4CCE75}

CMST_CONNECTION_DEVICE_TYPEGeben Sie für die GUID für den gewünschten Gerätetyp an. Die geschweiften Klammern {} um die GUID sind erforderlich. Die folgenden Gerätetypen sind verfügbar:

Gerätetyp GUID
Mobilfunkgerät {F9A53167-4016-4198-9B41-86D9522DC019}
Ethernet {97844272-00C7-4572-B20A-D8D861C095F2}
Bluetooth {1D793123-701A-4fd0-B6AE-9C3C57E99C2C}
Virtuellen {EAA02CE5-9C70-4E87-97FE-55C9DEC847D4}

Typ Gibt den Verbindungstyp an, auf den verwiesen wird. In der folgenden Liste werden die verfügbaren Verbindungstypen beschrieben:

  • CMST_CONNECTION_NAME – Eine verbindung, die durch den Namen angegeben wird.

  • CMST_CONNECTION_TYPE – Jede Verbindung eines angegebenen Typs.

  • CMST_CONNECTION_NETWORK_TYPE – Jede Verbindung eines angegebenen Gerätetyps.

  • CMST_CONNECTION_DEVICE_TYPE – Jede Verbindung des angegebenen Netzwerktyps.

Beispiele für die OMA-Clientbereitstellung

Hinzufügen einer anwendungsbasierten Zuordnungsrichtlinie. In diesem Beispiel wird die ConnectionId für den Typ CMST_CONNECTION_NAME auf den Namen der Verbindung ("GPRSConn1") festgelegt, die mit dem CM_CellularEntries Konfigurationsdienstanbieter konfiguriert ist.

<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="CMPolicyEnterprise">
      <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>

Hinzufügen einer hostbasierten Zuordnungsrichtlinie. In diesem Beispiel wird die ConnectionId für den Typ CMST_CONNECTION_NAME auf den Namen der Verbindung ("GPRSConn1") festgelegt, die mit dem CM_CellularEntries Konfigurationsdienstanbieter konfiguriert ist.

<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="CMPolicyEnterprise">
      <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-Beispiele

Hinzufügen einer anwendungsbasierten Zuordnungsrichtlinie:

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

Hinzufügen einer hostbasierten Zuordnungsrichtlinie:

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

Benutzerdefinierte Microsoft-Elemente

Element Verfügbar
parm-query Ja
nocharacteristisch Ja
merkmalsabfrage Ja

Rekursive Abfrage: Ja

Abfrage der obersten Ebene: Ja

Referenz zum Konfigurationsdienstanbieter