< Back
Import-StartLayout
Post
NAME
Import-StartLayout
SYNOPSIS
Imports the layout of the Start into a mounted Windows image.
SYNTAX
Import-StartLayout [-LayoutPath] <String> [-MountPath] <String> [-InformationAction {SilentlyContinue | Stop |
Continue | Inquire | Ignore | Suspend}] [-InformationVariable <System.String>] [-Confirm] [-WhatIf]
[<CommonParameters>]
Import-StartLayout [-LayoutLiteralPath] <String> [-MountLiteralPath] <String> [-InformationAction
{SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVariable <System.String>]
[-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
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.
PARAMETERS
-InformationAction [<System.Management.Automation.ActionPreference>]
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-InformationVariable [<System.String>]
Specifies a variable in which to store an information event message.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? 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 (').
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-LayoutPath <String>
Specifies a path to a layout file.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? 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 (').
Required? true
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-MountPath <String>
Specifies the path where you mounted the .wim file and specifies the local appdata folder for the default user.
Required? true
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Example 1: Import a layout into a Windows image
PS C:\\> Import-StartLayout -LayoutPath "Layout.xml" -MountPath "E:\\MountedImage\\"
This command imports a layout of the Start screen into a Windows image.
Example 2: Validate the layout file and Windows image
PS C:\\> Import-StartLayout -LayoutPath "Layout.xml" -MountPath " E:\\MountedImage\\" -WhatIf
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkID=294167
Export-StartLayout
Start Layout Cmdlets
Import-StartLayout
SYNOPSIS
Imports the layout of the Start into a mounted Windows image.
SYNTAX
Import-StartLayout [-LayoutPath] <String> [-MountPath] <String> [-InformationAction {SilentlyContinue | Stop |
Continue | Inquire | Ignore | Suspend}] [-InformationVariable <System.String>] [-Confirm] [-WhatIf]
[<CommonParameters>]
Import-StartLayout [-LayoutLiteralPath] <String> [-MountLiteralPath] <String> [-InformationAction
{SilentlyContinue | Stop | Continue | Inquire | Ignore | Suspend}] [-InformationVariable <System.String>]
[-Confirm] [-WhatIf] [<CommonParameters>]
DESCRIPTION
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.
PARAMETERS
-InformationAction [<System.Management.Automation.ActionPreference>]
Specifies how this cmdlet responds to an information event. The acceptable values for this parameter are:
-- SilentlyContinue
-- Stop
-- Continue
-- Inquire
-- Ignore
-- Suspend
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-InformationVariable [<System.String>]
Specifies a variable in which to store an information event message.
Required? false
Position? named
Default value none
Accept pipeline input? false
Accept wildcard characters? 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 (').
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-LayoutPath <String>
Specifies a path to a layout file.
Required? true
Position? 2
Default value none
Accept pipeline input? false
Accept wildcard characters? 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 (').
Required? true
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-MountPath <String>
Specifies the path where you mounted the .wim file and specifies the local appdata folder for the default user.
Required? true
Position? 3
Default value none
Accept pipeline input? false
Accept wildcard characters? false
-Confirm [<SwitchParameter>]
Prompts you for confirmation before running the cmdlet.Prompts you for confirmation before running the cmdlet.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
-WhatIf [<SwitchParameter>]
Shows what would happen if the cmdlet runs. The cmdlet is not run.Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Required? false
Position? named
Default value false
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (http://go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
Example 1: Import a layout into a Windows image
PS C:\\> Import-StartLayout -LayoutPath "Layout.xml" -MountPath "E:\\MountedImage\\"
This command imports a layout of the Start screen into a Windows image.
Example 2: Validate the layout file and Windows image
PS C:\\> Import-StartLayout -LayoutPath "Layout.xml" -MountPath " E:\\MountedImage\\" -WhatIf
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.
RELATED LINKS
Online Version: http://go.microsoft.com/fwlink/?LinkID=294167
Export-StartLayout
Start Layout Cmdlets