コマンド ライン インターフェイス (CLI) を使用する変換Conversion with Command Line Interface (CLI)

アプリケーションの新しい MSIX パッケージを作成するには、管理者コマンド プロンプト ウィンドウで、MsixPackagingTool.exe パッケージの作成コマンドを実行します。To create a new MSIX package for your application, run the MsixPackagingTool.exe create-package command in an administrator Command prompt window.

コマンドライン引数として渡すことができるパラメーターを次に示します。Here are the parameters that can be passed as command line arguments:

パラメーターParameter 説明Description
-?-? -ヘルプ--help ヘルプ情報を表示します。Show help information
-テンプレート--template パッケージ情報と、この変換の設定を含む変換テンプレート XML ファイルのパスを [必須][required] path to the conversion template XML file containing package information and settings for this conversion
--virtualMachinePassword--virtualMachinePassword [省略可能]変換の環境に使用する仮想マシンのパスワード。[optional] The password for the Virtual Machine to be used for the conversion environment. 注:テンプレート ファイルは、仮想マシンの要素を含める必要があり、Settings::AllowPromptForPassword 属性を設定しない必要がありますを true にします。Notes: The template file must contain a VirtualMachine element and the Settings::AllowPromptForPassword attribute must not be set to true.
-v --verbose-v --verbose [省略可能]コンソールの詳細ログを出力します。[optional] Print verbose logs to the console.

例:Examples:

'' コマンド プロンプト``` command prompt

MsixPackagingTool.exe create-package --template c:\users\documents\ConversionTemplate.xml -v

MSIXPackagingTool.exe create-package --template c:\users\documents\ConversionTemplate.xml --virtualMachinePassword pswd112893
> [!NOTE]
> App-V 5.x conversion is currently supported to be converted throught the command line. This includes capabilities. 

**Conversion template file**

``` xml
<MsixPackagingToolTemplate
    xmlns="http://schemas.microsoft.com/appx/msixpackagingtool/template/2018">

    <Settings
        AllowTelemetry="true"
        ApplyAllPrepareComputerFixes="true"
        GenerateCommandLineFile="true"
        AllowPromptForPassword="false" 
    EnforceMicrosoftStoreVersioningRequirements="false">
        
    <!--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>
    -->
        
    </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.
    <VirtualMachine Name="vmname" Username="vmusername" />
    -->

    <PackageInformation
        PackageName="MyAppPackageName"
        PackageDisplayName="MyApp Display Name"
        PublisherName="CN=MyPublisher"
        PublisherDisplayName="MyPublisher Display Name"
        Version="1.1.0.0"
        MainPackageNameForModificationPackage="MainPackageIdentityName">
        
    <!--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>

変換テンプレート パラメーターの参照Conversion template parameter reference

変換テンプレート ファイルで使用できるパラメーターの完全な一覧を次に示します。Here is the complete list of parameters that you can use in the Conversion template file.

