App Volumes アプリケーション キャプチャ コマンドライン プログラムの Windows コマンドライン引数

appcapture.exe help

/format や /output などの追加パラメータが指定されていない場合、デフォルトでは、.vhd ファイルと .json ファイルがこの場所 (C:\ProgramData\Omnissa\AppVolumes\Packages) にキャプチャされます。

• このコマンドでは、/name、/author、/description、/format、/output、/source、/manualresume、/upgradecode、/productversion の各パラメータを使用できます。


• /name と /upgradecode は必須のパラメータで、start コマンドで使用する必要があります。残りのパラメータはオプションです。


• キャプチャするアプリケーションの製品バージョン形式が、想定される形式と互換性がないと、キャプチャは失敗します。このようなシナリオでは、キャプチャ時に /productversion を使用する必要があります。

appcapture.exe start /name Notepad++ /upgradecode {867CAC46-AFDC-4462-8BE4-1F25861A5C55} /author John /description "This is Notepad++".

appcapture.exe metadata /file "C:\Users\TestUser\Desktop\Notepad++.vhd" /output "C:\Users\TestUser\Desktop\Test"

• パッケージは、VHD、VMDK、または MSI 形式に変換できます。
• ソース パッケージは VHD、VMDK、または MSI です。ソースが MSI の場合、VHD パッケージにのみ変換できます。
• デフォルトでは、変換後のアプリケーション パッケージはソース アプリケーション パッケージと同じパスに配置され、ソース パッケージと同じファイル名になります。
• 変換されたパッケージごとに .json ファイルが生成されます。変換されたパッケージと同じパスに .json ファイルがすでに存在する場合、このファイルは置き換えられます。

appcapture.exe convert /file "path_of_the_source_application_package" /format [VHD | VMDK | MSI]

/file パラメータで指定されたパスにあるアプリケーション パッケージは、/format パラメータで指定されたアプリケーション パッケージ形式に変換されます。

このコマンドは、App-V アプリケーション パッケージを App Volumes パッケージに変換する場合にも使用できます。App-V アプリケーション パッケージの変換の詳細については、「App-V アプリケーション パッケージから App Volumes アプリケーション パッケージへの変換」を参照してください

注：App Volumes Manager を使用してキャプチャされた .vmdk アプリケーション パッケージから .vhd アプリケーション パッケージを生成するには、.vmdk パッケージをモノリシック スパース .vmdk に変換してから、appcapture.exe convert コマンドを使用する必要があります。

• この例では、Notepad++.vhd が Notepad++.msi に変換され、変換されたパッケージは C:\Users\TestUser\Desktop\test に配置されます。
  

  appcapture.exe convert /file "C:\Users\TestUser\Desktop\Notepad++.vhd" /format MSI /output "C:\Users\TestUser\Desktop\test"



• この例では、Notepad++_workstation.vmdk が Notepad++.vhd に変換され、変換されたパッケージは C:\Users\TestUser\Desktop\test に配置されます。
  

  appcapture.exe convert /file "C:\Users\TestUser\Desktop\Notepad++_workstation.vmdk" /format VHD /output "C:\Users\TestUser\Desktop\test"



• この例では、Notepad++.appv が Notepad++.vhd に変換され、変換されたパッケージは C:\Users\TestUser\Desktop\test
  

  appcapture.exe convert /file "C:\Users\TestUser\Desktop\Notepad++.appv" /format VHD /output "C:\Users\TestUser\Desktop\test"

  に配置されます。
  Notepad++.vhd は、App-V アプリケーション パッケージです。


• この例では、Notepad++.msi が Notepad++.vhd に変換されます。VHD パッケージが MSI パッケージと同じ場所に配置されます。

  appcapture.exe convert /file "C:\Users\TestUser\Desktop\Notepad++.msi" /format VHD

appcapture.exe start /name Notepad++
.........................
.........................
appcapture.exe cancel

