This section describes the Get-MDTOperatingSystemCatalog Windows PowerShell cmdlet. Run this cmdlet from a Windows PowerShell console that has the MDT PowerShell snap-in loaded. For more information on how to start a Windows PowerShell console that has the MDT PowerShell snap-in loaded, see Loading the MDT Windows PowerShell Snap-In.
Syntax
Get-MDTOperatingSystemCatalog [-ImageFile] <String> [-Index] <Int32> [<CommonParameters>]
Description
This cmdlet retrieves or creates an operating system catalog for a custom operating system image so that you can modify the corresponding unattend.xml file using Windows System Image Manager (WSIM). If no operating system catalog is available or if the existing operating system catalog is invalid or out of date, this cmdlet will generate a new operating system catalog.
Note The process of generating a new operating system catalog may take a long time as the custom operating system image must be mounted, inspected, and unmounted before the operating system catalog creation completes.
Parameters
This subsection provides information about the various parameters that can be used with the Get-MDTOperatingSystemCatalog cmdlet.
-ImageFile <String>
This parameter specifies the fully qualified path to the custom operating system image file (.wim file), including the name of the custom operating system image file.
Parameter |
Value |
Required? |
True |
Position? |
2 and Named |
Default value |
– |
Accept pipeline input? |
False |
Accept wildcard characters? |
False |
-Index <Int32>
This parameter specifies the index of the desired operating system image within the operating system image file (.wim file).
Parameter |
Value |
Required? |
True |
Position? |
3 and Named |
Default value |
– |
Accept pipeline input? |
False |
Accept wildcard characters? |
False |
<CommonParameters>
This cmdlet supports the following common parameters: Verbose, Debug, ErrorAction, ErrorVariable, OutBuffer, OutVariable, WarningAction, and WarningVariable. For more information, see the topic, “about_CommonParameters,” which you can access by typing the following command, and then pressing ENTER:
Get-Help about_CommonParameters
Outputs
This cmdlet outputs a PSObject type object that contains the path to the operating system catalog.
Example 1
Get-MDTOperatingSystemCatalog –ImageFile "DS001:\Operating Systems\Windows 8\sources\install.wim" –Index 2
Description
This example returns the operating system catalog for the operating system image at the index of 2 in the operating system image file DS001:\Operating Systems\Windows 8\sources\install.wim.
Related Topics