Import-StartLayout
Import-StartLayout
Imports the layout of the Start into a mounted Windows image.
Sintaxis
Parameter Set: LiteralPath
Import-StartLayout [-LayoutLiteralPath] <String> [-MountLiteralPath] <String> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Path
Import-StartLayout [-LayoutPath] <String> [-MountPath] <String> [-InformationAction <System.Management.Automation.ActionPreference> {SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend} ] [-InformationVariable <System.String> ] [-Confirm] [-WhatIf] [ <CommonParameters>]
Descripción detallada
The Import-StartLayout cmdlet imports the specified layout of Start into a mounted Windows image. When you import a layout, it replaces the existing layout of Start. Before you use this cmdlet, mount the Windows image file to import the layout into.
You must have administrator rights to import a layout.
The Export-StartLayout cmdlet exports layouts as .xml files, and the Import-StartLayout cmdlet imports only .xml files.
Parámetros
-InformationAction<System.Management.Automation.ActionPreference>
Specifies how this cmdlet responds to an information event. Los valores aceptables para este parámetro son:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Alias |
infa |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-InformationVariable<System.String>
Specifies a variable in which to store an information event message.
Alias |
iv |
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-LayoutLiteralPath<String>
Specifies a literal path to a layout file. This parameter does not accept the wildcard character (*). If the path includes an escape character (\), enclose the string in single quotes (').
Alias |
none |
¿Necesario? |
true |
¿Posición? |
2 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-LayoutPath<String>
Specifies a path to a layout file.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
2 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-MountLiteralPath<String>
Specifies the literal path where you mounted the .wim file. This parameter does not accept the wildcard character (*). If the path includes an escape character (\), enclose the string in single quotes (').
Alias |
none |
¿Necesario? |
true |
¿Posición? |
3 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-MountPath<String>
Specifies the path where you mounted the .wim file and specifies the local appdata folder for the default user.
Alias |
none |
¿Necesario? |
true |
¿Posición? |
3 |
Valor predeterminado |
none |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Confirm
Solicita confirmación antes de ejecutar el cmdlet.
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
false |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-WhatIf
Muestra lo que sucedería si se ejecuta el cmdlet. El cmdlet no se ejecuta.
¿Necesario? |
false |
¿Posición? |
named |
Valor predeterminado |
false |
¿Aceptar la entrada de la canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_CommonParameters (https://go.microsoft.com/fwlink/p/?LinkID=113216).
Entradas
El tipo de entrada es el tipo de objetos que se pueden canalizar al cmdlet.
Salidas
El tipo de resultado es el tipo de los objetos que el cmdlet emite.
Ejemplos
Example 1: Import a layout into a Windows image
This command imports a layout of the Start screen into a Windows image.
PS C:\> Import-StartLayout -LayoutPath "Layout.xml" -MountPath "E:\MountedImage\"
Example 2: Validate the layout file and Windows image
This command validates the layout file and the Windows image by using the WhatIf parameter. Besides that parameter, the command is the same as the previous example, but this command makes no changes.
PS C:\> Import-StartLayout -LayoutPath "Layout.xml" -MountPath " E:\MountedImage\" -WhatIf