azure-docs/language-packs.md at main - GitHub

Windows 10, version 21H1 or 21H2 Inbox Apps ISO. If you use Local Experience Pack (LXP) ISO files to localize your images, you'll also need to download the ... Skiptocontent {{message}} MicrosoftDocs / azure-docs Public Notifications Fork 17.2k Star 7.6k Code Issues 4.5k Pullrequests 586 Security Insights More Code Issues Pullrequests Security Insights Permalink main Branches Tags Couldnotloadbranches Nothingtoshow {{refName}} default Couldnotloadtags Nothingtoshow {{refName}} default azure-docs/articles/virtual-desktop/language-packs.md Gotofile Gotofile T Gotoline L Copypath Copypermalink Thiscommitdoesnotbelongtoanybranchonthisrepository,andmaybelongtoaforkoutsideoftherepository. dknappettmsft AVDadd2206LXPISOlink Latestcommit d0b6b35 Jul14,2022 History 14 contributors Userswhohavecontributedtothisfile +2 AddlanguagepackstoaWindows10multi-sessionimage Prerequisites Createacontentrepositoryforlanguagepackagesandfeaturesondemand CreateacustomWindows10Enterprisemulti-sessionimagemanually CreateacustomWindows10Enterprisemulti-sessionimageautomatically Finishcustomizingyourimage EnablelanguagesinWindowssettingsapp Nextsteps 260lines(200sloc) 19.8KB Raw Blame Editthisfile E OpeninGitHubDesktop OpenwithDesktop Viewraw Viewblame title description author ms.topic ms.date ms.author manager InstalllanguagepacksonWindows10VMsinAzureVirtualDesktop-Azure HowtoinstalllanguagepacksforWindows10multi-sessionVMsinAzureVirtualDesktop. Heidilohr how-to 06/01/2022 helohr femila AddlanguagepackstoaWindows10multi-sessionimage AzureVirtualDesktopisaservicethatyouruserscandeployanytime,anywhere.That'swhyit'simportantthatyourusersbeabletocustomizewhichlanguagetheirWindows10Enterprisemulti-sessionimagedisplays. Therearetwowaysyoucanaccommodatethelanguageneedsofyourusers: Builddedicatedhostpoolswithacustomizedimageforeachlanguage. Haveuserswithdifferentlanguageandlocalizationrequirementsinthesamehostpool,butcustomizetheirimagestoensuretheycanselectwhicheverlanguagetheyneed. Thelattermethodisalotmoreefficientandcost-effective.However,it'suptoyoutodecidewhichmethodbestsuitsyourneeds.Thisarticlewillshowyouhowtocustomizelanguagesforyourimages. Prerequisites YouneedthefollowingthingstocustomizeyourWindows10Enterprisemulti-sessionimagestoaddmultiplelanguages: AnAzurevirtualmachine(VM)withWindows10Enterprisemulti-session,version1903orlater TheLanguageISO,FeatureonDemand(FOD)Disk1,andInboxAppsISOoftheOSversiontheimageuses.Youcandownloadthemhere: LanguageISO: Windows10,version1903or1909LanguagePackISO Windows10,version2004orlaterLanguagePackISO FODDisk1ISO: Windows10,version1903or1909FODDisk1ISO Windows10,version2004orlaterFODDisk1ISO InboxAppsISO: Windows10,version1903or1909InboxAppsISO Windows10,version2004InboxAppsISO Windows10,version20H2InboxAppsISO Windows10,version21H1or21H2InboxAppsISO IfyouuseLocalExperiencePack(LXP)ISOfilestolocalizeyourimages,you'llalsoneedtodownloadtheappropriateLXPISOforthebestlanguageexperience Ifyou'reusingWindows10,version1903or1909: Windows10,version1903or1909LXPISO Ifyou'reusingWindows10,version2004,20H2,or21H1,usetheinformationinAddinglanguagesinWindows10:KnownissuestofigureoutwhichofthefollowingLXPISOsisrightforyou: Windows10,version2004orlater01C2021LXPISO Windows10,version2004orlater02C2021LXPISO Windows10,version2004orlater04B2021LXPISO Windows10,version2004orlater05C2021LXPISO Windows10,version2004orlater07C2021LXPISO Windows10,version2004orlater09C2021LXPISO Windows10,version2004orlater10C2021LXPISO Windows10,version2004orlater11C2021LXPISO Windows10,version2004orlater01C2022LXPISO Windows10,version2004orlater02C2022LXPISO Windows10,version2004orlater04C2022LXPISO Windows10,version2004orlater06C2022LXPISO AnAzureFilesShareorafileshareonaWindowsFileServerVirtualMachine [!NOTE] Thefileshare(repository)mustbeaccessiblefromtheAzureVMyouplantousetocreatethecustomimage. Createacontentrepositoryforlanguagepackagesandfeaturesondemand TocreatethecontentrepositoryforlanguagepackagesandFODsandarepositoryfortheInboxAppspackages: OnanAzureVM,downloadtheWindows10Multi-LanguageISO,FODs,andInboxAppsforWindows10Enterprisemulti-session,version1903/1909,and2004imagesfromthelinksinPrerequisites. OpenandmounttheISOfilesontheVM. GotothelanguagepackISOandcopythecontentfromtheLocalExperiencePacksandx64\langpacksfolders,thenpastethecontentintothefileshare. GototheFODISOfile,copyallofitscontent,thenpasteitintothefileshare. Gototheamd64frefolderontheInboxAppsISOandcopythecontentintherepositoryfortheinboxappsthatyou'veprepared. [!NOTE] Ifyou'reworkingwithlimitedstorage,onlycopythefilesforthelanguagesyouknowyourusersneed.Youcantellthefilesapartbylookingatthelanguagecodesintheirfilenames.Forexample,theFrenchfilehasthecode"fr-FR"initsname.Foracompletelistoflanguagecodesforallavailablelanguages,seeAvailablelanguagepacksforWindows. [!IMPORTANT] Somelanguagesrequireadditionalfontsincludedinsatellitepackagesthatfollowdifferentnamingconventions.Forexample,Japanesefontfilenamesinclude“Jpan." [!divclass="mx-imgBorder"] SetthepermissionsonthelanguagecontentrepositorysharesothatyouhavereadaccessfromtheVMyou'llusetobuildthecustomimage. CreateacustomWindows10Enterprisemulti-sessionimagemanually TocreateacustomWindows10Enterprisemulti-sessionimagemanually: DeployanAzureVM,thengototheAzureGalleryandselectthecurrentversionofWindows10Enterprisemulti-sessionyou'reusing. Afteryou'vedeployedtheVM,connecttoitusingRDPasalocaladmin. MakesureyourVMhasallthelatestWindowsUpdates.DownloadtheupdatesandrestarttheVM,ifnecessary. [!IMPORTANT] Afteryouinstallalanguagepack,youhavetoreinstallthelatestcumulativeupdatethatisinstalledonyourimage.Ifyoudonotreinstallthelatestcumulativeupdate,youmayencountererrors.Ifthelatestcumulativeupdateisalreadyinstalled,WindowsUpdatedoesnotofferitagain;youhavetomanuallyreinstallit.Formoreinformation,seeLanguagesoverview. Connecttothelanguagepackage,FOD,andInboxAppsfilesharerepositoryandmountittoaletterdrive(forexample,driveE). CreateacustomWindows10Enterprisemulti-sessionimageautomatically Ifyou'dratherinstalllanguagesthroughanautomatedprocess,youcansetupascriptinPowerShell.YoucanusethefollowingscriptsampletoinstalltheSpanish(Spain),French(France),andChinese(PRC)languagepacksandsatellitepackagesforWindows10Enterprisemulti-session,version2004.Thescriptintegratesthelanguageinterfacepackandallnecessarysatellitepackagesintotheimage.However,youcanalsomodifythisscripttoinstallotherlanguages.JustmakesuretorunthescriptfromanelevatedPowerShellsession,orelseitwon'twork. ######################################################## ##AddLanguagestorunningWindowsImageforCapture## ######################################################## ##DisableLanguagePackCleanup## Disable-ScheduledTask-TaskPath"\Microsoft\Windows\AppxDeploymentClient\"-TaskName"Pre-stagedappcleanup" ##SetLanguagePackContentStores## [string]$LIPContent="E:" ##Spanish## Add-AppProvisionedPackage-Online-PackagePath$LIPContent\es-es\LanguageExperiencePack.es-es.Neutral.appx-LicensePath$LIPContent\es-es\License.xml Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Client-Language-Pack_x64_es-es.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Basic-es-es-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Handwriting-es-es-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-OCR-es-es-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Speech-es-es-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-TextToSpeech-es-es-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-NetFx3-OnDemand-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-InternetExplorer-Optional-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-MSPaint-FoD-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Notepad-FoD-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-PowerShell-ISE-FOD-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Printing-WFS-FoD-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-StepsRecorder-Package~31bf3856ad364e35~amd64~es-es~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-WordPad-FoD-Package~31bf3856ad364e35~amd64~es-es~.cab $LanguageList=Get-WinUserLanguageList $LanguageList.Add("es-es") Set-WinUserLanguageList$LanguageList-force ##French## Add-AppProvisionedPackage-Online-PackagePath$LIPContent\fr-fr\LanguageExperiencePack.fr-fr.Neutral.appx-LicensePath$LIPContent\fr-fr\License.xml Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Client-Language-Pack_x64_fr-fr.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Basic-fr-fr-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Handwriting-fr-fr-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-OCR-fr-fr-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Speech-fr-fr-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-TextToSpeech-fr-fr-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-NetFx3-OnDemand-Package~31bf3856ad364e35~amd64~fr-fr~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-InternetExplorer-Optional-Package~31bf3856ad364e35~amd64~fr-FR~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-MSPaint-FoD-Package~31bf3856ad364e35~amd64~fr-FR~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Notepad-FoD-Package~31bf3856ad364e35~amd64~fr-FR~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-PowerShell-ISE-FOD-Package~31bf3856ad364e35~amd64~fr-FR~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Printing-WFS-FoD-Package~31bf3856ad364e35~amd64~fr-FR~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-StepsRecorder-Package~31bf3856ad364e35~amd64~fr-FR~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-WordPad-FoD-Package~31bf3856ad364e35~amd64~fr-FR~.cab $LanguageList=Get-WinUserLanguageList $LanguageList.Add("fr-fr") Set-WinUserLanguageList$LanguageList-force ##Chinese(PRC)## Add-AppProvisionedPackage-Online-PackagePath$LIPContent\zh-cn\LanguageExperiencePack.zh-cn.Neutral.appx-LicensePath$LIPContent\zh-cn\License.xml Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Client-Language-Pack_x64_zh-cn.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Basic-zh-cn-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Fonts-Hans-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Handwriting-zh-cn-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-OCR-zh-cn-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-Speech-zh-cn-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-LanguageFeatures-TextToSpeech-zh-cn-Package~31bf3856ad364e35~amd64~~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-NetFx3-OnDemand-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-InternetExplorer-Optional-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-MSPaint-FoD-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Notepad-FoD-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-PowerShell-ISE-FOD-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-Printing-WFS-FoD-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-StepsRecorder-Package~31bf3856ad364e35~amd64~zh-cn~.cab Add-WindowsPackage-Online-PackagePath$LIPContent\Microsoft-Windows-WordPad-FoD-Package~31bf3856ad364e35~amd64~zh-cn~.cab $LanguageList=Get-WinUserLanguageList $LanguageList.Add("zh-cn") Set-WinUserLanguageList$LanguageList-force Thescriptmighttakeawhiledependingonthenumberoflanguagesyouneedtoinstall. Oncethescriptisfinishedrunning,checktomakesurethelanguagepacksinstalledcorrectlybygoingtoStart>Settings>Time&Language>Language.Ifthelanguagefilesarethere,you'reallset. Afteryou'veaddedadditionallanguagestotheWindowsimage,theinboxappsarealsorequiredtobeupdatedtosupporttheaddedlanguages.Thiscanbedonebyrefreshingthepre-installedappswiththecontentfromtheinboxappsISO. ToperformthisrefreshinanenvironmentwheretheVMdoesn'thaveinternetaccess,youcanusethefollowingPowerShellscripttemplatetoautomatetheprocessandupdateonlyinstalledversionsofinboxapps. ######################################### ##UpdateInboxAppsforMultiLanguage## ######################################### ##SetInboxAppPackageContentStores## [string]$AppsContent="F:\" ##UpdateinstalledInboxStoreApps## foreach($Appin(Get-AppxProvisionedPackage-Online)){ $AppPath=$AppsContent+$App.DisplayName+'_'+$App.PublisherId Write-Host"Handling$AppPath" $licFile=Get-Item$AppPath*.xml if($licFile.Count){ $lic=$true $licFilePath=$licFile.FullName }else{ $lic=$false } $appxFile=Get-Item$AppPath*.appx* if($appxFile.Count){ $appxFilePath=$appxFile.FullName if($lic){ Add-AppxProvisionedPackage-Online-PackagePath$appxFilePath-LicensePath$licFilePath }else{ Add-AppxProvisionedPackage-Online-PackagePath$appxFilePath-skiplicense } } } [!IMPORTANT] TheinboxappsincludedintheISOaren'tthelatestversionsofthepre-installedWindowsapps.Togetthelatestversionofallapps,youneedtoupdatetheappsusingtheWindowsStoreAppandperformanmanualsearchforupdatesafteryou'veinstalledtheadditionallanguages. Whenyou'redone,makesuretodisconnecttheshare. Finishcustomizingyourimage Afteryou'veinstalledthelanguagepacks,youcaninstallanyothersoftwareyouwanttoaddtoyourcustomizedimage. Onceyou'refinishedcustomizingyourimage,you'llneedtorunthesystempreparationtool(sysprep). Torunsysprep: Openanelevatedcommandpromptandrunthefollowingcommandtogeneralizetheimage: C:\Windows\System32\Sysprep\sysprep.exe/oobe/generalize/shutdown StoptheVM,thencaptureitinamanagedimagebyfollowingtheinstructionsinCreateamanagedimageofageneralizedVMinAzure. YoucannowusethecustomizedimagetodeployanAzureVirtualDesktophostpool.Tolearnhowtodeployahostpool,seeTutorial:CreateahostpoolwiththeAzureportal. EnablelanguagesinWindowssettingsapp Finally,afteryoudeploythehostpool,you'llneedtoaddthelanguagetoeachuser'slanguagelistsotheycanselecttheirpreferredlanguageintheSettingsmenu. Toensureyouruserscanselectthelanguagesyouinstalled,signinastheuser,thenrunthefollowingPowerShellcmdlettoaddtheinstalledlanguagepackstotheLanguagesmenu.Youcanalsosetupthisscriptasanautomatedtaskorlogonscriptthatactivateswhentheusersignsintotheirsession. $LanguageList=Get-WinUserLanguageList $LanguageList.Add("es-es") $LanguageList.Add("fr-fr") $LanguageList.Add("zh-cn") Set-WinUserLanguageList$LanguageList-force Afterauserchangestheirlanguagesettings,they'llneedtosignoutoftheirAzureVirtualDesktopsessionandsigninagainforthechangestotakeeffect. Nextsteps Ifyou'recuriousaboutknownissuesforlanguagepacks,seeAddinglanguagepacksinWindows10,version1803andlaterversions:Knownissues. IfyouhaveanyotherquestionsaboutWindows10Enterprisemulti-session,checkoutourFAQ. Go Youcan’tperformthatactionatthistime. Yousignedinwithanothertaborwindow.Reloadtorefreshyoursession. Yousignedoutinanothertaborwindow.Reloadtorefreshyoursession.