CMPolicyEnterprise CSP

Artículo
03/18/2023

En la tabla siguiente se muestra la aplicabilidad de Windows:

Edición	Windows 10	Windows 11
Inicio	No	No
Pro	No	No
Windows SE	No	No
Negocios	No	No
Empresa	No	No
Educación	No	No

La empresa usa el proveedor de servicios de configuración CMPolicyEnterprise para definir las reglas que el Administrador de conexiones usa para identificar la conexión correcta para una solicitud de conexión.

Nota

Este proveedor de servicios de configuración requiere que se acceda a las funcionalidades de ID_CAP_CSP_FOUNDATION y ID_CAP_NETWORKING_ADMIN desde una aplicación de configuración de red.

Cada entrada de directiva identifica una o varias aplicaciones en combinación con un patrón de host. A la entrada de directiva se le asigna una lista de detalles de conexión que Administrador de conexiones usa para satisfacer las solicitudes de conexión que coinciden con los patrones de aplicación y host. El proveedor de servicios de configuración CMPolicyEnterprise puede tener varias directivas

Ordenación de directivas: no hay ningún orden explícito de las directivas. La regla general es que las asignaciones de directivas más concretas o específicas tienen mayor prioridad.

Directivas predeterminadas: las directivas se aplican en el orden de su ámbito con las directivas más específicas que se tienen en cuenta antes que las directivas más generales. El comportamiento predeterminado del teléfono se aplica a todas las aplicaciones y todos los dominios y solo se usa cuando no hay ninguna otra directiva más específica disponible. La directiva predeterminada es usar primero cualquier Wi-Fi red disponible y, a continuación, cualquier APN disponible.

A continuación se muestra el objeto de administración del proveedor de servicios de configuración CMPolicyEnterprise en formato de árbol, tal como lo usan tanto el aprovisionamiento de clientes de Open Mobile Alliance (OMA) como el Administración de dispositivos OMA.

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

policyName Define el nombre de la directiva.

SID El valor de SID depende de ClientType.

Para las directivas de asignación basadas en aplicaciones de Plataforma universal de Windows (UWP), SID es el nombre de la familia package sin corchetes{}, no la aplicación.

En el caso de las directivas de asignación no basadas en aplicaciones para UWP, SID es el identificador de producto de la aplicación en formato GUID. Los corchetes {} alrededor del GUID son necesarios.

Para las directivas de asignación basadas en host, el SID debe establecerse en *.

ClientType Especifica el tipo de directiva de asignación.

En la lista siguiente se describen los tipos de directivas de asignación disponibles:

Las directivas de asignación basadas en aplicaciones se aplican a las aplicaciones. Para especificar este tipo de asignación, use el valor app.
Las directivas de asignación basadas en host se aplican a todos los tipos de clientes que solicitan conexiones a los hosts especificados. Para especificar este tipo de asignación, use el valor *.

Host Especifica el nombre de un patrón de host. El nombre de host coincide con la solicitud de conexión para seleccionar la directiva correcta que se va a usar.

El patrón de host puede tener dos comodín, "*" y "+". El patrón de host no es un patrón de dirección URL y no hay ningún concepto de transporte o rutas de acceso en el host específico. Por ejemplo, el patrón de host podría ser "*.host_name.com" para que coincida con cualquier prefijo con los dominios de host_name.com. El patrón de host coincidirá con "www.host_name.com" y "mail.host_name.com", pero no coincidirá con "host_name.com".

OrderedConnections Especifica si la lista de conexiones está en orden de preferencia.

Un valor de "0" especifica que las conexiones no aparecen en orden de preferencia. Un valor de "1" indica que las conexiones enumeradas están en orden de preferencia.

ConnXXX

Enumera las conexiones asociadas a la directiva. Los nombres de los elementos comienzan por "Conn" seguidos de tres dígitos, que se incrementan a partir de "000". Por ejemplo, una directiva que se aplica a cinco conexiones tendría entradas de elemento denominadas "Conn000", "Conn001", "Conn002", "Conn003" y "Conn004".

