Personalizar o ativo de configurações de país e operador

O COSA (Country and Operator Settings Asset) é um banco de dados de perfis de operadora móvel. Ele está incluído em Windows 10 como um pacote de provisionamento. Quando um SIM é inserido em um dispositivo baseado no Windows habilitado para COSA, a estrutura de provisionamento tenta estabelecer uma conexão celular pesquisando o perfil correspondente e o APN no COSA.

Observação

Esse recurso só tem suporte no Windows 10, versão 1703 e superior para edições da área de trabalho (Home, Pro, Enterprise e Education)

O COSA pode ser estendido com pacotes de provisionamento gerados por OEM durante a geração de imagens da área de trabalho. Isso permite que os OEMs introduzam novos perfis COSA no banco de dados, bem como substituam ou estendem perfis cosa existentes do Windows. Por exemplo, você pode adicionar um perfil para uma operadora de rede virtual móvel (MVNO) que não está atualmente na COSA ou um novo parceiro para Planos Móveis, criando um arquivo de resposta que contém as configurações. Você também pode alterar ou remover um perfil existente usando o Replace operador no arquivo de resposta existente.

Importante

  • Leia a seção Como dar suporte ao pacote de provisionamento gerado por OEM da COSA depois que o dispositivo estiver no mercado abaixo.
  • Geralmente, você só deve adicionar APNs que não estão incluídas no banco de dados COSA do Windows.  Se você substituir as entradas que já existem no COSA e a operadora móvel as alterar no futuro, elas não serão atualizadas automaticamente, pois o banco de dados procurará o pacote COSA do OEM para essas entradas.
  • Recomendamos consultar as APNs mais recentes para a operadora móvel que você está planejando adicionar, para garantir que, se houver APNs específicas do dispositivo de dados, elas sejam adicionadas ao arquivo COSA do OEM (caso o operador use APNs diferentes para tablets do que telefones).
  • A Microsoft recomenda que as Operadoras Móveis enviem quaisquer alterações de perfil feitas para estender o COSA à Microsoft. Para saber mais, confira Envio de banco de dados COSA/APN.

Importante

A Microsoft está coletando os seguintes dados de telemetria relacionados à COSA:

  • AfterMarketProfile – Publicado quando um pacote OEM adiciona um novo perfil. Os dados incluem a ID do perfil (normalmente um GUID), bem como as informações de direcionamento para o perfil (como MCC, MNC, SPN e assim por diante).
  • ProfileReplaced – publicado quando o pacote OEM substitui um perfil cosa. Os dados são a ID do perfil.
  • ProfileSuppressedByAfterMarketProfile – publicado quando um pacote OEM contém um perfil que corresponde quando um perfil COSA também corresponde. Os dados de telemetria contêm a ID do perfil.

Para adicionar um novo perfil

Você pode adicionar um novo perfil que ainda não está incluído no banco de dados COSA usando as etapas a seguir.

  1. Crie um arquivo de resposta ou edite um arquivo de resposta existente que contenha as novas configurações de perfil. Abaixo está um exemplo,

    • Verifique se você está substituindo as informações de <ID> marca por seu próprio GUID.
     <?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>
    
  2. Crie um pacote de provisionamento que inclua o arquivo de resposta. Para obter mais informações, consulte Para criar um pacote de provisionamento.

  3. Coloque seus pacotes de provisionamento (PPKG) no seguinte local: %WINDIR%\Provisioning\COSA\OEM.

  4. Execute os testes necessários para validação.

Veja abaixo uma lista dos Grupos de Finalidade relevantes para as APNs.

Tipo Identificator
Internet 3E5545D2-1137-4DC8-A198-33F1C657515F
Anexação LTE 11A6FE68-5B47-4859-9CB6-1EAC96A8F0BD
Purchase 95522B2B-A6D1-4E40-960B-05E6D3F962AB
Administrativa 2FFD9261-C23C-4D27-8DCF-CDE4E14A3364

Para obter uma lista completa das configurações de COSA, consulte Planejando o envio do banco de dados COSA/APN.

Como dar suporte ao pacote de provisionamento gerado por OEM da COSA quando o dispositivo estiver no mercado

Antes de incluir o pacote de provisionamento gerado por OEM da COSA na imagem do dispositivo, considere um mecanismo para atualizar o pacote gerado por OEM da COSA depois que o dispositivo estiver no mercado. Aqui estão anotações adicionais sobre configuração e atualizações de imagem.

  1. O pacote de provisionamento gerado por OEM da COSA precisa ser excluído da migração PBR para evitar entradas duplicadas, consulte Excluir Arquivos e Configurações.
    • Para testar se o arquivo de exclusão foi bem-sucedido, você precisará ter uma imagem de fábrica com o PBR implementado e, em seguida, ir para configurações -> atualizar -> redefinir este computador e, após a redefinição, você ainda poderá ver o APN personalizado nas configurações -> rede -> rede celular. Também deve haver apenas um pacote de provisionamento OEM COSA na pasta %WINDIR%\Provisioning\COSA\OEM.

Exemplo

<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>
  1. Para todos os operadores que você adicionar por meio do pacote de provisionamento gerado por OEM da COSA, precisará ser mantido pelo OEM no caso de alterações futuras pela operadora móvel, portanto, você deve garantir que tenha um mecanismo para atualizá-los no futuro.

    • A atualização do pacote é manipulada por um driver e Windows Update
    • Você precisará garantir que tenha um driver de dispositivo existente no dispositivo para o componente da rede celular e se o arquivo INF está definido para copiar o PPKG
    • Siga as instruções neste documento para criar o arquivo INF Exemplo:
       [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
    
    • O driver precisa ser pré-carregado em sua imagem de fábrica para que, se você atualizar o driver no Windows Update no futuro, o dispositivo procurará e encontrará uma versão mais recente desse driver para baixar e instalar.
    • Você deve testar o mecanismo de atualização por meio de Windows Update no mesmo mecanismo que testaria as atualizações do driver para um dispositivo ou driver de pré-lançamento.
    • Se você tiver um mecanismo alternativo para atualizar o pacote de provisionamento gerado por OEM da COSA, verifique se ele funciona tanto na imagem de fábrica quanto no dispositivo depois que a redefinição do botão de push é executada para testar o cenário do usuário final.

    Observação

    O PPKG será aplicado nas condições a seguir. É por design que eles não são aplicados no evento do PPKG que está sendo copiado para o local especificado

    • Após a reinicialização do sistema operacional quando o sistema está ocioso
    • Após o Logon do Usuário quando o sistema está ocioso
  2. Se a operadora móvel atualizar qualquer informação de provisionamento (por exemplo, APNs) e o dispositivo for um pacote de provisionamento gerado por OEM de COSA para essa operadora móvel, o OEM precisará obter as novas informações de provisionamento e atualizar seu pacote de provisionamento gerado por OEM do COSA nos dispositivos enviados por meio de Windows Update.