Aracılığıyla paylaş

Görüntüleme işlemi sırasında OEM uygulaması kaydetme

Önemli

Universal Orchestrator, OEM'lerin görüntüleme işlemi sırasında bir uygulamayı kaydederek tek seferlik hızlandırılmış yükleme veya güncelleştirme gerçekleştirmeleri için işlevsellik sağlar. Bu yükleme, kullanıcının yeni bir cihazda oturum açmasının 30 dakika içinde gerçekleşir. Bir uygulamanın hızlandırılması, yeni cihazlar için ilk çalıştırma deneyiminde olumsuz bir performans etkisine neden olabilir.

Bu işlev şu durumlarda kullanılabilir:

  • Windows 11 23H2 - KB5046732 (İşletim Sistemi Derlemesi 22631.4541)
  • Windows 11 24H2 - KB5046740 (İS Yapısı 26100.2454)
  • Windows 11 25H2 ve üzeri Windows sürümleri

Gereksinimler

Hızlandırılmış uygulama çerçevesine bağlanmak için uygulamanın aşağıdaki gereksinimleri karşılaması gerekir:

  • MSIX biçiminde mağaza paketli bir uygulama olmalıdır
  • Geçerli bir Ürün Aile Adı (PFN) olmalıdır

Kayıt

Kayıt dosyaları, istenen hızlandırılmış işlem akışı ve gerçekleştirilmesi gereken özel istemci tarafı hedefleme bilgilerini içeren metaveri barındıran ASCII JSON dosyalarıdır.

Hızlandırılmış uygulamalar, bir uygulamayı güncelleştirmek / almak için iki mekanizmayı destekler:

  1. ProductId (Önerilen) kullanarak Microsoft Store'dan
  2. MSIX paketi veya demet içeren bir URL'den. Bu paket, geçerli bir Paket Aile Adı (PFN) ile Mağaza için paketlenmiş bir uygulama içermelidir. BU URL'yi korumak OEM veya Uygulama Sahibi'nin sorumluluğundadır.

Her kayıt dosyası aşağıdaki gerekli JSON özelliklerini içermelidir:

Anahtar Türü Açıklama
PFN Dize Uygulamanın Paket Aile Adı (Örnek: Microsoft.WindowsStore_8wekyb3d8bbwe)
Üretici Adı Dize Bu kaydı oluşturan OEM'i temsil eden dize.

Yalnızca alfasayısal karakterler, alt çizgi ve kısa çizgi içermelidir.
UpdaterName Dize Bu hızlandırılmış kaydı takip etmek için benzersiz bir ad.

Yalnızca alfasayısal karakterler, alt çizgi ve kısa çizgi içermelidir.
Kayıt Sürümü Sayı Bu uygulama kaydının versiyonu
Kaynak Dize İzin verilen değerler:

Mağaza | Özel URL

Mağaza - uygulamayı doğrudan Microsoft Store'dan arar

CustomURL - Uygulama kaydının "Uç Nokta" değerinde belirtilen bir URL'den uygulamayı arar
Senaryo Dize İzin verilen değerler:

Güncelleme | Satın Alma | StubAcquisition

Güncelleştirme - (CustomURL akışları için desteklenmez) mevcut bir uygulamayı en son kullanılabilir sürümüne güncelleştirmeye çalışır. Uygulama yoksa iş yapılmaz

Edinme - Bir uygulamanın en son sürümünü alma girişimleri.

StubAcquisition - uygulamanın "stub" değerini (varsa) almaya çalışır. Yer tutucu kullanılamıyorsa tam uygulamayı edinir.
Ürün Kimliği Dize (Yalnızca Mağaza senaryoları için gereklidir)

İstenen Mağaza uygulamasının ProductId değeri
Bitiş noktası Dize (Yalnızca CustomURL senaryoları için gereklidir)

MSIX paketini barındıran bir konuma işaret eden bir dize URI'si. 'https' ile başlayan bir SSL URI'si olmalıdır.

Ayrıca, hızlandırılmış uygulama yüklemesinin davranışını değiştirmek veya hızlandırılmış akışı yalnızca belirli koşullar altında gerçekleşecek şekilde hedeflemek için aşağıdaki isteğe bağlı özellikler belirtilebilir.