appcapture.exe start /name Notepad++
.........................
.........................
appcapture.exe finalize

appcapture.exe start /name Notepad++ /manualresume
...................................
...................................
appcapture.exe resume

• appcapture.exe update /upgradecode {867CAC46-AFDC-4462-8BE4-1F25861A5C55} /format MSI /file "C:\Users\TestUsers\Desktop\7zip.msi"
このコマンドでは、{867CAC46-AFDC-4462-8BE4-1F25861A5C55} が、以前にキャプチャされた 7zip.msi パッケージの UpgradeCode プロパティとして設定されています。


• appcapture.exe update /upgradecode {867CAC46-AFDC-4462-8BE4-1F25861A5C55} /format VHD /file "C:\Users\TestUsers\Desktop\NPP.vhd"
このコマンドでは、{867CAC46-AFDC-4462-8BE4-1F25861A5C55} が、NPP.vhd パッケージの app_product_guid プロパティとして設定されています。このプロパティは NPP.json ファイルにあります。


• appcapture.exe update /upgradecode "C:\Users\TestUser\Downloads\7z920-x64.msi" /format MSI /file "C:\Users\TestUser\Desktop\7zip.msi"
このコマンドでは、ネイティブの 7z920-x64.msi アプリケーション インストーラの UpgradeCode プロパティを使用して生成された GUID が、以前にキャプチャされた 7zip.msi App Volumes アプリケーション パッケージの UpgradeCode プロパティとして設定されます。


• appcapture.exe update /upgradecode "C:\Users\TestUser\Downloads\7z920-x64.msi" /format VHD /file "C:\Users\TestUser\Desktop\7zip.VHD"
このコマンドでは、ネイティブの MSI 7-zip アプリケーション インストーラ (7z920-x64.msi)の UpgradeCode を使用して生成された GUID が、7zip.VHD パッケージの .json ファイルの app_product_guid プロパティとして設定されます。

appcapture.exe test /package C:\ProgramData\Omnissa\AppVolumes\Packages\test_dir\Notepad++.vhd

appcapture.exe testend

appcapture.exe packagereport /file "C:\Users\localadmin\Documents\emeditor.vhd" /output "C:\Users\localadmin\Desktop"

appcapture.exe securityscan /path "C:\Users\localadmin\Desktop\ScanVHD\Notepad++.vhd" /output "C:\Users\localadmin\Desktop\scannotepad++.json"

• MSIXMGR ツール (msixmgr.exe) をダウンロードし、実行ファイルをキャプチャ仮想マシンに配置する必要があります。
  MSIXMGR ツールは、この場所からダウンロードできます。
• App Volumes パッケージを生成するアプリケーションの MSIX インストーラ。

• appcapture.exe は、MSIXMGR ツールの実行ファイルを実行して、MSIX アプリケーションを VHD に展開します。
• コマンドの実行後、デフォルトで .json ファイルと .vhd ファイルが C:\ProgramData\Omnissa\AppVolumes\Packages で生成されます。
  VMDK 形式と MSI 形式が指定されている場合、*_workstation.vmdk 形式と .msi 形式がそれぞれ生成されます。
  場所をカスタマイズするには、/output オプションを使用します。
• コマンドの初回実行時に MSIXMGR ツールの実行ファイルのパスが svservice レジストリ値 MSIXMgrToolPath に格納されます。
  2 回目以降は次のようになります。
  • コマンドに実行ファイルのパスが指定されていない場合、レジストリ値に格納されている実行ファイルの場所が使用されます。
  • 実行ファイルのパスが指定されている場合、その場所が使用され、レジストリ値に新しい場所が格納されます。
  このレジストリ値の詳細については、「svservice の構成」を参照してください。