ConnectionID Especifica un identificador único para una conexión dentro de un grupo de conexiones. El valor exacto se basa en el parámetro Type.

En CMST_CONNECTION_NAME, especifique el nombre de conexión. Por ejemplo, si tiene una conexión configurada mediante el proveedor de servicios de configuración de CM_CellularEntries, el nombre de la conexión podría ser el nombre de la conexión. Si tiene un NAP configurado con el NAPID establecido en "GPRS1", el nombre de conexión podría ser "GPRS1@WAP".

Para CMST_CONNECTION_TYPE, especifique el GUID para el tipo de conexión deseado. Los corchetes {} alrededor del GUID son necesarios. Están disponibles los siguientes tipos de conexión:

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

Para CMST_CONNECTION_NETWORK_TYPE, especifique el GUID para el tipo de red deseado. Los corchetes {} alrededor del GUID son necesarios. Están disponibles los siguientes tipos de red:

Tipo de red	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 Mbps	{97D3D1B3-854A-4C32-BD1C-C13069078370}
Ethernet 100 Mbps	{A8F4FE66-8D04-43F5-9DDD2-2A85BD21029B}
Ethernet Gbps	{556C1E6B-B8D4-448E-836D-9451BA4CCE75}

Para CMST_CONNECTION_DEVICE_TYPE, especifique el GUID para el tipo de dispositivo deseado. Los corchetes {} alrededor del GUID son necesarios. Están disponibles los siguientes tipos de dispositivos:

Tipo de dispositivo	GUID
Dispositivo móvil	{F9A53167-4016-4198-9B41-86D9522DC019}
Ethernet	{97844272-00C7-4572-B20A-D8D861C095F2}
Bluetooth	{1D793123-701A-4fd0-B6AE-9C3C57E99C2C}
Virtual	{EAA02CE5-9C70-4E87-97FE-55C9DEC847D4}

Tipo Especifica el tipo de conexión a la que se hace referencia. En la lista siguiente se describen los tipos de conexión disponibles:

CMST_CONNECTION_NAME : una conexión especificada por el nombre.
CMST_CONNECTION_TYPE : cualquier conexión de un tipo especificado.
CMST_CONNECTION_NETWORK_TYPE : cualquier conexión de un tipo de dispositivo especificado.
CMST_CONNECTION_DEVICE_TYPE : cualquier conexión del tipo de red especificado.

Ejemplos de aprovisionamiento de clientes OMA

Agregar una directiva de asignación basada en aplicaciones. En este ejemplo, connectionId para el tipo CMST_CONNECTION_NAME se establece en el nombre de la conexión ("GPRSConn1") configurada con el proveedor de servicios de configuración de 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="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>

Agregar una directiva de asignación basada en host. En este ejemplo, connectionId para el tipo CMST_CONNECTION_NAME se establece en el nombre de la conexión ("GPRSConn1") configurada con el proveedor de servicios de configuración de 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="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>

Ejemplos de OMA DM

Agregar una directiva de asignación basada en aplicaciones:

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

Agregar una directiva de asignación basada en host:

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

Elementos personalizados de Microsoft

Elemento	Disponible
parm-query	Sí
nocharacteristic	Sí
characteristic-query	Sí Consulta recursiva: Sí Consulta de nivel superior: Sí

Referencia de proveedor de servicios de configuración

CMPolicyEnterprise CSP

Ejemplos de aprovisionamiento de clientes OMA

Ejemplos de OMA DM

Elementos personalizados de Microsoft

Comentarios

Comentarios

Recursos adicionales

CMPolicyEnterprise CSP

Ejemplos de aprovisionamiento de clientes OMA

Ejemplos de OMA DM

Elementos personalizados de Microsoft

Temas relacionados

Comentarios

Comentarios

Recursos adicionales