Jak vygenerovat soubor šablony pro převody příkazového řádku

2025-06-10

Pomocí nástroje MSIX Packaging Tool můžete převod provést dvěma způsoby: prostřednictvím interaktivního uživatelského rozhraní nebo prostřednictvím možnosti příkazového řádku. Při použití příkazového řádku musíte zadat soubor šablony, aby převod fungoval s vašimi konkrétními nastaveními a potřebami. Tento článek vás provede procesem generování souboru šablony, který vám vyhovuje.

Soubor šablony, který vám vyhovuje, můžete získat dvěma způsoby:

Můžete použít uživatelské rozhraní nástroje MSIX Packaging Tool. V nastavení nástroje můžete určit, že chcete vygenerovat soubor šablony převodu s každým balíčkem MSIX, který vytvoříte.
Můžete vzít ukázkovou šablonu a ručně zadat konfigurace, které potřebujete pro každý převod.

Vygenerování souboru šablony převodu z nástroje MSIX Packaging Tool

Spusťte nástroj MSIX Packaging Tool.
Přejděte do nastavení v pravém horním rohu aplikace.
Ujistěte se, že je vybraná možnost Vygenerovat soubor příkazového řádku s každým balíčkem.
Proveďte jakékoli další změny nebo změny nastavení, které potřebujete (např. položky vyloučení, ukončovací kódy).
Uložte nastavení.
Projděte si pracovní postup balíčku aplikace pomocí instalačního programu.
- Pokud nevyberete instalační program, nebudete moct vygenerovat soubor šablony převodu.
- Pokud používáte exe soubor, budete muset předat instalačnímu programu tichý režim, aby se vygeneroval soubor šablony převodu.
Na konci převodu budete mít soubor šablony nakonfigurovaný na základě zvoleného instalačního programu a aktuální nastavení, která teď můžete znovu použít pro budoucí převody.
- Ve výchozím nastavení se soubor šablony převodu uloží do stejného umístění jako balíček MSIX, ale můžete zadat samostatné umístění pro uložení souboru šablony na stránce Vytvořit balíček.
- Stále budete muset provést určité úpravy na základě toho, jaký MSIX chcete výstup na konci každého převodu.

Ruční úprava souboru šablony převodu

Parametry šablony pro soubor šablony převodu můžete upravit ručně a vygenerovat tak soubor šablony, který vám bude vyhovovat. Při generování souboru šablony převodu věnujte pozornost funkcím, které do souboru šablony přidáte, protože některé můžou vyžadovat další odkazy na schéma, aby fungovaly.

Referenční informace k parametrům šablony převodu

Tady je úplný seznam parametrů, které můžete použít v souboru šablony převodu.