ConversionSettingsConversionSettings 説明Description
設定::AllowTelemetrySettings:: AllowTelemetry [省略可能]ツールのこの呼び出しの製品利用統計情報のログ記録を有効にします。[optional] Enables telemetry logging for this invocation of the tool.
設定::ApplyAllPrepareComputerFixesSettings:: ApplyAllPrepareComputerFixes [省略可能]適用対象のコンピューターの修正プログラムを準備する推奨すべて。[optional] Applies all recommended prepare computer fixes. その他の属性を使用する場合は設定できません。Cannot be set when other attributes are used.
設定::GenerateCommandLineFileSettings:: GenerateCommandLineFile [省略可能]将来使用するため、SaveLocation ディレクトリへの入力をテンプレート ファイルをコピーします。[optional] Copies the template file input to the SaveLocation directory for future use.
設定::AllowPromptForPasswordSettings:: AllowPromptForPassword [省略可能]必要なが指定されていない場合、仮想マシンと署名証明書のパスワードの入力をユーザーに確認するツールに指示します。[optional] Instructs the tool to prompt the user to enter passwords for the Virtual Machine and for the signing certificate if it is required and not specified.
設定::EnforceMicrosoftStoreVersioningRequirementsSettings:: EnforceMicrosoftStoreVersioningRequirements [省略可能]Microsoft Store およびビジネス向け Microsoft Store からのデプロイに必要なパッケージのバージョン管理スキームを適用するツールに指示します。[optional] Instructs the tool to enforce the package versioning scheme required for deployment from Microsoft Store and Microsoft Store for Business.
ExclusionItemsExclusionItems (省略可能) 0 または FileExclusion または RegistryExclusion 要素。[optional] 0 or more FileExclusion or RegistryExclusion elements. FileExclusion のすべての要素は、RegistryExclusion 要素の前に表示する必要があります。All FileExclusion elements must appear before any RegistryExclusion elements.
ExclusionItems::FileExclusionExclusionItems::FileExclusion [省略可能]パッケージから除外するファイルです。[optional] A file to exclude for packaging.
ExclusionItems::FileExclusion::ExcludePathExclusionItems::FileExclusion::ExcludePath パッケージから除外するファイルへのパス。Path to file to exclude for packaging.
ExclusionItems::RegistryExclusionExclusionItems::RegistryExclusion [省略可能]パッケージから除外するレジストリ キー。[optional] A registry key to exclude for packaging.
ExclusionItems::RegistryExclusion:。ExcludePathExclusionItems::RegistryExclusion:: ExcludePath パッケージから除外するレジストリへのパス。Path to registry to exclude for packaging.
PrepareComputer::DisableDefragServicePrepareComputer::DisableDefragService [省略可能]アプリが変換中には、Windows のデフラグ ツールを無効にします。[optional] Disables Windows Defragmenter while the app is being converted. 場合は false に設定、ApplyAllPrepareComputerFixes よりも優先されます。If set to false, overrides ApplyAllPrepareComputerFixes.
PrepareComputer:。DisableWindowsSearchServicePrepareComputer:: DisableWindowsSearchService [省略可能]アプリが変換中には、Windows Search を無効にします。[optional] Disables Windows Search while the app is being converted. 場合は false に設定、ApplyAllPrepareComputerFixes よりも優先されます。If set to false, overrides ApplyAllPrepareComputerFixes.
PrepareComputer:。DisableSmsHostServicePrepareComputer:: DisableSmsHostService [省略可能]アプリが変換中には、SMS のホストを無効にします。[optional] Disables SMS Host while the app is being converted. 場合は false に設定、ApplyAllPrepareComputerFixes よりも優先されます。If set to false, overrides ApplyAllPrepareComputerFixes.
PrepareComputer:。DisableWindowsUpdateServicePrepareComputer:: DisableWindowsUpdateService [省略可能]アプリが変換中には、Windows Update を無効にします。[optional] Disables Windows Update while the app is being converted. 場合は false に設定、ApplyAllPrepareComputerFixes よりも優先されます。If set to false, overrides ApplyAllPrepareComputerFixes.
SaveLocationSaveLocation [省略可能]保存先を指定する要素ツールの場所。[optional] An element to specify the save location of the tool. 指定しない場合は、パッケージを保存して、デスクトップ フォルダーの下。If not specified, the package will be saved under the Desktop folder.
SaveLocation::PackagePathSaveLocation::PackagePath [省略可能]ファイルまたはフォルダーの結果として得られる MSIX パッケージの保存場所へのパス。[optional] The path to the file or folder where the resulting MSIX package is saved.
SaveLocation::TemplatePathSaveLocation::TemplatePath [省略可能]ファイルまたはフォルダーの結果として得られる CLI テンプレートの保存場所へのパス。[optional] The path to the file or folder where the resulting CLI template is saved.
Installer::PathInstaller::Path アプリケーションのインストーラーのパス。The path to the application installer.
Installer::ArgumentsInstaller::Arguments [省略可能]インストーラーに渡す引数。[optional] The arguments to pass to the installer. ツールが自動的にサイレント モードで引数を使用して MSI インストーラーを実行"/qn/norestart INSTALLSTARTMENUSHORTCUTS 1 DISABLEADVTSHORTCUTS を = = 1"です。The tool will automatically run MSI installers silently using argument "/qn /norestart INSTALLSTARTMENUSHORTCUTS=1 DISABLEADVTSHORTCUTS=1". 注: .Exe インストーラーを使用している場合、サイレント モードで実行するインストーラーを強制的に引数を渡す必要があります。NOTE: You must pass the arguments to force your installer to run silently if you are using .exe installers.
Installer::InstallLocationInstaller::InstallLocation [省略可能](例: インストールされた場合は、インストールされているファイルのアプリケーションのルート フォルダーへの完全パス"C:\Program Files (x86) \MyAppInstalllocation")。[optional] The full path to your application's root folder for the installed files if it were installed (e.g. "C:\Program Files (x86)\MyAppInstalllocation").
VirtualMachineVirtualMachine [省略可能]ローカルの仮想マシンの変換が実行されることを指定する要素。[optional] An element to specify that the conversion will be run on a local Virtual Machine.
VrtualMachine::NameVrtualMachine::Name 変換の環境に使用する仮想マシンの名前。The name of the Virtual Machine to be used for the conversion environment.
VirtualMachine::UsernameVirtualMachine::Username [省略可能]変換の環境に使用する仮想マシンのユーザー名。[optional] The user name for the Virtual Machine to be used for the conversion environment.
PackageInformation::PackageNamePackageInformation::PackageName MSIX パッケージのパッケージ名。The Package Name for your MSIX package.
PackageInformation::PackageDisplayNamePackageInformation::PackageDisplayName MSIX パッケージのパッケージの表示名。The Package Display Name for your MSIX package.
PackageInformation::PublisherNamePackageInformation::PublisherName MSIX パッケージの発行者。The Publisher for your MSIX package.
PackageInformation::PublisherDisplayNamePackageInformation::PublisherDisplayName MSIX パッケージの発行元表示名。The Publisher Display Name for your MSIX package.
PackageInformation::VersionPackageInformation::Version MSIX パッケージのバージョン番号です。The version number for your MSIX package.
パッケージ情報。MainPackageNameForModificationPackagePackageInformation:: MainPackageNameForModificationPackage [省略可能]メイン パッケージの名前のパッケージ id 名。[optional] The Package identity name of the main package name. これは、主要な (親) アプリケーションに依存した修正パッケージの作成時に使用されます。This is used when creating a modification package that takes a dependency on a main (parent) application.
アプリケーションApplications (省略可能) 0 または MSIX パッケージにアプリケーションのエントリを構成するための複数のアプリケーション要素。[optional] 0 or more Application elements to configure the Application entries in your MSIX package.
Application::IdApplication::Id MSIX アプリケーション用のアプリ ID。The App ID for your MSIX application. この ID が使用されるアプリケーションのエントリでは、指定した ExecutableName に一致する検出されたのです。This ID will be used for the Application entry detected that matches the specified ExecutableName. パッケージには、実行可能ファイルに対して複数のアプリケーションの ID 値を設定できます。You can have multiple Application ID values for executables in the package.