appcapture.exe packagemsix /name Teams /upgradecode {64E3DF12-93EB-4567-9EA7-A3656026E549} /source "C:\Users\localadmin\Downloads\Microsoft Teams_25332.1210.4188.1171_X64_msix_en-US.msix" /msixmgr C:\MSIXMGR\x64\msixmgr.exe /format VHD,VMDK,MSI

appcapture.exe start /name Notepad++ /description "This is a Notepad++ application package."

• appcapture.exe start /name name_of_package /format [VHD | VMDK | MSI]


• appcapture.exe convert /file path_of_the_source_application_package /format [VHD | VMDK | MSI]

• /format [MSI | VMDK ]：これは、アプリケーション パッケージが最初に VHD 形式でキャプチャされ、パラメータ値に指定された出力形式に変換されてから、VHD 形式が削除されることを示します。
• /format VHD, [MSI | VMDK ]：パッケージのキャプチャ後、VHD 形式がパラメータ値に指定された出力形式に変換されます。VHD 形式も保持されます。
• /format VHD,MSI,VMDK：これは、パッケージのキャプチャ後、VHD 形式が MSI 形式と VMDK 形式の両方に変換され、VHD 形式も保持されることを示します。
• /format VMDK,MSI：VHD 形式が VMDK および MSI に変換され、VHD 形式が削除されることを示します。

appcapture.exe start /name Notepad++ /format VMDK,MSI

appcapture.exe start /name Notepad++ /manualresume

appcapture.exe start /name Notepad++ /upgradecode {867CAC46-AFDC-4462-8BE4-1F25861A5C55} /noreboot

appcapture.exe start /name Notepad++ /output C:\ProgramData\Omnissa\AppVolumes\Packages\Test

• このパラメータは、VHD パッケージのキャプチャにのみ使用できます。
• 前提条件パッケージを特定の順序で仮想化する必要がある場合は、これらのパッケージを仮想化と同じ順序でパラメータに指定する必要があります。

• appcapture.exe start /name name_of_the_package /upgradecode custom_guid /prerequisitepackages [\\share\folderA];[file1.vhd];[file2.vhd];[file3.vhd][\\share\folderB];[file4.vhd]
  
  • file1.vhd、file2.vhd、file3.vhd、file4.vhd は、リストされている順序で仮想化されます。
  • file1.vhd、file2.vhd、file3.vhd は folderA のファイルで、file4.vhd は folderB のファイルです。同じフォルダを複数回指定できます。複数のフォルダから複数の前提条件パッケージを追加できます。


• appcapture.exe start /name name_of_the_packcage /upgradecode custom_guid /prerequisitepackages [full-path-to-file1.vhd];[file2.vhd];

• 例：

  appcapture.exe start /name Notepad++ /prerequisitepackages \\mymachineA\share;myapp1.vhd;myapp2.vhd;\\mymachineB\anothershare;myapp3.vhd;\\mymachineA\share;myapp4.vhd /output C:\ProgramData\Omnissa\AppVolumes\Packages\Test

  
  
  この例では、myapp1.vhd、myapp2.vhd、myapp3.vhd、myapp4.vhd は、Notepad++ のキャプチャに必要な前提条件パッケージです。これらの前提条件パッケージはリスト順に仮想化されます。つまり、myapp1.vhd が最初に仮想化され、次に myapp2.vhd が仮想化されます。Notepad++ は、これらのプライマリ アプリケーションがすべてキャプチャ仮想マシンにインストールされた後にのみキャプチャされます。キャプチャ セッション後に Notepad++.vhd と Notepad++.json が Test フォルダに格納されます。


• 例：

  appcapture.exe start /name 7zip /prerequisitepackages \\mymachineA\share\myapp1.vhd;myapp2.vhd;myapp3.vhd;myapp4.vhd /output C:\ProgramData\Omnissa\AppVolumes\Packages\Test

  
  この例では、7 zip アプリケーションをキャプチャするために前提条件パッケージが必要です。ファイル パス全体は、前提条件パッケージの 1 つである myapp1.vhd に指定されています。指定されている他の前提条件パッケージは myapp2.vhd、myapp3.vhd、myapp4.vhd で、これらも \\mymachineA\share に存在します。これらのパッケージは、リスト順（myapp1.vhd、myapp2.vhd、myapp3.vhd、myapp4.vhd の順）に仮想化されます。

