CMPolicy CSP

Articolo
03/18/2023

La tabella seguente mostra l'applicabilità di Windows:

Edizione	Windows 10	Windows 11
Home	Sì	Sì
Pro	Sì	Sì
Windows SE	No	Sì
Lavoro	Sì	Sì
Per le aziende	Sì	Sì
Istruzione	Sì	Sì

Il provider di servizi di configurazione CMPolicy definisce le regole usate dal Gestione connessioni per identificare la connessione corretta per una richiesta di connessione.

Nota

Questo provider di servizi di configurazione richiede l'accesso alle funzionalità ID_CAP_CSP_FOUNDATION e ID_CAP_NETWORKING_ADMIN da un'applicazione di configurazione di rete.

Ogni voce di criterio identifica una o più applicazioni in combinazione con un modello host. Alla voce di criterio viene assegnato un elenco di dettagli di connessione che Gestione connessioni usa per soddisfare le richieste di connessione corrispondenti ai modelli di applicazione e host. Il provider di servizi di configurazione CMPolicy può avere più criteri

Ordinamento dei criteri: non esiste un ordinamento esplicito dei criteri. La regola generale prevede che i mapping dei criteri più concreti o specifici abbiano una precedenza più alta.

Criteri predefiniti: i criteri vengono applicati nell'ordine dell'ambito con i criteri più specifici considerati prima dei criteri più generali. Il comportamento predefinito del telefono si applica a tutte le applicazioni e a tutti i domini e viene usato solo quando non sono disponibili altri criteri più specifici. Il criterio predefinito consiste nell'usare prima qualsiasi rete Wi-Fi disponibile e quindi qualsiasi APN disponibile.

Di seguito viene illustrato l'oggetto di gestione del provider di servizi di configurazione CMPolicy in formato albero usato sia da Open Mobile Alliance (OMA) Client Provisioning che da OMA Gestione dispositivi.

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

policyName Definisce il nome dei criteri.

SID Il valore del SID dipende da ClientType.

Per i criteri di mapping basati su app piattaforma UWP (Universal Windows Platform) (UWP), SID è il nome della famiglia di pacchetti senza parentesi {}graffe e non l'applicazione.

Per i criteri di mapping non basati su applicazioni UWP, SID è l'ID prodotto dell'applicazione in formato GUID. Sono necessarie le parentesi {} graffe intorno al GUID.

Per i criteri di mapping basati su host, IL SID deve essere impostato su *.

ClientType Specifica il tipo di criteri di mapping.

L'elenco seguente descrive i tipi di criteri di mapping disponibili:

I criteri di mapping basati su applicazioni vengono applicati alle applicazioni. Per specificare questo tipo di mapping, usare il valore app.
I criteri di mapping basati su host vengono applicati a tutti i tipi di client che richiedono connessioni a host specificati. Per specificare questo tipo di mapping, usare il valore *.

Host Specifica il nome di un modello host. Il nome host viene associato alla richiesta di connessione per selezionare i criteri corretti da usare.

Il modello host può avere due caratteri jolly e *+. Il modello host non è un modello di URL e non esiste alcun concetto di trasporto o percorsi nell'host specifico. Ad esempio, il modello host potrebbe corrispondere *.host_name.com a qualsiasi prefisso ai host_name.com domini. Il modello host corrisponderà www.host_name.com a e mail.host_name.com, ma non corrisponderà host_name.coma .

OrderedConnections Specifica se l'elenco di connessioni è in ordine di preferenza.

Il valore "0" specifica che le connessioni non sono elencate in ordine di preferenza. Il valore "1" indica che le connessioni elencate sono in ordine di preferenza.

ConnXXX Enumera le connessioni associate ai criteri. I nomi degli elementi iniziano con "Conn" seguito da tre cifre, che a partire da "000". Ad esempio, un criterio applicato a cinque connessioni avrebbe voci di elemento denominate "Conn000", "Conn001", "Conn002", "Conn003" e "Conn004".

CONNECTIONID Specifica un identificatore univoco per una connessione all'interno di un gruppo di connessioni. Il valore esatto è basato sul parametro Type.

Per CMST_CONNECTION_NAMEspecificare il nome della connessione. Ad esempio, se si dispone di una connessione configurata usando il provider del servizio di configurazione CM_CellularEntries, il nome della connessione potrebbe essere il nome della connessione. Se è stato configurato un accesso alla rete con napid impostato su "GPRS1", il nome della connessione potrebbe essere "GPRS1@WAP".

Per CMST_CONNECTION_TYPEspecificare il GUID per il tipo di connessione desiderato. Sono necessarie le parentesi {} graffe intorno al GUID. Sono disponibili i tipi di connessione seguenti:

Tipo di connessione	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}
Wi-Fi	{8568B401-858E-4B7B-B3DF-0FD4927F131B}
Wi-Fi hotspot	{072FC7DC-1D93-40D1-9BB0-2114D7D73434}

Per CMST_CONNECTION_NETWORK_TYPEspecificare il GUID per il tipo di rete desiderato. Sono necessarie le parentesi {} graffe intorno al GUID. Sono disponibili i tipi di rete seguenti:

Tipo di rete	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-9DD2-2A85BD21029B}
Ethernet Gbps	{556C1E6B-B8D4-448E-836D-9451BA4CCE75}

Per CMST_CONNECTION_DEVICE_TYPEspecificare il GUID per il tipo di dispositivo desiderato. Sono necessarie le parentesi {} graffe intorno al GUID. Sono disponibili i tipi di dispositivo seguenti:

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

Digitare Specifica il tipo di connessione a cui si fa riferimento. Nell'elenco seguente vengono descritti i tipi di connessione disponibili:

CMST_CONNECTION_NAME : connessione specificata in base al nome.
CMST_CONNECTION_TYPE : qualsiasi connessione di un tipo specificato.
CMST_CONNECTION_NETWORK_TYPE : qualsiasi connessione di un tipo di rete specificato.
CMST_CONNECTION_DEVICE_TYPE : qualsiasi connessione del tipo di dispositivo specificato.

Esempi di provisioning client OMA

Aggiunta di criteri di mapping basati su applicazione. In questo esempio, connectionId per il tipo CMST_CONNECTION_NAME è impostato sul nome della connessione ("GPRSConn1") configurata con il provider del servizio di configurazione 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="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>

Aggiunta di criteri di mapping basati su host:

In questo esempio, connectionId per il tipo CMST_CONNECTION_NAME è impostato sul nome della connessione ("GPRSConn1") configurata con il provider del servizio di configurazione 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="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>

Esempi di dm OMA

Aggiunta di criteri di mapping basati su applicazione:

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

Aggiunta di criteri di mapping basati su host:

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

Elementi personalizzati Microsoft

Elemento	Disponibile
parm-query	Sì
uncharacteristic	Sì
characteristic-query	Sì Query ricorsiva: Sì Query di primo livello: Sì

Riferimento del provider di servizi di configurazione

CMPolicy CSP

Esempi di provisioning client OMA

Esempi di dm OMA

Elementi personalizzati Microsoft

Commenti e suggerimenti

Commenti e suggerimenti

Risorse aggiuntive

CMPolicy CSP

Esempi di provisioning client OMA

Esempi di dm OMA

Elementi personalizzati Microsoft

Argomenti correlati

Commenti e suggerimenti

Commenti e suggerimenti

Risorse aggiuntive