Versions Compared

Old Version 17

changes.mady.by.user Leigh Jones

Saved on

compared with

New Version Current

changes.mady.by.user Leigh Jones

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Toolshed ezdeploy is able to output a Windows Provisioning Package (file extension .PPKG) which is a small archive that contains Windows Setup instructions that can be processed automatically during the Windows OOBE (out-of-box experience) phase. When the OS boots up for the first time, it will check removable USB storage for a valid PPKG file and process the first one that it finds. You can also double-click a PPKG from a computer that has already been through OOBE, but the primary use case for PPKG is to

The Toolshed ezdeploy OneTouch PPKG file contains a few instructions for the OS to skip the normal “Hi. Welcome to Windows…” bootup sequence, and instead it will automatically create a local administrator account with your desired password, optionally connect to an SSID, optionally do a Windows Refresh procedure, and then proceed to install the EZDeploy ezdeploy service (a Windows service). EZDeploy ezdeploy service will then install a predetermined RMM Agent and schedule your Configuration Profile.

Info

  • The OneTouch deployment package must be left in the portal in order to use the ppkg after downloading. The ppkg will fail if the corresponding OneTouch Deployment no longer present in the MSP Toolshed ezdeploy Portal.

  • Changes to the OneTouch Deployment itself does require a re-download of the ppkg for distribution.

  • Changes to the Configuration Profile included in a OneTouch Deployment do not require a re-download of the ppkg for distribution.

...

New

Select to create a new OneTouch Deployment

Edit

Select an existing OneTouchDeployment- then click Edit to make changes.

Duplicate

Select an existing OneTouchDeployment - then click Duplicate to create a copy which will default to “OneTouchName “OneTouch Name - Copy” as OneTouchNameOneTouch Name.

Delete

Select an existing OneTouch Deployment - then click Delete. You will be prompted to confirm deletion.

Generate

Select an existing OneTouch Deployment then click Generate. You will be prompted to save the ppkg file once the generation has completed.

Show Column Chooser

Selecting allows you to choose which columns to display. Example 6 of the 10 available columns are displayed.

Image RemovedImage Added

Filter Row

This allows you to search/filter based on the available column data. Text can be typed in the Name, Description, Modified By and Created By columns. Client, Location, Configuration Profile and WiFi Enabled columns have a Dropdown Selector. Modified On and Created On columns have a Date Selector.

Image RemovedImage Added

 

OneTouch Deployments Usage

Once you select New from the menu bar - you will be presented with the following form to populate.

...

Deployment Information

Name

Enter name for the OneTouch deployment package

Description

Enter description (optional)

Configuration Profile

Select desired Configuration Profile from dropdown selector

Clean PC

Disabled by default. Click checkbox to toggled to Enabled.
When enabled the OneTouch Deployment will perform a reset of Windows 10/11 with the “remove user data” option.

Note Microsoft indicates CleanPC CSP is supported in Windows 10/11, Enterprise and Education versions editions only.

Local Admin Username

Enter local admin username to be created. This account will remain after deployment is completed.

Local Admin Password

Enter password to use for local admin

Confirm Password

Confirm password to use for local admin

...

Deployment Encryption

Password

Enter encryption password for package - you will be prompted to enter when the ppkg is used. Enabled by default.

Confirm Password

Confirm encryption password for packed.

...

  1. Once you have populated the form - click Save OneTouch button and confirm.

    Image Added

  2. Now the OneTouch Deployment is listed - select row then click Generate to get the ppkg file.

    Image RemovedImage Added

  3. You will see package being generated and once completed you will be prompted where to save file and what filename to use (defaults to the package Name)

    Image RemovedImage RemovedImage Added

    Image Added

  4. You can edit an existing OneTouch at any time by selecting the row and choosing Edit from menu bar.

    Image RemovedImage Added

  5. Note if you make changes to settings within the OneTouch other than the Configuration Profile - you will need to generate a fresh copy of the ppkg.

    You can make as many changes within the Configuration Profile, the Naming Rules and script items used without generating a new ppkg file. During the deployment the Configuration Profile is fetched to get the current instruction set to process.

Deployment Sequence

  1. Boot from USB containing your ppkg. The Windows OOBE (out-of-box experience) will bring you to the region selection screen. You will hit the Windows key 5 times to proceed to next menu.

    Image Added

  2. Select Install provisioning package and click continue

    Image Added

  3. Enter you password for the package then click OK

    Image Added

  4. Windows will display Setting up your PC screen next

    Image Added

  5. Once the initial provisioning steps are completed, local admin account created and the ezdservice service installed and begins the post-provisioning portion of the deployment. Your Build Notice title will display on the next screen

    Image Added

  6. Once configuration profile items start processing you will see both your Build Notice Title and Notice Message displayed on this screen - click OK.

    Image Added

  7. As mentioned you can logon but the build notices will not be removed until the completion of the entire deployment.