ConversionSettings	Popis
Nastavení:: Povolit telemetrii	[volitelné] Povolí protokolování telemetrie pro toto vyvolání nástroje.
Nastavení:: Použít všechny opravy pro přípravu počítače	[volitelné] Použije všechny doporučené opravy počítačů pro přípravu. Nelze nastavit při použití jiných atributů.
Nastavení:: GenerateCommandLineFile	[volitelné] Zkopíruje vstup souboru šablony do adresáře SaveLocation pro budoucí použití.
Nastavení:: PovolitVýzvuKZadáníHesla	[volitelné] Přikazuje nástroji, aby vyzval uživatele k zadání hesel pro virtuální počítač a podpisový certifikát, pokud je to vyžadováno a nebylo zadáno.
Nastavení:: ProsazováníPožadavkůNaVerzováníMicrosoftStore	[volitelné] Dává nástroji pokyn, aby vynucoval schéma správy verzí balíčků vyžadované pro nasazení z Microsoft Storu a Microsoft Storu pro firmy.
Nastavení: ČísloPortuServeru	[volitelné] Používá se při připojování ke vzdálenému počítači. Vyžaduje v2 schématu šablony.
Nastavení:: AddPackageIntegrity	[volitelné] Přidá integritu balíčku do každého vygenerovaného MSIX. Vyžaduje verzi 5 schématu šablony.
ValidInstallerExitCodes	[volitelné] 0 nebo více elementů ValidInstallerExitCode. Vyžaduje v2 schématu šablony.
ValidInstallerExitCodes:: ValidInstallerExitCode	[volitelné] Zadejte všechny ukončovací kódy instalačního programu, které nástroj nemusí znát nebo vyžadují restartování. Vyžaduje v2 schématu šablony.
ValidInstallerExitCodes:: ValidInstallerExitCode:: Restartovat	[volitelné] Určete, jestli má ukončovací kód aktivovat restartování během převodu. Vyžaduje verzi 3 schématu šablony.
Vyloučené položky	[volitelné] 0 nebo více elementů FileExclusion nebo RegistryExclusion. Všechny elementy FileExclusion musí být uvedeny před všemi elementy RegistryExclusion.
PoložkyVyloučení::VyloučeníSouboru	[volitelné] Soubor, který chcete vyloučit pro balení.
ExclusionItems::FileExclusion::ExcludePath	Cesta k souboru, který chcete vyloučit pro balení.
ExclusionItems::RegistryExclusion	[volitelné] Klíč registru, který se má vyloučit pro balení.
ExclusionItems::RegistryExclusion::ExcludePath	Cesta k registru, která se má vyloučit pro balení.
PrepareComputer::D isableDefragService	[volitelné] Zakáže defragmentaci Systému Windows při převodu aplikace. Pokud je nastaven na false, přepíše ApplyAllPrepareComputerFixes.
PrepareComputer:: ZakázatSlužbuVyhledáváníWindows	[volitelné] Zakáže Windows Search při převodu aplikace. Pokud je nastaven na false, přepíše ApplyAllPrepareComputerFixes.
PrepareComputer:: DisableSmsHostService	[volitelné] Zakáže server SMS během převodu aplikace. Pokud je nastaven na false, přepíše ApplyAllPrepareComputerFixes.
PrepareComputer:: DisableWindowsUpdateService (zakázat službu aktualizace Windows)	[volitelné] Zakáže Windows Update při převodu aplikace. Pokud je nastaven na false, přepíše ApplyAllPrepareComputerFixes.
SaveLocation	[volitelné] Prvek, který určuje umístění uložení nástroje. Pokud není specifikováno, balíček se uloží do složky Plocha.
SaveLocation::P ackagePath	[volitelné] Cesta k souboru nebo složce, do které se uloží výsledný balíček MSIX.
SaveLocation::TemplatePath	[volitelné] Cesta k souboru nebo složce, kde je uložena výsledná šablona příkazového řádku.
Instalační program::Path	Cesta k instalačnímu programu aplikace.
Instalační program::Argumenty	[volitelné] Argumenty, které se mají předat instalačnímu programu. Nástroj automaticky spustí instalační programy MSI v tichém režimu pomocí argumentu "/qn /norestart INSTALLSTARTMENUSHORTCUTS=1 DISABLEADVTSHORTCUTS=1". POZNÁMKA: Pokud používáte .exe instalační programy, musíte předat argumenty, aby se instalační program spustil bezobslužně.
Installer::InstallLocation	[volitelné] Úplná cesta ke kořenové složce vaší aplikace pro nainstalované soubory, pokud byla nainstalovaná (např. C:\Program Files (x86)\MyAppInstalllocation).
Installer::IsunattendedInstallWithoutArgument	[volitelné] Tento atribut by se měl použít, pokud aplikace umožňuje bezobslužnou instalaci bez tichých argumentů. Tento atribut se používá pouze pro instalační programy .exe.
Virtuální počítač	[volitelné] Prvek, který určí, že převod bude spuštěn na místním virtuálním počítači.
VirtualMachine::Name	Název virtuálního počítače, který se má použít pro převodní prostředí.
VirtualMachine::Username	Uživatelské jméno virtuálního počítače, které se má použít pro převodní prostředí.
RemoteMachine	[volitelné] Prvek, který určí, že převod bude spuštěn na vzdáleném počítači. Vyžaduje v2 schématu šablony.
RemoteMachine:: Název_počítače	Název vzdáleného počítače, který se má použít pro převodní prostředí. Vyžaduje v2 schématu šablony.
RemoteMachine:: Uživatelské jméno	Uživatelské jméno vzdáleného počítače, které se má použít pro převodní prostředí. Vyžaduje v2 schématu šablony.
RemoteMachine:: PovolitAutomatickéPřihlášení	[volitelné] Tím se automaticky přihlásíte při převodu, který vyžaduje restartování na vzdáleném počítači, aby převod pokračoval bezproblémově. Vyžaduje verzi 3 schématu šablony.
PackageInformation::P ackageName	Název balíčku MSIX.
PackageInformation::P ackageDisplayName	Zobrazovaný název pro váš MSIX balíček.
PackageInformation::P ublisherName	Vydavatel vašeho balíčku MSIX.
PackageInformation::P ublisherDisplayName	Název vydavatele zobrazený pro váš balíček MSIX.
BalíčekInformace::Verze	Číslo verze balíčku MSIX.
PackageInformation::P ackageDescription	[volitelné] Popis balíčku MSIX. Vyžaduje verzi 4 schématu šablony.
PackageInformation:: NázevHlavníhoBalíčkuProBalíčekModifikace	[volitelné] Název identity hlavního balíčku. Používá se při vytváření balíčku pro úpravy, který přebírá závislost na hlavní (nadřazené) aplikaci.
Informace o podpisu	[volitelné] Prvek, který určuje podpisové informace pro podepisování Device Guard. Vyžaduje verzi 4 schématu šablony.
SigningInformation:: DeviceGuardSigning	[volitelné] Prvek, který určuje informace o podepisování Device Guard. Vyžaduje verzi 4 schématu šablony.
DeviceGuardSigning:: TokenFile	Přístupový token Azure AD vyžadovaný pro přihlašování k Device Guard ve formátu JSON. Vyžaduje schéma šablony v4.
DeviceGuardSigning:: TimestampUrl	[volitelné] Poskytuje časové razítko v době podepisování pomocí Device Guard, aby se zajistilo, že se vaše aplikace nainstaluje po dobu životnosti certifikátu. Vyžaduje verzi 4 schématu šablony.
Aplikace	[volitelné] 0 nebo více prvků aplikace pro konfiguraci položek aplikace v balíčku MSIX.
Application::Id	ID vaší aplikace MSIX. Toto ID se použije pro položku aplikace, která zjistí, že odpovídá zadanému názvu spustitelného souboru. V balíčku můžete mít více hodnot ID aplikace pro spustitelné soubory. Tato hodnota je jedinečný identifikátor aplikace v rámci balíčku. Tato hodnota se někdy označuje jako identifikátor aplikace relativní vzhledem k balíčku (PRAID). ID musí být v rámci balíčku jedinečné (stejné ID nelze použít více než jednou ve stejném balíčku). ID však nesmí být globálně jedinečné. V systému může existovat další balíček, který používá stejné ID. Tento řetězec obsahuje alfanumerická pole oddělená tečkami. Každé pole musí začínat abecedním znakem ASCII. Tyto hodnoty nelze použít jako hodnoty polí: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8" a "LPT9".
Application::D isplayName	Zobrazovaný název aplikace pro balíček MSIX. Tento zobrazovaný název se použije pro položku aplikace zjištěnou, která odpovídá zadanému názvu spustitelného souboru.
Application::ExecutableName	Název spustitelného souboru pro aplikaci MSIX, která se přidá do manifestu balíčku. Odpovídající položka aplikace bude ignorována, pokud není zjištěna žádná aplikace s tímto názvem.
Application::D escription	[volitelné] Popis aplikace MSIX Pokud se nepoužije jiný název, bude použit zobrazovaný název aplikace. Tento popis se použije pro položku aplikace zjištěnou, která odpovídá zadanému názvu spustitelného souboru.
Schopnosti	[volitelné] 0 nebo více prvků schopností pro přidání vlastních funkcí do balíčku MSIX. Funkce runFullTrust se během převodu přidá ve výchozím nastavení.
Schopnost::Jméno	Možnost přidat do balíčku MSIX.