Anahtar Türü Varsayılan Açıklama
YetkiliOOBE'de Boole mantığı Yanlış Bu hızlandırılmış uygulamanın kullanıcı OOBE sırasında çalıştırılıp çalıştırılmayacağı.

Önemli: İlk Çalıştırma Deneyimi akışı sırasında bir cihazda kaynak kısıtlamaları oluşturabileceğinden ve kullanıcının algılanan performansını olumsuz etkileyebileceğinden, ayarı true olarak ayarlarken dikkatli olun.
Maksimum Deneme Sayısı Sayı 1 Bu güncelleştiricinin hatadan sonra yeniden denemesine izin verilen sayı.

İzin verilen en yüksek değer: 5
TimeoutDurationInMinutes Sayı 15 Bu güncelleştiricinin işini bitirmesini beklemek için dakika cinsinden süre.

İzin verilen en yüksek değer: 30
Mimarlık Dize Kısıtlama yok İzin verilen değerler:

amd64 | arm64

Hızlandırılmış çalışmanın yalnızca belirli bir mimari için gerçekleşip gerçekleşmeyeceğini belirtir.
İzin Verilen Minimum Derleme Sürümü Sayı Kısıtlama yok Hızlandırılmış çalışmaya izin verilen en düşük Windows derleme sürümleri.

Örneğin, 22631 olarak ayarlanırsa, Windows 11 23H2 (10.0.22631.x) için hızlandırılmış çalışmaya izin verilir, ancak Windows 11 22H2 (10.0.22621.x) için engellenir
HonorDeprovisioning Boole mantığı Yanlış (Yalnızca Edinme senaryoları için geçerlidir)

Uygulamanın daha önce sağlaması kaldırılmışsa, uygulamayı yeniden edinmeye çalışmayın.
SkipIfPresent (Var ise Atla) Boole mantığı Yanlış (Yalnızca Edinme senaryoları için geçerlidir)

Uygulamanın herhangi bir sürümü zaten mevcutsa hızlandırılmış çalışmayı gerçekleştirmeyin.
Öncelik Sayı 100 Bu uygulama güncelleştirmesinin göreli önceliğini belirtmek için 1 - 100 arası sayısal bir değer.

Düşük değerler, diğer hızlandırılmış uygulamalara göre daha yüksek bir öncelik olduğunu gösterir.
Hariç Tutulan Bölgeler Dizi (Dize) Kısıtlama yok Bu uygulamanın hızlandırılmaması gereken bölgeler için bir JSON dize dizisi.

Dizideki her giriş, istenen bölgenin iki iso 3166-1 ülke koduna karşılık gelir.

Örnek: ["US", "MX"], bölgenin ABD veya Meksika olduğu cihazlarda bu akışı engeller.

Bu değer IncludedRegions ile kullanılamaz.
Dahil Edilen Bölgeler Dizi (Dize) Kısıtlama yok Bu uygulamanın hızlandırılması gereken bölgelerin izin verilenler listesini gösteren dizelerden oluşan JSON dizisi.

Dizideki her giriş, istenen bölgenin iki iso 3166-1 ülke koduna karşılık gelir.

Örnek: ["US", "MX"] bu akışa yalnızca bölgenin ABD veya Meksika olduğu cihazlarda izin verir.

Bu değer ExcludedRegions ile kullanılamaz.
Dahil Edilen Sürümler Sayı Dizisi Kısıtlama yok Hızlandırılması gereken bu uygulama için izinli Sürümleri belirten sayılardan oluşan bir JSON dizisi.

Dizideki her girdi, GetProductInfo APItarafından alınan Sürüm koduna karşılık gelir.

Örnek: Yalnızca Education ve EducationN Sürümlerini dahil etmek için [121, 122]

Bu değer ExcludedEditions ile kullanılamaz.
Hariç Tutulan Sürümler Sayı Dizisi Kısıtlama yok Bu uygulamanın hızlandırılmaması gereken Sürümler için bir JSON sayı dizisi.

Dizideki her girdi, GetProductInfo APItarafından alınan Sürüm koduna karşılık gelir.

Örnek: Education ve EducationN Sürümlerini hariç tutmak için [121, 122].

Bu değer IncludedEditions ile kullanılamaz.

Örnekler

Mağaza tabanlı saplama alımı, yalnızca ABD ve Meksika'da, OOBE sırasında yürütülecek

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

