Skip to content

Latest commit

 

History

History
241 lines (212 loc) · 9.58 KB

File metadata and controls

241 lines (212 loc) · 9.58 KB

Frequent Asked Questions - PowerShell Deployment Extension Kit

This document highlights and captures some of the known issues and limitations of PSD (as of the published date above).

Frequently Asked Questions

Q: Does the installer copy over my existing MDT Deployment Share content (e.g. applications, drivers, task sequences, etc) to a new PSD share?

A: No, users and administrators will need to copy/export any existing components to new PSD shares using in-built content management features of MDT. MDT Shares which have been PSD upgraded will continue to have access to any existing object and artifacts.

Q: Can the installer (PSD_Install.ps1) be executed remotely?

A: No, PSD_Install.ps1 must be run locally with administrative rights on the target/intended MDT installation.

Q: Does the installer copy over my existing BootStrap.ini or CustomSettings.ini files to the target PSD repositories?

A: No, if you've created a new PSD-enabled deployment share, users and administrators will need to manually copy or reproduce any existing Bootstrap and CustomSettings files to new repositories.

Q: What are the client/target hardware requirements for baremetal PSD deployments?

A: PSD requires roughly the same hardware as is required for Windows 10 and MDT deployments:

  • At least 1.5GB RAM (WinPE has been extended and requires additional memory)
  • At least one (1) network adapter(s)
  • At least one (1) 50GB hard drive (for New/BareMetal deployments)
  • At least one (1) XXX MHz processor (for New/BareMetal deployments)

Q: Are system clocks synchronized?

A: Yes, PSDStart.ps1 will attempt to synchronize the time are deployment target computers. Deployment Roots servers and or the HTTP/S target servers will be NTP synchronized.

Q: Does PSD work with 2Pint's OSD Toolkit?

A: Yes: See the BranchCache installation guide

Q: Why does the PowerShell window appear to flash and then change size?

A: The default window is resized by PSDStart by design. You should observe it to change from full screen to roughly one third the screen early in the boot/start process. This is again by design.

Q: What is "Transcript Logging"?

A: Logs (for example PSD.LOG, and BDD.log) are what we explicitly write, Transcript logs captures everything that happens on the screen. PSD Transcript logs are much better suited and useful for troubleshooting, but may be visually "sub-optimal".

Q: What do I see frequent references to "Stopping Transcript Logging"?

A: (TBA MiNy)

Q: Do I still need to 'add' PowerShell support to my WinPE images?

A: No, the PSD installation and scripting takes care of it for you. As a matter of fact, unticking the box on the WinPE Features tab will not affect PSD at all.

Q: Will PSD work on my xxx version of MDT or ADK?

A: We've only developed and tested against the versions and platforms listed below. If you have success on additional versions and platforms, please be sure and let us know!

Q: Do I need to add PowerShell to my boot media images?

A: NO, PSD and MDT automatically handle this for you. By default LiteTouchPE.XML automatically injects PowerShell into Boot Media (despite what may or may not be configured in the MDT WinPE tab)

Q: Which MDT components are copied or injected into the PSD Boot Media?

A: As defined by LiteTouchPE.XML, the following files are injected into MDT and PSD boot media by default:

  • winpe-dismcmdlets
  • winpe-enhancedstorage
  • winpe-fmapi
  • winpe-hta
  • winpe-netfx
  • winpe-powershell
  • winpe-scripting
  • winpe-securebootcmdlets
  • winpe-securestartup
  • winpe-storagewmi
  • winpe-wmi

Q: What files and or components are copied or injected into the PSD-enabled Boot Media?

A: As defined by LiteTouchPE.XML, the following files are injected into MDT and PSD boot media by default:

