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

アプリケーションの新しい MSIX パッケージを作成するには、管理者のコマンド プロンプト ウィンドウで MsixPackagingTool.exe create-package コマンドを実行します。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--help ヘルプ情報を表示します。Show help information
--template--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. 注:テンプレート ファイルには VirtualMachine 要素が含まれている必要があり、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:


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

    MSIXPackagingTool.exe create-package --template c:\users\documents\ConversionTemplate.xml --virtualMachinePassword pswd112893
    

注意

現在、App-V 5.x の変換は、コマンド ラインを通じての変換がサポートされています。App-V 5.x conversion is currently supported to be converted throught the command line. これには機能が含まれます。This includes capabilities.

変換テンプレート ファイルConversion template file

<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
Settings:: AllowTelemetrySettings:: AllowTelemetry [省略可能] このツールの呼び出しについてのテレメトリ ログを有効にします。[optional] Enables telemetry logging for this invocation of the tool.
Settings:: ApplyAllPrepareComputerFixesSettings:: ApplyAllPrepareComputerFixes [省略可能] 準備コンピューターの推奨される修正プログラムをすべて適用します。[optional] Applies all recommended prepare computer fixes. その他の属性が使用される場合は設定できません。Cannot be set when other attributes are used.
Settings:: GenerateCommandLineFileSettings:: GenerateCommandLineFile [省略可能] 将来使用するために、テンプレート ファイルの入力を SaveLocation ディレクトリにコピーします。[optional] Copies the template file input to the SaveLocation directory for future use.
Settings:: 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.
Settings:: 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. 指定しない場合、パッケージは Desktop フォルダーに保存されます。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. 本ツールによって引数 "/qn /norestart INSTALLSTARTMENUSHORTCUTS=1 DISABLEADVTSHORTCUTS=1" がサイレントで使用され、MSI インストーラーが自動的に実行されます。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.
PackageInformation:: 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 [省略可能] MSIX パッケージでアプリケーション エントリを構成するための 0 個以上のアプリケーション要素。[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 は 1 つしか使用できません)。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 [省略可能] MSIX パッケージにカスタム機能を追加するための 0 個以上の機能要素。[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.