Yalnızca Windows 11 23H2'de Education ve EducationN sürümleri hariç amd64 cihazlarda URL tabanlı uygulama alımı (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 
}

Araçlar

Kayıt işlemini kolaylaştırmak ve kayıt meta verileri üzerinde eyleme geçirilebilir geri bildirim sağlamak için, OEM'lerin aşağıdaki konumdan AppOrchestration PowerShell betiklerini kullanması gerekir.

microsoft/ms-update-universalorchestrator: Evrensel Orchestrator tabanlı güncelleme akışlarına bağlanmak için betikler ve araçlar

Betikler temel doğrulama gerçekleştirir ve kaydı cihazdaki uygun konuma hazırlar. Hatalar olduğunda, betikler belirli hata ayrıntılarıyla birlikte bir istisna fırlatır.

Komut dosyalarını kullanmak için:

  1. Betikleri cihazınıza indirin. GitHub deposu sayfasından ZIP dosyası olarak indirmeyi ve cihazınıza ayıklamayı seçebilirsiniz
  2. PowerShell penceresinde "Import-Module <PathToScripts>\scripts\AppOrchestration.psd1" komutunu çalıştırın

Uyarı

Bu betikler, kullanıcının cihazda yönetici ayrıcalıklarına sahip olmasını gerektirir ve yükseltilmiş bir konsoldan yürütülmelidir.

Kayıt akışı için kullanılan dört ana cmdlet vardır:

Test-UpdaterRegistration <KayıtDosyasınınYolu>
Amaç: Önerilen kayıt dosyasının içeriğini doğrulayın (kayıt gerçekleştirmeden). OEM'in cihazı etkilemeden kayıt dosyası yükünde yineleme yapmasına izin verir.

Add-UpdaterRegistration <PathToRegistrationFile>
Amaç: Kayıt dosyasının içeriğini doğrulayıp uygun konuma düzenleyerek hızlandırılmış uygulama akışına katılım sürecini başlatmak.

Get-UpdaterRegistration <OEMName><UpdaterName>
Amaç: OEMName ve UpdaterName sağlanmışsa, bu değerlerle eşleşen mevcut bir kaydın özetini döndürür. Bu girişler atlanırsa, cihazda mevcut olan tüm geçerli kayıtların özetini döndürür.

Remove-UpdaterRegistration <OEMName><UpdaterName>
Amaç: OEMName ve UpdaterName değerleriyle eşleşen tüm kayıtlar aşamadan kaldırılır.

İdam

Evrensel Orchestrator çerçevesi, kullanıcının yeni bir cihazda Masaüstüne ulaşmasının ilk 30 dakikası içinde (veya AllowedInOobe true olarak ayarlandıysa Kullanıcı OOBE sırasında) göreli önceliğe göre sıralı olarak kayıtlı uygulamaların her birini otomatik olarak çağırır. OEM kayıt işlemi tarafından eklenen her kayıtlı uygulama aşağıdakilerden birine kadar denenecektir:

  • Başarıyla yüklendi
  • MaxRetryCount içinde belirtilen en fazla hata sayısını aşıyor. Her hatadan sonra uygulama yeniden denenmeden önce 30 dakikalık bir bekleme süresi girer.

Aşağıdaki koşullardan herhangi biri doğruysa Evrensel Orchestrator çerçevesi hızlandırılmış girişimler gerçekleştirmez:

Bu durumların her birinde, cihaz yapılandırması hızlandırılmış girişimlerin devam etmesine izin verene kadar Evrensel Orchestrator çerçevesi kayıtları yerinde tutar.

Uygulama kaydı hızlandırılmış akışı engelleyen isteğe bağlı değerler içeriyorsa (örneğin, sürüm türü nedeniyle), Universal Orchestrator çerçevesi bu kayıt isteğinin yerine getirildiğini kabul eder ve daha sonra bu koşullar bir cihazda değişse bile yeniden denemez.

Önemli

Güncelleştirme işlemleri cihaz kullanımda olduğunda ve yeni bir cihazda kullanıcı deneyiminin olumsuz bir performans etkisine neden olabileceğinden, bu çerçeve aracılığıyla uygulamaları hızlandırmayı tercih ederken dikkatli olun.

  • Last updated on