Set-AppXProvisionedDataFile
Set-AppXProvisionedDataFile
Adds custom data into the specified app (.appx) package that has been provisioned in a Windows image.
Sintaxis
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>]
Descripción detallada
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.
Use el parámetro Online para especificar el sistema operativo que se ejecuta en el equipo local o utilice el parámetro Path para especificar la ubicación de una imagen de Windows montada.
Parámetros
-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.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-LogLevel<LogLevel>
Especifica el nivel de salida máximo que se muestra en los registros. El nivel de registro predeterminado es 3. Los valores aceptados son los siguientes:1 = Solo errores2 = Errores y advertencias3 = Errores, advertencias e información4 = Todo lo anterior junto con la salida de depuración
Alias |
LL |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-LogPath<String>
Especifica la ruta de acceso completa y el nombre de archivo en el que se registrará. Si no se establece, el valor predeterminado es %WINDIR%\Logs\Dism\dism.log
.En Windows PE, el directorio predeterminado es el espacio de desecho de RAMDISK que puede tener un mínimo de 32 MB. El archivo de registro se archivará automáticamente. El archivo de registro se guardará con la extensión .bak anexada al nombre de archivo y se generará un nuevo archivo de registro. Cada vez que se almacene el archivo de registro, se sobrescribirá el archivo .bak. Cuando use un recurso compartido de red que no esté unido a un dominio, utilice el comando net use junto con las credenciales de dominio para establecer permisos de acceso antes de establecer la ruta de acceso de registro para el registro DISM.
Alias |
LP |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Online
Especifica que la acción se realizará en el sistema operativo que se está ejecutando actualmente en el equipo local.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-PackageName<String>
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Path<String>
Especifica la ruta de acceso completa al directorio raíz de la imagen de Windows sin conexión que suministrará. Si el directorio llamado Windows no es un subdirectorio del directorio raíz, debe especificarse -WindowsDirectory.
Alias |
ninguno |
¿Requerido? |
true |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-ScratchDirectory<String>
Especifica un directorio temporal que se usará al extraer los archivos que se utilizarán durante el mantenimiento. El directorio debe existir localmente. Si no se especifica, se usará el directorio \Windows\%Temp%
con un nombre de subdirectorio de valor hexadecimal generado aleatoriamente para cada ejecución de DISM. Los elementos del directorio temporal se eliminan después de cada operación. No se debe usar una ubicación de recurso compartido de red como directorio temporal para expandir un paquete (archivo .cab o .msu) para la instalación. El directorio que se utilice para extraer los archivos para el uso temporal durante el mantenimiento debe ser un directorio local.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-SystemDrive<String>
Especifica la ruta de acceso de la ubicación de los archivos BootMgr. Esto solo es necesario si los archivos BootMgr se encuentran en una partición distinta de aquella desde la que se ejecuta el comando. Use -SystemDrive para mantener una imagen de Windows instalada desde un entorno Windows PE.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-WindowsDirectory<String>
Especifica la ruta de acceso al directorio de Windows en relación con la ruta de acceso de la imagen. No puede ser la ruta de acceso completa al directorio de Windows; debe ser una ruta de acceso relativa. Si no se especifica, el valor predeterminado es el directorio de Windows en la raíz del directorio de la imagen sin conexión.
Alias |
ninguno |
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
ninguno |
¿Aceptar canalización? |
True (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los siguientes parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, consulte about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet.
- System.String[]
- Microsoft.Dism.Commands.ImageObject
- Microsoft.Dism.Commands.AppxPackageObject
Salidas
El tipo de resultado es el tipo de objetos que emite el cmdlet.
- Microsoft.Dism.Commands.ImageObject
Ejemplos
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