Personalizzare l'asset delle impostazioni paese e operatore
L'asset delle impostazioni paese e dell'operatore (COSA) è un database di profili di operatore mobile. È incluso in Windows 10 come pacchetto di provisioning. Quando una SIM viene inserita in un dispositivo basato su Windows abilitato per LA COSA, il framework di provisioning tenta di stabilire una connessione cellulare cercando il profilo corrispondente e APN in COSA.
Nota
Questa funzionalità è supportata solo in Windows 10, versione 1703 e successiva per le edizioni desktop (Home, Pro, Enterprise e Education)
È possibile estendere COSA con pacchetti di provisioning generati dall'OEM durante l'immagine desktop. Ciò consente agli OEMS di introdurre nuovi profili COSA al database, nonché sostituire o estendere i profili COSA esistenti. Ad esempio, è possibile aggiungere un profilo per un operatore di rete virtuale mobile (MVNO) attualmente in COSA o un nuovo partner per Piani per dispositivi mobili creando un file di risposta che contiene le impostazioni. È anche possibile modificare o rimuovere un profilo esistente usando l'operatore Replace nel file di risposte esistente.
Importante
- Assicurarsi di leggere la sezione How to support the COSA OEM-generated provisioning package once the device is in market section below.
- In genere è consigliabile aggiungere solo LE API non incluse nel database COSA di Windows. Se si sostituisce la voce già presente in COSA e l'operatore mobile cambia in futuro, non verrà aggiornato automaticamente poiché il database cercherà il pacchetto COSA OEM per tali voci.
- È consigliabile consultare le API più recenti per l'operatore mobile che si prevede di aggiungere, per assicurarsi che, se sono presenti API specifiche del dispositivo dati aggiunte al file COSA OEM (nel caso in cui l'operatore usi API diverse per tablet rispetto ai telefoni).
- Microsoft consiglia agli operatori mobili di inviare eventuali modifiche del profilo apportate per estendere COSA a Microsoft. Per altre informazioni, vedere Invio di database COSA/APN.
Importante
Microsoft raccoglie i dati di telemetria seguenti correlati alla COSA:
- AfterMarketProfile: pubblicato quando un pacchetto OEM aggiunge un nuovo profilo. I dati includono l'ID profilo (in genere un GUID) e le informazioni di destinazione per il profilo (ad esempio MCC, MNC, SPN e così via).
- ProfileReplaced: pubblicato quando il pacchetto OEM sostituisce un profilo COSA. I dati sono l'ID del profilo.
- ProfileSuppressedByAfterMarketProfile : pubblicato quando un pacchetto OEM contiene un profilo corrispondente anche quando un profilo COSA corrisponde. I dati di telemetria contengono l'ID profilo.
Per aggiungere un nuovo profilo
È possibile aggiungere un nuovo profilo non ancora incluso nel database COSA usando la procedura seguente.
Creare un file di risposte o modificare un file di risposte esistente contenente le nuove impostazioni del profilo. Di seguito è riportato un esempio,
- Assicurarsi di sostituire le informazioni sul
<ID>tag con il GUID personalizzato.
<?xml version="1.0" encoding="UTF-8"?> <WindowsCustomizations> <PackageConfig xmlns="urn:schemas-Microsoft-com:Windows-ICD-Package-Config.v1.0"> <ID>{7240F79C-7567-4BA3-95C0-ABD31D02A385}</ID> <Name>COSAPC.Extension</Name> <Version>5.0</Version> <OwnerType>OEM</OwnerType> </PackageConfig> <Settings xmlns="urn:schemas-microsoft-com:windows-provisioning"> <Customizations> <Targets> <Target Id="12345678-abcd-1111-aaaa-1ead5bca0320"> <TargetState> <Condition Name="Mcc" Value="901" /> <Condition Name="Mnc" Value="37" /> <Condition Name="ICCID" Value="range:8988247000100000000,8988247000199999997" /> <Condition Name="uiname" Value="Contoso (OEM)" /> <Condition Name="uiorder" Value="0" /> </TargetState> </Target> <Target Id="87654321-abcd-1111-aaaa-1ead5bca0320"> <TargetState> <Condition Name="Mcc" Value="001" /> <Condition Name="Mnc" Value="01" /> <Condition Name="uiname" Value="Fabrikam (OEM)" /> <Condition Name="uiorder" Value="0" /> </TargetState> </Target> </Targets> <Profile Name="Fabrikam (OEM)"> <TargetRefs> <TargetRef Id="87654321-abcd-1111-aaaa-1ead5bca0320" /> </TargetRefs> <Settings> <Connections> <Cellular> <Connection ConnectionName="Fabrikam (OEM)_i0$(__MVID)@WAP"> <PurposeGroups>{3e5545d2-1137-4dc8-a198-33f1c657515f}</PurposeGroups> <AlwaysOn>1</AlwaysOn> <FriendlyName>Fabrikan Connect</FriendlyName> <AccessPointName>apn</AccessPointName> <IPType>IPv4v6</IPType> <AlwaysOn>1</AlwaysOn> <Roaming>5</Roaming> </Connection> </Cellular> </Connections> <DataMarketplace> <PerSimSettings> <SettingsForSim SimIccid="$(__ICCID)"> <SupportDataMarketplace>1</SupportDataMarketplace> <DataMarketplaceRoamingUIEnabled>0</DataMarketplaceRoamingUIEnabled> </SettingsForSim> </PerSimSettings> </DataMarketplace> </Settings> </Profile> <Profile Name="Contoso (OEM)"> <TargetRefs> <TargetRef Id="12345678-abcd-1111-aaaa-1ead5bca0320" /> </TargetRefs> <Settings> <Connections> <Cellular> <Connection ConnectionName="Contoso (OEM)_i0$(__MVID)@WAP"> <PurposeGroups>{3e5545d2-1137-4dc8-a198-33f1c657515f}</PurposeGroups> <AlwaysOn>1</AlwaysOn> <FriendlyName>Contoso Connect</FriendlyName> <AccessPointName>apn</AccessPointName> <IPType>IPv4v6</IPType> <AlwaysOn>1</AlwaysOn> <Roaming>5</Roaming> </Connection> </Cellular> </Connections> <DataMarketplace> <PerSimSettings> <SettingsForSim SimIccid="$(__ICCID)"> <SupportDataMarketplace>1</SupportDataMarketplace> <DataMarketplaceRoamingUIEnabled>0</DataMarketplaceRoamingUIEnabled> </SettingsForSim> </PerSimSettings> </DataMarketplace> </Settings> </Profile> </Customizations> </Settings> </WindowsCustomizations>- Assicurarsi di sostituire le informazioni sul
Creare un pacchetto di provisioning che include il file di risposta. Per altre informazioni, vedere Per compilare un pacchetto di provisioning.
Inserire i pacchetti di provisioning (PPKG) nella posizione seguente: %WINDIR%\Provisioning\COSA\OEM.
Eseguire test necessari per la convalida.
Di seguito è riportato un elenco dei gruppi di scopo pertinenti per le API.
| Tipo | Identificatore |
|---|---|
| Internet | 3E5545D2-1137-4DC8-A198-33F1C657515F |
| Collegamento LTE | 11A6FE68-5B47-4859-9CB6-1EAC96A8F0BD |
| Purchase | 95522B2B-A6D1-4E40-960B-05E6D3F962AB |
| Amministrativo | 2FFD9261-C23C-4D27-8DCF-CDE4E14A364 |
Per un elenco completo delle impostazioni COSA, vedere Pianificazione dell'invio del database COSA/APN.
Come supportare il pacchetto di provisioning generato dall'OEM COSA una volta che il dispositivo si trova sul mercato
Prima di includere il pacchetto di provisioning generato dall'OEM COSA nell'immagine del dispositivo, prendere in considerazione un meccanismo per aggiornare il pacchetto generato dall'OEM COSA dopo che il dispositivo si trova sul mercato. Ecco altre note sulla configurazione e gli aggiornamenti delle immagini.
- Il pacchetto di provisioning generato dall'OEM COSA deve essere escluso dalla migrazione PBR per evitare voci duplicate, vedere Escludere file e impostazioni.
- Per verificare che il file di esclusione abbia esito positivo, sarà necessario avere un'immagine di fabbrica con PBR implementata, quindi passare alle impostazioni -> aggiornare> - reimpostare questo PC e dopo la reimpostazione è comunque possibile visualizzare l'APN personalizzato nelle impostazioni -> rete> - cellulare. Nella cartella %WINDIR%\Provisioning\COSA OEM deve essere presente anche un solo pacchetto di provisioning COSA\OEM.
Esempio
<migration urlid="http://www.microsoft.com/migration/1.0/migxmlext/MyFileExclusions">
<component type="Documents" context="System">
<displayName>File exclusions</displayName>
<role role="Data">
<rules>
<unconditionalExclude>
<objectSet>
<pattern type="File">%SystemDrive%\Windows\Provisioning\Cosa\OEM\* [*]</pattern>
</objectSet>
</unconditionalExclude>
</rules>
</role>
</component>
</migration>
Per tutti gli operatori aggiunti tramite il pacchetto di provisioning generato dall'OEM, sarà necessario mantenere l'OEM in caso di modifiche future da parte dell'operatore mobile, in modo da assicurarsi di disporre di un meccanismo per aggiornare questi elementi in futuro.
- L'aggiornamento del pacchetto viene gestito da un driver e Windows Update
- Sarà necessario assicurarsi di avere un driver di dispositivo esistente nel dispositivo per il componente cellulare e il file INF è impostato per copiare il PPKG
- Seguire le istruzioni riportate in questo documento per creare l'esempio di file INF:
[SourceDisksNames] 1 = %DiskId1% [SourceDisksFiles] ContosoCosaCustomization.ppkg = 1 ContosoCosaCustomizationWithDataClass.xml = 1 ; other driver package files omitted from example for brevity [DestinationDirs] CosaCustomization.CopyList =10,Provisioning\Cosa\OEM ; other CopyFiles sections in DestinationDirs omitted from example for brevity ; Manufacturer and Models sections omitted for brevity. Assume Models section indicates a DDInstall section of ContosoInstallSection [ContosoInstallSection] CopyFiles=CosaCustomization.CopyList [CosaCustomization.CopyList] ContosoCosaCustomization.ppkg ContosoCosaCustomizationWithDataClass.xml- Il driver deve essere precaricati nell'immagine factory in modo che se si aggiorna il driver in Windows Update in futuro il dispositivo eseguirà l'analisi e troverà una versione più recente di questo driver per scaricare e installare.
- È consigliabile testare il meccanismo di aggiornamento tramite Windows Update nello stesso meccanismo di test degli aggiornamenti del driver per un dispositivo o un driver pre-rilascio.
- Se si dispone di un meccanismo alternativo per aggiornare il pacchetto di provisioning generato dall'OEM, assicurarsi che funzioni sia nell'immagine di fabbrica che nel dispositivo dopo l'esecuzione della reimpostazione del pulsante push per testare lo scenario utente finale.
Nota
Il PPKG verrà applicato nelle condizioni seguenti. È in base alla progettazione che non vengono applicate all'evento di copia di PPKG nella posizione specificata
- Dopo il riavvio del sistema operativo quando il sistema è inattiva
- Dopo l'accesso utente quando il sistema è inattiva
Se l'operatore mobile aggiorna eventuali informazioni di provisioning (ad esempio API) e il dispositivo è il pacchetto di provisioning generato dall'OEM per tale operatore mobile, l'OEM dovrà ottenere le nuove informazioni di provisioning e aggiornare il pacchetto di provisioning GENERATO dall'OEM sui dispositivi forniti tramite Windows Update.