この値は、パッケージ内のアプリケーションの一意の識別子です。This value is the unique identifier of the application within the package. この値は、アプリのパッケージ相対識別子 (PRAID) とも呼ばれます。This value is sometimes referred to as the package-relative app identifier (PRAID). ID は、(同じ ID では使用できません複数回、同じパッケージ)、パッケージ内で一意である必要があります。The ID must be unique within the package (the same ID cannot be used more than once in the same package). ただし、ID する必要があります一意でないグローバルに。However, the ID must not be unique globally. ある可能性がある別のパッケージと同じ ID を使用するシステムThere may be another package on the system that uses the same ID.

この文字列には、ピリオドで区切られた英数字フィールドが含まれています。This string contains alpha-numeric fields separated by periods. 各フィールドは、ASCII 英数字で始まる必要があります。Each field must begin with an ASCII alphabetic character. フィールドの値としてこれらを使用することはできません。"CON"、"PRN"、"AUX"、"NUL"、"COM1"、"COM2"、"COM3"、"COM4"、"COM5"、"COM6"、"COM7"、"COM8"、"COM9"、"LPT1"、"LPT2"、"LPT3"、"LPT4"、"LPT5"、"LPT6"、"LPT7"、"LPT8"、"LPT9"。You cannot use these as field values: "CON", "PRN", "AUX", "NUL", "COM1", "COM2", "COM3", "COM4", "COM5", "COM6", "COM7", "COM8", "COM9", "LPT1", "LPT2", "LPT3", "LPT4", "LPT5", "LPT6", "LPT7", "LPT8", and "LPT9".
Application::ExecutableNameApplication::ExecutableName パッケージ マニフェストに追加される MSIX アプリケーションの実行可能ファイル名。The executable name for the MSIX application that will be added to the package manifest. この名前のアプリケーションが検出されない場合は、対応するアプリケーションのエントリが無視されます。The corresponding application entry will be ignored if no application with this name is detected.
Application::DescriptionApplication::Description [省略可能]MSIX アプリケーション用のアプリの説明。[optional] The App Description for your MSIX application. 使用しない場合は、アプリケーションの表示名が使用されます。If not used, the Application DisplayName will be used. この説明が使用するアプリケーションのエントリでは、指定した ExecutableName に一致する検出されたためThis description will be used for the application entry detected that matches the specified ExecutableName
Application::DisplayNameApplication::DisplayName MSIX パッケージ アプリの表示名。The App Display Name for your MSIX package. この表示名が使用するアプリケーションのエントリでは、指定した ExecutableName に一致する検出されたためThis Display Name will be used for the application entry detected that matches the specified ExecutableName
機能Capabilities (省略可能) 0 または MSIX パッケージにカスタム機能を追加する多くの機能の要素。[optional] 0 or more Capability elements to add custom capabilities to your MSIX package. 変換中に既定で"runFullTrust"機能が追加されます。“runFullTrust” capability is added by default during conversion.
Capability::NameCapability::Name MSIX パッケージに追加する機能です。The capability to add to your MSIX package.