COMPONENTS TOOLS CONFIG
winpe-hta
winpe-scripting
winpe-wmi
winpe-securestartup
winpe-fmapi
winpe-netfx
winpe-powershell
winpe-dismcmdlets
winpe-storagewmi
winpe-enhancedstorage
winpe-securebootcmdlets
BDDRUN.exe
WinRERUN.exe
CcmCore.dll
CcmUtilLib.dll
Smsboot.exe
SmsCore.dll
TsCore.dll
TSEnv.exe
TsManager.exe
TsmBootstrap.exe
TsMessaging.dll
TsmBootstrap.exe
TsProgressUI.exe
TSResNlc.dll
CommonUtils.dll
ccmgencert.dll
msvcp120.dll
msvcr120.dll
00000409\tsres.dll
Microsoft.BDD.Utility.dll
Bootstrap.ini
Unattend.xml
winpeshl.ini
MODULES
SCRIPTS
PSDUtility.psm1
PSDGather.psm1
PSDWizard.psm1

PSDWizardNew.psm1
PSDDeploymentShare.psm1
ZTIGather.xml
Interop.TSCore.dll
Microsoft.BDD.TaskSequenceModule.dll
Microsoft.BDD.TaskSequenceModule.psd
PSDStart.ps1
PSDHelper.ps1

Q: What scripts or files can be safely deleted from my PSD Deployment Share?

A: This is still being refined and defined. For now:

  • Do NOT delete any PSD*.ps1 or PSD*.psm1 files.
  • Do NOT delete ZTIGather.xml or ZTIConfigure.xml
  • If installing applications as part of the task sequence, do not delete ZTIUtility.vbs as it might be called during the deployment.
  • If desired, many of the legacy MDT .wsf scripts and Wizard files can be removed manually from the PSD Deployment Share scripts folder to thin out the environment.

Documented Platforms and Scenarios

Q: What operating systems and components has PSD been tested and or evaluated against?

A: The following tables identifies tested and validated components, scenarios as well as testing and development status:

Component Version Notes
MDT 6.3.8456.1000 - (8456)
ADK 10.1.16299 - (1709)
10.1.17763.1 - (1809)
MDT WinPE addon 10.1.17763.1 - (1809)
Target client OS Windows 10 ENT x64 EN 1809
Windows 10 ENT x64 EN 1709
MSDN media tested
IIS
WebDAV
PXE
BareMetal via UNC n/a Tested and working
BareMetal via HTTP n/a Tested and working
BareMetal via HTTPS n/a not yet tested
Host Server OS Windows Server 2016 ENT
Virtual Machines Microsoft Hyper-V Client deployments tested against Hyper-V.
MDT/PSD tested hosted on Hyper-V
Refresh via UNC n/a not yet implemented
Refresh via HTTP n/a not yet implemented
Refresh via HTTPS n/a not yet implemented
Replace via UNC n/a not yet implemented
Replace via HTTP n/a not yet implemented
Replace via HTTPS n/a not yet implemented
BIOS-to-UEFI via UNC n/a not yet implemented
BIOS-to-UEFI  via HTTP n/a not yet implemented
BIOS-to-UEFI via HTTPS n/a not yet implemented
Generic, non-OSD TS via UNC n/a not yet implemented
Generic, non-OSD TS via HTTP n/a not yet implemented
Generic, non-OSD TS via HTTPS n/a not yet implemented

Installation Observations

  • The PSD installer will create the -psDeploymentShare name exactly as specified. The PSD installer does NOT handle or change the hidden share ($) character in any form or fashion.

  • The PSD installer should automatically mount a new PSD-created deployment share repository. Users may need to refresh the workbench or manually mount newly created PSD deployment shares.

  • The PSD installer does NOT automatically copy over any existing MDT artifacts and components to a new PSD-created deployment share repositories. Users will need to manually copy over, re-import or instantiate applications, drivers, etc.

Operational Observations

Please review the PSD Installation Guide for additional detailed post-installation configuration recommendations.

  • Applications specified in task sequences BootStrap.ini or CustomSettings.ini MUST have { } brackets around their GUID
  • New TS variables must be declared explicitly in BootStrap.ini or CustomSettings.ini
  • You many notice that during the Post OS install phases of the PSD Task Sequence (OOBE) that the screen briefly flashes a window and the PowerShell window appears to refresh. This is expected when a script is executed.