Set-AppXProvisionedDataFile

Set-AppXProvisionedDataFile

Adds custom data into the specified app (.appx) package that has been provisioned in a Windows image.

構文

Parameter Set: Offline
Set-AppXProvisionedDataFile -CustomDataPath <String> -PackageName <String> -Path <String> [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]

Parameter Set: Online
Set-AppXProvisionedDataFile -CustomDataPath <String> -Online -PackageName <String> [-LogLevel <LogLevel> ] [-LogPath <String> ] [-ScratchDirectory <String> ] [-SystemDrive <String> ] [-WindowsDirectory <String> ] [ <CommonParameters>]

詳細説明

The Set-AppXProvisionedDataFile cmdlet adds custom data into the specified app (.appx) package that has been provisioned in a Windows image. The specified app (.appx) package must already be added to the image prior to adding custom data.

You cannot install an app package (.appx) on an operating system that does not support apps for at least Windows® 8. Apps are not supported on Server Core installations of Windows Server, Windows PE, or on any versions of Windows older than Windows 8 and Windows Server 2012.

To install and run apps on Windows Server, you must install the Desktop Experience.

Online パラメーターを使用して、ローカル コンピューターで実行中のオペレーティング システムを指定するか、Path パラメーターを使用して、マウントされている Windows イメージの場所を指定します。

パラメーター

-CustomDataPath<String>

Specifies an optional custom data file for an app. You can specify any file name. The file will be renamed to Custom.dat when it is added to the image. If a Custom.dat file already exists, it will be overwritten.

-LogLevel<LogLevel>

ログに表示する最大の出力レベルを指定します。既定のログ レベルは 3 です。指定できる値は次のとおりです。1 = エラーのみ2 = エラーと警告3 = エラー、警告、および情報4 = 以上のすべての情報とデバッグ出力

-LogPath<String>

ログの記録先の完全なパスとファイル名を指定します。設定しない場合、既定値は %WINDIR%\Logs\Dism\dism.log です。Windows PE では、既定のディレクトリは RAMDISK スクラッチ領域 (最低 32 MB) です。ログ ファイルは自動的にアーカイブされます。アーカイブされたログ ファイルは、ファイル名に .bak が追加されて保存され、新しいログ ファイルが生成されます。ログ ファイルがアーカイブされるたびに、.bak ファイルが上書きされます。ドメインに参加していないネットワーク共有を使用する場合は、DISM ログのパスを設定する前に、ドメイン資格情報を指定して net use コマンドを使用し、アクセス許可を設定します。

-Online

ローカル コンピューター上で現在実行中のオペレーティング システムで操作を実行することを指定します。

-PackageName<String>

-Path<String>

操作するオフラインの Windows イメージのルート ディレクトリへの完全なパスを指定します。Windows という名前のディレクトリがルート ディレクトリのサブディレクトリではない場合、-WindowsDirectory を指定する必要があります。

-ScratchDirectory<String>

操作の実行中に使用するファイルの展開時に使用される一時ディレクトリを指定します。このディレクトリはローカルに存在する必要があります。指定しない場合は \Windows\%Temp% ディレクトリが使用され、サブディレクトリ名には DISM の実行ごとにランダムに生成される 16 進数値が使用されます。各操作の終了後、このスクラッチ ディレクトリ内の項目は削除されます。インストール用のパッケージ (.cab または .msu ファイル) を展開する際に、ネットワーク共有の場所をスクラッチ ディレクトリとして使用しないでください。操作の実行中にファイルを展開するために一時的に使用されるディレクトリは、ローカル ディレクトリである必要があります。

-SystemDrive<String>

BootMgr ファイルの場所のパスを指定します。これは、このコマンドの実行元以外のパーティションに BootMgr ファイルがある場合にのみ必要になります。-SystemDrive を使用して、インストールされている Windows イメージを Windows PE 環境から操作します。

-WindowsDirectory<String>

イメージ パスを基準にして、Windows ディレクトリへのパスを指定します。Windows ディレクトリへの完全なパスは使用できません。相対パスである必要があります。指定しない場合、既定値はオフライン イメージ ディレクトリのルートにある Windows ディレクトリです。

<CommonParameters>

このコマンドレットは次の共通パラメーターをサポートします。-Verbose、-Debug、-ErrorAction、-ErrorVariable、-OutBuffer、-OutVariable.詳細については、以下を参照してください。 about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216)。

入力

入力型は、コマンドレットにパイプできるオブジェクトの型です。

• System.String[]
• Microsoft.Dism.Commands.ImageObject
• Microsoft.Dism.Commands.AppxPackageObject

出力

出力型は、コマンドレットによって生成されるオブジェクトの型です。

• Microsoft.Dism.Commands.ImageObject

例

Example 1

This command adds the custom data file, c:\Appx\myCustomData.dat, into the app package, MyAppxPkg, that has been added to the running Windows operating system.

PS C:\> Set-AppXProvisionedDataFile -Online -PackageName MyAppxPkg -CustomDataPath c:\Appx\myCustomData.dat

Example 2

This command adds the custom data file, c:\Appx\myCustomData.dat, into the app package, MyAppxPkg, that has been added to the Windows image mounted to c:\offline.

PS C:\> Set-AppxProvisionedDataFile -Path c:\offline -PackageName MyAppxPkg -CustomDataPath c:\Appx\myCustomData.dat

関連トピック

Add-AppxProvisionedPackage

Get-AppxProvisionedPackage

Remove-AppxProvisionedPackage