ContentsSysprep and Windows Media DRM Workaround for Windows 7 Windows AIK Setup and Installation Known Issues Supported installation to Windows Server 2003 with Service Pack 2 Installing multiple versions of Windows AIK Location of User State Migration Tool (USMT) documentation Installing Windows AIK in two languages on the same computer is not supported Installing a localized Windows AIK in an additional language results in an inconsistent experience Supported versions that can be installed with Windows AIK The version of .NET Framework that is provided on the Windows AIK DVD is English only Installing Windows AIK to a directory path that contains parentheses is not supported Password requirements for user accounts Running Sysprep against a Windows Tablet PC image An error might occur while running Sysprep when Windows Media Player sharing is enabled Windows System Image Manager (Windows SIM) Known Issues Use Windows SIM to create catalogs of different architecture types Component Platform Interface (CPI) Known Issues Deployment Image Servicing and Management (DISM) Known Issues Servicing Windows Preinstallation Environment (Windows PE) 2.1 Servicing and running Windows Setup from Windows PE 2.1 Servicing and running Windows Setup from Windows Server 2003 Servicing and running Windows Setup from Windows PE 1.6 (2005) Hotfix required for Windows Vista SP1 and Windows Server 2003 R2 64-bit host environments Package Manager (Pkgmgr) Known Issues Servicing fails when logging is enabled for some Windows images Windows Boot Manager compatibility Mounted images become corrupted after a Windows PE reboot Disk partitions inaccessible when booting from optical media with flat Windows PE images CreatePageFile option of the Wpeutil command may fail with existing page files Booting Windows PE from a USB Flash Drive is only supported for RAM disk images WinPE-SRT is not an available package Windows Recovery Environment (Windows RE) Known Issues View Winrecfg.exe command line help Automatically shutting down the computer by using FirstLogonCommand Help update: Suppressing the user accounts-creation page in Windows Welcome Error message: "Windows could not parse or process unattend answer file." General Windows Deployment Known Issues Error when entering Hibernation on a Windows 7-based computer Availability and Location of Language Interface Packs OSCDIMG Command-Line Options topic is incomplete. Using the troubleshooting link to direct users to your escalation page. |
June 2010 Readme Document Update
Applies to:
Information in this document, including URL and other Internet Web site references, is subject to change without notice. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property. © 2010 Microsoft Corporation. All rights reserved. BitLocker, Internet Explorer, Microsoft, Windows, Windows Media, Windows Server, Windows Vista, and Zune are trademarks of the Microsoft groups of companies. The names of actual companies and products mentioned herein may be the trademarks of their respective owners. Contents
IntroductionThis readme contains important, late-breaking information that supplements the Help documentation for the Windows® 7 release of Windows Automated Installation Kit (Windows AIK). Before installing Windows AIK, we strongly recommend that you review this readme. A set of documentation is provided with this product that includes the Windows AIK User's Guide, the User State Migration Tool User's Guide, and other documents. To view these documents after you install Windows AIK, click Start, point to All Programs, point to Microsoft Windows AIK, point to Documentation, and then click the appropriate Help file. By default, these documents are installed in the %ProgramFiles%\Windows AIK\Docs\CHMs directory. Updates to This ReadmeThis readme contains updated information for the Windows AIK and is current as of May 2010. The latest version of this readme for Windows AIK is located here (http://go.microsoft.com/fwlink/?LinkID=139690). Additional ResourcesIn addition to the tools available in Windows AIK, Microsoft provides additional tools and resources to help facilitate Windows deployment.
Critical Issues
Sysprep and Windows Media DRM Workaround for Windows 7This issue only affects Windows 7 editions with the exception of the N editions of Windows 7. In some scenarios, using the Sysprep tool will prevent playback and transfer of any Windows Media® Digital Rights Management (DRM) content on a Windows 7 computer. If you boot to Windows Welcome, configure the network as either "Work" or "Home", and then run Sysprep, your computer might be affected. This issue does not occur if you customize Windows in audit mode, or if you boot to Windows Welcome and select the "public" network. This issue prevents the following scenarios:
No data loss occurs due to this issue and users upgrading their computers from previous versions of Windows are not impacted by this issue. To determine if your Windows image is affected, open the following WMA file: http://go.microsoft.com/fwlink/?LinkID=166118 If you can play the file, your image is not affected. If you receive an error about media usage rights, use one of the following workarounds:
Windows AIK Setup and Installation Known Issues
Supported installation to Windows Server 2003 with Service Pack 2The Windows AIK installation program (StartCD.exe) lists Windows Server® 2003 with Service Pack 1 (SP1) as a supported platform. This is incorrect. Only Windows Server 2003 with Service Pack 2 is supported. Installing multiple versions of Windows AIKInstalling multiple versions of Windows AIK is not supported. You cannot install both the Windows 7 version and the Windows Vista version of Windows AIK to the same technician computer. First, you must uninstall the previous version, and then you can install the new version. You can use the 2.0 version of Windows AIK to configure and deploy the RTM version of Windows Vista with SP1, Windows 7, Windows Server 2008, and Windows Server 2008 R2. Location of User State Migration Tool (USMT) documentationThere is not a link from the Start menu to the User State Migration Tool User's Guide (Usmt.chm). The documentation for USMT is included with this release of Windows AIK and is available in %PROGRAMFILES%\Windows AIK\Docs\CHMs. Installing Windows AIK in two languages on the same computer is not supportedWindows AIK enables a subsequent installation in a different language, even if there is a pre-existing Windows AIK with another language installed. Installation of Windows AIK in multiple languages on the same computer is not supported. Installing a localized Windows AIK in an additional language results in an inconsistent experienceInstalling a localized Windows AIK in a language that is not the active operating-system language might cause the tools and the documentation to be displayed in different languages. Workaround: Install Windows AIK in the same language as the active operating system language. Supported versions that can be installed with Windows AIKWindows AIK is supported on the following versions of Windows:
Installing Windows AIK on pre-release versions of Windows 7 and Windows Vista causes the offline servicing and Windows Preinstallation Environment (Windows PE) customization components to behave unexpectedly. The version of .NET Framework that is provided on the Windows AIK DVD is English onlyTo install a localized version of the Microsoft .NET Framework, go to the Microsoft Download Center. Installing Windows AIK to a directory path that contains parentheses is not supportedFor example, \Program Files\Windows AIK (Windows7) is not a supported directory path. Windows Setup Known Issues
Password requirements for user accountsIn Windows Server 2008, Windows Server 2008 R2, and Windows Vista with Service Pack 1, the default password policy requires the creation of a complex password for all user accounts. During installation, Setup prompts you to configure a complex password. Attempting to configure a non-complex password, either manually or by using a script, such as with the Net command, will fail. When the Sysprep tool runs, it sets a blank password for the built-in administrator account. However, Sysprep clears the built-in administrator account’s password only for server editions, not for client editions. The next time the computer is started, Setup displays a prompt for a password. You can automate configuration of the password by creating an answer file to use with Sysprep that specifies a value for the Microsoft-Windows-Shell-Setup | UserAccounts | OEMs and system builders are required to retain the default password policy of their computers. However, corporate customers are permitted to change the default password policy. A corporate customer can configure a non-complex password for the built-in administrator account during an unattended installation by specifying the desired value for Microsoft-Windows-Shell-Setup | UserAccounts |
Sysprep Known IssuesRunning Sysprep against a Windows Tablet PC image[Updated July 13, 2009] After you run the Sysprep tool against a Windows Tablet PC image, you must delete the %LocalAppData%\Microsoft\InputPersonalization directory from the image.
An error might occur while running Sysprep when Windows Media Player sharing is enabled[Added May 22, 2009] The following error might be encountered when running Sysprep on a computer that has Windows Media® Player media sharing enabled: Info [0x0f0080] SYSPRP LaunchDll:Found 'drmv2clt.dll,Sysprep'; executing it Error [0x0f0082] SYSPRP LaunchDll:Failure occurred while executing 'drmv2clt.dll,Sysprep', returned error code -2147024864[gle=0x00000020] Error [0x0f0070] SYSPRP RunExternalDlls:An error occurred while running registry sysprep DLLs, halting sysprep execution. dwRet = -2147024864[gle=0x00000020] Info [0x0f004c] SYSPRP WaitThread:Exiting spawned waiting thread This error occurs because of issues with Windows Media Digital Rights Management (WMDRM). You must disable Windows Media Player media sharing before running the Sysprep tool. The Windows Media Player media-sharing feature requires individual user consent and must be enabled only by an end user. This same error might also occur if Windows Media Center is launched and configured, Intel Viiv is installed, or when certain third-party tuner-card drivers are installed. You must stop these services before running the Sysprep tool. Windows System Image Manager (Windows SIM) Known Issues
Use Windows SIM to create catalogs of different architecture typesBecause of the changes in the servicing stack in Windows Vista with SP1, Windows Server 2008, Windows 7, and Windows Server 2008 R2, Windows SIM cannot create catalog files for some Windows images of different architecture types. The following list describes the Windows SIM architecture types and catalogs that can be created for each one.
Windows SIM cannot save answer files generated from a Windows image containing an ampersand character (&) in its file pathAttempts to save an answer file with an ampersand character (&) in the Windows image file path generates an XML validation error. Workaround: Store all Windows image (.wim) files and Windows image catalog (.clg) files in directories without an ampersand (&) in the path name. Component Platform Interface (CPI) Known IssuesIf you attempt to import a package to a distribution share using a custom application that calls the Component Platform Interface (CPI), it will return an error (System.IO.FileNotFoundException). This is because a file in the servicing stack (Dpx.dll) must be in an available path to your application. Workaround: Verify that the %PROGRAM FILES%\Windows OPK\Tools\Image Manager directory is in the system path. Deployment Image Servicing and Management (DISM) Known Issues
Servicing Windows Preinstallation Environment (Windows PE) 2.1[Added May 22, 2009] You cannot use DISM to service a Windows PE 2.1 image. To service a Windows PE 2.1 image, you must install the Windows OPK or Windows AIK for Windows Vista with SP1 on a separate computer, and then use these tools to service the Windows PE 2.1 image. Servicing and running Windows Setup from Windows PE 2.1[Added May 22, 2009] Before servicing a Windows 7 image, or running Windows 7 Setup from Windows PE 2.1, you must have the MSXML optional component installed. See the corresponding Windows OPK or Windows AIK documentation for instructions on installing the MSXML optional component. Servicing and running Windows Setup from Windows Server 2003[Added May 22, 2009] Before servicing a Windows 7 image, or running Windows 7 Setup from Windows Server 2003, you must first install the correct MSXML 6 binary files (Msxml6.dll and Msxml6r.dll) on your system. These binary files must be installed from the Windows 7 OPK or Windows 7 AIK media. Servicing and running Windows Setup from Windows PE 1.6 (2005)[Added May 22, 2009] Before servicing a Windows 7 image, or running Windows 7 Setup from Windows PE 1.6 (2005), you must first install the correct MSXML 6 binary files (Msxml6.dll and Msxml6R.dll) on your full Windows Server 2003 operating system of the same architecture. MSXML is available with this release of the Windows AIK. After you install the correct MSXML 6 binaries, you can then install them to Windows PE 1.6 by copying them from your Windows Server 2003 installation. You do this by copying all Msxml6*.dll binary files from %Windir%\System32 into the Windows PE 2005 %Windir%\System32 directory of the same architecture.
Hotfix required for Windows Vista SP1 and Windows Server 2003 R2 64-bit host environmentsBefore using the DISM command with the /Add-Package, /Enable-Feature, or /Disable-Feature options from a 64-bit Windows Vista with SP1 host, Windows Server 2008 RTM, or Windows Server 2003 R2 host, you must install a hotfix. To service a Windows 7 image from the host environment, you must install hotfix KB960037 on the host computer. The hotfix is available on the Windows OPK and Windows AIK media, in the hotfix <%Mediaroot%>\HotFix directory in one of the following locations:
Double-click the appropriate .exe file to install the hotfix. Package Manager (Pkgmgr) Known Issues
Servicing fails when logging is enabled for some Windows imagesServicing a Windows Vista® with Service Pack 1 (SP1) or more recent Windows image on a computer running Windows Server 2003 with Service Pack 2 will fail when logging is enabled.To disable logging, do not use the /l option in the Package Manager command-line syntax. Windows PE Known Issues
Windows Boot Manager compatibilityPrevious versions of Windows Boot Manager (Bootmgr and Bootmgfw.efi) are not compatible with later versions of Windows. However, all versions of the Windows Boot Manager are backward-compatible. To avoid complications during the boot process, such as with dual-boot systems, use the version of Windows Boot Manager that matches the latest version of Windows you are installing. For more information on BCDboot.exe command-line options, and for information on how to deploy the Windows 7 Boot Manager, see the Windows AIK User's Guide. Mounted images become corrupted after a Windows PE rebootIf you mount an image during a Windows PE session and the computer reboots, the mounted directory becomes corrupt. The ImageX/Cleanup command is not supported. Use the ImageX/Unmount command to unmount the corrupted directory, and then remount the image. Disk partitions inaccessible when booting from optical media with flat Windows PE imagesWhen booting from a flat Windows PE image on optical media, no disk partitions are reported. This is because the NTFS service is not launched. Workaround: Run CreatePageFile option of the Wpeutil command may fail with existing page filesIf a page file exists, the /CreatePageFile option must be set equal to or greater than the current size of the page file or the command will fail. Booting Windows PE from a USB Flash Drive is only supported for RAM disk images[Added May 2010] Windows PE does not support a standalone installation from a USB flash drive. To boot Windows PE from a USB flash drive, create a bootable Windows PE RAM disk. For more information, see the topic "Walkthrough: Create a Bootable Windows PE RAM Disk on a USB Flash Disk" in the Windows AIK documentation. WinPE-SRT is not an available package[Added May 2010] In the topic "Building a Windows PE Image", the package WinPE-SRT is listed as an optional package. This package is not available in the Windows Automated Installation Kit. Windows Recovery Environment (Windows RE) Known Issues
View Winrecfg.exe command line help[Added July 13, 2009] To view the command line help for Winrecfg.exe, you must use both the /? argument and /target offline_image argument where offline_image is the path to the Windows image. For example: winrecfg.exe /? /target c:\Windows. Unattended Setup Known Issues
Automatically shutting down the computer by using FirstLogonCommand[Added July 13, 2009] You might experience problems automatically shutting down the computer by using FirstLogonCommands. Windows continues to process features and settings while a user is logged on to the computer and the processing time varies depending on the hardware configuration. If the computer shuts down while Windows features are still being processed, you might experience unexpected behavior. In some cases, user profile folders or libraries might not be properly created. Windows Backup and other applications might rely on these user profile settings being configured. Workaround: Test the Windows features you intend to use. If you experience problems with the user account, use the /t option to add a delay to the shutdown command. For example, to add 60 seconds before the shutdown command executes, use the following command: shutdown -r -t 60. Help update: Suppressing the user accounts-creation page in Windows WelcomeThe user accounts-creation page in Windows Welcome is suppressed if a user or a group is added to a local security group. Add a user or a group to a local security group by doing one of the following:
To suppress the user accounts-creation page in Windows Welcome, without creating a local user, use one of the following workarounds: Workaround 1 If the computer is already joined to a domain, use the following XML example to add the Domain Users security group to the Local Users security group. <DomainAccounts> <DomainAccountList wcm:action="add"> <DomainAccount wcm:action="add"> <Group>Users</Group> <Name>Domain Users</Name> </DomainAccount> <Domain>FabrikamDomain</Domain> </DomainAccountList> </DomainAccounts> Because joining a domain automatically adds the Domain Users security group to the Local Users security group, the DomainAccounts command does not affect the membership of the Local Users group. However, using this XML example to join a domain will also suppress the user accounts-creation page in Windows Welcome. Workaround 2 Use the Sysprep/Quit command to set the following registry value to 1: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Setup\OOBE\UnattendCreatedUser Error message: "Windows could not parse or process unattend answer file."If there is an error in your answer file, such as a typo, you might receive the following error message: "Windows could not parse or process unattend answer C:\Windows\Panther\Unattend.xml for <configuration pass>. The settings specified in the answer file cannot be applied. The error was detected when processing settings for <component name>." This error message does not appear until you have installed Windows to a destination computer and booted the computer. To correct this, you must overwrite the answer file in the reference image with a corrected answer file. Then, you can deploy the reference image again. To update the answer file in your reference image
General Windows Deployment Known Issues
Error when entering Hibernation on a Windows 7-based computer[Added October 22, 2009] On computers with disk capacity greater than 16 gigabytes, corporations may want to increase the size allotted to the Hiberfil.sys file. For more information, see this Microsoft Web site. Availability and Location of Language Interface Packs[Added May, 2010] Not all Language Interface Packs (LIPs) are currently available for Windows 7. For information about the latest available LIPs, see the Local Language Program. OEMs and System Builders with Microsoft Software License Terms can get the LIPs from the Microsoft OEM site and OEM Partner Center. OSCDIMG Command-Line Options topic is incomplete.[Added May, 2010] For a full list of available command-line options for the OSCDIMG tool, use the oscdimg -help <category> command, where <category> is one of the following categories:
Help & Support Known Issues
Using the troubleshooting link to direct users to your escalation page.[Added July 13, 2009] After you customize your escalation page in Help and Support, to make sure that this link goes to the customized page, you can modify the Troubleshooting link to point to: mshelp://help/?id=escalation. You may use the link to point to an external Web site instead. For more information, see the topic Microsoft-Windows-DiagCpl in the Windows® Unattended Setup Reference. |