Upravit

Sdílet prostřednictvím

Testing your desktop COSA database submission

  • Článek

Before submitting a COSA update request to Microsoft, it is important for the MNO or MVNO to validate the APN entries that they are about to submit. Microsoft does not have access to your network, so it is your responsibility to ensure the values that are being submitted are valid and work correctly.

Contact your Microsoft technical account manager

The first step in testing and submitting your COSA update is to work with your technical account manager (TAM) to open a case with Microsoft Support. This case is for tracking purposes. After a support case is opened, provide a test package (ppkg) to the support engineer.

If you do not have a TAM:

  • Contact Microsoft Support by calling (800) MICROSOFT (642-7676).
  • Inform the customer service representative that a COSA database update is needed.
  • Provide the test package to the support engineer.
  • If asked, specify Windows 10 or Windows 11 as the product, as appropriate.

Note

You will need to provide a credit card to open the incident, but you will not be charged.

Test your submission for desktop COSA

Use this process for Windows 10, version 1703 and later, including Windows 11.

After you have updated the COSA database with your new APN information, Microsoft will create a provisioning package (PPKG) file for you and return it to you so you can install and test your APN.

For more information about installing a provisioning package file, see Apply a provisioning package.

Modify the local COSA database (desktop COSA)

Follow these steps to test the updated COSA provisioning package (PPKG) you received from Microsoft.

These steps require a script from Microsoft to apply and test the PPKG file. Download the latest version of the script.

Apply the test PPKG file

Important

Create a backup of the original provisioning package before performing the following actions. The original provisioning package is located at: %systemroot%\Provisioning\Cosa\Microsoft\Microsoft.Windows.Cosa.Desktop.Client.ppkg.

  1. Remove any SIM from the device.
  2. Copy the script and the new PPKG file to a local directory.
  3. Open an elevated command prompt window and change to the directory containing the script.
  4. Run the script with this syntax to apply the PPKG: ApplyCosaProvisioning.BAT -a <full path to the PPKG local directory>.
  5. Insert the SIM and await provisioning.

Restore the original PPKG file

Warning

Once validation of the new PPKG received from Microsoft has completed, always restore it with the following steps. Restoring back to the original PPKG will ensure that you receive the latest COSA updates via Windows Update.

  1. Once validated, remove the SIM from the device.
  2. Run the script with this syntax to restore the original PPKG: ApplyCosaProvisioning.BAT -r.
  3. Insert the SIM for provisioning to take effect, reading the original PPKG.

Collect logs in case of failure

To collect logs in the event of a failure during the testing process, follow these steps:

  1. Remove any SIM from the device.
  2. Run the script with this syntax to start netsh logging: ApplyCosaProvisioning.BAT -l.
  3. Insert the SIM and wait for provisioning to fail.
  4. Follow the tool's prompts to end logging.
  5. Send the logs to Microsoft in zipped format.