Ukázkový soubor šablony převodu

<MsixPackagingToolTemplate
    xmlns="http://schemas.microsoft.com/appx/msixpackagingtool/template/2018"
    xmlns:V2="http://schemas.microsoft.com/msix/msixpackagingtool/template/1904"
    xmlns:V3="http://schemas.microsoft.com/msix/msixpackagingtool/template/1907"
    xmlns:V4="http://schemas.microsoft.com/msix/msixpackagingtool/template/1910"
    xmlns:V5="http://schemas.microsoft.com/msix/msixpackagingtool/template/2001">
<!--Note: You only need to include xmlns:v2 - xmlns:v5 if you are using one of the features that use those schemas -->

    <Settings
        AllowTelemetry="true"
        ApplyAllPrepareComputerFixes="true"
        GenerateCommandLineFile="true"
        AllowPromptForPassword="false" 
	    EnforceMicrosoftStoreVersioningRequirements="false"
        v2:ServerPortNumber="1599"
        v5:AddPackageIntegrity="true">    

	<!--Note: Exclusion items are optional and if declared take precedence over the default tool exclusion items
        <ExclusionItems>
            <FileExclusion ExcludePath="[{CryptoKeys}]" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Crypto" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Search\Data" />
            <FileExclusion ExcludePath="[{Cookies}]" />
            <FileExclusion ExcludePath="[{History}]" />
            <FileExclusion ExcludePath="[{Cache}]" />
            <FileExclusion ExcludePath="[{Personal}]" />
            <FileExclusion ExcludePath="[{Profile}]\Local Settings" />
            <FileExclusion ExcludePath="[{Profile}]\NTUSER.DAT.LOG1" />
            <FileExclusion ExcludePath="[{Profile}]\ NTUSER.DAT.LOG2" />
            <FileExclusion ExcludePath="[{Recent}]" />
            <FileExclusion ExcludePath="[{Windows}]\debug" />
            <FileExclusion ExcludePath="[{Windows}]\Logs\CBS" />
            <FileExclusion ExcludePath="[{Windows}]\Temp" />
            <FileExclusion ExcludePath="[{Windows}]\WinSxS\ManifestCache" />
            <FileExclusion ExcludePath="[{Windows}]\WindowsUpdate.log" />
	    <FileExclusion ExcludePath="[{Windows}]\Installer" />
            <FileExclusion ExcludePath="[{AppVPackageDrive}]\$Recycle.Bin " />
            <FileExclusion ExcludePath="[{AppVPackageDrive}]\System Volume Information" />
	    <FileExclusion ExcludePath="[{AppVPackageDrive}]\Config.Msi" />
            <FileExclusion ExcludePath="[{AppData}]\Microsoft\AppV" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Microsoft Security Client" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Microsoft Antimalware" />
            <FileExclusion ExcludePath="[{Common AppData}]\Microsoft\Windows Defender" />
            <FileExclusion ExcludePath="[{ProgramFiles}]\Microsoft Security Client" />
            <FileExclusion ExcludePath="[{ProgramFiles}]\Windows Defender" />
	    <FileExclusion ExcludePath="[{ProgramFiles}]\WindowsApps" />
            <FileExclusion ExcludePath="[{Local AppData}]\Temp" />
	    <FileExclusion ExcludePath="[{Local AppData}]\Microsoft\Windows" />
	    <FileExclusion ExcludePath="[{Local AppData}]\Packages" />

            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Wow6432Node\Microsoft\Cryptography" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Cryptography" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Microsoft Antimalware" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Microsoft Antimalware Setup" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\Microsoft Security Client" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Policies\Microsoft\Microsoft Antimalware" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Policies\Microsoft\Windows Defender" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Microsoft\Windows\CurrentVersion\Explorer\StreamMRU" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Explorer\StreamMRU" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Microsoft\Windows\CurrentVersion\Explorer\Streams" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Wow6432Node\Microsoft\Windows\CurrentVersion\Explorer\Streams" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Microsoft\AppV" />
            <RegistryExclusion ExcludePath= "REGISTRY\MACHINE\SOFTWARE\Wow6432Node\Microsoft\AppV" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Microsoft\AppV" />
            <RegistryExclusion ExcludePath= "REGISTRY\USER\[{AppVCurrentUserSID}]\Software\Wow6432Node\Microsoft\AppV" />
        </ExclusionItems>
	-->
    
    <!--Note: Specifying an installer exit code will allow you to automatically trigger a reboot during your conversion
      <v2:ValidInstallerExitCodes>
        <V2:ValidInstallerExitCode ExitCode="3010" V3:Reboot="true"/>
        <V2:ValidInstallerExitCode ExitCode="1641"/>
      </v2:ValidInstallerExitCodes>
    -->
	    
    </Settings>

    <!--Note: this section takes precedence over the Settings::ApplyAllPrepareComputerFixes attribute and is optional
    <PrepareComputer
        DisableDefragService="true"
        DisableWindowsSearchService="true"
        DisableSmsHostService="true"
        DisableWindowsUpdateService="true"/>
    -->

    <SaveLocation
        PackagePath="C:\users\user\Desktop\MyPackage.msix" 
        TemplatePath="C:\users\user\Desktop\MyTemplate.xml" />

    <Installer
        Path="C:\MyAppInstaller.msi"
        InstallLocation="C:\Program Files\MyAppInstallLocation" />
	
    <!--NOTE: This section specifies that the conversion will be run on a local Virtual Machine. This is optional if you want to change your conversion environment from the default local machine.
    <VirtualMachine Name="vmname" Username="vmusername"/>
    -->

    <!--NOTE: This section specifies that the conversion will be run on a remote machine.This is optional if you want to change your conversion environment from the default local machine.
    <v2:RemoteMachine ComputerName="vmname" Username="vmusername" v3:EnableAutoLogon="true"/>
    -->

    <PackageInformation
        PackageName="MyAppPackageName"
        PackageDisplayName="MyApp Display Name"
        PublisherName="CN=MyPublisher"
        PublisherDisplayName="MyPublisher Display Name"
        Version="1.1.0.0"
        MainPackageNameForModificationPackage="MainPackageIdentityName">

    <!--Note: This is optional, if you want to sign your package with Device Guard signing
        <v4:SigningInformation>
            <v4:DeviceGuardSigning
                Tokenfile="tokenfile.json"
                TimestampUrl="https://mytimestamp.com"/>
        </v4:SigningInformation>
    -->
        
	<!--NOTE: This ID will be used if the Application entry detected matches the specified ExecutableName
        <Applications>
            <Application
                Id="MyApp1"
                Description="MyApp"
                DisplayName="My App"
                ExecutableName="MyApp.exe"/>
        </Applications>
	-->

	<!--NOTE: This is optional as “runFullTrust” capability is added by default during conversion
        <Capabilities>
            <Capability Name="runFullTrust" />
        </Capabilities>
	-->
	    
    </PackageInformation>
</MsixPackagingToolTemplate>

Sdílet prostřednictvím

Jak vygenerovat soubor šablony pro převody příkazového řádku

Vygenerování souboru šablony převodu z nástroje MSIX Packaging Tool

Ruční úprava souboru šablony převodu

Referenční informace k parametrům šablony převodu

Ukázkový soubor šablony převodu

Váš názor

Další materiály