Edit

Export-StartLayout

  • Reference
Module:
StartScreen

Exports the layout of the Start screen.

Syntax

Export-StartLayout
      [[-As] <AsFileType>]
      [-Path] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
Export-StartLayout
      [[-As] <AsFileType>]
      [-LiteralPath] <String>
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

The Export-StartLayout cmdlet exports the layout of the Start screen of the current user. You can export layout as an .xml file to verify the layout, or you can export layout as a .bin file to modify the layout of an existing Windows image. Specify the appropriate file name extension, .bin or .xml, in the name of the file. To modify the layout of a Windows image, export the layout as a .bin file, and then import it into a Windows image by using the Import-StartLayout cmdlet.

Examples

Example 1: Export the layout as a .bin file

PS C:\> Export-StartLayout -Path "C:\Layouts\Marketing.bin" -As BIN

This command exports the layout of the Start screen to a file named Marketing.bin in the C:\Layouts folder. The command specifies a value of BIN for the As parameter, so the cmdlet creates a .bin file.

Parameters

-As

Specifies a file type to export. The acceptable values for this parameter are:

  • BIN. Export as a .bin file.
  • XML. Export as an .xml file.

The default value is BIN.

Type:AsFileType
Position:1
Default value:BIN
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LiteralPath

Specifies a literal path to a layout file. Include the file name extension, .bin or .xml. This parameter does not accept the wildcard character (*). If the path includes an escape character (\), enclose the string in single quotes (').

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-Path

Specifies an absolute path to a layout file. Include the file name extension, .bin or .xml.

Type:String
Position:1
Default value:Current Location
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Enum

You can specify the following file formats:

  • BIN. Export as a .bin file.
  • XML. Export as an .xml file.