Set-AppXProvisionedDataFile

Set-AppXProvisionedDataFile

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

Syntaxe

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>]

Description détaillée

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.

Utilisez le paramètre Online pour spécifier le système d’exploitation en cours d’exécution sur votre ordinateur local, ou utilisez le paramètre Path pour spécifier l’emplacement d’une image Windows montée.

Paramètres

-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>

Spécifie le niveau de sortie maximal enregistré dans les journaux. Le niveau de journalisation par défaut est 3. Les valeurs acceptées sont les suivantes :1 = erreurs uniquement2 = erreurs et avertissements3 = erreurs, avertissements et informations4 = toutes les informations répertoriées plus haut, plus la sortie du débogage

-LogPath<String>

Spécifie le chemin et le nom de fichier complets où consigner la journalisation. S’il n’est pas défini, la valeur par défaut est %WINDIR%\Logs\Dism\dism.log.Dans Windows PE, le répertoire par défaut est l’espace de travail RAMDISK; dont la taille peut être de seulement 32 Mo. Le fichier journal est archivé automatiquement. Le fichier journal archivé est enregistré avec l’extension .bak ajoutée au nom de fichier et un nouveau fichier journal est généré. Chaque fois que le fichier journal est archivé, le fichier .bak est remplacé. Quand vous utilisez un partage réseau qui n’est pas joint à un domaine, utilisez la commande net use avec des informations d’identification de domaine pour définir les autorisations d’accès avant de définir le chemin du journal DISM.

-Online

Spécifie que l’action doit être effectuée sur le système d’exploitation en cours d’exécution sur l’ordinateur local.

-PackageName<String>

-Path<String>

Spécifie le chemin complet du répertoire racine de l’image Windows hors connexion dont vous allez effectuer la maintenance. Si le répertoire nommé Windows n’est pas un sous-répertoire du répertoire racine, vous devez spécifier -WindowsDirectory.

-ScratchDirectory<String>

Spécifie un répertoire temporaire qui sera utilisé lors de l’extraction de fichiers à utiliser pendant la maintenance. Le répertoire doit exister localement. S’il n’est pas spécifié, le répertoire \Windows\%Temp% sera utilisé, avec comme nom de sous-répertoire une valeur hexadécimale générée de manière aléatoire pour chaque exécution de DISM. Les éléments du répertoire de travail sont supprimés après chaque opération. Vous ne devez pas utiliser un emplacement de partage réseau comme répertoire de travail pour développer un package (fichier .cab ou .msu) en vue d’une installation. Le répertoire utilisé pour l’extraction des fichiers à usage temporaire pendant la maintenance doit être un répertoire local.

-SystemDrive<String>

Spécifie le chemin d’accès de l’emplacement des fichiers BootMgr. Ceci est nécessaire seulement quand les fichiers BootMgr sont trouvent sur une partition autre que celle à partir de laquelle vous exécutez la commande. Utilisez -SystemDrive pour traiter une image Windows installée à partir d’un environnement Windows PE.

-WindowsDirectory<String>

Spécifie le chemin d’accès du répertoire Windows relativement au chemin de l’image. Il peut pas s’agir du chemin complet du répertoire Windows ; ce doit être un chemin d’accès relatif. S’il n’est pas spécifié, la valeur par défaut est le répertoire Windows dans la racine du répertoire de l’image hors connexion.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d’informations, consultez about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).

Entrées

Le type d’entrée correspond au type des objets que vous pouvez transmettre à l’applet de commande.

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

Sorties

Le type de sortie est le type des objets émis par l’applet de commande.

• Microsoft.Dism.Commands.ImageObject

Exemples

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

Rubriques connexes

Add-AppxProvisionedPackage

Get-AppxProvisionedPackage

Remove-AppxProvisionedPackage