Skip to content

PowerShell Deployment - Latest Release Setup Guide.md

Latest commit

 

History

History
131 lines (79 loc) · 4.36 KB

PowerShell Deployment - Latest Release Setup Guide.md

File metadata and controls

131 lines (79 loc) · 4.36 KB

Setting Up PSD 2.30

Table of Contents

  1. Introduction
  2. Prerequisites
  3. Upgrade Process
  4. Editing Configuration Files
  5. Final Steps
  6. Troubleshooting

Introduction

This guide provides step-by-step instructions for setting up the new release of PSD 2.30, including the upgrade process and editing the necessary configuration files.

Prerequisites

  • Ensure you have administrative access to the system.

Upgrade Process

Backup Existing Configuration

  1. Navigate to the directory containing your current PSD installation.
  2. Go to the Control folder
  3. Create a backup of the existing configuration files:
    • CustomSettings.ini
    • Bootstrap.ini

NOTE: The Install-PSD with upgrade switch will backup these files plus several others to the Backup directory (eg. PSD_0001)

Download PSD 2.30

  1. Visit the official PSD github page: https://github.com/FriendsOfMDT/PSD
  2. Download the latest release of PSD 2.30.
    • Click the green [<> Code] button, Select Download Zip

Install PSD 2.30

  1. Extract the downloaded files to your desired directory.
  2. Open PowerShell as an Administrator and run the step provide here: Installation Guide

Review PSD Install

One of the common things skipped is reviewing the Install-PSD.log file. This is important as some files may not have been overwritten.

Here are a few checks to be sure you have the latest release installed:

  1. Check these files to ensure they have been updated:

    • Scripts\ZTIGather.xml
    • Tools\Modules\PSDGather\ZTIGather.xml
    • Tools\Modules\PSDWizardNew\PSDWizardNew.psm1

  2. Check to make sure these folder exist

    • Scripts\PSDWizardNew\Themes\Classic
    • Scripts\PSDWizardNew\Themes\Dark

    NOTE: you can delete the other folders unless you are using those themes.

  3. Check to make sure these files exist:

    • PSDResources\Readiness\Computer_Readiness.ps1

    NOTE this file contains basic functions and is required unless you disable the Readiness Check: SkipReadinessCheck=YES

Editing Configuration Files

If this is a new installation, all the items are setup for you and ready to go. However, on an upgrade installation, several things must be done to support the new PSD release

CustomSettings.ini

  1. Ensure Control\CustomSettings.ini is backed up

  2. Open Control\CustomSettings.ini in a text editor.

  3. Overwrite [Settings] and [Default] sections with this one: INIFiles/CustomSettings.ini

WHY? There are several new items added and we want to make sure you get the best experience. Also if a PSD variable exists, it won't be processed

  1. Update the necessary settings the related to your deployment share. Things like:

    • Priority
    • YOUR custom properties (not related to PSD)
    • Additional Sections

  2. If no Application001 or MandatoryApplications001 exist, add a real or dummy one

APPLICATIONS001={d7f2f50a-e85f-425e-a2f7-68392b1f31a6}

WHY? This is known bug. Applications selected in UI won't install otherwise

  1. Edit any skips if desired

  2. Save and close the file.

Bootstrap.ini

  1. Ensure Control\Bootstrap.ini is backed up

  2. Open Control\Bootstrap.ini in a text editor.

  3. Overwrite [Settings] and [Default] sections with this one: INIFiles/Bootstrap.ini

WHY? There are several new items added and we want to make sure you get the best experience. Also if a PSD variable exists, it won't be processed

  1. Ensure PSDDeployRoots reflects your deployment share url.

  2. Edit any skips if desired

  3. Save and close the file.

PSDUpdateExit.ps1

If you have added content to this file, you must add it back.

Final Steps

Update the Deployment share and select to build new ISO.

Troubleshooting

If you encounter any issues, refer to the official PSD documentation or open an issue