Set-AppXProvisionedDataFile
Set-AppXProvisionedDataFile
Adds custom data into the specified app (.appx) package that has been provisioned in a Windows image.
Syntax
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>]
Detaillierte Beschreibung
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.
Verwenden Sie den Onlineparameter, um das ausgeführte Betriebssystem auf dem lokalen Computer anzugeben, oder verwenden Sie den Path-Parameter, um den Speicherort eines bereitgestellten Windows-Abbilds anzugeben.
Parameter
-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.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-LogLevel<LogLevel>
Gibt die in den Protokollen angezeigte maximale Ausgabestufe an. Die Standardprotokollstufe ist 3. Die zulässigen Werte lauten wie folgt:1 = nur Fehler2 = Fehler und Warnungen3 = Fehler, Warnungen und Informationen4 = alle zuvor genannten Informationen sowie Debugausgabe
Aliasse |
LL |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-LogPath<String>
Gibt den vollständigen Pfad und Dateinamen zum Anmelden an. Ohne besondere Festlegung ist der Standardwert %WINDIR%\Logs\Dism\dism.log.In Windows PE ist der RAMDISK-Speicherbereich, der 32 MB klein sein kann, das Standardverzeichnis. Die Protokolldatei wird automatisch archiviert. Die archivierte Protokolldatei wird mit der Dateiendung „.bak“ gespeichert, und eine neue Protokolldatei wird generiert. Bei jeder Archivierung der Protokolldatei wird die BAK-Datei überschrieben. Wenn Sie eine Netzwerkfreigabe verwenden, die nicht Mitglied einer Domäne ist, verwenden Sie den Befehl „net use“ zusammen mit den Domänenanmeldeinformationen, um Zugriffsberechtigungen festlegen, bevor Sie den Protokollpfad für das DISM-Protokoll festlegen.
Aliasse |
LP |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Online
Gibt an, dass die Aktion unter dem Betriebssystem ausgeführt werden muss, dass derzeit auf dem lokalen Computer ausgeführt wird.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-PackageName<String>
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-Path<String>
Gibt den vollständigen Pfad zum Stammverzeichnis des Offline-Windows-Abbilds an, das Sie warten. Wenn das Verzeichnis mit dem Namen „Windows“ kein Unterverzeichnis des Stammverzeichnisses ist, muss „- WindowsDirectory“ angegeben werden.
Aliasse |
Keiner |
Erforderlich? |
true |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-ScratchDirectory<String>
Gibt ein temporäres Verzeichnis an, das beim Extrahieren von Dateien während der Wartung verwendet wird. Das Verzeichnis muss lokal vorhanden sein. Wenn nicht angegeben, wird das Verzeichnis \Windows\%Temp% verwendet, mit einem Unterverzeichnisnamen auf Basis eines für jede Ausführung von DISM zufällig generierten Hexadezimalwerts. Elemente im Scratchverzeichnis werden nach jedem Vorgang gelöscht. Sie sollten keine Netzwerkfreigabe als Scratchverzeichnis verwenden, um ein Paket (CAB- oder MSU-Datei) für die Installation zu erweitern. Das Verzeichnis für das Extrahieren von Dateien für die temporäre Verwendung während der Wartung sollte ein lokales Verzeichnis sein.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-SystemDrive<String>
Gibt den Pfad zum Speicherort der BootMgr-Dateien an. Dies ist nur dann notwendig, wenn die BootMgr-Dateien sich auf einer anderen Partition befinden als der, von der aus Sie den Befehl ausführen. Verwenden Sie „-SystemDrive“, um ein installiertes Windows-Abbild von einer Windows PE-Umgebung aus zu warten.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
-WindowsDirectory<String>
Gibt den Pfad zum Windows-Verzeichnis relativ zum Abbildpfad an. Dies kann nicht der vollständige Pfad zum Windows-Verzeichnis sein. Es sollte ein relativer Pfad sein. Wenn nicht angegeben, ist die Standardeinstellung das Windows-Verzeichnis im Stamm des Offlineabbildverzeichnisses.
Aliasse |
Keiner |
Erforderlich? |
false |
Position? |
named |
Standardwert |
Keiner |
Pipelineeingaben akzeptieren? |
True (ByPropertyName) |
Platzhalterzeichen akzeptieren? |
false |
<CommonParameters>
Dieses Cmdlet unterstützt die allgemeinen Parameter: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable. Weitere Informationen finden Sie unter about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Eingaben
Der Eingabetyp ist der Typ der Objekte, die über die Pipeline an das Cmdlet übergeben werden können.
- System.String[]
- Microsoft.Dism.Commands.ImageObject
- Microsoft.Dism.Commands.AppxPackageObject
Ausgaben
Der Ausgabetyp ist der Typ der Objekte, die vom Cmdlet ausgegeben werden.
- Microsoft.Dism.Commands.ImageObject
Beispiele
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