• パラメータの値は、x.x、x.x.x、または x.x.x.x の形式にする必要があります。x には、0 から 9 までの任意の数値を指定できます。
• アプリケーションに製品バージョンがない場合は、パッケージ キャプチャの開始時またはキャプチャのファイナライズ前に製品バージョンを指定する必要があります。
• ファイナライズ時にも製品バージョンが指定されていない場合、事前に設定されたタイマーの時間が経過すると、キャプチャが失敗します。
• このパラメータは、新しいパッケージに対する appcapture.exe start コマンドと既存のアプリケーション パッケージに対する appcapture.exe update コマンドで使用できます。
  
  注：アプリケーションにすでに製品バージョンが設定されていて、このパラメータが使用されていない場合、アプリケーションに誤ったバージョンが指定されていても、キャプチャ コマンドライン プログラムは既存の製品バージョンを使用します。

• 次の例では、キャプチャのファイナライズで、指定された製品バージョンがアプリケーションに追加されます。アプリケーションにすでに製品バージョンが設定されている場合、5.3.3 は既存の製品バージョンを置き換えます。
  appcapture.exe start /name /npp /upgradecode {64E3DF12-93EB-4567-9EA7-A3656026E549} /productversion 5.3.3


• 製品バージョンのない既存のアプリケーション パッケージには、/productversion パラメータを使用できます。
  appcapture.exe update /name /npp /upgradecode {64E3DF12-93EB-4567-9EA7-A3656026E549} /productversion 5.3.3

appcapture.exe start /name Notepad++_update /source C:\ProgramData\Omnissa\AppVolumes\Packages\Notepad++.vhd

appcapture.exe securityscan /summary "C:\Users\localadmin\Desktop\ScanVHD"

appcapture.exe securityscan /summary "C:\Users\localadmin\Desktop\ScanVHD\Notepad++.vhd"

• キャプチャするアプリケーションの MSI インストーラを使用する場合は、ネイティブ MSI インストーラのパスを指定します。この MSI インストーラの UpgradeCode は、自動的に app_product_guid として使用されます。
• キャプチャするアプリケーションの EXE インストーラを使用する場合は、カスタム GUID を指定します。
  カスタム GUID を生成するには、PowerShell New-Guid コマンドを使用します

• custom_GUID は、アプリケーションごとに一意の GUID にする必要があります。
• アップグレードを正常に行うには、以前のキャプチャ セッションで使用されたものに応じて、このパラメータに同じアプリケーションの MSI インストーラまたは同じカスタム GUID を使用する必要があります。

• appcapture.exe start /name 7zip /upgradecode "C:\Path\7z920-x64.msi” /format MSI

  この例では、7zip MSI インストーラの UpgradeCode を使用して、MSI 形式でキャプチャされたパッケージの app_product_guid プロパティを生成します。



• appcapture.exe start /name Notepad++ /upgradecode {867CAC46-AFDC-4462-8BE4-1F25861A5C55}

  この例では、カスタム GUID を使用して、キャプチャされたパッケージの app_product_guid プロパティを生成します。デフォルトでは、パッケージは VHD 形式にキャプチャされます。



• appcapture.exe update /upgradecode {867CAC46-AFDC-4462-8BE4-1F25861A5C55} /format MSI /file "C:\Packages\Notepad++.msi"

  この例では、カスタム GUID を使用して、app_product_guid プロパティを生成します。MSI パッケージにこのプロパティがない場合、生成された app_product_guid がパッケージに設定されます。MSI パッケージにこのプロパティがある場合、生成された app_product_guid によって既存のプロパティが更新されます。