Import-StartLayout
Import-StartLayout
Imports the layout of the Start screen into a mounted Windows image.
Syntaxe
Parameter Set: LiteralPath
Import-StartLayout [-LayoutLiteralPath] <String> [-MountLiteralPath] <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Parameter Set: Path
Import-StartLayout [-LayoutPath] <String> [-MountPath] <String> [-Confirm] [-WhatIf] [ <CommonParameters>]
Description détaillée
The Import-StartLayout cmdlet imports the layout of the Start screen into a mounted Windows image. When you import a layout, it replaces the existing layout of the Start screen. Before you use this cmdlet, mount the Windows image file to import the layout into.
Use the Export-StartLayout cmdlet to create a .bin file, and then use this cmdlet to import that file. You must have administrator rights to import a layout.
The Export-StartLayout cmdlet also exports layouts as .xml files, but this cmdlet imports only .bin files.
Paramètres
-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 |
Obligatoire ? |
true |
Position ? |
2 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-LayoutPath<String>
Specifies a path to a layout file.
Alias |
none |
Obligatoire ? |
true |
Position ? |
2 |
Valeur par défaut |
null |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
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 |
Obligatoire ? |
true |
Position ? |
3 |
Valeur par défaut |
none |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-MountPath<String>
Specifies the path where you mounted the .wim file.
Alias |
none |
Obligatoire ? |
true |
Position ? |
3 |
Valeur par défaut |
null |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Confirm
Votre confirmation sera requise avant l’exécution de l’applet de commande.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-WhatIf
Présente les conséquences éventuelles de l’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
false |
Accepter l’entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
<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.
Sorties
Le type de sortie est le type des objets émis par l’applet de commande.
Exemples
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.bin" -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.bin" -MountPath "E:\MountedImage" -WhatIf