Registro de una aplicación OEM durante el proceso de creación de imágenes

Requisitos

Para conectar con el marco de trabajo de la aplicación acelerada, la aplicación debe cumplir los siguientes requisitos:

• Debe ser una aplicación empaquetada para la Tienda en formato MSIX.
• Debe tener un nombre de familia de productos (PFN) válido.

Registration

Los archivos de registro son archivos JSON ASCII que contienen metadatos con información sobre el flujo acelerado deseado y cualquier destino personalizado del lado cliente que necesite realizarse.

Las aplicaciones aceleradas admiten dos mecanismos para actualizar o adquirir una aplicación:

1. Desde la Microsoft Store con Id. de producto (recomendado)
2. Desde una dirección URL que contiene un paquete o conjunto MSIX. Este paquete debe contener una aplicación empaquetada de Microsoft Store con un nombre de familia de paquete (PFN) válido. El oem o el propietario de la aplicación son responsables de mantener esta dirección URL.

Cada archivo de registro debe contener las siguientes propiedades JSON necesarias:

Además, se pueden especificar las siguientes propiedades opcionales para modificar el comportamiento de la instalación rápida de la aplicación o para tener como destino el flujo acelerado para que solo se produzca en determinadas condiciones.

Samples

Adquisición de stub basada en tienda, solo en EE. UU. y México, para ejecutarse durante el OOBE

{  
    "OEMName": "Contoso",
    "UpdaterName": "OEMApp1",
    "RegistrationVersion":1,  
    "Source": "Store",  
    "Scenario": "StubAcquisition",  
    "PFN": "FakePackageFamilyName",  
    "ProductId": "StoreProductId",  
    "HonorDeprovisioning": true,  
    "AllowedInOobe": true,  
    "IncludedRegions": ["US", "MX"],  
    "Priority": 50  
}

Adquisición de aplicaciones basadas en direcciones URL en dispositivos amd64, excepto las ediciones Education y EducationN, solo en Windows 11 23H2 (not Windows 11 22H2)

{  
    "OEMName": "Contoso",
    "UpdaterName": "OEMApp1",
    "RegistrationVersion":2,  
    "Source": "CustomURL",  
    "Scenario": "Acquisition",  
    "PFN": "FakePackageFamilyName",  
    "Endpoint": "https://<SSL_URI>",   
    "ExcludedEditions": [121, 122],   
    "Architecture": "amd64",   
    "MinimumAllowedBuildVersion": 22631,  
    "Priority": 60 
}

Tools

Para facilitar el proceso de registro y proporcionar comentarios accionables sobre los metadatos de registro, los OEM deben usar los scripts de PowerShell de AppOrchestration desde la siguiente ubicación:

microsoft/ms-update-universalorchestrator: scripts y herramientas para incorporarlos a flujos de actualización basados en Universal Orchestrator

Los scripts realizan la validación básica y almacenan provisionalmente el registro en la ubicación adecuada en el dispositivo. En caso de errores, los scripts lanzan una excepción con los detalles específicos del error.

Para usar los scripts:

1. Descargue los scripts en el dispositivo. En la página del repositorio de GitHub, puede seleccionar descargarlo como un archivo ZIP y extraerlo en el dispositivo.
2. En una ventana de PowerShell, ejecute "Import-Module <PathToScripts>\scripts\AppOrchestration.psd1"

Hay cuatro cmdlets principales que se utilizan para el flujo de registro:

<Test-UpdaterRegistration PathToRegistrationFile>
Propósito: valide el contenido de un archivo de registro propuesto (sin realizar el registro). Permite a OEM iterar en la carga del archivo de registro sin afectar al dispositivo.

<Add-UpdaterRegistration PathToRegistrationFile>
Propósito: validar y preparar el contenido de un archivo de registro en la ubicación adecuada para incorporarlo al proceso rápido de la aplicación.

<Get-UpdaterRegistration OEMName><UpdaterName>
Propósito: si se proporcionan OEMName y UpdaterName, devuelva un resumen de un registro existente que coincida con esos valores. Si se omiten esas entradas, devuelva un resumen de todos los registros actuales presentes en el dispositivo.

<Remove-UpdaterRegistration OEMName><UpdaterName>
Propósito: Deshacer cualquier registro que coincida con los valores OEMName y UpdaterName.

Execution

El marco del Orquestador Universal invoca automáticamente cada una de las aplicaciones registradas, en secuencia de acuerdo con la prioridad relativa, dentro de los primeros 30 minutos desde que un usuario llega al Escritorio en un nuevo dispositivo (o durante la OOBE del usuario si "AllowedInOobe" está establecido en true). Cada aplicación registrada agregada por el proceso de registro del OEM se intentará hasta que suceda alguna de las siguientes condiciones:

• Se ha instalado correctamente
• Supera el número máximo de errores especificados en MaxRetryCount. Después de cada error, la aplicación entrará en un período de enfriamiento de 30 minutos antes de intentarlo de nuevo.

El marco Orquestador Universal no realizará intentos acelerados si se cumple alguna de las condiciones siguientes:

• El dispositivo no tiene acceso a Internet.
• El dispositivo está en una red de uso medido.
• El dispositivo está en batería y el ahorro de batería está habilitado.
• El dispositivo está configurado con una directiva de tráfico de red restringido de Windows Update.
• El dispositivo está configurado con una política CTA que no está establecida para AutoApprove.

En cada uno de estos casos, el marco de Universal Orchestrator mantiene los registros en vigor hasta que la configuración del dispositivo permite que los intentos acelerados continúen.

Si el registro de la aplicación contiene valores opcionales que bloquean el flujo acelerado (por ejemplo, debido al tipo de edición), el marco universal Orchestrator considera que esta solicitud de registro se ha cumplido y no volverá a intentarlo, incluso si esas condiciones podrían cambiar posteriormente en un dispositivo.