Testing your desktop COSA database submission
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.
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 via the MO Config Portal, you can generate a test provisioning package (PPKG) file to install and test your settings updates.
For more information about installing a provisioning package file, see Apply a provisioning package.
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.
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
.
- Remove any SIM from the device.
- Copy the script and the new PPKG file to a local directory.
- Open an elevated command prompt window and change to the directory containing the script.
- Run the script with this syntax to apply the PPKG:
ApplyCosaProvisioning.BAT -a <full path to the PPKG local directory>
. - Insert the SIM and await provisioning.
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.
- Once validated, remove the SIM from the device.
- Run the script with this syntax to restore the original PPKG:
ApplyCosaProvisioning.BAT -r
. - Insert the SIM for provisioning to take effect, reading the original PPKG.
To collect logs in the event of a failure during the testing process, follow these steps:
- Remove any SIM from the device.
- Run the script with this syntax to start netsh logging:
ApplyCosaProvisioning.BAT -l
. - Insert the SIM and wait for provisioning to fail.
- Follow the tool's prompts to end logging.
- Send the logs to Microsoft in zipped format.
Once you've finished validation of the PPKG, you can submit your COSA changes in the MOCP.