forked from PSAppDeployToolkit/PSAppDeployToolkit
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathCHANGELOG.txt
531 lines (496 loc) · 47.5 KB
/
CHANGELOG.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
Version 3.6.9 [02/xx/2016]
Added IncludeUpdatesAndHotfixes Parameter to Execute-MSI and Remove-MSI functions
Fixed issue in Test-MSUpdate which returned a false positive when searching for an installed update
Fixed typo in Get-HardwarePlatform function
Fixed issue in Set-RegistryKey where registry keys with forward slashes were treated like backslahes and broken up into subkeys
Fixed issue in Remove-RegistryKey function where it failed to delete the (Default) value when specified due to limitation of Remove-ChildItem cmdlet
Fixed issue in New-Shortcut to use Rename-Item parameter name that is compatible with PS 2.0
Improved comments and documentation
Version 3.6.8 [02/06/2016]
Added environment variables with additions for Pictures, Templates, and Common User locations
Added SecureParameters parameter to Execute-MSI and Execute-Process functions
Added language translations for Slovak, Hungarian and also updated translations for German
Added ParentProcessId property to Get-WindowTitle
Fixed issue in Remove-File where deleting of multiple files would stop silently on first error and added LiteralPath parameter
Fixed issue in the Uninstall Office 2013 Deploy-Application example where an incorrect variable was referenced to determine if a user session was present for the script execution
Fixed issue in Test-MSUpdates where a fatal error occured when no update history is present on the target system
Fixed issue in Install-MSUpdates where the full path to the update file was not passed to Execute-Process for installation
Fixed issue where Get-InstalledApplication throws an error when attempting to import invalid registry values from the subkeys of the Uninstall key
Fixed formatting of window title name when showing the blocked app dialog window or the restart computer window
Fixed issue in Test-PowerPoint where detection did not work if there were multiple screens or if presentation was on screen without mouse focus
Fixed issue in Get-RegistryKey where reading an empty value or a DWord value of 0 caused function to return $null
Fixed issue in Set-DeferHistory where function did now log $deferTimesRemaining and referenced an incorrect variable name instead
Fixed issue in Get-HardwarePlatform where function did not detect Microsoft Surface hardware correctly
Fixed issue in Remove-MSIApplications to make sure that an invalid ProductCode is not passed to the Execute-MSI function
Improved toolkit so that asynchronous executions of the toolkit write to the same log file instead of creating a new one
Improved Get-InstalledApplication to verify ProductCode is valid product code before storing value, also added UninstallSubkey property
Improved toolkit to allow setting custom $InstallTitle and $InstallName in Deploy-Applicatio
Improved temporary logging folder naming convention to include deployment type in the name
Improved Office example script by updating Offscrub13.vbs to latest version from Microsoft, fixes issue with completion notice
Improved error handling in the Get-InstalledApplication function
Improved error handling in the Test-MSUpdates function
Improved Execute-MSI so that environment variables created by MSIs are always updated for Windows Explorer
Improved Execute-Process function to capture out of range exit codes and return custom 60013 exit code
Improved Remove-RegistryKey function to write warning instead of error to log if a property being deleted does not exist
Improved Get-PendingReboot function to check if "ROOT\CCM\ClientSDK\CCM_ClientUtilities" WMI class exists before executing method
Improved Show-BalloonTip function to suppress balloon notifications if a PowerPoint presentation is in fullscreen slideshow mode or presentation mode
Improved comments and documentation
Version 3.6.7 [09/22/2015]
Fixed Write-Log issue introduced in v3.6.6 that created malformed CMTrace type log files
Improved documentation to add section on how to use zero-config MSI install option
Version 3.6.6 [09/21/2015]
Added error handling for Remove-RegistryKey function when used on key with child keys and -Recurse parameter not used to avoid script hanging
Added ability in Remove-MSIApplications to filter the list of results returned by Get-InstalledApplication to only those that should be uninstalled
Fixed issue with Set-ServiceStartMode where setting the service to Automatic will set it to Automatic (Delayed Start)
Fixed issue introduced in v3.6.5 where blocked application dialog did not display for blocked applications
Fixed issue with $appRevision being appended to $installName if not defined
Fixed issue in Show-InstallationPrompt with $installName being passed instead of $Title for -ReferringApplication parameter when -NoWait option specified
Fixed issue in Test-MSUpdates where information about the discovered KBArticle was not being converted to readable text before being logged
Fixed issue with detecting UI language by removing faulty detection method for Windows 8
Fixed issue in Block-AppExecution by removing illegal characters such as "&" from the arguments string of the XML file before importing it
Fixed issue in Get-InstalledApplication where invalid data in the registry could terminate enumeration of the registry
Fixed issue with compiling scripts to EXE by removing support for alternative PowerShell hosts from AppDeployToolkitMain.ps1 file
Fixed typo in config XML file for Swedish language message for 'ClosePrompt_CountdownMessage'
Fixed issue in Show-InstallationWelcome where $notesPath was not defined before it was used
Fixed issue in Show-InstallationWelcome where all process names were not enumerated on PS2.0 when trying to close notes processes
Changed message update priority, to increase it, from 'Normal' to 'Send' in Show-InstallationProgress (should hopefully address reports that messages do not display on screen on time)
Changed Set-Acl and Get-Acl -LiteralPath parameter to -Path in function New-ZipFile as -LiteralPath is not available in PS 2.0
Changed $global: variables to $script: variables as these two scopes are the same in the context of the powershell console that executes the script
Improved registry functions to throw error if registry hive not specified
Improved comments and documentation
Version 3.6.5 [08/17/2015]
Added function New-MsiTransform to allow creation of transform files for MSI databases. Supporting functions: Set-MsiProperty, Invoke-ObjectMethod, Get-ObjectProperty.
Added ability in Remove-MSIApplications to exclude software from being uninstalled by matching against specified property/value/match-type pairs
Added function Get-PendingReboot to get pending reboot status for the local computer (thanks to user 'That-Annoying-Guy' for the original code)
Added function Test-RegistryValue to check for the existence of a registry value, needed to support Get-PendingReboot function
Added ability to install MSP files as part of a zero-config MSI install
Added ability to Get-MsiTableProperty to apply a list of transform files to an MSI database after opening it. Also added ability to read properties from MSP files. Also added -GetSummaryInformation parameter to allow reading of Summary Information from a Windows Installer database file.
Added support for retrieving $MyInvocationInfo when using alternative PowerShell hosts such as with Sapien PowerShell compiled EXEs
Added following variables: $currentDateTime, $envLogicalDrives, $envUserCookies, $envUserDesktop, $envUserFavorites, $envUserInternetCache, $envUserInternetHistory, $envUserMyDocuments, $envUserSendTo, $envUserStartMenu, $envUserStartMenuPrograms, $envUserStartUp, $envSystem32Directory
Added function New-ZipFile to allow creating zip archives, cleaned up the code for zipping the log folder from the Exit-Script function
Fixed issue with Get-WindowTitle which caused the -PromptToSave functionality in Show-InstallationWelcome to fail on Win 7 PowerShell 2.0 machines
Fixed issue with Show-WelcomePrompt which caused the -TopMost $false option to not work (also affected Show-InstallationWelcome)
Fixed issue introduced in v3.6.3 where Norwegian language code in config XML was changed to NO. Code reverted back to NB as this is the proper code for the Bokmål written language supported by Windows.
Fixed issue introduced in v3.6.4 by adding back a double quote to the .vbs file generated by Execute-ProcessAsUser (initial reported issue was caused by bad code in the example which has been fixed)
Fixed issue in Refresh-Desktop which caused refreshing the global process environment block to fail
Fixed issue in Test-MSUpdates where updates that had been uninstalled were detected as installed by the Office updates detection method
Fixed issue with detecting user's display UI on XP from registry key 'HKCU\Control Panel\International\Locale', and fixed type in one of the other registry paths checked
Fixed issue in Set-ActiveSetup so that HKCU active setup registry keys are created when stubpath is executed for currently logged in user so that it does not execute a second time when user logs into account
Fixed issue with New-Folder function displaying console output
Fixed issue with Get-MsiTableProperty where reading the property table for a second MSI would throw an error unless -Force parameter specified
Fixed issue with the zip compressed log files only being accessible to elevated users
Fixed issue with Show-InstallationRestartPrompt where the PSADT restart prompt prevented a manual user initiated Windows Shutdown from being executed
Fixed issue with Show-InstallationPrompt and Show-InstallationRestartPrompt where the dialog would be displayed in Silent Mode
Fixed issue in Get-InstalledApplication where -ErrorAction could prematurely stop function if permissions issue while enumerating registry keys
Fixed issue with Invoke-HKCURegistrySettingsForAllUsers where registry profiles would fail to unload
Fixed issue where the final (asynchronous) balloon tip would not display
Fixed issue with Zero-Config MSI installations not being able to handle MST files
Fixed issue with Get-MsiTableProperty where handle to MSI database file was not released by powershell.exe after reading properties
Fixed issue with Close-InstallationProgress where $global:ProgressRunspace was not closed
Fixed issue where the toolkit would terminate in session zero due to absence of user domain variable
Changed 5000 exit code for "InstallationDefer_ExitCode" in config XML to 60012 to be in line with newly defined exit code ranges for the toolkit
Changed Deploy-Application.ps1 to allow exiting with custom exit code if failure to parse toolkit
Changed registry manipulation functions to use -LiteralPath instead of -Path because * and ? are rare but valid characters for registry names
Changed Show-InstallationWelcome and Show-WelcomePrompt to allow display of custom message from XML by using -CustomMessage parameter. Also added -ForceCountdown to allow us to have a countdown timer with the defer option on the welcome screen.
Changed variable $envTemp to use recommended method of retrieving temp folder path
Improved Exit-Script so that it is possible to manually exit the script with a 3010 or 1641 exit code and trigger an SCCM "Soft Reboot"
Improved comments and documentation
Version 3.6.4 [05/19/2015]
Fixed issue with detecting user's display UI when enforced by Group Policy, fixed typo in one of the registry paths
Fixed issue with extra double quote at end of VBScript command in function Execute-ProcessAsUser (caused issue in Set-ActiveSetup as well)
Fixed issue with Enable-TerminalServerInstallMode and Disable-TerminalServerInstallMode expecting a successful execution of change.exe to return 0 when it should really be 1
Fixed issue with Execute-MSI so that Get-MsiTableProperty is only called when the file being executed is an MSI and not when it is an MSP
Fixed issue in Invoke-HKCURegistrySettingsForAllUsers where a registry hive would fail to unload because of an active memory reference by manually invoking garbage collection
Fixed issue where registry key for deferrals was not being set correctly
Fixed issue in Show-InstallationWelcome where blocking "notes" would stop script execution
Fixed issue where System.Threading.Mutex class does not have Dispose() method prior to .NET 3.5 so will call Close() method instead. This also fixed issue with blocked app message not showing on Win 7 .NET 2.
Changed StubPath registry type to 'String' in Set-ActiveSetup
Improved comments and documentation
Version 3.6.3 [04/29/2015]
Added an informational tooltip to the 'Continue' button on the close apps screen to make it clear that it can only be used after closing the listed applications
Added -PendingStatusWait as a configurable option to functions Start-ServiceAndDependencies and Stop-ServiceAndDependencies
Added translations for following languages to config XML: Arabic, Hebrew, Korean, Portuguese (Brazil), Russian, Chinese (Traditional), Chinese (Simplified)
Fixed issue with Get-ScheduledTask not working properly with non-English languages
Fixed issue with Write-Log throwing error on Windows 7 when discovering script source under certain conditions
Fixed issue with Get-RunningProcesses on Windows 7 where the custom object did not return ProcessDescription property unless -PassThru option was used
Fixed issue with the creation of the blocked apps cleanup scheduled task to avoid 259 character limit for the 'Command' property
Fixed issue where a file remnant from an old version of the toolkit caused failure in ability to copy toolkit to temporary folder defined in config XML
Fixed issue with Set-ActiveSetup where StubExePath was a mandatory parameter when purging active setup entry
Fixed issue in config XML where two letter ISO language code for Norwegian was defined as NB instead of NO
Fixed issue in Write-Log where hashtable is storing $LogfilePath instead of $LogFileName for LogfileName property when archiving logs
Changed icon for Deploy-Application.exe
Improved Get-LoggedOnUser by increasing performance. Added IsActiveUserSession and IsRdpSession properties.
Improved documentation
Version 3.6.2 [04/14/2015]
Improved capture of error details in function Invoke-HKCURegistrySettingsForAllUsers when a user profile fails to load
Improved internal function Test-MsiExecMutex: renamed function to Test-IsMutexAvailable, added parameters to allow checking for any named mutex, improved error trapping and messages
Improved Get-LoggedOnUser by increasing performance (should be much faster now)
Improved Show-WelcomePrompt by adding horizontal scrollbar for listbox items that are longer then the window
Changed toolkit so that all custom C# code is now in a separate file called "AppDeployToolkitMain.cs" which gets compiled once after functions are declared
Added an alias called 'Text' for the -Message parameter in Write-Log for backwards compatibility
Fixed issue with retrieving the active logged in user's system DPI scale factor because of typo in registry key
Fixed issue with malformed log entries being inserted into log file when dot sourcing scriptblock to retrieve logged in user session details
Fixed issue in Remove-MSIApplications where 'Path' key could be added to hash table more than once
Fixed issue with detecting a logged in user's locale
Fixed issue in Get-RunningProcesses where a regex match would detect processes that partially matched the name of the process being searched for
Fixed issue in Get-RunningProcesses and Show-InstallationWelcome where a specified custom process description was ignored
Fixed issue where Deploy-Application.ps1 script version would be set to toolkit version if it was not specified
Version 3.6.1 [04/02/2015]
Added Zero-Config deployment for MSI files. No need to customize anything. Drop your MSI in the Files folder and run the toolkit. Information is pulled from the MSI to do branding, logging, and closing in-use processes.
Added -DisableLogging switch to Deploy-Application.ps1 to disable logging to file for the script
Added -SoftwareUpdatesScanWaitInSeconds and -WaitForPendingUpdatesTimeout parameters to Install-SCCMSoftwareUpdates
Added -WildCard search option to Get-InstalledApplication and Remove-MSIApplications
Added -PassThru option to Test-Battery which will return the following properties: IsLaptop, IsUsingACPower, ACPowerLineStatus, BatteryChargeStatus, BatteryLifePercent, BatteryLifeRemaining, BatteryFullLifetime
Added following parameters to Remove-MSIApplications to match those in Execute-MSI: -Parameters, -AddParameters, -LoggingOptions, -LogName
Added default active username for -UserName parameter in Execute-ProcessAsUser
Added -SkipMSIAlreadyInstalledCheck parameter to Execute-MSI function to allow ability to skip the check that determines if an MSI is already installed on the system
Added SID property to Get-LoggedOnUser function results
Added -LoadLoggedOnUserEnvironmentVariables parameter to Refresh-SessionEnvironmentVariables function to allow loading user environment variables when running in the SYSTEM context
Added ability in Set-ActiveSetup to execute active setup entry for currently logged on user when running under the SYSTEM account
Added ability to detect Primary UI language of active logged in user when running under the SYSTEM account
Added function Get-WindowTitle to add ability to search for an open window title and return details about the window
Added -WindowHandle and -GetAllWindowTitles parameters to Send-Keys function
Added ability to detect display scale factor for currently logged on user when running under the SYSTEM account
Added -PassThru parameter to Execute-MSI and Remove-MSIApplications to return ExitCode, STDOut, and STDErr output
Fixed issue introduced in 3.6 whereby the toolkit timeout would not be triggered resulting in the wrong exit code being passed
Fixed issue in Install-MSUpdates where a folder path with a KB number in the folder name would force the regex to only detect that one KB in the folder
Fixed issue in Get-ServiceStartMode to avoid error when DelayedAutoStart property does not exist
Fixed issue introduced in 3.6.0 where $sessionZero was incorrectly set to $false after being set to the correct value
Fixed issue in Test-PowerPoint related to accurately measuring the size of a non-fullscreen window
Fixed variable type for -PassThru parameter in functions for manipulating services
Fixed issue in Execute-ProcessAsUser which improperly caused script exit
Fixed issue in Get-UserProfiles where 'DefaultUserProfile' registry value was mis-typed as 'DefaultUsersProfile'
Fixed issue in Show-InstallationWelcome to avoid error if the Description field of a hung process could not be accessed
Fixed issue where script would hang when removing deferrals (cause: Remove-RegistryKey did not have -Recurse parameter specified)
Changed Send-Keys function to use new Get-WindowTitle function when searching for window titles
Changed Deploy-Application.exe to exit with exit codes in the newly defined range
Improved Install-SCCMSoftwareUpdates to only execute if SCCM 2012 or higher installed because method is not compatible with SCCM 2007 or lower
Improved Install-SCCMSoftwareUpdates to check if SCCM client service is installed and running before trying to install updates
Improved Invoke-SCCMTask to check if SCCM client service is installed and running before invoking task
Improved Invoke-SCCMTask to add a few more SCCM 2012 client compatible schedule ids and to only allow execution of a schedule id compatible with the installed version of the client
Improved Block-AppExecution by using the import XML method of creating a scheduled task so that we could configure the task that unblocks applications to execute even if running on batteries
Improved Deploy-Application.ps1 by setting exit code to 60008 if AppDeployToolkitMain.ps1 fails to dot source
Improved Send-Keys function to be able to detect all open windows (including Explorer windows and all child windows), and also to bring any child window into the foreground
Improved -PromptToSave function to allow prompting for all child windows of a single instance application (such as Microsoft Word)
Improved the behavior for dialog shown when user tries to execute a blocked app so that no more than one dialog can be shown at a time
Improved documentation
Version 3.6.0 [03/11/2015]
Added function Set-ActiveSetup to allow creation/deletion of Active Setup entries (thanks to Denis St-Pierre, Todd MacNaught for code)
Added function Execute-ProcessAsUser to support running processes as the current logged on user to provide interaction in the system context. Note: if the user is not a local admin the process launched in user context will not inherit admin rights.
Added -PromptToSave parameter to Show-InstallationWelcome to prompt to save working documents when the users selects to close running applications
Added -TopMost parameter to Show-InstallationWelcome to allow the ability for the user to move the welcome screen to the background
Added variable to determine if running in terminal server session
Added functions to handle Windows services: Test-ServiceExists, Stop-ServiceAndDependencies, Start-ServiceAndDependencies, Get-ServiceStartMode, Set-ServiceStartMode
Added check to test whether or not the Windows Task Scheduler service is in a healthy state and fix any issues if possible.
Added ability in Deploy-Application.exe to read if Admin rights required from XML file and then automatically prompt to elevate on Vista or higher
Added -ExcludeDefaultUser parameter to Get-UserProfiles to allow exclusion of the Default User profile
Added IsLocalAdmin property to results from Get-LoggedOnUser function to determine if the user account is in the local Administrators security group
Added -AddParameters parameter to Execute-MSI to allow augmenting of parameters instead of replacing them
Added -ReturnEmptyKeyIfExists parameter to Get-RegistryKey to allow returning empty registry keys if they exist
Added -LoggingOptions parameter to Execute-MSI to allow overriding the default logging options specified in the config file
Added validation for -Path parameter in Execute-MSI function
Fixed issue where Show-InstallationRestartPrompt and Show-InstallationPrompt with -NoWait parameter didn't work
Added default action of Install to Execute-MSI
Added ability to specify multiple transforms and patches in Execute-MSI using a comma separated list
Added ability in XML configuration to override the detected language with a statically defined language for installation UI elements
Fixed issue in Show-InstallationProgress where -BottomRight parameter would cause prompt to be placed off screen where DPI is > 100%
Fixed issue with error being thrown when reading the DPI scale from the registry if the property doesn't exist
Fixed issue with Show-InstallationWelcome failing if "notes" specified with -CloseApps parameter when Notes application not installed
Fixed issue in Execute-MSI where LogName parameter did not work correctly
Fixed issue with Show-InstallationWelcome where deferrals would be ignored if CloseAppsCountdown parameter is specified
Fixed issue in Copy-File where operation would fail if destination folder was not created before operation when using wildcards in -Path parameter
Fixed issue in Unblock-AppExecution on some systems where process failed to unblock if only one process was initially blocked
Fixed issue with Deploy-Application.exe not executing on systems where only .NET 4 or higher installed by adding Deploy-Application.exe.config file
Fixed issue with Deploy-Application.exe by using -Command parameter instead of -File to avoid bug in PowerShell 2.0 where incorrect exit code might be returned if -File parameter used
Fixed a number of issues with the Office 2013 example script
Fixed issue whereby pressing enter would default to a hidden Abort button on Show-installationWelcome and Show-Installation Prompt
Fixed aesthetic issue whereby use of DeferDays or DeferDeadline without DeferTimes would show a deferral count of 1 remaining
Fixed issue in Get-InstalledApplication to properly detect applications when -Exact parameter used
Fixed issue in Get-UniversalDate where function would fail for some valid date formats under some culture settings
Fixed issue in Write-Log where it was not possible to change logfile name and directory after the first time these paths were set
Fixed issue with Deploy-Application.ps1 where variable expansion wouldn't work in Show-InstallationPrompt example
Fixed issue with Install-SCCMSoftwareUpdates not working on all clients
Fixed issue where modal dialog windows were not properly disposed
Improved path validation in Deploy-Application.exe, rewrote utility in C#
Improved defining default values for script variables not defined
Improved path validation in Execute-Process
Improved path validation in Execute-MSI
Improved working directory validation in Execute-MSI
Improved error message when toolkit launched without admin permissions
Improved detection of when invoking script is the Help script to avoid false positives
Improved Deploy-Application.ps1 to use Write-Error instead of Write-Output when toolkit fails to dot source
Improved Get-ScheduledTask to retrieve all scheduled task details, remove spaces and colons from property names, allow retrieval of details for a specific task name, and remove lines with column headers from results
Improved compilation of custom C# code by using -IgnoreWarnings switch with Add-Type cmdlet so that toolkit does not fail to run because of a warning
Improved Write-Log to log following for CMTrace log type: thread id, file name of source script
Improved environment variable population when running in system context
Improved Write-Log to log PID and log source for CMTrace log type
Improved Remove-RegistryKey to check if a key exists before trying to delete it and log a warning if key does not exist
Changed default Exit Codes for internal Toolkit functions. The range of 60000 is used for internal, and 70000 should be used for custom extensions
Changed toolkit to remove unused variables which did not exist and were being read from XML file
Changed Register-DLL/Unregister-DLL function to combine them into one function called Invoke-RegisterOrUnregisterDLL. Created Aliases for new function name to maintain backwards compatibility.
Changed Notes process termination using NSD to only run if Notes processes are running
Updated documentation
Added Polish translations
Updated German translations
Updated Italian translations
Version 3.5.0 [11/24/2014]
Added CMTrace compatible log files to Write-Log (now the default). Legacy log format still available through configuration in XML config file
Added ability to modify HKCU registry settings for all users on a machine by loading registry hives. Added functions to support this: Invoke-HKCURegistrySettingsForAllUsers, Get-UserProfiles, ConvertTo-NTAccountOrSID. Modified functions to support this: Convert-RegistryPath, Get-RegistryKey, Set-RegistryKey, Remove-RegistryKey
Added ability in Register-DLL / Unregister-DLL to detect bitness of DLL files and register for the correct architecture automatically
Added ability for Test-PowerPoint to actually detect if user is presenting slideshow in fullscreen mode
Added Get-LoggedOnUser to get session details for all local and RDP logged on users
Added Refresh-SessionEnvironmentVariables to allow reloading of newly created environment variables for the current process
Added new variables for Domain Membership, Process Information, Account Permissions, OS Type and Versions, PowerShell and .NET versions, TimeZone Bias
Added TRANSFORMSSECURE=1 as default where Transform parameter is specified
Added ability to detect active console user (user with control of the monitor, keyboard, mouse)
Added ForceCloseAppsCountdown parameter to Show-InstallationWelcome allowing a countdown to close apps regardless of whether deferral is allowed
Added Patch parameter to Execute-MSI to allow an MSP file to be specified on the command line with an MSI installation
Added ability to Get-InstalledApplication to detect whether a 64-bit or 32-bit application
Added CreateNoWindow parameter to Execute-Process
Changed Deploy-Application.exe to new executable built in VB.NET
Changed detection of Admin rights by looking for Admin SID on the current processes access token, previous method checked for membership in the BuiltInAdministrator group
Changed Restart Prompt default selected button to Restart Later
Changed $envOSArchitecture variable so that it reports consistent value regardless of OS language
Improved detection of change.exe failures for TerminalServerInstallMode
Improved detection of logged in users, including users connected through RDP
Improved error trapping and logging of messages throughout script. Modified messages for clarity and consistency.
Improved parameter validation on all functions to simplify function logic and give standard error messages when function parameters not specified properly, also helps make clear which parameters are mandatory and which are not
Improved Set-PinnedApplication to detect when one of the chosen actions is not available on an operating system (such as pinning items to Start Menu on Windows 8)
Improved session 0 detection
Improved Execute-MSI and Execute-Process to sync parameter names for -Path and -Parameters and add alias for backwards compatibility
Improved method of detecting OS architecture so that detection works on some non-English operating systems
Improved Block-AppExecution to not flash CMD window right before displaying application block message
Show-InstallationWelcome, Show-InstallationPrompt: Fixed clipping of text when non-default DPI settings used
Fixed creation of URL shortcuts in New-Shortcut
Fixed detection of when script is running from a task sequence
Fixed issue in Get-InstalledApplication where an "Invalid Cast" error was thrown if registry contains a value with invalid data
Fixed issue in New-Shortcut where an error would be thrown if no icon was specified
Fixed issue in Test-Battery where the incorrect information would be returned if the battery was failing
Fixed issue in Send-Keys where there was an improper script exit upon failure
Fixed issue with Show-BalloonTip where icon was not disposed before exit
Fixed issue where Block-Execution would display an error creating the scheduled task if the Application Name was too long (command was longer than 261 characters)
Fixed issue where Block-Execution was not showing a message window when user tried to open a blocked app
Fixed issue where Block-Execution was creating a scheduled task to clean up blocked apps which would not execute
Fixed issue where AppDeployToolkitHelp.ps1 threw an error when executed
Fixed CloseAppsCountdown and PersistPrompt in Show-InstallationWelcome (bug introduced in v3.2)
Fixed issue in Show-InstallationPrompt and Show-InstallationWelcome where timeout object was not disposed and would cause timeout of subsequent UI components
Fixed issue with enumerating hashtable boolean parameters into string format
Fixed centering of Show-InstallationProgress window where DPI scale is not 100%
Fixed centering of toolkit banner in UI elements where the full length banner is not used
Fixed issue where MinimizeAll() and UndoMinimizeAll() method calls were inserting a $null into the pipeline
Fixed issue in Execute-Process to asynchronously capture process Standard Output
Updated Deploy-Application template to be consistent with the rest of the toolkit. Scripts from previous versions are fully backwards compatible.
Updated German translations
Updated Norwegian translations
Updated documentation
Version 3.2.0 [08/22/2014]
Added further optimization and best practice enhancements to Execute-Process to improve parameter validation, object and exception handling.
Added a check for in-progress MSI installations preventing an MSI from installing and waits up to 10 minutes - this reduces instances of MSI error code 1618 (Test-MsiExecMutex)
Added Get-MsiExitCodeMessage - used by Execute-MSI (also available to Execute-Process) to get MSI exit code description if not handled by default.
Get-InstalledApplication and Remove-MSIApplication now support exact application name matching
Added error message to clarify when the toolkit fails to dot source and functions are not available
Improved exception handling in Write-Log
The install title format on asynchronous UI elements will now match the synchronous UI elements
Asynchronous toolkit invocations now write to the same log file as synchronous
Install-MSUpdates now handles re-distributables such as the VC++ runtime redistributables
Added additional uninstallation sections to Deploy-Application.ps1 template to mirror installation sections
Added Dutch translations
(Thanks to mmashwani for his excellent contributions to this release)
Version 3.1.5 [08/01/2014]
Added Send-Keys function to send a sequence of keys to an application window (Thanks to mmashwani)
Added 3 optimization/stability improvements to Execute-Process following MS best practice (Thanks to mmashwani)
Fixed issue where Execute-MSI did not use value from XML file for uninstall but instead ran all uninstalls silently by default
Fixed error on 1641 exit code (should be a success like 3010)
Fixed issue with error handling in Invoke-SCCMTask
Fixed issue with deferral dates where the letter Z is in the month (non-English languages)
Fixed issue where custom process descriptions failed to display in Show-InstallationWelcome if an exact process name was specified
Updated French translations
Version 3.1.4 [06/10/2014]
Added New-Folder and Remove-Folder functions (Thanks to SueH)
Added NoWait parameter to Execute-Process
Added the ability for Deploy-Application.exe to point to a different .ps1 file by specifying it on the command-line
Added checks to Deploy-Application.exe to verify the AppDeployToolkit folder exists
Added PSAppDeployToolkit icon to Deploy-Application.exe
Fixed issue where hang could occur if file version was null when using Get-FileVersion
Improved exception handling and logging for a number of functions
Version 3.1.3 [05/22/2014]
Added CompressLogs option to the config file. Each Install / Uninstall creates a timestamped zip file with all MSI and PSAppDeployToolkit logs contained within
Added variable expansion to all paths in the configuration file
Added documentation for each of the Toolkit internal variables that can be used
Changed Install-MSUpdates to continue if any errors are encountered when installing updates
Implement /Force parameter on Update-GroupPolicy (ensure that any logoff message is ignored)
Fixed issue where the AppClose Countdown timer would reset if the user attempted to close the UI
Fixed error handling in Set-PinnedApplication if the executable existed but the shortcut wasn't actually pinned
Version 3.1.2 [04/30/2014]
Added Get-IniValue / Set-IniValue functions. Replaces Get-IniContent / Set-IniContent which were a bit unwieldy. The new functions are much easier to use.
Added -Value parameter to Get-RegistryKey so that a specific registry value can be retrieved instead of the entire Key as an object
Fixed Test-Battery to work with machines that can have multiple batteries
Fixed issue where BlockExecution would fail if a Custom Temp Path was specified in the config file
Updated examples with latest templates and Office 2013
Updated French translations
Updated Japanese translations
Version 3.1.1 [03/27/2014]
Added -NoCountdown parameter to Show-InstallationRestartPrompt to provide an option for just displaying the restart now or restart later buttons. The UI will restore/reposition itself persistently based on the interval value specified in the config file.
Fixed issue whereby the restart prompt could be closed from the task bar
Added Recurse parameter to Copy-File function
Fixed exact process match on Show-InstallationWelcome was broken in a recent release
Fixed MinimizeWindows parameter which was broken in a recent release
Version 3.1.0 [02/25/2014]
Re-coded BlockExecution to be more stable and prevent issues unblocking execution
Added support for installing applications on Remote Desktop Session Host/Citrix servers
Added handling of UI assembly load errors affecting PS 2.0 and .NET 4.0 and greater. Errors are ignored only if deploy mode is set to noninteractive
Fixed ContinueOnError parameter data type which was set as a switch but should have been boolean
Added default progress message for Uninstallation deployment mode
Fixed issue with detection of Session 0 on XP which resulted in no UI being displayed
Fixed issue where Working Directory wouldn't be set correctly if using a subfolder in $dirFiles
Version 3.0.12 [01/17/2014]
Fixed error handling of Pin To Start in Win 8 (not programmatically supported in Win 8.1)
Fixed issue where user generated thumbs.db file in AppDeployToolkit folder could cause BlockExecution to fail
Fixed issue where uninstalls would fail if there was a backslash in the MSI DisplayName
Fixed issue where Execute-Process could fail but return an exit code of 0 indicating success
Fixed issue where DeferDays or in some scenarios DeferDeadline values would be erroneously converted to a different timezone.
Fixed issue where Remove-MSIApplications and Get-InstalledApplication wouldn't find a match if the application name contained square brackets
Version 3.0.11 [01/07/2014]
Changed persistent prompt interval to default to 60 seconds
Fixed issue with false Session 0 detected on some XP machines
Fixed minimum configuration version checking
Fixed Set-RegistryValue not accepting arrays
Version 3.0.10 [12/05/2013]
Improved process matching in CloseApps, Remove-MSIApplications & Get-InstalledApplication (for support of apps with special characters, like NotePad++)
Revert change that prevented AllowDefer and CloseAppsCountdown from working together
Version 3.0.9 [11/29/2013]
Note We recently attempted to add a killer new feature and release 3.1.0. We thought we had nailed it but ended up hitting problems once we went into production environments.
Worse still, we ended up causing a bunch of problems in 3.0.8 trying to reverse out all of these changes.
We've prided ourselves on getting to be a really stable toolkit that works well in an enterprise environment.
So we're very sorry for the shoddiness of 3.0.8 and have taken a number of steps (a QA process and test scripts) to ensure we don't have these issues going forward.
Added handling of X86 environment variables so they are never empty
Added prevention of AllowDefer and CloseAppsCountdown at the same time
Added x86 support to Register-DLL and Unregister-DLL (if DLL is dropped in SysWOW64)
Fixed Register-DLL and Unregister-DLL when using paths with spaces
Fixed sporadic log file corruption that were introduced in v3.0.8
Fixed CloseAppsCountdown that got broken in v3.0.8
Fixed DeployMode handling that got broken in v3.0.8
Version 3.0.8 [11/26/2013]
Show-InstallationWelcome now supports exact process matching by specifying .exe after process name.
Added Swedish translation & improved German translation.
Changed Write-Log function to use StreamWriter, which is faster
Modified application name on block app execution prompt (cosmetic).
Fixed an issue where displaying BlockExecution message with interfere with the main application installation
Fixed parameter encapsulation in asynchronous prompts and scheduled task creation.
Fixed extension script not dot-sourcing from UNC path.
Fixed Toolkit logpath not reading config file value.
Fixed UI timeout resetting on Show-InstallationWelcome prompt when continue button is clicked
Fixed UI timeout not decrementing deferrals remaining.
Version 3.0.7 [10/24/2013]
Fixed issue where Session 0 was not detected correctly, resulting in issues when attempting to display a UI when none was allowed
Fixed Installation Prompt and Installation Restart Prompt appearing when deploy mode was non-interactive or silent
Fixed issue where defer prompt is displayed after force closing multiple applications
Fixed issue executing blocked app execution dialog from UNC path (executed instead from local temporary directory)
Added sanitization of all application details to prevent invalid characters in log file name creation (which would break the script)
Fixed Test-Battery function returning inverse value (was True when Power was connected)
Fixed error failing to locate schtasks.exe
Fixed "Restart Now" button text not using text from config file
Corrected the window properties of the countdown-no-hide phase of restart prompt to be topmost.
Version 3.0.6 [10/10/2013]
Added PersistPrompt parameter to Show-InstallationWelcome and Show-InstallationPrompt. Prompt window is persistently returned to center screen after interval specified in config file (default 10 seconds). For Show-InstallationWelcome, this only takes effect if deferral is not available to user. The user will have no option but to respond to the prompt - resistance is futile!
Added example advanced Office 2010 deployment script
Asynchronous actions now write to the same log file as synchronous actions
Changed Defer Exit Code default to 5000. In CM07, deployments with deferrals should be set on a recurring schedule (ie, every 4 hours, not just As Soon As Possible). In CM12, the Application Model evaluates once a day by default (can be changed in Client Settings)
Fixed Get-ScheduledTask not running on non-English system
Fixed error deleting deferral history in registry on successful installation.
Fixed non default Defer Exit Code from displaying error - should display a warning
Updated documentation with information on how to build and deploy Adobe Acrobat using SCCM 2007 / 2012 packages, and SCCM 2012 application model
Updated documentation with information on how to use advanced Office 2010 deployment script
Updated documentation with important information on how deferrals work with SCCM 2007 and differences with SCCM 2012
Version 3.0.5 [09/27/2013]
Fixed issue with Show-InstallationPrompt not running asynchronously with the NoWait parameter.
Fixed issue with Show-InstallationRestartPrompt closing with the parent process.
Fixed issue matching application names with brackets in Remove-MSIApplications.
Fixed exception after clicking "Close Programs" button on Show-InstallationWelcomePrompt (only known to affect v3.0.4).
Fixed issue with one deferral more showing than is remaining (cosmetic only)
Deferral history is now reset on successful installation
Added ExitOnTimeout parameter to Show-InstallationPrompt (default is true)
Added MinimizeWindows parameter to Show-InstallationPrompt (default is false)
Added MinimizeWindows parameter to Show-InstallationWelcome (default is true)
Added extra space for the <DeferPrompt_WelcomeMessage> message
Added additional XML configuration items:
- Specify separate toolkit and msi log directories
- Specify whether administrator rights are required
- Minimum supported version check for the XMl config file
- Configure deferral exit code
- Configure temporary path for caching toolkit files
- Configure registry path for storing deferral information
Version 3.0.4 [09/13/2013]
Added parameter to Show-InstallationWelcome called "AllowDeferCloseApps" which only provides a deferral option if there are running applications that need to be closed.
Added ability to configure the timeout period for Show-InstallationPrompt
Added option to position progress window in bottom right of screen (above task bar) and specify whether it is topmost.
Added Danish translations
Added Italian translations
Added Japanese translations
Changes to French translations
Fixed issue where Test-MSUpdates function could fail with an exception calling QueryHistory
Fixed issue where Install-MSUpdates function could fail with an "argument is null or empty" exception
Removed default ButtonRightText "OK" value on Show-InstallationPrompt to allow prompts with only the middle button.
The exit code used for UI timeouts or deferrals can now be configured in XML (default is 1618).
Version 3.0.3 [09/05/2013]
Fixed issue where spaces in the file path would cause block execution prompt not to work
Fixed issue where non-English UIs which were not already localized would fail to fall back on English as a default
Fixed issue with uninstalling applications with non-ascii characters in the name or version
Version 3.0.2 [08/29/2013]
Added CheckDiskSpace and RequiredDiskSpace parameters to Show-InstallationWelcome
If CheckDiskSpace parameter is used, disk space will be evaluated before showing the Welcome screen. If disk space requirements are not met, an error message will be displayed and a Fast Retry (1618) exit code generated. The disk space requirements are calculated automatically based on the size of the source files or by specifying the required space in MB using the RequiredDiskSpace parameter.
Added Get-FreeDiskSpace function (returns value in MB)
Show-InstallationPrompt enhancements
MessageAlignment - align message text on the prompt
Icon - display a system icon on the prompt
NoWait - display the prompt asynchronously and continue the script without waiting for user response
Cosmetic improvements
Added parameter validation to Invoke-SCCMTask
Cosmetic improvements to Show-InstallationWelcome & Show-InstallationProgress
Fixed issue where user would not be granted their last deferral.
Version 3.0.1 [08/28/2013]
Fixed issue where using NonInteractive DeployMode would cause a bluescreen (!!!)
Fixed issue where Remove-MSIApplications would only remove the first application if multiple matches were made
Fixed issue where automatic timeout of Welcome screen was not triggered
Fixed issue where automatic timeout of installation prompt caused a .NET exception
Fixed help system to work with Standard User rights
Fixed text cutoff issue with non-English languages
Minor fixes to the help information and default template
Updated French translation
Version 3.0.0 [08/23/2013]
Each UI element now has a customizable banner
Show-InstallationWelcome function
Replaces Stop-RunningApplications (deprecated) and presents a unified welcome screen
Deferral system. Ability to defer installation x number of times / days / until deadline date
Ability to force closing applications after a countdown period
Show-InstallationPrompt function
Replaces Show-DialogBox (deprecated)
Standardized UI with the rest of the toolkit
Customizable text and 3 buttons
Show-InstallationRestartPrompt function
Displays a restart prompt with a countdown to a forced restart, independent of SCCM restart mechanism
Invoke-SCCMTask function
Replaces Update-SCCMInventory and Update-SCCMDeployments (deprecated)
No longer reliant on COM object which could cause issues on x64 machines
Get-UniversalDate function
Write-Log now works with the PowerShell Pipeline and -PassThru
Set-RegistryKey now accepts arrays
Improved error handling: ContinueOnError switch allows to to control the error action for functions that fail. ContinueOnErrorGlobalPreference allows you to debug the script to detect errors in functions.
Fixed issue with BlockExecution failing under PowerShell v2
Fixed issue with Show-InstallationProgress failing on .NET Framework versions prior to 4.5
Fixed issue with command-line parameters not being passed through Deploy-Application.exe on x86 operating systems
Test-MSUpdates KB regex matching is now case insensitive
Parameters passed to scripts are now logged.
Backwards Compatibility Considerations:
The following functions have been deprecated and are no longer supported:
Stop-RunningApplications
Update-SCCMInventory
Update-SCCMDeployments
Version 2.0.1 [08/15/2013]
New Show-DialogBox parameters: TopMost and DefaultButton. Specify whether dialog box is topmost (new default) and specify default selected button.
Fixed issue with long file names when removing certain types of software using Remove-MSIApplications.
Added ability to turn automatic balloon notifications on or off in the XML config file.
Attempted to fix issue with stale balloon notifications.
Attempted to fix issue with installation progress not updating or hanging.
Version 2.0.0 [08/07/2013]
Initial Public Release.