diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitBanner.png b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitBanner.png
new file mode 100644
index 0000000..60c2ed1
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitBanner.png differ
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitConfig.xml b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitConfig.xml
new file mode 100644
index 0000000..67fe1f1
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitConfig.xml differ
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitExtensions.ps1 b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitExtensions.ps1
new file mode 100644
index 0000000..08fd4ed
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitExtensions.ps1
@@ -0,0 +1,57 @@
+<#
+.SYNOPSIS
+ This script is a template that allows you to extend the toolkit with your own custom functions.
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script is automatically dot-sourced by the AppDeployToolkitMain.ps1 script.
+.NOTES
+ Toolkit Exit Code Ranges:
+ 60000 - 68999: Reserved for built-in exit codes in Deploy-Application.ps1, Deploy-Application.exe, and AppDeployToolkitMain.ps1
+ 69000 - 69999: Recommended for user customized exit codes in Deploy-Application.ps1
+ 70000 - 79999: Recommended for user customized exit codes in AppDeployToolkitExtensions.ps1
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+)
+
+##*===============================================
+##* VARIABLE DECLARATION
+##*===============================================
+
+# Variables: Script
+[string]$appDeployToolkitExtName = 'PSAppDeployToolkitExt'
+[string]$appDeployExtScriptFriendlyName = 'App Deploy Toolkit Extensions'
+[version]$appDeployExtScriptVersion = [version]'1.5.0'
+[string]$appDeployExtScriptDate = '02/12/2017'
+[hashtable]$appDeployExtScriptParameters = $PSBoundParameters
+
+##*===============================================
+##* FUNCTION LISTINGS
+##*===============================================
+
+#
+
+##*===============================================
+##* END FUNCTION LISTINGS
+##*===============================================
+
+##*===============================================
+##* SCRIPT BODY
+##*===============================================
+
+If ($scriptParentPath) {
+ Write-Log -Message "Script [$($MyInvocation.MyCommand.Definition)] dot-source invoked by [$(((Get-Variable -Name MyInvocation).Value).ScriptName)]" -Source $appDeployToolkitExtName
+}
+Else {
+ Write-Log -Message "Script [$($MyInvocation.MyCommand.Definition)] invoked directly" -Source $appDeployToolkitExtName
+}
+
+##*===============================================
+##* END SCRIPT BODY
+##*===============================================
\ No newline at end of file
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitHelp.ps1 b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitHelp.ps1
new file mode 100644
index 0000000..83c6e4a
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitHelp.ps1
@@ -0,0 +1,132 @@
+<#
+.SYNOPSIS
+ Displays a graphical console to browse the help for the App Deployment Toolkit functions
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ Displays a graphical console to browse the help for the App Deployment Toolkit functions
+.EXAMPLE
+ AppDeployToolkitHelp.ps1
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+
+##*===============================================
+##* VARIABLE DECLARATION
+##*===============================================
+
+## Variables: Script
+[string]$appDeployToolkitHelpName = 'PSAppDeployToolkitHelp'
+[string]$appDeployHelpScriptFriendlyName = 'App Deploy Toolkit Help'
+[version]$appDeployHelpScriptVersion = [version]'3.6.5'
+[string]$appDeployHelpScriptDate = '02/12/2017'
+
+## Variables: Environment
+[string]$scriptDirectory = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+# Dot source the App Deploy Toolkit Functions
+. "$scriptDirectory\AppDeployToolkitMain.ps1" -DisableLogging
+
+##*===============================================
+##* END VARIABLE DECLARATION
+##*===============================================
+
+##*===============================================
+##* FUNCTION LISTINGS
+##*===============================================
+
+Function Show-HelpConsole {
+ ## Import the Assemblies
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName System.Drawing -ErrorAction 'Stop'
+
+ ## Form Objects
+ $HelpForm = New-Object -TypeName 'System.Windows.Forms.Form'
+ $HelpListBox = New-Object -TypeName 'System.Windows.Forms.ListBox'
+ $HelpTextBox = New-Object -TypeName 'System.Windows.Forms.RichTextBox'
+ $InitialFormWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ ## Form Code
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 665
+ $System_Drawing_Size.Width = 957
+ $HelpForm.ClientSize = $System_Drawing_Size
+ $HelpForm.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpForm.Name = 'HelpForm'
+ $HelpForm.Text = 'PowerShell App Deployment Toolkit Help Console'
+ $HelpForm.WindowState = 'Normal'
+ $HelpForm.ShowInTaskbar = $true
+ $HelpForm.FormBorderStyle = 'Fixed3D'
+ $HelpForm.MaximizeBox = $false
+ $HelpForm.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $HelpListBox.Anchor = 7
+ $HelpListBox.BorderStyle = 1
+ $HelpListBox.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpListBox.Font = New-Object -TypeName 'System.Drawing.Font' -ArgumentList ('Microsoft Sans Serif', 9.75, 1, 3, 1)
+ $HelpListBox.FormattingEnabled = $true
+ $HelpListBox.ItemHeight = 16
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $HelpListBox.Location = $System_Drawing_Point
+ $HelpListBox.Name = 'HelpListBox'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 658
+ $System_Drawing_Size.Width = 271
+ $HelpListBox.Size = $System_Drawing_Size
+ $HelpListBox.Sorted = $true
+ $HelpListBox.TabIndex = 2
+ $HelpListBox.add_SelectedIndexChanged({ $HelpTextBox.Text = Get-Help -Name $HelpListBox.SelectedItem -Full | Out-String })
+ $helpFunctions = Get-Command -CommandType 'Function' | Where-Object { ($_.HelpUri -match 'psappdeploytoolkit') -and ($_.Definition -notmatch 'internal script function') } | Select-Object -ExpandProperty Name
+ ForEach ($helpFunction in $helpFunctions) {
+ $null = $HelpListBox.Items.Add($helpFunction)
+ }
+ $HelpForm.Controls.Add($HelpListBox)
+ $HelpTextBox.Anchor = 11
+ $HelpTextBox.BorderStyle = 1
+ $HelpTextBox.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpTextBox.Font = New-Object -TypeName 'System.Drawing.Font' -ArgumentList ('Microsoft Sans Serif', 8.5, 0, 3, 1)
+ $HelpTextBox.ForeColor = [System.Drawing.Color]::FromArgb(255, 0, 0, 0)
+ $System_Drawing_Point = New-Object -TypeName System.Drawing.Point
+ $System_Drawing_Point.X = 277
+ $System_Drawing_Point.Y = 0
+ $HelpTextBox.Location = $System_Drawing_Point
+ $HelpTextBox.Name = 'HelpTextBox'
+ $HelpTextBox.ReadOnly = $True
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 658
+ $System_Drawing_Size.Width = 680
+ $HelpTextBox.Size = $System_Drawing_Size
+ $HelpTextBox.TabIndex = 1
+ $HelpTextBox.Text = ''
+ $HelpForm.Controls.Add($HelpTextBox)
+
+ ## Save the initial state of the form
+ $InitialFormWindowState = $HelpForm.WindowState
+ ## Init the OnLoad event to correct the initial state of the form
+ $HelpForm.add_Load($OnLoadForm_StateCorrection)
+ ## Show the Form
+ $null = $HelpForm.ShowDialog()
+}
+
+##*===============================================
+##* END FUNCTION LISTINGS
+##*===============================================
+
+##*===============================================
+##* SCRIPT BODY
+##*===============================================
+
+Write-Log -Message "Load [$appDeployHelpScriptFriendlyName] console..." -Source $appDeployToolkitHelpName
+
+## Show the help console
+Show-HelpConsole
+
+Write-Log -Message "[$appDeployHelpScriptFriendlyName] console closed." -Source $appDeployToolkitHelpName
+
+##*===============================================
+##* END SCRIPT BODY
+##*===============================================
\ No newline at end of file
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitLogo.ico b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitLogo.ico
new file mode 100644
index 0000000..411f4ab
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitLogo.ico differ
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.cs b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.cs
new file mode 100644
index 0000000..b1653b0
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.cs
@@ -0,0 +1,775 @@
+// Date Modified: 01-08-2016
+// Version Number: 3.6.8
+
+using System;
+using System.Text;
+using System.Collections;
+using System.ComponentModel;
+using System.DirectoryServices;
+using System.Security.Principal;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Text.RegularExpressions;
+using FILETIME = System.Runtime.InteropServices.ComTypes.FILETIME;
+
+namespace PSADT
+{
+ public class Msi
+ {
+ enum LoadLibraryFlags : int
+ {
+ DONT_RESOLVE_DLL_REFERENCES = 0x00000001,
+ LOAD_IGNORE_CODE_AUTHZ_LEVEL = 0x00000010,
+ LOAD_LIBRARY_AS_DATAFILE = 0x00000002,
+ LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE = 0x00000040,
+ LOAD_LIBRARY_AS_IMAGE_RESOURCE = 0x00000020,
+ LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008
+ }
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern IntPtr LoadLibraryEx(string lpFileName, IntPtr hFile, LoadLibraryFlags dwFlags);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern int LoadString(IntPtr hInstance, int uID, StringBuilder lpBuffer, int nBufferMax);
+
+ // Get MSI exit code message from msimsg.dll resource dll
+ public static string GetMessageFromMsiExitCode(int errCode)
+ {
+ IntPtr hModuleInstance = LoadLibraryEx("msimsg.dll", IntPtr.Zero, LoadLibraryFlags.LOAD_LIBRARY_AS_DATAFILE);
+
+ StringBuilder sb = new StringBuilder(255);
+ LoadString(hModuleInstance, errCode, sb, sb.Capacity + 1);
+
+ return sb.ToString();
+ }
+ }
+
+ public class Explorer
+ {
+ private static readonly IntPtr HWND_BROADCAST = new IntPtr(0xffff);
+ private const int WM_SETTINGCHANGE = 0x1a;
+ private const int SMTO_ABORTIFHUNG = 0x0002;
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern bool SendNotifyMessage(IntPtr hWnd, int Msg, IntPtr wParam, IntPtr lParam);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr SendMessageTimeout(IntPtr hWnd, int Msg, IntPtr wParam, string lParam, int fuFlags, int uTimeout, IntPtr lpdwResult);
+
+ [DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern int SHChangeNotify(int eventId, int flags, IntPtr item1, IntPtr item2);
+
+ public static void RefreshDesktopAndEnvironmentVariables()
+ {
+ // Update desktop icons
+ SHChangeNotify(0x8000000, 0x1000, IntPtr.Zero, IntPtr.Zero);
+ SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, IntPtr.Zero, null, SMTO_ABORTIFHUNG, 100, IntPtr.Zero);
+ // Update environment variables
+ SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, IntPtr.Zero, "Environment", SMTO_ABORTIFHUNG, 100, IntPtr.Zero);
+ }
+ }
+
+ public sealed class FileVerb
+ {
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int LoadString(IntPtr h, int id, StringBuilder sb, int maxBuffer);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr LoadLibrary(string s);
+
+ public static string GetPinVerb(int VerbId)
+ {
+ IntPtr hShell32 = LoadLibrary("shell32.dll");
+ const int nChars = 255;
+ StringBuilder Buff = new StringBuilder("", nChars);
+
+ LoadString(hShell32, VerbId, Buff, Buff.Capacity);
+ return Buff.ToString();
+ }
+ }
+
+ public sealed class IniFile
+ {
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetPrivateProfileString(string lpAppName, string lpKeyName, string lpDefault, StringBuilder lpReturnedString, int nSize, string lpFileName);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool WritePrivateProfileString(string lpAppName, string lpKeyName, StringBuilder lpString, string lpFileName);
+
+ public static string GetIniValue(string section, string key, string filepath)
+ {
+ string sDefault = "";
+ const int nChars = 1024;
+ StringBuilder Buff = new StringBuilder(nChars);
+
+ GetPrivateProfileString(section, key, sDefault, Buff, Buff.Capacity, filepath);
+ return Buff.ToString();
+ }
+
+ public static void SetIniValue(string section, string key, StringBuilder value, string filepath)
+ {
+ WritePrivateProfileString(section, key, value, filepath);
+ }
+ }
+
+ public class UiAutomation
+ {
+ public enum GetWindow_Cmd : int
+ {
+ GW_HWNDFIRST = 0,
+ GW_HWNDLAST = 1,
+ GW_HWNDNEXT = 2,
+ GW_HWNDPREV = 3,
+ GW_OWNER = 4,
+ GW_CHILD = 5,
+ GW_ENABLEDPOPUP = 6
+ }
+
+ public enum ShowWindowEnum
+ {
+ Hide = 0,
+ ShowNormal = 1,
+ ShowMinimized = 2,
+ ShowMaximized = 3,
+ Maximize = 3,
+ ShowNormalNoActivate = 4,
+ Show = 5,
+ Minimize = 6,
+ ShowMinNoActivate = 7,
+ ShowNoActivate = 8,
+ Restore = 9,
+ ShowDefault = 10,
+ ForceMinimized = 11
+ }
+
+ public enum UserNotificationState
+ {
+ // http://msdn.microsoft.com/en-us/library/bb762533(v=vs.85).aspx
+ ScreenSaverOrLockedOrFastUserSwitching =1, // A screen saver is displayed, the machine is locked, or a nonactive Fast User Switching session is in progress.
+ FullScreenOrPresentationModeOrLoginScreen =2, // A full-screen application is running or Presentation Settings are applied. Presentation Settings allow a user to put their machine into a state fit for an uninterrupted presentation, such as a set of PowerPoint slides, with a single click. Also returns this state if machine is at the login screen.
+ RunningDirect3DFullScreen =3, // A full-screen, exclusive mode, Direct3D application is running.
+ PresentationMode =4, // The user has activated Windows presentation settings to block notifications and pop-up messages.
+ AcceptsNotifications =5, // None of the other states are found, notifications can be freely sent.
+ QuietTime =6, // Introduced in Windows 7. The current user is in "quiet time", which is the first hour after a new user logs into his or her account for the first time.
+ WindowsStoreAppRunning =7 // Introduced in Windows 8. A Windows Store app is running.
+ }
+
+ // Only for Vista or above
+ [DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern int SHQueryUserNotificationState(out UserNotificationState pquns);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool EnumWindows(EnumWindowsProcD lpEnumFunc, ref IntPtr lParam);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowText(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowTextLength(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr GetDesktopWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr GetShellWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool IsWindowEnabled(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool IsWindowVisible(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool IsIconic(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool ShowWindow(IntPtr hWnd, ShowWindowEnum flags);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr SetActiveWindow(IntPtr hwnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool SetForegroundWindow(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetForegroundWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr SetFocus(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool BringWindowToTop(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int lpdwProcessId);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetCurrentThreadId();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool AttachThreadInput(int idAttach, int idAttachTo, bool fAttach);
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLong", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetWindowLong32(IntPtr hWnd, int nIndex);
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLongPtr", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetWindowLongPtr64(IntPtr hWnd, int nIndex);
+
+ public delegate bool EnumWindowsProcD(IntPtr hWnd, ref IntPtr lItems);
+
+ public static bool EnumWindowsProc(IntPtr hWnd, ref IntPtr lItems)
+ {
+ if (hWnd != IntPtr.Zero)
+ {
+ GCHandle hItems = GCHandle.FromIntPtr(lItems);
+ List items = hItems.Target as List;
+ items.Add(hWnd);
+ return true;
+ }
+ else
+ {
+ return false;
+ }
+ }
+
+ public static List EnumWindows()
+ {
+ try
+ {
+ List items = new List();
+ EnumWindowsProcD CallBackPtr = new EnumWindowsProcD(EnumWindowsProc);
+ GCHandle hItems = GCHandle.Alloc(items);
+ IntPtr lItems = GCHandle.ToIntPtr(hItems);
+ EnumWindows(CallBackPtr, ref lItems);
+ return items;
+ }
+ catch (Exception ex)
+ {
+ throw new Exception("An error occured during window enumeration: " + ex.Message);
+ }
+ }
+
+ public static string GetWindowText(IntPtr hWnd)
+ {
+ int iTextLength = GetWindowTextLength(hWnd);
+ if (iTextLength > 0)
+ {
+ StringBuilder sb = new StringBuilder(iTextLength);
+ GetWindowText(hWnd, sb, iTextLength + 1);
+ return sb.ToString();
+ }
+ else
+ {
+ return String.Empty;
+ }
+ }
+
+ public static bool BringWindowToFront(IntPtr windowHandle)
+ {
+ bool breturn = false;
+ if (IsIconic(windowHandle))
+ {
+ // Show minimized window because SetForegroundWindow does not work for minimized windows
+ ShowWindow(windowHandle, ShowWindowEnum.ShowMaximized);
+ }
+
+ int lpdwProcessId;
+ int windowThreadProcessId = GetWindowThreadProcessId(GetForegroundWindow(), out lpdwProcessId);
+ int currentThreadId = GetCurrentThreadId();
+ AttachThreadInput(windowThreadProcessId, currentThreadId, true);
+
+ BringWindowToTop(windowHandle);
+ breturn = SetForegroundWindow(windowHandle);
+ SetActiveWindow(windowHandle);
+ SetFocus(windowHandle);
+
+ AttachThreadInput(windowThreadProcessId, currentThreadId, false);
+ return breturn;
+ }
+
+ public static int GetWindowThreadProcessId(IntPtr windowHandle)
+ {
+ int processID = 0;
+ GetWindowThreadProcessId(windowHandle, out processID);
+ return processID;
+ }
+
+ public static IntPtr GetWindowLong(IntPtr hWnd, int nIndex)
+ {
+ if (IntPtr.Size == 4)
+ {
+ return GetWindowLong32(hWnd, nIndex);
+ }
+ return GetWindowLongPtr64(hWnd, nIndex);
+ }
+
+ public static string GetUserNotificationState()
+ {
+ // Only works for Windows Vista or higher
+ UserNotificationState state;
+ int returnVal = SHQueryUserNotificationState(out state);
+ return state.ToString();
+ }
+ }
+
+ public class QueryUser
+ {
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr WTSOpenServer(string pServerName);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern void WTSCloseServer(IntPtr hServer);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Ansi, SetLastError = false)]
+ public static extern bool WTSQuerySessionInformation(IntPtr hServer, int sessionId, WTS_INFO_CLASS wtsInfoClass, out IntPtr pBuffer, out int pBytesReturned);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Ansi, SetLastError = false)]
+ public static extern int WTSEnumerateSessions(IntPtr hServer, int Reserved, int Version, out IntPtr pSessionInfo, out int pCount);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern void WTSFreeMemory(IntPtr pMemory);
+
+ [DllImport("winsta.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int WinStationQueryInformation(IntPtr hServer, int sessionId, int information, ref WINSTATIONINFORMATIONW pBuffer, int bufferLength, ref int returnedLength);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetCurrentProcessId();
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool ProcessIdToSessionId(int processId, ref int pSessionId);
+
+ public class TerminalSessionData
+ {
+ public int SessionId;
+ public string ConnectionState;
+ public string SessionName;
+ public bool IsUserSession;
+ public TerminalSessionData(int sessionId, string connState, string sessionName, bool isUserSession)
+ {
+ SessionId = sessionId;
+ ConnectionState = connState;
+ SessionName = sessionName;
+ IsUserSession = isUserSession;
+ }
+ }
+
+ public class TerminalSessionInfo
+ {
+ public string NTAccount;
+ public string SID;
+ public string UserName;
+ public string DomainName;
+ public int SessionId;
+ public string SessionName;
+ public string ConnectState;
+ public bool IsCurrentSession;
+ public bool IsConsoleSession;
+ public bool IsActiveUserSession;
+ public bool IsUserSession;
+ public bool IsRdpSession;
+ public bool IsLocalAdmin;
+ public DateTime? LogonTime;
+ public TimeSpan? IdleTime;
+ public DateTime? DisconnectTime;
+ public string ClientName;
+ public string ClientProtocolType;
+ public string ClientDirectory;
+ public int ClientBuildNumber;
+ }
+
+ [StructLayout(LayoutKind.Sequential)]
+ private struct WTS_SESSION_INFO
+ {
+ public Int32 SessionId;
+ [MarshalAs(UnmanagedType.LPStr)]
+ public string SessionName;
+ public WTS_CONNECTSTATE_CLASS State;
+ }
+
+ [StructLayout(LayoutKind.Sequential)]
+ public struct WINSTATIONINFORMATIONW
+ {
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 70)]
+ private byte[] Reserved1;
+ public int SessionId;
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)]
+ private byte[] Reserved2;
+ public FILETIME ConnectTime;
+ public FILETIME DisconnectTime;
+ public FILETIME LastInputTime;
+ public FILETIME LoginTime;
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1096)]
+ private byte[] Reserved3;
+ public FILETIME CurrentTime;
+ }
+
+ public enum WINSTATIONINFOCLASS
+ {
+ WinStationInformation = 8
+ }
+
+ public enum WTS_CONNECTSTATE_CLASS
+ {
+ Active,
+ Connected,
+ ConnectQuery,
+ Shadow,
+ Disconnected,
+ Idle,
+ Listen,
+ Reset,
+ Down,
+ Init
+ }
+
+ public enum WTS_INFO_CLASS
+ {
+ SessionId=4,
+ UserName,
+ SessionName,
+ DomainName,
+ ConnectState,
+ ClientBuildNumber,
+ ClientName,
+ ClientDirectory,
+ ClientProtocolType=16
+ }
+
+ private static IntPtr OpenServer(string Name)
+ {
+ IntPtr server = WTSOpenServer(Name);
+ return server;
+ }
+
+ private static void CloseServer(IntPtr ServerHandle)
+ {
+ WTSCloseServer(ServerHandle);
+ }
+
+ private static IList PtrToStructureList(IntPtr ppList, int count) where T : struct
+ {
+ List result = new List();
+ long pointer = ppList.ToInt64();
+ int sizeOf = Marshal.SizeOf(typeof(T));
+
+ for (int index = 0; index < count; index++)
+ {
+ T item = (T) Marshal.PtrToStructure(new IntPtr(pointer), typeof(T));
+ result.Add(item);
+ pointer += sizeOf;
+ }
+ return result;
+ }
+
+ public static DateTime? FileTimeToDateTime(FILETIME ft)
+ {
+ if (ft.dwHighDateTime == 0 && ft.dwLowDateTime == 0)
+ {
+ return null;
+ }
+ long hFT = (((long) ft.dwHighDateTime) << 32) + ft.dwLowDateTime;
+ return DateTime.FromFileTime(hFT);
+ }
+
+ public static WINSTATIONINFORMATIONW GetWinStationInformation(IntPtr server, int sessionId)
+ {
+ int retLen = 0;
+ WINSTATIONINFORMATIONW wsInfo = new WINSTATIONINFORMATIONW();
+ WinStationQueryInformation(server, sessionId, (int) WINSTATIONINFOCLASS.WinStationInformation, ref wsInfo, Marshal.SizeOf(typeof(WINSTATIONINFORMATIONW)), ref retLen);
+ return wsInfo;
+ }
+
+ public static TerminalSessionData[] ListSessions(string ServerName)
+ {
+ IntPtr server = IntPtr.Zero;
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+
+ List results = new List();
+
+ try
+ {
+ server = OpenServer(ServerName);
+ IntPtr ppSessionInfo = IntPtr.Zero;
+ int count;
+ bool _isUserSession = false;
+ IList sessionsInfo;
+
+ if (WTSEnumerateSessions(server, 0, 1, out ppSessionInfo, out count) == 0)
+ {
+ throw new Win32Exception();
+ }
+
+ try
+ {
+ sessionsInfo = PtrToStructureList(ppSessionInfo, count);
+ }
+ finally
+ {
+ WTSFreeMemory(ppSessionInfo);
+ }
+
+ foreach (WTS_SESSION_INFO sessionInfo in sessionsInfo)
+ {
+ if (sessionInfo.SessionName != "Services" && sessionInfo.SessionName != "RDP-Tcp")
+ {
+ _isUserSession = true;
+ }
+ results.Add(new TerminalSessionData(sessionInfo.SessionId, sessionInfo.State.ToString(), sessionInfo.SessionName, _isUserSession));
+ _isUserSession = false;
+ }
+ }
+ finally
+ {
+ CloseServer(server);
+ }
+
+ TerminalSessionData[] returnData = results.ToArray();
+ return returnData;
+ }
+
+ public static TerminalSessionInfo GetSessionInfo(string ServerName, int SessionId)
+ {
+ IntPtr server = IntPtr.Zero;
+ IntPtr buffer = IntPtr.Zero;
+ int bytesReturned;
+ TerminalSessionInfo data = new TerminalSessionInfo();
+ bool _IsCurrentSessionId = false;
+ bool _IsConsoleSession = false;
+ bool _IsUserSession = false;
+ int currentSessionID = 0;
+ string _NTAccount = String.Empty;
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+ if (ProcessIdToSessionId(GetCurrentProcessId(), ref currentSessionID) == false)
+ {
+ currentSessionID = -1;
+ }
+
+ // Get all members of the local administrators group
+ bool _IsLocalAdminCheckSuccess = false;
+ List localAdminGroupSidsList = new List();
+ try
+ {
+ DirectoryEntry localMachine = new DirectoryEntry("WinNT://" + ServerName + ",Computer");
+ string localAdminGroupName = new SecurityIdentifier("S-1-5-32-544").Translate(typeof(NTAccount)).Value.Split('\\')[1];
+ DirectoryEntry admGroup = localMachine.Children.Find(localAdminGroupName, "group");
+ object members = admGroup.Invoke("members", null);
+ foreach (object groupMember in (IEnumerable)members)
+ {
+ DirectoryEntry member = new DirectoryEntry(groupMember);
+ if (member.Name != String.Empty)
+ {
+ localAdminGroupSidsList.Add((new NTAccount(member.Name)).Translate(typeof(SecurityIdentifier)).Value);
+ }
+ }
+ _IsLocalAdminCheckSuccess = true;
+ }
+ catch { }
+
+ try
+ {
+ server = OpenServer(ServerName);
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientBuildNumber, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ int lData = Marshal.ReadInt32(buffer);
+ data.ClientBuildNumber = lData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientDirectory, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ string strData = Marshal.PtrToStringAnsi(buffer);
+ data.ClientDirectory = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.ClientName = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientProtocolType, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ Int16 intData = Marshal.ReadInt16(buffer);
+ if (intData == 2)
+ {
+ strData = "RDP";
+ data.IsRdpSession = true;
+ }
+ else
+ {
+ strData = "";
+ data.IsRdpSession = false;
+ }
+ data.ClientProtocolType = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ConnectState, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ lData = Marshal.ReadInt32(buffer);
+ data.ConnectState = ((WTS_CONNECTSTATE_CLASS) lData).ToString();
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.SessionId, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ lData = Marshal.ReadInt32(buffer);
+ data.SessionId = lData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.DomainName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer).ToUpper();
+ data.DomainName = strData;
+ if (strData != String.Empty)
+ {
+ _NTAccount = strData;
+ }
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.UserName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.UserName = strData;
+ if (strData != String.Empty)
+ {
+ data.NTAccount = _NTAccount + "\\" + strData;
+ string _Sid = (new NTAccount(_NTAccount + "\\" + strData)).Translate(typeof(SecurityIdentifier)).Value;
+ data.SID = _Sid;
+ if (_IsLocalAdminCheckSuccess == true)
+ {
+ foreach (string localAdminGroupSid in localAdminGroupSidsList)
+ {
+ if (localAdminGroupSid == _Sid)
+ {
+ data.IsLocalAdmin = true;
+ break;
+ }
+ else
+ {
+ data.IsLocalAdmin = false;
+ }
+ }
+ }
+ }
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.SessionName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.SessionName = strData;
+ if (strData != "Services" && strData != "RDP-Tcp" && data.UserName != String.Empty)
+ {
+ _IsUserSession = true;
+ }
+ data.IsUserSession = _IsUserSession;
+ if (strData == "Console")
+ {
+ _IsConsoleSession = true;
+ }
+ data.IsConsoleSession = _IsConsoleSession;
+
+ WINSTATIONINFORMATIONW wsInfo = GetWinStationInformation(server, SessionId);
+ DateTime? _loginTime = FileTimeToDateTime(wsInfo.LoginTime);
+ DateTime? _lastInputTime = FileTimeToDateTime(wsInfo.LastInputTime);
+ DateTime? _disconnectTime = FileTimeToDateTime(wsInfo.DisconnectTime);
+ DateTime? _currentTime = FileTimeToDateTime(wsInfo.CurrentTime);
+ TimeSpan? _idleTime = (_currentTime != null && _lastInputTime != null) ? _currentTime.Value - _lastInputTime.Value : TimeSpan.Zero;
+ data.LogonTime = _loginTime;
+ data.IdleTime = _idleTime;
+ data.DisconnectTime = _disconnectTime;
+
+ if (currentSessionID == SessionId)
+ {
+ _IsCurrentSessionId = true;
+ }
+ data.IsCurrentSession = _IsCurrentSessionId;
+ }
+ finally
+ {
+ WTSFreeMemory(buffer);
+ buffer = IntPtr.Zero;
+ CloseServer(server);
+ }
+ return data;
+ }
+
+ public static TerminalSessionInfo[] GetUserSessionInfo(string ServerName)
+ {
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+
+ // Find and get detailed information for all user sessions
+ // Also determine the active user session. If a console user exists, then that will be the active user session.
+ // If no console user exists but users are logged in, such as on terminal servers, then select the first logged-in non-console user that is either 'Active' or 'Connected' as the active user.
+ TerminalSessionData[] sessions = ListSessions(ServerName);
+ TerminalSessionInfo sessionInfo = new TerminalSessionInfo();
+ List userSessionsInfo = new List();
+ string firstActiveUserNTAccount = String.Empty;
+ bool IsActiveUserSessionSet = false;
+ foreach (TerminalSessionData session in sessions)
+ {
+ if (session.IsUserSession == true)
+ {
+ sessionInfo = GetSessionInfo(ServerName, session.SessionId);
+ if (sessionInfo.IsUserSession == true)
+ {
+ if ((firstActiveUserNTAccount == String.Empty) && (sessionInfo.ConnectState == "Active" || sessionInfo.ConnectState == "Connected"))
+ {
+ firstActiveUserNTAccount = sessionInfo.NTAccount;
+ }
+
+ if (sessionInfo.IsConsoleSession == true)
+ {
+ sessionInfo.IsActiveUserSession = true;
+ IsActiveUserSessionSet = true;
+ }
+ else
+ {
+ sessionInfo.IsActiveUserSession = false;
+ }
+
+ userSessionsInfo.Add(sessionInfo);
+ }
+ }
+ }
+
+ TerminalSessionInfo[] userSessions = userSessionsInfo.ToArray();
+ if (IsActiveUserSessionSet == false)
+ {
+ foreach (TerminalSessionInfo userSession in userSessions)
+ {
+ if (userSession.NTAccount == firstActiveUserNTAccount)
+ {
+ userSession.IsActiveUserSession = true;
+ break;
+ }
+ }
+ }
+
+ return userSessions;
+ }
+ }
+}
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.ps1 b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.ps1
new file mode 100644
index 0000000..9687117
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.ps1
@@ -0,0 +1,10830 @@
+<#
+.SYNOPSIS
+ This script contains the functions and logic engine for the Deploy-Application.ps1 script.
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script can be called directly to dot-source the toolkit functions for testing, but it is usually called by the Deploy-Application.ps1 script.
+ The script can usually be updated to the latest version without impacting your per-application Deploy-Application scripts.
+ Please check release notes before upgrading.
+.PARAMETER CleanupBlockedApps
+ Clean up the blocked applications.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ShowBlockedAppDialog
+ Display a dialog box showing that the application execution is blocked.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredInstallName
+ Name of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredInstallTitle
+ Title of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredLogname
+ Logfile name of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER AsyncToolkitLaunch
+ This parameter is passed to the script when it is being called externally, e.g. from a scheduled task or asynchronously.
+.NOTES
+ The other parameters specified for this script that are not documented in this help section are for use only by functions in this script that call themselves by running this script again asynchronously.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+ ## Script Parameters: These parameters are passed to the script when it is called externally from a scheduled task or because of an Image File Execution Options registry setting
+ [switch]$ShowInstallationPrompt = $false,
+ [switch]$ShowInstallationRestartPrompt = $false,
+ [switch]$CleanupBlockedApps = $false,
+ [switch]$ShowBlockedAppDialog = $false,
+ [switch]$DisableLogging = $false,
+ [string]$ReferredInstallName = '',
+ [string]$ReferredInstallTitle = '',
+ [string]$ReferredLogName = '',
+ [string]$Message = '',
+ [string]$MessageAlignment = '',
+ [string]$ButtonRightText = '',
+ [string]$ButtonLeftText = '',
+ [string]$ButtonMiddleText = '',
+ [string]$Icon = '',
+ [string]$Timeout = '',
+ [switch]$ExitOnTimeout = $false,
+ [boolean]$MinimizeWindows = $false,
+ [switch]$PersistPrompt = $false,
+ [int32]$CountdownSeconds,
+ [int32]$CountdownNoHideSeconds,
+ [switch]$NoCountdown = $false,
+ [switch]$AsyncToolkitLaunch = $false
+)
+
+##*=============================================
+##* VARIABLE DECLARATION
+##*=============================================
+#region VariableDeclaration
+
+## Variables: Toolkit Name
+[string]$appDeployToolkitName = 'PSAppDeployToolkit'
+[string]$appDeployMainScriptFriendlyName = 'App Deploy Toolkit Main'
+
+## Variables: Script Info
+[version]$appDeployMainScriptVersion = [version]'3.7.0'
+[version]$appDeployMainScriptMinimumConfigVersion = [version]'3.6.9'
+[string]$appDeployMainScriptDate = '02/13/2018'
+[hashtable]$appDeployMainScriptParameters = $PSBoundParameters
+
+## Variables: Datetime and Culture
+[datetime]$currentDateTime = Get-Date
+[string]$currentTime = Get-Date -Date $currentDateTime -UFormat '%T'
+[string]$currentDate = Get-Date -Date $currentDateTime -UFormat '%d-%m-%Y'
+[timespan]$currentTimeZoneBias = [timezone]::CurrentTimeZone.GetUtcOffset([datetime]::Now)
+[Globalization.CultureInfo]$culture = Get-Culture
+[string]$currentLanguage = $culture.TwoLetterISOLanguageName.ToUpper()
+[Globalization.CultureInfo]$uiculture = Get-UICulture
+[string]$currentUILanguage = $uiculture.TwoLetterISOLanguageName.ToUpper()
+
+## Variables: Environment Variables
+[psobject]$envHost = $Host
+[psobject]$envShellFolders = Get-ItemProperty -Path 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders' -ErrorAction 'SilentlyContinue'
+[string]$envAllUsersProfile = $env:ALLUSERSPROFILE
+[string]$envAppData = [Environment]::GetFolderPath('ApplicationData')
+[string]$envArchitecture = $env:PROCESSOR_ARCHITECTURE
+[string]$envCommonProgramFiles = [Environment]::GetFolderPath('CommonProgramFiles')
+[string]$envCommonProgramFilesX86 = ${env:CommonProgramFiles(x86)}
+[string]$envCommonDesktop = $envShellFolders | Select-Object -ExpandProperty 'Common Desktop' -ErrorAction 'SilentlyContinue'
+[string]$envCommonDocuments = $envShellFolders | Select-Object -ExpandProperty 'Common Documents' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartMenuPrograms = $envShellFolders | Select-Object -ExpandProperty 'Common Programs' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartMenu = $envShellFolders | Select-Object -ExpandProperty 'Common Start Menu' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartUp = $envShellFolders | Select-Object -ExpandProperty 'Common Startup' -ErrorAction 'SilentlyContinue'
+[string]$envCommonTemplates = $envShellFolders | Select-Object -ExpandProperty 'Common Templates' -ErrorAction 'SilentlyContinue'
+[string]$envComputerName = [Environment]::MachineName.ToUpper()
+[string]$envComputerNameFQDN = ([Net.Dns]::GetHostEntry('localhost')).HostName
+[string]$envHomeDrive = $env:HOMEDRIVE
+[string]$envHomePath = $env:HOMEPATH
+[string]$envHomeShare = $env:HOMESHARE
+[string]$envLocalAppData = [Environment]::GetFolderPath('LocalApplicationData')
+[string[]]$envLogicalDrives = [Environment]::GetLogicalDrives()
+[string]$envProgramFiles = [Environment]::GetFolderPath('ProgramFiles')
+[string]$envProgramFilesX86 = ${env:ProgramFiles(x86)}
+[string]$envProgramData = [Environment]::GetFolderPath('CommonApplicationData')
+[string]$envPublic = $env:PUBLIC
+[string]$envSystemDrive = $env:SYSTEMDRIVE
+[string]$envSystemRoot = $env:SYSTEMROOT
+[string]$envTemp = [IO.Path]::GetTempPath()
+[string]$envUserCookies = [Environment]::GetFolderPath('Cookies')
+[string]$envUserDesktop = [Environment]::GetFolderPath('DesktopDirectory')
+[string]$envUserFavorites = [Environment]::GetFolderPath('Favorites')
+[string]$envUserInternetCache = [Environment]::GetFolderPath('InternetCache')
+[string]$envUserInternetHistory = [Environment]::GetFolderPath('History')
+[string]$envUserMyDocuments = [Environment]::GetFolderPath('MyDocuments')
+[string]$envUserName = [Environment]::UserName
+[string]$envUserPictures = [Environment]::GetFolderPath('MyPictures')
+[string]$envUserProfile = $env:USERPROFILE
+[string]$envUserSendTo = [Environment]::GetFolderPath('SendTo')
+[string]$envUserStartMenu = [Environment]::GetFolderPath('StartMenu')
+[string]$envUserStartMenuPrograms = [Environment]::GetFolderPath('Programs')
+[string]$envUserStartUp = [Environment]::GetFolderPath('StartUp')
+[string]$envUserTemplates = [Environment]::GetFolderPath('Templates')
+[string]$envSystem32Directory = [Environment]::SystemDirectory
+[string]$envWinDir = $env:WINDIR
+# Handle X86 environment variables so they are never empty
+If (-not $envCommonProgramFilesX86) { [string]$envCommonProgramFilesX86 = $envCommonProgramFiles }
+If (-not $envProgramFilesX86) { [string]$envProgramFilesX86 = $envProgramFiles }
+
+## Variables: Domain Membership
+[boolean]$IsMachinePartOfDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').PartOfDomain
+[string]$envMachineWorkgroup = ''
+[string]$envMachineADDomain = ''
+[string]$envLogonServer = ''
+[string]$MachineDomainController = ''
+If ($IsMachinePartOfDomain) {
+ [string]$envMachineADDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').Domain | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+ Try {
+ [string]$envLogonServer = $env:LOGONSERVER | Where-Object { (($_) -and (-not $_.Contains('\\MicrosoftAccount'))) } | ForEach-Object { $_.TrimStart('\') } | ForEach-Object { ([Net.Dns]::GetHostEntry($_)).HostName }
+ # If running in system context, fall back on the logonserver value stored in the registry
+ If (-not $envLogonServer) { [string]$envLogonServer = Get-ItemProperty -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Group Policy\History' -ErrorAction 'SilentlyContinue' | Select-Object -ExpandProperty 'DCName' -ErrorAction 'SilentlyContinue' }
+ [string]$MachineDomainController = [DirectoryServices.ActiveDirectory.Domain]::GetCurrentDomain().FindDomainController().Name
+ }
+ Catch { }
+}
+Else {
+ [string]$envMachineWorkgroup = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').Domain | Where-Object { $_ } | ForEach-Object { $_.ToUpper() }
+}
+[string]$envMachineDNSDomain = [Net.NetworkInformation.IPGlobalProperties]::GetIPGlobalProperties().DomainName | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+[string]$envUserDNSDomain = $env:USERDNSDOMAIN | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+Try {
+ [string]$envUserDomain = [Environment]::UserDomainName.ToUpper()
+}
+Catch { }
+
+## Variables: Operating System
+[psobject]$envOS = Get-WmiObject -Class 'Win32_OperatingSystem' -ErrorAction 'SilentlyContinue'
+[string]$envOSName = $envOS.Caption.Trim()
+[string]$envOSServicePack = $envOS.CSDVersion
+[version]$envOSVersion = $envOS.Version
+[string]$envOSVersionMajor = $envOSVersion.Major
+[string]$envOSVersionMinor = $envOSVersion.Minor
+[string]$envOSVersionBuild = $envOSVersion.Build
+If ($envOSVersionMajor -eq 10) {$envOSVersionRevision = (Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'UBR' -ErrorAction SilentlyContinue).UBR}
+Else { [string]$envOSVersionRevision = ,((Get-ItemProperty -Path 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'BuildLabEx' -ErrorAction 'SilentlyContinue').BuildLabEx -split '\.') | ForEach-Object { $_[1] } }
+If ($envOSVersionRevision -notmatch '^[\d\.]+$') { $envOSVersionRevision = '' }
+If ($envOSVersionRevision) { [string]$envOSVersion = "$($envOSVersion.ToString()).$envOSVersionRevision" } Else { "$($envOSVersion.ToString())" }
+# Get the operating system type
+[int32]$envOSProductType = $envOS.ProductType
+[boolean]$IsServerOS = [boolean]($envOSProductType -eq 3)
+[boolean]$IsDomainControllerOS = [boolean]($envOSProductType -eq 2)
+[boolean]$IsWorkStationOS = [boolean]($envOSProductType -eq 1)
+Switch ($envOSProductType) {
+ 3 { [string]$envOSProductTypeName = 'Server' }
+ 2 { [string]$envOSProductTypeName = 'Domain Controller' }
+ 1 { [string]$envOSProductTypeName = 'Workstation' }
+ Default { [string]$envOSProductTypeName = 'Unknown' }
+}
+# Get the OS Architecture
+[boolean]$Is64Bit = [boolean]((Get-WmiObject -Class 'Win32_Processor' -ErrorAction 'SilentlyContinue' | Where-Object { $_.DeviceID -eq 'CPU0' } | Select-Object -ExpandProperty 'AddressWidth') -eq 64)
+If ($Is64Bit) { [string]$envOSArchitecture = '64-bit' } Else { [string]$envOSArchitecture = '32-bit' }
+
+## Variables: Current Process Architecture
+[boolean]$Is64BitProcess = [boolean]([IntPtr]::Size -eq 8)
+If ($Is64BitProcess) { [string]$psArchitecture = 'x64' } Else { [string]$psArchitecture = 'x86' }
+
+## Variables: Hardware
+[int32]$envSystemRAM = Get-WMIObject -Class Win32_PhysicalMemory -ComputerName $env:COMPUTERNAME -ErrorAction 'SilentlyContinue' | Measure-Object -Property Capacity -Sum -ErrorAction SilentlyContinue | % {[Math]::Round(($_.sum / 1GB),2)}
+
+## Variables: PowerShell And CLR (.NET) Versions
+[hashtable]$envPSVersionTable = $PSVersionTable
+# PowerShell Version
+[version]$envPSVersion = $envPSVersionTable.PSVersion
+[string]$envPSVersionMajor = $envPSVersion.Major
+[string]$envPSVersionMinor = $envPSVersion.Minor
+[string]$envPSVersionBuild = $envPSVersion.Build
+[string]$envPSVersionRevision = $envPSVersion.Revision
+[string]$envPSVersion = $envPSVersion.ToString()
+# CLR (.NET) Version used by PowerShell
+[version]$envCLRVersion = $envPSVersionTable.CLRVersion
+[string]$envCLRVersionMajor = $envCLRVersion.Major
+[string]$envCLRVersionMinor = $envCLRVersion.Minor
+[string]$envCLRVersionBuild = $envCLRVersion.Build
+[string]$envCLRVersionRevision = $envCLRVersion.Revision
+[string]$envCLRVersion = $envCLRVersion.ToString()
+
+## Variables: Permissions/Accounts
+[Security.Principal.WindowsIdentity]$CurrentProcessToken = [Security.Principal.WindowsIdentity]::GetCurrent()
+[Security.Principal.SecurityIdentifier]$CurrentProcessSID = $CurrentProcessToken.User
+[string]$ProcessNTAccount = $CurrentProcessToken.Name
+[string]$ProcessNTAccountSID = $CurrentProcessSID.Value
+[boolean]$IsAdmin = [boolean]($CurrentProcessToken.Groups -contains [Security.Principal.SecurityIdentifier]'S-1-5-32-544')
+[boolean]$IsLocalSystemAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'LocalSystemSid')
+[boolean]$IsLocalServiceAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'LocalServiceSid')
+[boolean]$IsNetworkServiceAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'NetworkServiceSid')
+[boolean]$IsServiceAccount = [boolean]($CurrentProcessToken.Groups -contains [Security.Principal.SecurityIdentifier]'S-1-5-6')
+[boolean]$IsProcessUserInteractive = [Environment]::UserInteractive
+[string]$LocalSystemNTAccount = (New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ([Security.Principal.WellKnownSidType]::'LocalSystemSid', $null)).Translate([Security.Principal.NTAccount]).Value
+# Check if script is running in session zero
+If ($IsLocalSystemAccount -or $IsLocalServiceAccount -or $IsNetworkServiceAccount -or $IsServiceAccount) { $SessionZero = $true } Else { $SessionZero = $false }
+
+## Variables: Script Name and Script Paths
+[string]$scriptPath = $MyInvocation.MyCommand.Definition
+[string]$scriptName = [IO.Path]::GetFileNameWithoutExtension($scriptPath)
+[string]$scriptFileName = Split-Path -Path $scriptPath -Leaf
+[string]$scriptRoot = Split-Path -Path $scriptPath -Parent
+[string]$invokingScript = (Get-Variable -Name 'MyInvocation').Value.ScriptName
+# Get the invoking script directory
+If ($invokingScript) {
+ # If this script was invoked by another script
+ [string]$scriptParentPath = Split-Path -Path $invokingScript -Parent
+}
+Else {
+ # If this script was not invoked by another script, fall back to the directory one level above this script
+ [string]$scriptParentPath = (Get-Item -LiteralPath $scriptRoot).Parent.FullName
+}
+
+## Variables: App Deploy Script Dependency Files
+[string]$appDeployLogoIcon = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitLogo.ico'
+[string]$appDeployLogoBanner = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitBanner.png'
+[string]$appDeployConfigFile = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitConfig.xml'
+[string]$appDeployCustomTypesSourceCode = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitMain.cs'
+# App Deploy Optional Extensions File
+[string]$appDeployToolkitDotSourceExtensions = 'AppDeployToolkitExtensions.ps1'
+# Check that dependency files are present
+If (-not (Test-Path -LiteralPath $appDeployLogoIcon -PathType 'Leaf')) { Throw 'App Deploy logo icon file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployLogoBanner -PathType 'Leaf')) { Throw 'App Deploy logo banner file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployConfigFile -PathType 'Leaf')) { Throw 'App Deploy XML configuration file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployCustomTypesSourceCode -PathType 'Leaf')) { Throw 'App Deploy custom types source code file not found.' }
+
+## Import variables from XML configuration file
+[Xml.XmlDocument]$xmlConfigFile = Get-Content -LiteralPath $AppDeployConfigFile
+[Xml.XmlElement]$xmlConfig = $xmlConfigFile.AppDeployToolkit_Config
+# Get Config File Details
+[Xml.XmlElement]$configConfigDetails = $xmlConfig.Config_File
+[string]$configConfigVersion = [version]$configConfigDetails.Config_Version
+[string]$configConfigDate = $configConfigDetails.Config_Date
+# Get Toolkit Options
+[Xml.XmlElement]$xmlToolkitOptions = $xmlConfig.Toolkit_Options
+[boolean]$configToolkitRequireAdmin = [boolean]::Parse($xmlToolkitOptions.Toolkit_RequireAdmin)
+[string]$configToolkitTempPath = $ExecutionContext.InvokeCommand.ExpandString($xmlToolkitOptions.Toolkit_TempPath)
+[string]$configToolkitRegPath = $xmlToolkitOptions.Toolkit_RegPath
+[string]$configToolkitLogDir = $ExecutionContext.InvokeCommand.ExpandString($xmlToolkitOptions.Toolkit_LogPath)
+[boolean]$configToolkitCompressLogs = [boolean]::Parse($xmlToolkitOptions.Toolkit_CompressLogs)
+[string]$configToolkitLogStyle = $xmlToolkitOptions.Toolkit_LogStyle
+[double]$configToolkitLogMaxSize = $xmlToolkitOptions.Toolkit_LogMaxSize
+[boolean]$configToolkitLogWriteToHost = [boolean]::Parse($xmlToolkitOptions.Toolkit_LogWriteToHost)
+[boolean]$configToolkitLogDebugMessage = [boolean]::Parse($xmlToolkitOptions.Toolkit_LogDebugMessage)
+# Get MSI Options
+[Xml.XmlElement]$xmlConfigMSIOptions = $xmlConfig.MSI_Options
+[string]$configMSILoggingOptions = $xmlConfigMSIOptions.MSI_LoggingOptions
+[string]$configMSIInstallParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_InstallParams)
+[string]$configMSISilentParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_SilentParams)
+[string]$configMSIUninstallParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_UninstallParams)
+[string]$configMSILogDir = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_LogPath)
+[int32]$configMSIMutexWaitTime = $xmlConfigMSIOptions.MSI_MutexWaitTime
+# Get UI Options
+[Xml.XmlElement]$xmlConfigUIOptions = $xmlConfig.UI_Options
+[string]$configInstallationUILanguageOverride = $xmlConfigUIOptions.InstallationUI_LanguageOverride
+[boolean]$configShowBalloonNotifications = [boolean]::Parse($xmlConfigUIOptions.ShowBalloonNotifications)
+[int32]$configInstallationUITimeout = $xmlConfigUIOptions.InstallationUI_Timeout
+[int32]$configInstallationUIExitCode = $xmlConfigUIOptions.InstallationUI_ExitCode
+[int32]$configInstallationDeferExitCode = $xmlConfigUIOptions.InstallationDefer_ExitCode
+[int32]$configInstallationPersistInterval = $xmlConfigUIOptions.InstallationPrompt_PersistInterval
+[int32]$configInstallationRestartPersistInterval = $xmlConfigUIOptions.InstallationRestartPrompt_PersistInterval
+[int32]$configInstallationPromptToSave = $xmlConfigUIOptions.InstallationPromptToSave_Timeout
+[boolean]$configInstallationWelcomePromptDynamicRunningProcessEvaluation = [boolean]::Parse($xmlConfigUIOptions.InstallationWelcomePrompt_DynamicRunningProcessEvaluation)
+[int32]$configInstallationWelcomePromptDynamicRunningProcessEvaluationInterval = $xmlConfigUIOptions.InstallationWelcomePrompt_DynamicRunningProcessEvaluationInterval
+# Define ScriptBlock for Loading Message UI Language Options (default for English if no localization found)
+[scriptblock]$xmlLoadLocalizedUIMessages = {
+ # If a user is logged on, then get primary UI language for logged on user (even if running in session 0)
+ If ($RunAsActiveUser) {
+ # Read language defined by Group Policy
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKLM:SOFTWARE\Policies\Microsoft\MUI\Settings' -Value 'PreferredUILanguages'
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Software\Policies\Microsoft\Windows\Control Panel\Desktop' -Value 'PreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ # Read language for Win Vista & higher machines
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop' -Value 'PreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop\MuiCached' -Value 'MachinePreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\International' -Value 'LocaleName' -SID $RunAsActiveUser.SID
+ }
+ # Read language for Win XP machines
+ If (-not $HKULanguages) {
+ [string]$HKULocale = Get-RegistryKey -Key 'HKCU\Control Panel\International' -Value 'Locale' -SID $RunAsActiveUser.SID
+ If ($HKULocale) {
+ [int32]$HKULocale = [Convert]::ToInt32('0x' + $HKULocale, 16)
+ [string[]]$HKULanguages = ([Globalization.CultureInfo]($HKULocale)).Name
+ }
+ }
+ If ($HKULanguages) {
+ [Globalization.CultureInfo]$PrimaryWindowsUILanguage = [Globalization.CultureInfo]($HKULanguages[0])
+ [string]$HKUPrimaryLanguageShort = $PrimaryWindowsUILanguage.TwoLetterISOLanguageName.ToUpper()
+
+ # If the detected language is Chinese, determine if it is simplified or traditional Chinese
+ If ($HKUPrimaryLanguageShort -eq 'ZH') {
+ If ($PrimaryWindowsUILanguage.EnglishName -match 'Simplified') {
+ [string]$HKUPrimaryLanguageShort = 'ZH-Hans'
+ }
+ If ($PrimaryWindowsUILanguage.EnglishName -match 'Traditional') {
+ [string]$HKUPrimaryLanguageShort = 'ZH-Hant'
+ }
+ }
+
+ # If the detected language is Portuguese, determine if it is Brazilian Portuguese
+ If ($HKUPrimaryLanguageShort -eq 'PT') {
+ If ($PrimaryWindowsUILanguage.ThreeLetterWindowsLanguageName -eq 'PTB') {
+ [string]$HKUPrimaryLanguageShort = 'PT-BR'
+ }
+ }
+ }
+ }
+
+ If ($HKUPrimaryLanguageShort) {
+ # Use the primary UI language of the logged in user
+ [string]$xmlUIMessageLanguage = "UI_Messages_$HKUPrimaryLanguageShort"
+ }
+ Else {
+ # Default to UI language of the account executing current process (even if it is the SYSTEM account)
+ [string]$xmlUIMessageLanguage = "UI_Messages_$currentLanguage"
+ }
+ # Default to English if the detected UI language is not available in the XMl config file
+ If (-not ($xmlConfig.$xmlUIMessageLanguage)) { [string]$xmlUIMessageLanguage = 'UI_Messages_EN' }
+ # Override the detected language if the override option was specified in the XML config file
+ If ($configInstallationUILanguageOverride) { [string]$xmlUIMessageLanguage = "UI_Messages_$configInstallationUILanguageOverride" }
+
+ [Xml.XmlElement]$xmlUIMessages = $xmlConfig.$xmlUIMessageLanguage
+ [string]$configDiskSpaceMessage = $xmlUIMessages.DiskSpace_Message
+ [string]$configBalloonTextStart = $xmlUIMessages.BalloonText_Start
+ [string]$configBalloonTextComplete = $xmlUIMessages.BalloonText_Complete
+ [string]$configBalloonTextRestartRequired = $xmlUIMessages.BalloonText_RestartRequired
+ [string]$configBalloonTextFastRetry = $xmlUIMessages.BalloonText_FastRetry
+ [string]$configBalloonTextError = $xmlUIMessages.BalloonText_Error
+ [string]$configProgressMessageInstall = $xmlUIMessages.Progress_MessageInstall
+ [string]$configProgressMessageUninstall = $xmlUIMessages.Progress_MessageUninstall
+ [string]$configClosePromptMessage = $xmlUIMessages.ClosePrompt_Message
+ [string]$configClosePromptButtonClose = $xmlUIMessages.ClosePrompt_ButtonClose
+ [string]$configClosePromptButtonDefer = $xmlUIMessages.ClosePrompt_ButtonDefer
+ [string]$configClosePromptButtonContinue = $xmlUIMessages.ClosePrompt_ButtonContinue
+ [string]$configClosePromptButtonContinueTooltip = $xmlUIMessages.ClosePrompt_ButtonContinueTooltip
+ [string]$configClosePromptCountdownMessage = $xmlUIMessages.ClosePrompt_CountdownMessage
+ [string]$configDeferPromptWelcomeMessage = $xmlUIMessages.DeferPrompt_WelcomeMessage
+ [string]$configDeferPromptExpiryMessage = $xmlUIMessages.DeferPrompt_ExpiryMessage
+ [string]$configDeferPromptWarningMessage = $xmlUIMessages.DeferPrompt_WarningMessage
+ [string]$configDeferPromptRemainingDeferrals = $xmlUIMessages.DeferPrompt_RemainingDeferrals
+ [string]$configDeferPromptDeadline = $xmlUIMessages.DeferPrompt_Deadline
+ [string]$configBlockExecutionMessage = $xmlUIMessages.BlockExecution_Message
+ [string]$configDeploymentTypeInstall = $xmlUIMessages.DeploymentType_Install
+ [string]$configDeploymentTypeUnInstall = $xmlUIMessages.DeploymentType_UnInstall
+ [string]$configRestartPromptTitle = $xmlUIMessages.RestartPrompt_Title
+ [string]$configRestartPromptMessage = $xmlUIMessages.RestartPrompt_Message
+ [string]$configRestartPromptMessageTime = $xmlUIMessages.RestartPrompt_MessageTime
+ [string]$configRestartPromptMessageRestart = $xmlUIMessages.RestartPrompt_MessageRestart
+ [string]$configRestartPromptTimeRemaining = $xmlUIMessages.RestartPrompt_TimeRemaining
+ [string]$configRestartPromptButtonRestartLater = $xmlUIMessages.RestartPrompt_ButtonRestartLater
+ [string]$configRestartPromptButtonRestartNow = $xmlUIMessages.RestartPrompt_ButtonRestartNow
+ [string]$configWelcomePromptCountdownMessage = $xmlUIMessages.WelcomePrompt_CountdownMessage
+ [string]$configWelcomePromptCustomMessage = $xmlUIMessages.WelcomePrompt_CustomMessage
+}
+
+## Variables: Script Directories
+[string]$dirFiles = Join-Path -Path $scriptParentPath -ChildPath 'Files'
+[string]$dirSupportFiles = Join-Path -Path $scriptParentPath -ChildPath 'SupportFiles'
+[string]$dirAppDeployTemp = Join-Path -Path $configToolkitTempPath -ChildPath $appDeployToolkitName
+
+## Set the deployment type to "Install" if it has not been specified
+If (-not $deploymentType) { [string]$deploymentType = 'Install' }
+
+## Variables: Executables
+[string]$exeWusa = 'wusa.exe' # Installs Standalone Windows Updates
+[string]$exeMsiexec = 'msiexec.exe' # Installs MSI Installers
+[string]$exeSchTasks = "$envWinDir\System32\schtasks.exe" # Manages Scheduled Tasks
+
+## Variables: RegEx Patterns
+[string]$MSIProductCodeRegExPattern = '^(\{{0,1}([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}\}{0,1})$'
+
+## Variables: Registry Keys
+# Registry keys for native and WOW64 applications
+[string[]]$regKeyApplications = 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall','HKLM:SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall'
+If ($is64Bit) {
+ [string]$regKeyLotusNotes = 'HKLM:SOFTWARE\Wow6432Node\Lotus\Notes'
+}
+Else {
+ [string]$regKeyLotusNotes = 'HKLM:SOFTWARE\Lotus\Notes'
+}
+[string]$regKeyAppExecution = 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options'
+
+## COM Objects: Initialize
+[__comobject]$Shell = New-Object -ComObject 'WScript.Shell' -ErrorAction 'SilentlyContinue'
+[__comobject]$ShellApp = New-Object -ComObject 'Shell.Application' -ErrorAction 'SilentlyContinue'
+
+## Variables: Reset/Remove Variables
+[boolean]$msiRebootDetected = $false
+[boolean]$BlockExecution = $false
+[boolean]$installationStarted = $false
+[boolean]$runningTaskSequence = $false
+If (Test-Path -LiteralPath 'variable:welcomeTimer') { Remove-Variable -Name 'welcomeTimer' -Scope 'Script'}
+# Reset the deferral history
+If (Test-Path -LiteralPath 'variable:deferHistory') { Remove-Variable -Name 'deferHistory' }
+If (Test-Path -LiteralPath 'variable:deferTimes') { Remove-Variable -Name 'deferTimes' }
+If (Test-Path -LiteralPath 'variable:deferDays') { Remove-Variable -Name 'deferDays' }
+
+## Variables: System DPI Scale Factor
+[scriptblock]$GetDisplayScaleFactor = {
+ # If a user is logged on, then get display scale factor for logged on user (even if running in session 0)
+ [boolean]$UserDisplayScaleFactor = $false
+ If ($RunAsActiveUser) {
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop\WindowMetrics' -Value 'AppliedDPI' -SID $RunAsActiveUser.SID
+ If (-not ([string]$dpiPixels)) {
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop' -Value 'LogPixels' -SID $RunAsActiveUser.SID
+ }
+ [boolean]$UserDisplayScaleFactor = $true
+ }
+ If (-not ([string]$dpiPixels)) {
+ # This registry setting only exists if system scale factor has been changed at least once
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion\FontDPI' -Value 'LogPixels'
+ [boolean]$UserDisplayScaleFactor = $false
+ }
+ Switch ($dpiPixels) {
+ 96 { [int32]$dpiScale = 100 }
+ 120 { [int32]$dpiScale = 125 }
+ 144 { [int32]$dpiScale = 150 }
+ 192 { [int32]$dpiScale = 200 }
+ Default { [int32]$dpiScale = 100 }
+ }
+}
+#endregion
+##*=============================================
+##* END VARIABLE DECLARATION
+##*=============================================
+
+##*=============================================
+##* FUNCTION LISTINGS
+##*=============================================
+#region FunctionListings
+
+#region Function Write-FunctionHeaderOrFooter
+Function Write-FunctionHeaderOrFooter {
+<#
+.SYNOPSIS
+ Write the function header or footer to the log upon first entering or exiting a function.
+.DESCRIPTION
+ Write the "Function Start" message, the bound parameters the function was invoked with, or the "Function End" message when entering or exiting a function.
+ Messages are debug messages so will only be logged if LogDebugMessage option is enabled in XML config file.
+.PARAMETER CmdletName
+ The name of the function this function is invoked from.
+.PARAMETER CmdletBoundParameters
+ The bound parameters of the function this function is invoked from.
+.PARAMETER Header
+ Write the function header.
+.PARAMETER Footer
+ Write the function footer.
+.EXAMPLE
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+.EXAMPLE
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$CmdletName,
+ [Parameter(Mandatory=$true,ParameterSetName='Header')]
+ [AllowEmptyCollection()]
+ [hashtable]$CmdletBoundParameters,
+ [Parameter(Mandatory=$true,ParameterSetName='Header')]
+ [switch]$Header,
+ [Parameter(Mandatory=$true,ParameterSetName='Footer')]
+ [switch]$Footer
+ )
+
+ If ($Header) {
+ Write-Log -Message 'Function Start' -Source ${CmdletName} -DebugMessage
+
+ ## Get the parameters that the calling function was invoked with
+ [string]$CmdletBoundParameters = $CmdletBoundParameters | Format-Table -Property @{ Label = 'Parameter'; Expression = { "[-$($_.Key)]" } }, @{ Label = 'Value'; Expression = { $_.Value }; Alignment = 'Left' }, @{ Label = 'Type'; Expression = { $_.Value.GetType().Name }; Alignment = 'Left' } -AutoSize -Wrap | Out-String
+ If ($CmdletBoundParameters) {
+ Write-Log -Message "Function invoked with bound parameter(s): `n$CmdletBoundParameters" -Source ${CmdletName} -DebugMessage
+ }
+ Else {
+ Write-Log -Message 'Function invoked without any bound parameters.' -Source ${CmdletName} -DebugMessage
+ }
+ }
+ ElseIf ($Footer) {
+ Write-Log -Message 'Function End' -Source ${CmdletName} -DebugMessage
+ }
+}
+#endregion
+#region Function Execute-MSP
+Function Execute-MSP {
+<#
+.SYNOPSIS
+ Reads SummaryInfo targeted product codes in MSP file and determines if the MSP file applies to any installed products
+ If a valid installed product is found, triggers the Execute-MSI function to patch the installation.
+.PARAMETER Path
+.EXAMPLE
+ Execute-MSP -Path 'Adobe_Reader_11.0.3_EN.msp'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,HelpMessage='Please enter the path to the MSP file')]
+ [ValidateScript({('.msp' -contains [IO.Path]::GetExtension($_))})]
+ [Alias('FilePath')]
+ [string]$Path
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If the MSP is in the Files directory, set the full path to the MSP
+ If (Test-Path -LiteralPath (Join-Path -Path $dirFiles -ChildPath $path -ErrorAction 'SilentlyContinue') -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ [string]$mspFile = Join-Path -Path $dirFiles -ChildPath $path
+ }
+ ElseIf (Test-Path -LiteralPath $Path -ErrorAction 'SilentlyContinue') {
+ [string]$mspFile = (Get-Item -LiteralPath $Path).FullName
+ }
+ Else {
+ Write-Log -Message "Failed to find MSP file [$path]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to find MSP file [$path]."
+ }
+ Continue
+ }
+ Write-Log -Message 'Checking MSP file for valid product codes' -Source ${CmdletName}
+
+ [boolean]$IsMSPNeeded = $false
+
+ $Installer = New-Object -com WindowsInstaller.Installer
+ $Database = $Installer.GetType().InvokeMember(“OpenDatabase”, “InvokeMethod”, $Null, $Installer, $($mspFile,([int32]32)))
+ [__comobject]$SummaryInformation = Get-ObjectProperty -InputObject $Database -PropertyName 'SummaryInformation'
+ [hashtable]$SummaryInfoProperty = @{}
+ $all = (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(7)).Split(";")
+ Foreach($FormattedProductCode in $all) {
+ [psobject]$MSIInstalled = Get-InstalledApplication -ProductCode $FormattedProductCode
+ If ($MSIInstalled) {[boolean]$IsMSPNeeded = $true }
+ }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SummaryInformation) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($DataBase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ If ($IsMSPNeeded) { Execute-MSI -Action Patch -Path $Path }
+ }
+}
+#endregion
+
+#region Function Write-Log
+Function Write-Log {
+<#
+.SYNOPSIS
+ Write messages to a log file in CMTrace.exe compatible format or Legacy text file format.
+.DESCRIPTION
+ Write messages to a log file in CMTrace.exe compatible format or Legacy text file format and optionally display in the console.
+.PARAMETER Message
+ The message to write to the log file or output to the console.
+.PARAMETER Severity
+ Defines message type. When writing to console or CMTrace.exe log format, it allows highlighting of message type.
+ Options: 1 = Information (default), 2 = Warning (highlighted in yellow), 3 = Error (highlighted in red)
+.PARAMETER Source
+ The source of the message being logged.
+.PARAMETER ScriptSection
+ The heading for the portion of the script that is being executed. Default is: $script:installPhase.
+.PARAMETER LogType
+ Choose whether to write a CMTrace.exe compatible log file or a Legacy text log file.
+.PARAMETER LogFileDirectory
+ Set the directory where the log file will be saved.
+.PARAMETER LogFileName
+ Set the name of the log file.
+.PARAMETER MaxLogFileSizeMB
+ Maximum file size limit for log file in megabytes (MB). Default is 10 MB.
+.PARAMETER WriteHost
+ Write the log message to the console.
+.PARAMETER ContinueOnError
+ Suppress writing log message to console on failure to write message to log file. Default is: $true.
+.PARAMETER PassThru
+ Return the message that was passed to the function
+.PARAMETER DebugMessage
+ Specifies that the message is a debug message. Debug messages only get logged if -LogDebugMessage is set to $true.
+.PARAMETER LogDebugMessage
+ Debug messages only get logged if this parameter is set to $true in the config XML file.
+.EXAMPLE
+ Write-Log -Message "Installing patch MS15-031" -Source 'Add-Patch' -LogType 'CMTrace'
+.EXAMPLE
+ Write-Log -Message "Script is running on Windows 8" -Source 'Test-ValidOS' -LogType 'Legacy'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [AllowEmptyCollection()]
+ [Alias('Text')]
+ [string[]]$Message,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateRange(1,3)]
+ [int16]$Severity = 1,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNull()]
+ [string]$Source = '',
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [string]$ScriptSection = $script:installPhase,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateSet('CMTrace','Legacy')]
+ [string]$LogType = $configToolkitLogStyle,
+ [Parameter(Mandatory=$false,Position=5)]
+ [ValidateNotNullorEmpty()]
+ [string]$LogFileDirectory = $(If ($configToolkitCompressLogs) { $logTempFolder } Else { $configToolkitLogDir }),
+ [Parameter(Mandatory=$false,Position=6)]
+ [ValidateNotNullorEmpty()]
+ [string]$LogFileName = $logName,
+ [Parameter(Mandatory=$false,Position=7)]
+ [ValidateNotNullorEmpty()]
+ [decimal]$MaxLogFileSizeMB = $configToolkitLogMaxSize,
+ [Parameter(Mandatory=$false,Position=8)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$WriteHost = $configToolkitLogWriteToHost,
+ [Parameter(Mandatory=$false,Position=9)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [Parameter(Mandatory=$false,Position=10)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false,Position=11)]
+ [switch]$DebugMessage = $false,
+ [Parameter(Mandatory=$false,Position=12)]
+ [boolean]$LogDebugMessage = $configToolkitLogDebugMessage
+ )
+
+ Begin {
+ ## Get the name of this function
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ ## Logging Variables
+ # Log file date/time
+ [string]$LogTime = (Get-Date -Format 'HH:mm:ss.fff').ToString()
+ [string]$LogDate = (Get-Date -Format 'MM-dd-yyyy').ToString()
+ If (-not (Test-Path -LiteralPath 'variable:LogTimeZoneBias')) { [int32]$script:LogTimeZoneBias = [timezone]::CurrentTimeZone.GetUtcOffset([datetime]::Now).TotalMinutes }
+ [string]$LogTimePlusBias = $LogTime + $script:LogTimeZoneBias
+ # Initialize variables
+ [boolean]$ExitLoggingFunction = $false
+ If (-not (Test-Path -LiteralPath 'variable:DisableLogging')) { $DisableLogging = $false }
+ # Check if the script section is defined
+ [boolean]$ScriptSectionDefined = [boolean](-not [string]::IsNullOrEmpty($ScriptSection))
+ # Get the file name of the source script
+ Try {
+ If ($script:MyInvocation.Value.ScriptName) {
+ [string]$ScriptSource = Split-Path -Path $script:MyInvocation.Value.ScriptName -Leaf -ErrorAction 'Stop'
+ }
+ Else {
+ [string]$ScriptSource = Split-Path -Path $script:MyInvocation.MyCommand.Definition -Leaf -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ $ScriptSource = ''
+ }
+
+ ## Create script block for generating CMTrace.exe compatible log entry
+ [scriptblock]$CMTraceLogString = {
+ Param (
+ [string]$lMessage,
+ [string]$lSource,
+ [int16]$lSeverity
+ )
+ "" + ""
+ }
+
+ ## Create script block for writing log entry to the console
+ [scriptblock]$WriteLogLineToHost = {
+ Param (
+ [string]$lTextLogLine,
+ [int16]$lSeverity
+ )
+ If ($WriteHost) {
+ # Only output using color options if running in a host which supports colors.
+ If ($Host.UI.RawUI.ForegroundColor) {
+ Switch ($lSeverity) {
+ 3 { Write-Host -Object $lTextLogLine -ForegroundColor 'Red' -BackgroundColor 'Black' }
+ 2 { Write-Host -Object $lTextLogLine -ForegroundColor 'Yellow' -BackgroundColor 'Black' }
+ 1 { Write-Host -Object $lTextLogLine }
+ }
+ }
+ # If executing "powershell.exe -File .ps1 > log.txt", then all the Write-Host calls are converted to Write-Output calls so that they are included in the text log.
+ Else {
+ Write-Output -InputObject $lTextLogLine
+ }
+ }
+ }
+
+ ## Exit function if it is a debug message and logging debug messages is not enabled in the config XML file
+ If (($DebugMessage) -and (-not $LogDebugMessage)) { [boolean]$ExitLoggingFunction = $true; Return }
+ ## Exit function if logging to file is disabled and logging to console host is disabled
+ If (($DisableLogging) -and (-not $WriteHost)) { [boolean]$ExitLoggingFunction = $true; Return }
+ ## Exit Begin block if logging is disabled
+ If ($DisableLogging) { Return }
+ ## Exit function function if it is an [Initialization] message and the toolkit has been relaunched
+ If (($AsyncToolkitLaunch) -and ($ScriptSection -eq 'Initialization')) { [boolean]$ExitLoggingFunction = $true; Return }
+
+ ## Create the directory where the log file will be saved
+ If (-not (Test-Path -LiteralPath $LogFileDirectory -PathType 'Container')) {
+ Try {
+ $null = New-Item -Path $LogFileDirectory -Type 'Directory' -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ [boolean]$ExitLoggingFunction = $true
+ # If error creating directory, write message to console
+ If (-not $ContinueOnError) {
+ Write-Host -Object "[$LogDate $LogTime] [${CmdletName}] $ScriptSection :: Failed to create the log directory [$LogFileDirectory]. `n$(Resolve-Error)" -ForegroundColor 'Red'
+ }
+ Return
+ }
+ }
+
+ ## Assemble the fully qualified path to the log file
+ [string]$LogFilePath = Join-Path -Path $LogFileDirectory -ChildPath $LogFileName
+ }
+ Process {
+ ## Exit function if logging is disabled
+ If ($ExitLoggingFunction) { Return }
+
+ ForEach ($Msg in $Message) {
+ ## If the message is not $null or empty, create the log entry for the different logging methods
+ [string]$CMTraceMsg = ''
+ [string]$ConsoleLogLine = ''
+ [string]$LegacyTextLogLine = ''
+ If ($Msg) {
+ # Create the CMTrace log message
+ If ($ScriptSectionDefined) { [string]$CMTraceMsg = "[$ScriptSection] :: $Msg" }
+
+ # Create a Console and Legacy "text" log entry
+ [string]$LegacyMsg = "[$LogDate $LogTime]"
+ If ($ScriptSectionDefined) { [string]$LegacyMsg += " [$ScriptSection]" }
+ If ($Source) {
+ [string]$ConsoleLogLine = "$LegacyMsg [$Source] :: $Msg"
+ Switch ($Severity) {
+ 3 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Error] :: $Msg" }
+ 2 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Warning] :: $Msg" }
+ 1 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Info] :: $Msg" }
+ }
+ }
+ Else {
+ [string]$ConsoleLogLine = "$LegacyMsg :: $Msg"
+ Switch ($Severity) {
+ 3 { [string]$LegacyTextLogLine = "$LegacyMsg [Error] :: $Msg" }
+ 2 { [string]$LegacyTextLogLine = "$LegacyMsg [Warning] :: $Msg" }
+ 1 { [string]$LegacyTextLogLine = "$LegacyMsg [Info] :: $Msg" }
+ }
+ }
+ }
+
+ ## Execute script block to create the CMTrace.exe compatible log entry
+ [string]$CMTraceLogLine = & $CMTraceLogString -lMessage $CMTraceMsg -lSource $Source -lSeverity $Severity
+
+ ## Choose which log type to write to file
+ If ($LogType -ieq 'CMTrace') {
+ [string]$LogLine = $CMTraceLogLine
+ }
+ Else {
+ [string]$LogLine = $LegacyTextLogLine
+ }
+
+ ## Write the log entry to the log file if logging is not currently disabled
+ If (-not $DisableLogging) {
+ Try {
+ $LogLine | Out-File -FilePath $LogFilePath -Append -NoClobber -Force -Encoding 'UTF8' -ErrorAction 'Stop'
+ }
+ Catch {
+ If (-not $ContinueOnError) {
+ Write-Host -Object "[$LogDate $LogTime] [$ScriptSection] [${CmdletName}] :: Failed to write message [$Msg] to the log file [$LogFilePath]. `n$(Resolve-Error)" -ForegroundColor 'Red'
+ }
+ }
+ }
+
+ ## Execute script block to write the log entry to the console if $WriteHost is $true
+ & $WriteLogLineToHost -lTextLogLine $ConsoleLogLine -lSeverity $Severity
+ }
+ }
+ End {
+ ## Archive log file if size is greater than $MaxLogFileSizeMB and $MaxLogFileSizeMB > 0
+ Try {
+ If ((-not $ExitLoggingFunction) -and (-not $DisableLogging)) {
+ [IO.FileInfo]$LogFile = Get-ChildItem -LiteralPath $LogFilePath -ErrorAction 'Stop'
+ [decimal]$LogFileSizeMB = $LogFile.Length/1MB
+ If (($LogFileSizeMB -gt $MaxLogFileSizeMB) -and ($MaxLogFileSizeMB -gt 0)) {
+ ## Change the file extension to "lo_"
+ [string]$ArchivedOutLogFile = [IO.Path]::ChangeExtension($LogFilePath, 'lo_')
+ [hashtable]$ArchiveLogParams = @{ ScriptSection = $ScriptSection; Source = ${CmdletName}; Severity = 2; LogFileDirectory = $LogFileDirectory; LogFileName = $LogFileName; LogType = $LogType; MaxLogFileSizeMB = 0; WriteHost = $WriteHost; ContinueOnError = $ContinueOnError; PassThru = $false }
+
+ ## Log message about archiving the log file
+ $ArchiveLogMessage = "Maximum log file size [$MaxLogFileSizeMB MB] reached. Rename log file to [$ArchivedOutLogFile]."
+ Write-Log -Message $ArchiveLogMessage @ArchiveLogParams
+
+ ## Archive existing log file from .log to .lo_. Overwrites any existing .lo_ file. This is the same method SCCM uses for log files.
+ Move-Item -LiteralPath $LogFilePath -Destination $ArchivedOutLogFile -Force -ErrorAction 'Stop'
+
+ ## Start new log file and Log message about archiving the old log file
+ $NewLogMessage = "Previous log file was renamed to [$ArchivedOutLogFile] because maximum log file size of [$MaxLogFileSizeMB MB] was reached."
+ Write-Log -Message $NewLogMessage @ArchiveLogParams
+ }
+ }
+ }
+ Catch {
+ ## If renaming of file fails, script will continue writing to log file even if size goes over the max file size
+ }
+ Finally {
+ If ($PassThru) { Write-Output -InputObject $Message }
+ }
+ }
+}
+#endregion
+
+
+#region Function New-ZipFile
+Function New-ZipFile {
+<#
+.SYNOPSIS
+ Create a new zip archive or add content to an existing archive.
+.DESCRIPTION
+ Create a new zip archive or add content to an existing archive by using the Shell object .CopyHere method.
+.PARAMETER DestinationArchiveDirectoryPath
+ The path to the directory path where the zip archive will be saved.
+.PARAMETER DestinationArchiveFileName
+ The name of the zip archive.
+.PARAMETER SourceDirectoryPath
+ The path to the directory to be archived, specified as absolute paths.
+.PARAMETER SourceFilePath
+ The path to the file to be archived, specified as absolute paths.
+.PARAMETER RemoveSourceAfterArchiving
+ Remove the source path after successfully archiving the content. Default is: $false.
+.PARAMETER OverWriteArchive
+ Overwrite the destination archive path if it already exists. Default is: $false.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $true.
+.EXAMPLE
+ New-ZipFile -DestinationArchiveDirectoryPath 'E:\Testing' -DestinationArchiveFileName 'TestingLogs.zip' -SourceDirectory 'E:\Testing\Logs'
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='CreateFromDirectory')]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullorEmpty()]
+ [string]$DestinationArchiveDirectoryPath,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$DestinationArchiveFileName,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='CreateFromDirectory')]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Container' })]
+ [string[]]$SourceDirectoryPath,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='CreateFromFile')]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string[]]$SourceFilePath,
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [switch]$RemoveSourceAfterArchiving = $false,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [switch]$OverWriteArchive = $false,
+ [Parameter(Mandatory=$false,Position=5)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Get the full destination path where the archive will be stored
+ [string]$DestinationPath = Join-Path -Path $DestinationArchiveDirectoryPath -ChildPath $DestinationArchiveFileName -ErrorAction 'Stop'
+ Write-Log -Message "Create a zip archive with the requested content at destination path [$DestinationPath]." -Source ${CmdletName}
+
+ ## If the destination archive already exists, delete it if the -OverWriteArchive option was selected
+ If (($OverWriteArchive) -and (Test-Path -LiteralPath $DestinationPath)) {
+ Write-Log -Message "An archive at the destination path already exists, deleting file [$DestinationPath]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $DestinationPath -Force -ErrorAction 'Stop'
+ }
+
+ ## If archive file does not exist, then create a zero-byte zip archive
+ If (-not (Test-Path -LiteralPath $DestinationPath)) {
+ ## Create a zero-byte file
+ Write-Log -Message "Create a zero-byte file [$DestinationPath]." -Source ${CmdletName}
+ $null = New-Item -Path $DestinationArchiveDirectoryPath -Name $DestinationArchiveFileName -ItemType 'File' -Force -ErrorAction 'Stop'
+
+ ## Write the file header for a zip file to the zero-byte file
+ [byte[]]$ZipArchiveByteHeader = 80, 75, 5, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+ [IO.FileStream]$FileStream = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($DestinationPath, ([IO.FileMode]::Create))
+ [IO.BinaryWriter]$BinaryWriter = New-Object -TypeName 'System.IO.BinaryWriter' -ArgumentList ($FileStream)
+ Write-Log -Message "Write the file header for a zip archive to the zero-byte file [$DestinationPath]." -Source ${CmdletName}
+ $null = $BinaryWriter.Write($ZipArchiveByteHeader)
+ $BinaryWriter.Close()
+ $FileStream.Close()
+ }
+
+ ## Create a Shell object
+ [__comobject]$ShellApp = New-Object -ComObject 'Shell.Application' -ErrorAction 'Stop'
+ ## Create an object representing the archive file
+ [__comobject]$Archive = $ShellApp.NameSpace($DestinationPath)
+
+ ## Create the archive file
+ If ($PSCmdlet.ParameterSetName -eq 'CreateFromDirectory') {
+ ## Create the archive file from a source directory
+ ForEach ($Directory in $SourceDirectoryPath) {
+ Try {
+ # Create an object representing the source directory
+ [__comobject]$CreateFromDirectory = $ShellApp.NameSpace($Directory)
+ # Copy all of the files and folders from the source directory to the archive
+ $null = $Archive.CopyHere($CreateFromDirectory.Items())
+ # Wait for archive operation to complete. Archive file count property returns 0 if archive operation is in progress.
+ Write-Log -Message "Compressing [$($CreateFromDirectory.Count)] file(s) in source directory [$Directory] to destination path [$DestinationPath]..." -Source ${CmdletName}
+ Do { Start-Sleep -Milliseconds 250 } While ($Archive.Items().Count -eq 0)
+ }
+ Finally {
+ # Release the ComObject representing the source directory
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($CreateFromDirectory)
+ }
+
+ # If option was selected, recursively delete the source directory after successfully archiving the contents
+ If ($RemoveSourceAfterArchiving) {
+ Try {
+ Write-Log -Message "Recursively delete the source directory [$Directory] as contents have been successfully archived." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Directory -Recurse -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to recursively delete the source directory [$Directory]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Else {
+ ## Create the archive file from a list of one or more files
+ [IO.FileInfo[]]$SourceFilePath = [IO.FileInfo[]]$SourceFilePath
+ ForEach ($File in $SourceFilePath) {
+ # Copy the files and folders from the source directory to the archive
+ $null = $Archive.CopyHere($File.FullName)
+ # Wait for archive operation to complete. Archive file count property returns 0 if archive operation is in progress.
+ Write-Log -Message "Compressing file [$($File.FullName)] to destination path [$DestinationPath]..." -Source ${CmdletName}
+ Do { Start-Sleep -Milliseconds 250 } While ($Archive.Items().Count -eq 0)
+
+ # If option was selected, delete the source file after successfully archiving the content
+ If ($RemoveSourceAfterArchiving) {
+ Try {
+ Write-Log -Message "Delete the source file [$($File.FullName)] as it has been successfully archived." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $File.FullName -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to delete the source file [$($File.FullName)]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+
+ ## If the archive was created in session 0 or by an Admin, then it may only be readable by elevated users.
+ # Apply the parent folder's permissions to the archive file to fix the problem.
+ Write-Log -Message "If the archive was created in session 0 or by an Admin, then it may only be readable by elevated users. Apply permissions from parent folder [$DestinationArchiveDirectoryPath] to file [$DestinationPath]." -Source ${CmdletName}
+ Try {
+ [Security.AccessControl.DirectorySecurity]$DestinationArchiveDirectoryPathAcl = Get-Acl -Path $DestinationArchiveDirectoryPath -ErrorAction 'Stop'
+ Set-Acl -Path $DestinationPath -AclObject $DestinationArchiveDirectoryPathAcl -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to apply parent folder's [$DestinationArchiveDirectoryPath] permissions to file [$DestinationPath]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to archive the requested file(s). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to archive the requested file(s): $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ ## Release the ComObject representing the archive
+ If ($Archive) { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Archive) }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Exit-Script
+Function Exit-Script {
+<#
+.SYNOPSIS
+ Exit the script, perform cleanup actions, and pass an exit code to the parent process.
+.DESCRIPTION
+ Always use when exiting the script to ensure cleanup actions are performed.
+.PARAMETER ExitCode
+ The exit code to be passed from the script to the parent process, e.g. SCCM
+.EXAMPLE
+ Exit-Script -ExitCode 0
+.EXAMPLE
+ Exit-Script -ExitCode 1618
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ExitCode = 0
+ )
+
+ ## Get the name of this function
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ ## Stop the Close Program Dialog if running
+ If ($formCloseApps) { $formCloseApps.Close }
+
+ ## Close the Installation Progress Dialog if running
+ Close-InstallationProgress
+
+ ## If block execution variable is true, call the function to unblock execution
+ If ($BlockExecution) { Unblock-AppExecution }
+
+ ## If Terminal Server mode was set, turn it off
+ If ($terminalServerMode) { Disable-TerminalServerInstallMode }
+
+ ## Determine action based on exit code
+ Switch ($exitCode) {
+ $configInstallationUIExitCode { $installSuccess = $false }
+ $configInstallationDeferExitCode { $installSuccess = $false }
+ 3010 { $installSuccess = $true }
+ 1641 { $installSuccess = $true }
+ 0 { $installSuccess = $true }
+ Default { $installSuccess = $false }
+ }
+
+ ## Determine if balloon notification should be shown
+ If ($deployModeSilent) { [boolean]$configShowBalloonNotifications = $false }
+
+ If ($installSuccess) {
+ If (Test-Path -LiteralPath $regKeyDeferHistory -ErrorAction 'SilentlyContinue') {
+ Write-Log -Message 'Remove deferral history...' -Source ${CmdletName}
+ Remove-RegistryKey -Key $regKeyDeferHistory -Recurse
+ }
+
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextComplete"
+ ## Handle reboot prompts on successful script completion
+ If (($AllowRebootPassThru) -and ((($msiRebootDetected) -or ($exitCode -eq 3010)) -or ($exitCode -eq 1641))) {
+ Write-Log -Message 'A restart has been flagged as required.' -Source ${CmdletName}
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextRestartRequired"
+ If (($msiRebootDetected) -and ($exitCode -ne 1641)) { [int32]$exitCode = 3010 }
+ }
+ Else {
+ [int32]$exitCode = 0
+ }
+
+ Write-Log -Message "$installName $deploymentTypeName completed with exit code [$exitcode]." -Source ${CmdletName}
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText $balloonText }
+ }
+ ElseIf (-not $installSuccess) {
+ Write-Log -Message "$installName $deploymentTypeName completed with exit code [$exitcode]." -Source ${CmdletName}
+ If (($exitCode -eq $configInstallationUIExitCode) -or ($exitCode -eq $configInstallationDeferExitCode)) {
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextFastRetry"
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Warning' -BalloonTipText $balloonText }
+ }
+ Else {
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextError"
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Error' -BalloonTipText $balloonText }
+ }
+ }
+
+ [string]$LogDash = '-' * 79
+ Write-Log -Message $LogDash -Source ${CmdletName}
+
+ ## Archive the log files to zip format and then delete the temporary logs folder
+ If ($configToolkitCompressLogs) {
+ ## Disable logging to file so that we can archive the log files
+ . $DisableScriptLogging
+
+ [string]$DestinationArchiveFileName = $installName + '_' + $deploymentType + '_' + ((Get-Date -Format 'yyyy-MM-dd-hh-mm-ss').ToString()) + '.zip'
+ New-ZipFile -DestinationArchiveDirectoryPath $configToolkitLogDir -DestinationArchiveFileName $DestinationArchiveFileName -SourceDirectory $logTempFolder -RemoveSourceAfterArchiving
+ }
+
+ If ($script:notifyIcon) { Try { $script:notifyIcon.Dispose() } Catch {} }
+ ## Exit the script, returning the exit code to SCCM
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $script:ExitCode = $exitCode; Exit } Else { Exit $exitCode }
+}
+#endregion
+
+
+#region Function Resolve-Error
+Function Resolve-Error {
+<#
+.SYNOPSIS
+ Enumerate error record details.
+.DESCRIPTION
+ Enumerate an error record, or a collection of error record, properties. By default, the details for the last error will be enumerated.
+.PARAMETER ErrorRecord
+ The error record to resolve. The default error record is the latest one: $global:Error[0]. This parameter will also accept an array of error records.
+.PARAMETER Property
+ The list of properties to display from the error record. Use "*" to display all properties.
+ Default list of error properties is: Message, FullyQualifiedErrorId, ScriptStackTrace, PositionMessage, InnerException
+.PARAMETER GetErrorRecord
+ Get error record details as represented by $_.
+.PARAMETER GetErrorInvocation
+ Get error record invocation information as represented by $_.InvocationInfo.
+.PARAMETER GetErrorException
+ Get error record exception details as represented by $_.Exception.
+.PARAMETER GetErrorInnerException
+ Get error record inner exception details as represented by $_.Exception.InnerException. Will retrieve all inner exceptions if there is more than one.
+.EXAMPLE
+ Resolve-Error
+.EXAMPLE
+ Resolve-Error -Property *
+.EXAMPLE
+ Resolve-Error -Property InnerException
+.EXAMPLE
+ Resolve-Error -GetErrorInvocation:$false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [AllowEmptyCollection()]
+ [array]$ErrorRecord,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Property = ('Message','InnerException','FullyQualifiedErrorId','ScriptStackTrace','PositionMessage'),
+ [Parameter(Mandatory=$false,Position=2)]
+ [switch]$GetErrorRecord = $true,
+ [Parameter(Mandatory=$false,Position=3)]
+ [switch]$GetErrorInvocation = $true,
+ [Parameter(Mandatory=$false,Position=4)]
+ [switch]$GetErrorException = $true,
+ [Parameter(Mandatory=$false,Position=5)]
+ [switch]$GetErrorInnerException = $true
+ )
+
+ Begin {
+ ## If function was called without specifying an error record, then choose the latest error that occurred
+ If (-not $ErrorRecord) {
+ If ($global:Error.Count -eq 0) {
+ #Write-Warning -Message "The `$Error collection is empty"
+ Return
+ }
+ Else {
+ [array]$ErrorRecord = $global:Error[0]
+ }
+ }
+
+ ## Allows selecting and filtering the properties on the error object if they exist
+ [scriptblock]$SelectProperty = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ $InputObject,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Property
+ )
+
+ [string[]]$ObjectProperty = $InputObject | Get-Member -MemberType '*Property' | Select-Object -ExpandProperty 'Name'
+ ForEach ($Prop in $Property) {
+ If ($Prop -eq '*') {
+ [string[]]$PropertySelection = $ObjectProperty
+ Break
+ }
+ ElseIf ($ObjectProperty -contains $Prop) {
+ [string[]]$PropertySelection += $Prop
+ }
+ }
+ Write-Output -InputObject $PropertySelection
+ }
+
+ # Initialize variables to avoid error if 'Set-StrictMode' is set
+ $LogErrorRecordMsg = $null
+ $LogErrorInvocationMsg = $null
+ $LogErrorExceptionMsg = $null
+ $LogErrorMessageTmp = $null
+ $LogInnerMessage = $null
+ }
+ Process {
+ If (-not $ErrorRecord) { Return }
+ ForEach ($ErrRecord in $ErrorRecord) {
+ ## Capture Error Record
+ If ($GetErrorRecord) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord -Property $Property
+ $LogErrorRecordMsg = $ErrRecord | Select-Object -Property $SelectedProperties
+ }
+
+ ## Error Invocation Information
+ If ($GetErrorInvocation) {
+ If ($ErrRecord.InvocationInfo) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord.InvocationInfo -Property $Property
+ $LogErrorInvocationMsg = $ErrRecord.InvocationInfo | Select-Object -Property $SelectedProperties
+ }
+ }
+
+ ## Capture Error Exception
+ If ($GetErrorException) {
+ If ($ErrRecord.Exception) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord.Exception -Property $Property
+ $LogErrorExceptionMsg = $ErrRecord.Exception | Select-Object -Property $SelectedProperties
+ }
+ }
+
+ ## Display properties in the correct order
+ If ($Property -eq '*') {
+ # If all properties were chosen for display, then arrange them in the order the error object displays them by default.
+ If ($LogErrorRecordMsg) { [array]$LogErrorMessageTmp += $LogErrorRecordMsg }
+ If ($LogErrorInvocationMsg) { [array]$LogErrorMessageTmp += $LogErrorInvocationMsg }
+ If ($LogErrorExceptionMsg) { [array]$LogErrorMessageTmp += $LogErrorExceptionMsg }
+ }
+ Else {
+ # Display selected properties in our custom order
+ If ($LogErrorExceptionMsg) { [array]$LogErrorMessageTmp += $LogErrorExceptionMsg }
+ If ($LogErrorRecordMsg) { [array]$LogErrorMessageTmp += $LogErrorRecordMsg }
+ If ($LogErrorInvocationMsg) { [array]$LogErrorMessageTmp += $LogErrorInvocationMsg }
+ }
+
+ If ($LogErrorMessageTmp) {
+ $LogErrorMessage = 'Error Record:'
+ $LogErrorMessage += "`n-------------"
+ $LogErrorMsg = $LogErrorMessageTmp | Format-List | Out-String
+ $LogErrorMessage += $LogErrorMsg
+ }
+
+ ## Capture Error Inner Exception(s)
+ If ($GetErrorInnerException) {
+ If ($ErrRecord.Exception -and $ErrRecord.Exception.InnerException) {
+ $LogInnerMessage = 'Error Inner Exception(s):'
+ $LogInnerMessage += "`n-------------------------"
+
+ $ErrorInnerException = $ErrRecord.Exception.InnerException
+ $Count = 0
+
+ While ($ErrorInnerException) {
+ [string]$InnerExceptionSeperator = '~' * 40
+
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrorInnerException -Property $Property
+ $LogErrorInnerExceptionMsg = $ErrorInnerException | Select-Object -Property $SelectedProperties | Format-List | Out-String
+
+ If ($Count -gt 0) { $LogInnerMessage += $InnerExceptionSeperator }
+ $LogInnerMessage += $LogErrorInnerExceptionMsg
+
+ $Count++
+ $ErrorInnerException = $ErrorInnerException.InnerException
+ }
+ }
+ }
+
+ If ($LogErrorMessage) { $Output = $LogErrorMessage }
+ If ($LogInnerMessage) { $Output += $LogInnerMessage }
+
+ Write-Output -InputObject $Output
+
+ If (Test-Path -LiteralPath 'variable:Output') { Clear-Variable -Name 'Output' }
+ If (Test-Path -LiteralPath 'variable:LogErrorMessage') { Clear-Variable -Name 'LogErrorMessage' }
+ If (Test-Path -LiteralPath 'variable:LogInnerMessage') { Clear-Variable -Name 'LogInnerMessage' }
+ If (Test-Path -LiteralPath 'variable:LogErrorMessageTmp') { Clear-Variable -Name 'LogErrorMessageTmp' }
+ }
+ }
+ End {
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationPrompt
+Function Show-InstallationPrompt {
+<#
+.SYNOPSIS
+ Displays a custom installation prompt with the toolkit branding and optional buttons.
+.DESCRIPTION
+ Any combination of Left, Middle or Right buttons can be displayed. The return value of the button clicked by the user is the button text specified.
+.PARAMETER Title
+ Title of the prompt. Default: the application installation name.
+.PARAMETER Message
+ Message text to be included in the prompt
+.PARAMETER MessageAlignment
+ Alignment of the message text. Options: Left, Center, Right. Default: Center.
+.PARAMETER ButtonLeftText
+ Show a button on the left of the prompt with the specified text
+.PARAMETER ButtonRightText
+ Show a button on the right of the prompt with the specified text
+.PARAMETER ButtonMiddleText
+ Show a button in the middle of the prompt with the specified text
+.PARAMETER Icon
+ Show a system icon in the prompt. Options: Application, Asterisk, Error, Exclamation, Hand, Information, None, Question, Shield, Warning, WinLogo. Default: None.
+.PARAMETER NoWait
+ Specifies whether to show the prompt asynchronously (i.e. allow the script to continue without waiting for a response). Default: $false.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds. The user will have no option but to respond to the prompt - resistance is futile!
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $false.
+.PARAMETER Timeout
+ Specifies the time period in seconds after which the prompt should timeout. Default: UI timeout value set in the config XML file.
+.PARAMETER ExitOnTimeout
+ Specifies whether to exit the script if the UI times out. Default: $true.
+.EXAMPLE
+ Show-InstallationPrompt -Message 'Do you want to proceed with the installation?' -ButtonRightText 'Yes' -ButtonLeftText 'No'
+.EXAMPLE
+ Show-InstallationPrompt -Title 'Funny Prompt' -Message 'How are you feeling today?' -ButtonRightText 'Good' -ButtonLeftText 'Bad' -ButtonMiddleText 'Indifferent'
+.EXAMPLE
+ Show-InstallationPrompt -Message 'You can customize text to appear at the end of an install, or remove it completely for unattended installations.' -Icon Information -NoWait
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Title = $installTitle,
+ [Parameter(Mandatory=$false)]
+ [string]$Message = '',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Left','Center','Right')]
+ [string]$MessageAlignment = 'Center',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonRightText = '',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonLeftText = '',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonMiddleText = '',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Application','Asterisk','Error','Exclamation','Hand','Information','None','Question','Shield','Warning','WinLogo')]
+ [string]$Icon = 'None',
+ [Parameter(Mandatory=$false)]
+ [switch]$NoWait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PersistPrompt = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$Timeout = $configInstallationUITimeout,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ExitOnTimeout = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in non-interactive mode
+ If ($deployModeSilent) {
+ Write-Log -Message "Bypassing Installation Prompt [Mode: $deployMode]... $Message" -Source ${CmdletName}
+ Return
+ }
+
+ ## Get parameters for calling function asynchronously
+ [hashtable]$installPromptParameters = $psBoundParameters
+
+ ## Check if the countdown was specified
+ If ($timeout -gt $configInstallationUITimeout) {
+ [string]$CountdownTimeoutErr = "The installation UI dialog timeout cannot be longer than the timeout specified in the XML configuration file."
+ Write-Log -Message $CountdownTimeoutErr -Severity 3 -Source ${CmdletName}
+ Throw $CountdownTimeoutErr
+ }
+
+ [Windows.Forms.Application]::EnableVisualStyles()
+ $formInstallationPrompt = New-Object -TypeName 'System.Windows.Forms.Form'
+ $pictureBanner = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $pictureIcon = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $labelText = New-Object -TypeName 'System.Windows.Forms.Label'
+ $buttonRight = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonMiddle = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonLeft = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonAbort = New-Object -TypeName 'System.Windows.Forms.Button'
+ $InitialFormInstallationPromptWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ ## Remove all event handlers from the controls
+ Try {
+ $labelText.remove_Click($handler_labelText_Click)
+ $buttonLeft.remove_Click($buttonLeft_OnClick)
+ $buttonRight.remove_Click($buttonRight_OnClick)
+ $buttonMiddle.remove_Click($buttonMiddle_OnClick)
+ $buttonAbort.remove_Click($buttonAbort_OnClick)
+ $timer.remove_Tick($timer_Tick)
+ $timer.Dispose()
+ $timer = $null
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $timerPersist.Dispose()
+ $timerPersist = $null
+ $formInstallationPrompt.remove_Load($Form_StateCorrection_Load)
+ $formInstallationPrompt.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formInstallationPrompt.WindowState = 'Normal'
+ $formInstallationPrompt.AutoSize = $true
+ $formInstallationPrompt.TopMost = $true
+ $formInstallationPrompt.BringToFront()
+ # Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formInstallationPromptStartPosition' -Value $formInstallationPrompt.Location -Scope 'Script'
+ }
+
+ ## Form
+ $formInstallationPrompt.Controls.Add($pictureBanner)
+
+ ##----------------------------------------------
+ ## Create padding object
+ $paddingNone = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $paddingNone.Top = 0
+ $paddingNone.Bottom = 0
+ $paddingNone.Left = 0
+ $paddingNone.Right = 0
+
+ ## Generic Button properties
+ $buttonWidth = 110
+ $buttonHeight = 23
+ $buttonPadding = 50
+ $buttonSize = New-Object -TypeName 'System.Drawing.Size'
+ $buttonSize.Width = $buttonWidth
+ $buttonSize.Height = $buttonHeight
+ $buttonPadding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $buttonPadding.Top = 0
+ $buttonPadding.Bottom = 5
+ $buttonPadding.Left = 50
+ $buttonPadding.Right = 0
+
+ ## Picture Banner
+ $pictureBanner.DataBindings.DefaultDataSourceUpdateMode = 0
+ $pictureBanner.ImageLocation = $appDeployLogoBanner
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $pictureBanner.Location = $System_Drawing_Point
+ $pictureBanner.Name = 'pictureBanner'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 50
+ $System_Drawing_Size.Width = 450
+ $pictureBanner.Size = $System_Drawing_Size
+ $pictureBanner.SizeMode = 'CenterImage'
+ $pictureBanner.Margin = $paddingNone
+ $pictureBanner.TabIndex = 0
+ $pictureBanner.TabStop = $false
+
+ ## Picture Icon
+ $pictureIcon.DataBindings.DefaultDataSourceUpdateMode = 0
+ If ($icon -ne 'None') { $pictureIcon.Image = ([Drawing.SystemIcons]::$Icon).ToBitmap() }
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 15
+ $System_Drawing_Point.Y = 105
+ $pictureIcon.Location = $System_Drawing_Point
+ $pictureIcon.Name = 'pictureIcon'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 32
+ $System_Drawing_Size.Width = 32
+ $pictureIcon.Size = $System_Drawing_Size
+ $pictureIcon.AutoSize = $true
+ $pictureIcon.Margin = $paddingNone
+ $pictureIcon.TabIndex = 0
+ $pictureIcon.TabStop = $false
+
+ ## Label Text
+ $labelText.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelText.Name = 'labelText'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 148
+ $System_Drawing_Size.Width = 385
+ $labelText.Size = $System_Drawing_Size
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 25
+ $System_Drawing_Point.Y = 50
+ $labelText.Location = $System_Drawing_Point
+ $labelText.Margin = '0,0,0,0'
+ $labelText.Padding = '40,0,20,0'
+ $labelText.TabIndex = 1
+ $labelText.Text = $message
+ $labelText.TextAlign = "Middle$($MessageAlignment)"
+ $labelText.Anchor = 'Top'
+ $labelText.add_Click($handler_labelText_Click)
+
+ ## Button Left
+ $buttonLeft.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonLeft.Location = '15,200'
+ $buttonLeft.Name = 'buttonLeft'
+ $buttonLeft.Size = $buttonSize
+ $buttonLeft.TabIndex = 5
+ $buttonLeft.Text = $buttonLeftText
+ $buttonLeft.DialogResult = 'No'
+ $buttonLeft.AutoSize = $false
+ $buttonLeft.UseVisualStyleBackColor = $true
+ $buttonLeft.add_Click($buttonLeft_OnClick)
+
+ ## Button Middle
+ $buttonMiddle.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonMiddle.Location = '170,200'
+ $buttonMiddle.Name = 'buttonMiddle'
+ $buttonMiddle.Size = $buttonSize
+ $buttonMiddle.TabIndex = 6
+ $buttonMiddle.Text = $buttonMiddleText
+ $buttonMiddle.DialogResult = 'Ignore'
+ $buttonMiddle.AutoSize = $true
+ $buttonMiddle.UseVisualStyleBackColor = $true
+ $buttonMiddle.add_Click($buttonMiddle_OnClick)
+
+ ## Button Right
+ $buttonRight.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonRight.Location = '325,200'
+ $buttonRight.Name = 'buttonRight'
+ $buttonRight.Size = $buttonSize
+ $buttonRight.TabIndex = 7
+ $buttonRight.Text = $ButtonRightText
+ $buttonRight.DialogResult = 'Yes'
+ $buttonRight.AutoSize = $true
+ $buttonRight.UseVisualStyleBackColor = $true
+ $buttonRight.add_Click($buttonRight_OnClick)
+
+ ## Button Abort (Hidden)
+ $buttonAbort.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonAbort.Name = 'buttonAbort'
+ $buttonAbort.Size = '1,1'
+ $buttonAbort.DialogResult = 'Abort'
+ $buttonAbort.TabStop = $false
+ $buttonAbort.UseVisualStyleBackColor = $true
+ $buttonAbort.add_Click($buttonAbort_OnClick)
+
+ ## Form Installation Prompt
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 270
+ $System_Drawing_Size.Width = 450
+ $formInstallationPrompt.Size = $System_Drawing_Size
+ $formInstallationPrompt.Padding = '0,0,0,10'
+ $formInstallationPrompt.Margin = $paddingNone
+ $formInstallationPrompt.DataBindings.DefaultDataSourceUpdateMode = 0
+ $formInstallationPrompt.Name = 'WelcomeForm'
+ $formInstallationPrompt.Text = $title
+ $formInstallationPrompt.StartPosition = 'CenterScreen'
+ $formInstallationPrompt.FormBorderStyle = 'FixedDialog'
+ $formInstallationPrompt.MaximizeBox = $false
+ $formInstallationPrompt.MinimizeBox = $false
+ $formInstallationPrompt.TopMost = $true
+ $formInstallationPrompt.TopLevel = $true
+ $formInstallationPrompt.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formInstallationPrompt.Controls.Add($pictureBanner)
+ $formInstallationPrompt.Controls.Add($pictureIcon)
+ $formInstallationPrompt.Controls.Add($labelText)
+ $formInstallationPrompt.Controls.Add($buttonAbort)
+ If ($buttonLeftText) { $formInstallationPrompt.Controls.Add($buttonLeft) }
+ If ($buttonMiddleText) { $formInstallationPrompt.Controls.Add($buttonMiddle) }
+ If ($buttonRightText) { $formInstallationPrompt.Controls.Add($buttonRight) }
+
+ ## Timer
+ $timer = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timer.Interval = ($timeout * 1000)
+ $timer.Add_Tick({
+ Write-Log -Message 'Installation action not taken within a reasonable amount of time.' -Source ${CmdletName}
+ $buttonAbort.PerformClick()
+ })
+
+ ## Save the initial state of the form
+ $InitialFormInstallationPromptWindowState = $formInstallationPrompt.WindowState
+ ## Init the OnLoad event to correct the initial state of the form
+ $formInstallationPrompt.add_Load($Form_StateCorrection_Load)
+ ## Clean up the control events
+ $formInstallationPrompt.add_FormClosed($Form_Cleanup_FormClosed)
+
+ ## Start the timer
+ $timer.Start()
+
+ ## Persistence Timer
+ [scriptblock]$RefreshInstallationPrompt = {
+ $formInstallationPrompt.BringToFront()
+ $formInstallationPrompt.Location = "$($formInstallationPromptStartPosition.X),$($formInstallationPromptStartPosition.Y)"
+ $formInstallationPrompt.Refresh()
+ }
+ If ($persistPrompt) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = { & $RefreshInstallationPrompt }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ ## Close the Installation Progress Dialog if running
+ Close-InstallationProgress
+
+ [string]$installPromptLoggedParameters = ($installPromptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' '
+ Write-Log -Message "Displaying custom installation prompt with the non-default parameters: [$installPromptLoggedParameters]." -Source ${CmdletName}
+
+ ## If the NoWait parameter is specified, launch a new PowerShell session to show the prompt asynchronously
+ If ($NoWait) {
+ # Remove the NoWait parameter so that the script is run synchronously in the new PowerShell session
+ $installPromptParameters.Remove('NoWait')
+ # Format the parameters as a string
+ [string]$installPromptParameters = ($installPromptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' '
+ Start-Process -FilePath "$PSHOME\powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$scriptPath`" -ReferredInstallTitle `"$Title`" -ReferredInstallName `"$installName`" -ReferredLogName `"$logName`" -ShowInstallationPrompt $installPromptParameters -AsyncToolkitLaunch" -WindowStyle 'Hidden' -ErrorAction 'SilentlyContinue'
+ }
+ ## Otherwise, show the prompt synchronously. If user cancels, then keep showing it until user responds using one of the buttons.
+ Else {
+ $showDialog = $true
+ While ($showDialog) {
+ # Minimize all other windows
+ If ($minimizeWindows) { $null = $shellApp.MinimizeAll() }
+ # Show the Form
+ $result = $formInstallationPrompt.ShowDialog()
+ If (($result -eq 'Yes') -or ($result -eq 'No') -or ($result -eq 'Ignore') -or ($result -eq 'Abort')) {
+ $showDialog = $false
+ }
+ }
+ $formInstallationPrompt.Dispose()
+
+ Switch ($result) {
+ 'Yes' { Write-Output -InputObject $buttonRightText }
+ 'No' { Write-Output -InputObject $buttonLeftText }
+ 'Ignore' { Write-Output -InputObject $buttonMiddleText }
+ 'Abort' {
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+ If ($ExitOnTimeout) {
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ Else {
+ Write-Log -Message 'UI timed out but `$ExitOnTimeout set to `$false. Continue...' -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-DialogBox
+Function Show-DialogBox {
+<#
+.SYNOPSIS
+ Display a custom dialog box with optional title, buttons, icon and timeout.
+ Show-InstallationPrompt is recommended over this function as it provides more customization and uses consistent branding with the other UI components.
+.DESCRIPTION
+ Display a custom dialog box with optional title, buttons, icon and timeout. The default button is "OK", the default Icon is "None", and the default Timeout is none.
+.PARAMETER Text
+ Text in the message dialog box
+.PARAMETER Title
+ Title of the message dialog box
+.PARAMETER Buttons
+ Buttons to be included on the dialog box. Options: OK, OKCancel, AbortRetryIgnore, YesNoCancel, YesNo, RetryCancel, CancelTryAgainContinue. Default: OK.
+.PARAMETER DefaultButton
+ The Default button that is selected. Options: First, Second, Third. Default: First.
+.PARAMETER Icon
+ Icon to display on the dialog box. Options: None, Stop, Question, Exclamation, Information. Default: None.
+.PARAMETER Timeout
+ Timeout period in seconds before automatically closing the dialog box with the return message "Timeout". Default: UI timeout value set in the config XML file.
+.PARAMETER TopMost
+ Specifies whether the message box is a system modal message box and appears in a topmost window. Default: $true.
+.EXAMPLE
+ Show-DialogBox -Title 'Installed Complete' -Text 'Installation has completed. Please click OK and restart your computer.' -Icon 'Information'
+.EXAMPLE
+ Show-DialogBox -Title 'Installation Notice' -Text 'Installation will take approximately 30 minutes. Do you wish to proceed?' -Buttons 'OKCancel' -DefaultButton 'Second' -Icon 'Exclamation' -Timeout 600 -Topmost $false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,HelpMessage='Enter a message for the dialog box')]
+ [ValidateNotNullorEmpty()]
+ [string]$Text,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Title = $installTitle,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('OK','OKCancel','AbortRetryIgnore','YesNoCancel','YesNo','RetryCancel','CancelTryAgainContinue')]
+ [string]$Buttons = 'OK',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('First','Second','Third')]
+ [string]$DefaultButton = 'First',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Exclamation','Information','None','Stop','Question')]
+ [string]$Icon = 'None',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Timeout = $configInstallationUITimeout,
+ [Parameter(Mandatory=$false)]
+ [boolean]$TopMost = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ # Bypass if in non-interactive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Dialog Box [Mode: $deployMode]: $Text..." -Source ${CmdletName}
+ Return
+ }
+
+ Write-Log -Message "Display Dialog Box with message: $Text..." -Source ${CmdletName}
+
+ [hashtable]$dialogButtons = @{
+ 'OK' = 0
+ 'OKCancel' = 1
+ 'AbortRetryIgnore' = 2
+ 'YesNoCancel' = 3
+ 'YesNo' = 4
+ 'RetryCancel' = 5
+ 'CancelTryAgainContinue' = 6
+ }
+
+ [hashtable]$dialogIcons = @{
+ 'None' = 0
+ 'Stop' = 16
+ 'Question' = 32
+ 'Exclamation' = 48
+ 'Information' = 64
+ }
+
+ [hashtable]$dialogDefaultButton = @{
+ 'First' = 0
+ 'Second' = 256
+ 'Third' = 512
+ }
+
+ Switch ($TopMost) {
+ $true { $dialogTopMost = 4096 }
+ $false { $dialogTopMost = 0 }
+ }
+
+ $response = $Shell.Popup($Text, $Timeout, $Title, ($dialogButtons[$Buttons] + $dialogIcons[$Icon] + $dialogDefaultButton[$DefaultButton] + $dialogTopMost))
+
+ Switch ($response) {
+ 1 {
+ Write-Log -Message 'Dialog Box Response: OK' -Source ${CmdletName}
+ Write-Output -InputObject 'OK'
+ }
+ 2 {
+ Write-Log -Message 'Dialog Box Response: Cancel' -Source ${CmdletName}
+ Write-Output -InputObject 'Cancel'
+ }
+ 3 {
+ Write-Log -Message 'Dialog Box Response: Abort' -Source ${CmdletName}
+ Write-Output -InputObject 'Abort'
+ }
+ 4 {
+ Write-Log -Message 'Dialog Box Response: Retry' -Source ${CmdletName}
+ Write-Output -InputObject 'Retry'
+ }
+ 5 {
+ Write-Log -Message 'Dialog Box Response: Ignore' -Source ${CmdletName}
+ Write-Output -InputObject 'Ignore'
+ }
+ 6 {
+ Write-Log -Message 'Dialog Box Response: Yes' -Source ${CmdletName}
+ Write-Output -InputObject 'Yes'
+ }
+ 7 {
+ Write-Log -Message 'Dialog Box Response: No' -Source ${CmdletName}
+ Write-Output -InputObject 'No'
+ }
+ 10 {
+ Write-Log -Message 'Dialog Box Response: Try Again' -Source ${CmdletName}
+ Write-Output -InputObject 'Try Again'
+ }
+ 11 {
+ Write-Log -Message 'Dialog Box Response: Continue' -Source ${CmdletName}
+ Write-Output -InputObject 'Continue'
+ }
+ -1 {
+ Write-Log -Message 'Dialog Box Timed Out...' -Source ${CmdletName}
+ Write-Output -InputObject 'Timeout'
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-HardwarePlatform
+Function Get-HardwarePlatform {
+<#
+.SYNOPSIS
+ Retrieves information about the hardware platform (physical or virtual)
+.DESCRIPTION
+ Retrieves information about the hardware platform (physical or virtual)
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-HardwarePlatform
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Retrieve hardware platform information.' -Source ${CmdletName}
+ $hwBios = Get-WmiObject -Class 'Win32_BIOS' -ErrorAction 'Stop' | Select-Object -Property 'Version', 'SerialNumber'
+ $hwMakeModel = Get-WMIObject -Class 'Win32_ComputerSystem' -ErrorAction 'Stop' | Select-Object -Property 'Model', 'Manufacturer'
+
+ If ($hwBIOS.Version -match 'VRTUAL') { $hwType = 'Virtual:Hyper-V' }
+ ElseIf ($hwBIOS.Version -match 'A M I') { $hwType = 'Virtual:Virtual PC' }
+ ElseIf ($hwBIOS.Version -like '*Xen*') { $hwType = 'Virtual:Xen' }
+ ElseIf ($hwBIOS.SerialNumber -like '*VMware*') { $hwType = 'Virtual:VMWare' }
+ ElseIf (($hwMakeModel.Manufacturer -like '*Microsoft*') -and ($hwMakeModel.Model -notlike '*Surface*')) { $hwType = 'Virtual:Hyper-V' }
+ ElseIf ($hwMakeModel.Manufacturer -like '*VMWare*') { $hwType = 'Virtual:VMWare' }
+ ElseIf ($hwMakeModel.Model -like '*Virtual*') { $hwType = 'Virtual' }
+ Else { $hwType = 'Physical' }
+
+ Write-Output -InputObject $hwType
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve hardware platform information. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve hardware platform information: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-FreeDiskSpace
+Function Get-FreeDiskSpace {
+<#
+.SYNOPSIS
+ Retrieves the free disk space in MB on a particular drive (defaults to system drive)
+.DESCRIPTION
+ Retrieves the free disk space in MB on a particular drive (defaults to system drive)
+.PARAMETER Drive
+ Drive to check free disk space on
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-FreeDiskSpace -Drive 'C:'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Drive = $envSystemDrive,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Retrieve free disk space for drive [$Drive]." -Source ${CmdletName}
+ $disk = Get-WmiObject -Class 'Win32_LogicalDisk' -Filter "DeviceID='$Drive'" -ErrorAction 'Stop'
+ [double]$freeDiskSpace = [math]::Round($disk.FreeSpace / 1MB)
+
+ Write-Log -Message "Free disk space for drive [$Drive]: [$freeDiskSpace MB]." -Source ${CmdletName}
+ Write-Output -InputObject $freeDiskSpace
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve free disk space for drive [$Drive]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve free disk space for drive [$Drive]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-InstalledApplication
+Function Get-InstalledApplication {
+<#
+.SYNOPSIS
+ Retrieves information about installed applications.
+.DESCRIPTION
+ Retrieves information about installed applications by querying the registry. You can specify an application name, a product code, or both.
+ Returns information about application publisher, name & version, product code, uninstall string, install source, location, date, and application architecture.
+.PARAMETER Name
+ The name of the application to retrieve information for. Performs a contains match on the application display name by default.
+.PARAMETER Exact
+ Specifies that the named application must be matched using the exact name.
+.PARAMETER WildCard
+ Specifies that the named application must be matched using a wildcard search.
+.PARAMETER RegEx
+ Specifies that the named application must be matched using a regular expression search.
+.PARAMETER ProductCode
+ The product code of the application to retrieve information for.
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.EXAMPLE
+ Get-InstalledApplication -Name 'Adobe Flash'
+.EXAMPLE
+ Get-InstalledApplication -ProductCode '{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Exact = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WildCard = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$RegEx = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$ProductCode,
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($name) {
+ Write-Log -Message "Get information for installed Application Name(s) [$($name -join ', ')]..." -Source ${CmdletName}
+ }
+ If ($productCode) {
+ Write-Log -Message "Get information for installed Product Code [$ProductCode]..." -Source ${CmdletName}
+ }
+
+ ## Enumerate the installed applications from the registry for applications that have the "DisplayName" property
+ [psobject[]]$regKeyApplication = @()
+ ForEach ($regKey in $regKeyApplications) {
+ If (Test-Path -LiteralPath $regKey -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorUninstallKeyPath') {
+ [psobject[]]$UninstallKeyApps = Get-ChildItem -LiteralPath $regKey -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorUninstallKeyPath'
+ ForEach ($UninstallKeyApp in $UninstallKeyApps) {
+ Try {
+ [psobject]$regKeyApplicationProps = Get-ItemProperty -LiteralPath $UninstallKeyApp.PSPath -ErrorAction 'Stop'
+ If ($regKeyApplicationProps.DisplayName) { [psobject[]]$regKeyApplication += $regKeyApplicationProps }
+ }
+ Catch{
+ Write-Log -Message "Unable to enumerate properties from registry key path [$($UninstallKeyApp.PSPath)]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ }
+ If ($ErrorUninstallKeyPath) {
+ Write-Log -Message "The following error(s) took place while enumerating installed applications from the registry. `n$(Resolve-Error -ErrorRecord $ErrorUninstallKeyPath)" -Severity 2 -Source ${CmdletName}
+ }
+
+ ## Create a custom object with the desired properties for the installed applications and sanitize property details
+ [psobject[]]$installedApplication = @()
+ ForEach ($regKeyApp in $regKeyApplication) {
+ Try {
+ [string]$appDisplayName = ''
+ [string]$appDisplayVersion = ''
+ [string]$appPublisher = ''
+
+ ## Bypass any updates or hotfixes
+ If (-not $IncludeUpdatesAndHotfixes) {
+ If ($regKeyApp.DisplayName -match '(?i)kb\d+') { Continue }
+ If ($regKeyApp.DisplayName -match 'Cumulative Update') { Continue }
+ If ($regKeyApp.DisplayName -match 'Security Update') { Continue }
+ If ($regKeyApp.DisplayName -match 'Hotfix') { Continue }
+ }
+
+ ## Remove any control characters which may interfere with logging and creating file path names from these variables
+ $appDisplayName = $regKeyApp.DisplayName -replace '[^\u001F-\u007F]',''
+ $appDisplayVersion = $regKeyApp.DisplayVersion -replace '[^\u001F-\u007F]',''
+ $appPublisher = $regKeyApp.Publisher -replace '[^\u001F-\u007F]',''
+
+ ## Determine if application is a 64-bit application
+ [boolean]$Is64BitApp = If (($is64Bit) -and ($regKeyApp.PSPath -notmatch '^Microsoft\.PowerShell\.Core\\Registry::HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node')) { $true } Else { $false }
+
+ If ($ProductCode) {
+ ## Verify if there is a match with the product code passed to the script
+ If ($regKeyApp.PSChildName -match [regex]::Escape($productCode)) {
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] matching product code [$productCode]." -Source ${CmdletName}
+ $installedApplication += New-Object -TypeName 'PSObject' -Property @{
+ UninstallSubkey = $regKeyApp.PSChildName
+ ProductCode = If ($regKeyApp.PSChildName -match $MSIProductCodeRegExPattern) { $regKeyApp.PSChildName } Else { [string]::Empty }
+ DisplayName = $appDisplayName
+ DisplayVersion = $appDisplayVersion
+ UninstallString = $regKeyApp.UninstallString
+ InstallSource = $regKeyApp.InstallSource
+ InstallLocation = $regKeyApp.InstallLocation
+ InstallDate = $regKeyApp.InstallDate
+ Publisher = $appPublisher
+ Is64BitApplication = $Is64BitApp
+ }
+ }
+ }
+
+ If ($name) {
+ ## Verify if there is a match with the application name(s) passed to the script
+ ForEach ($application in $Name) {
+ $applicationMatched = $false
+ If ($exact) {
+ # Check for an exact application name match
+ If ($regKeyApp.DisplayName -eq $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using exact name matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($WildCard) {
+ # Check for wildcard application name match
+ If ($regKeyApp.DisplayName -like $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using wildcard matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($RegEx) {
+ # Check for a regex application name match
+ If ($regKeyApp.DisplayName -match $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using regex matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ # Check for a contains application name match
+ ElseIf ($regKeyApp.DisplayName -match [regex]::Escape($application)) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using contains matching for search term [$application]." -Source ${CmdletName}
+ }
+
+ If ($applicationMatched) {
+ $installedApplication += New-Object -TypeName 'PSObject' -Property @{
+ UninstallSubkey = $regKeyApp.PSChildName
+ ProductCode = If ($regKeyApp.PSChildName -match $MSIProductCodeRegExPattern) { $regKeyApp.PSChildName } Else { [string]::Empty }
+ DisplayName = $appDisplayName
+ DisplayVersion = $appDisplayVersion
+ UninstallString = $regKeyApp.UninstallString
+ InstallSource = $regKeyApp.InstallSource
+ InstallLocation = $regKeyApp.InstallLocation
+ InstallDate = $regKeyApp.InstallDate
+ Publisher = $appPublisher
+ Is64BitApplication = $Is64BitApp
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to resolve application details from registry for [$appDisplayName]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Continue
+ }
+ }
+
+ Write-Output -InputObject $installedApplication
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-MSI
+Function Execute-MSI {
+<#
+.SYNOPSIS
+ Executes msiexec.exe to perform the following actions for MSI & MSP files and MSI product codes: install, uninstall, patch, repair, active setup.
+.DESCRIPTION
+ Executes msiexec.exe to perform the following actions for MSI & MSP files and MSI product codes: install, uninstall, patch, repair, active setup.
+ If the -Action parameter is set to "Install" and the MSI is already installed, the function will exit.
+ Sets default switches to be passed to msiexec based on the preferences in the XML configuration file.
+ Automatically generates a log file name and creates a verbose log file for all msiexec operations.
+ Expects the MSI or MSP file to be located in the "Files" sub directory of the App Deploy Toolkit. Expects transform files to be in the same directory as the MSI file.
+.PARAMETER Action
+ The action to perform. Options: Install, Uninstall, Patch, Repair, ActiveSetup.
+.PARAMETER Path
+ The path to the MSI/MSP file or the product code of the installed MSI.
+.PARAMETER Transform
+ The name of the transform file(s) to be applied to the MSI. The transform file is expected to be in the same directory as the MSI file.
+.PARAMETER Patch
+ The name of the patch (msp) file(s) to be applied to the MSI for use with the "Install" action. The patch file is expected to be in the same directory as the MSI file.
+.PARAMETER Parameters
+ Overrides the default parameters specified in the XML configuration file. Install default is: "REBOOT=ReallySuppress /QB!". Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER AddParameters
+ Adds to the default parameters specified in the XML configuration file. Install default is: "REBOOT=ReallySuppress /QB!". Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER SecureParameters
+ Hides all parameters passed to the MSI or MSP file from the toolkit Log file.
+.PARAMETER LoggingOptions
+ Overrides the default logging options specified in the XML configuration file. Default options are: "/L*v".
+.PARAMETER LogName
+ Overrides the default log file name. The default log file name is generated from the MSI file name. If LogName does not end in .log, it will be automatically appended.
+ For uninstallations, by default the product code is resolved to the DisplayName and version of the application.
+.PARAMETER WorkingDirectory
+ Overrides the working directory. The working directory is set to the location of the MSI file.
+.PARAMETER SkipMSIAlreadyInstalledCheck
+ Skips the check to determine if the MSI is already installed on the system. Default is: $false.
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by msiexec that is not recognized by the App Deploy Toolkit. Default is: $false.
+.EXAMPLE
+ Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi'
+ Installs an MSI
+.EXAMPLE
+ Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi' -Transform 'Adobe_FlashPlayer_11.2.202.233_x64_EN_01.mst' -Parameters '/QN'
+ Installs an MSI, applying a transform and overriding the default MSI toolkit parameters
+.EXAMPLE
+ [psobject]$ExecuteMSIResult = Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi' -PassThru
+ Installs an MSI and stores the result of the execution into a variable by using the -PassThru option
+.EXAMPLE
+ Execute-MSI -Action 'Uninstall' -Path '{26923b43-4d38-484f-9b9e-de460746276c}'
+ Uninstalls an MSI using a product code
+.EXAMPLE
+ Execute-MSI -Action 'Patch' -Path 'Adobe_Reader_11.0.3_EN.msp'
+ Installs an MSP
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Install','Uninstall','Patch','Repair','ActiveSetup')]
+ [string]$Action = 'Install',
+ [Parameter(Mandatory=$true,HelpMessage='Please enter either the path to the MSI/MSP file or the ProductCode')]
+ [ValidateScript({($_ -match $MSIProductCodeRegExPattern) -or ('.msi','.msp' -contains [IO.Path]::GetExtension($_))})]
+ [Alias('FilePath')]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Transform,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$AddParameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Patch,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$LoggingOptions,
+ [Parameter(Mandatory=$false)]
+ [Alias('LogName')]
+ [string]$private:LogName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$SkipMSIAlreadyInstalledCheck = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Initialize variable indicating whether $Path variable is a Product Code or not
+ [boolean]$PathIsProductCode = $false
+
+ ## If the path matches a product code
+ If ($Path -match $MSIProductCodeRegExPattern) {
+ # Set variable indicating that $Path variable is a Product Code
+ [boolean]$PathIsProductCode = $true
+
+ # Resolve the product code to a publisher, application name, and version
+ Write-Log -Message 'Resolve product code to a publisher, application name, and version.' -Source ${CmdletName}
+
+ If ($IncludeUpdatesAndHotfixes) {
+ [psobject]$productCodeNameVersion = Get-InstalledApplication -ProductCode $path -IncludeUpdatesAndHotfixes | Select-Object -Property 'Publisher', 'DisplayName', 'DisplayVersion' -First 1 -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ [psobject]$productCodeNameVersion = Get-InstalledApplication -ProductCode $path | Select-Object -Property 'Publisher', 'DisplayName', 'DisplayVersion' -First 1 -ErrorAction 'SilentlyContinue'
+ }
+
+ # Build the log file name
+ If (-not $logName) {
+ If ($productCodeNameVersion) {
+ If ($productCodeNameVersion.Publisher) {
+ $logName = ($productCodeNameVersion.Publisher + '_' + $productCodeNameVersion.DisplayName + '_' + $productCodeNameVersion.DisplayVersion) -replace "[$invalidFileNameChars]",'' -replace ' ',''
+ }
+ Else {
+ $logName = ($productCodeNameVersion.DisplayName + '_' + $productCodeNameVersion.DisplayVersion) -replace "[$invalidFileNameChars]",'' -replace ' ',''
+ }
+ }
+ Else {
+ # Out of other options, make the Product Code the name of the log file
+ $logName = $Path
+ }
+ }
+ }
+ Else {
+ # Get the log file name without file extension
+ If (-not $logName) { $logName = ([IO.FileInfo]$path).BaseName } ElseIf ('.log','.txt' -contains [IO.Path]::GetExtension($logName)) { $logName = [IO.Path]::GetFileNameWithoutExtension($logName) }
+ }
+
+ If ($configToolkitCompressLogs) {
+ ## Build the log file path
+ [string]$logPath = Join-Path -Path $logTempFolder -ChildPath $logName
+ }
+ Else {
+ ## Create the Log directory if it doesn't already exist
+ If (-not (Test-Path -LiteralPath $configMSILogDir -PathType 'Container' -ErrorAction 'SilentlyContinue')) {
+ $null = New-Item -Path $configMSILogDir -ItemType 'Directory' -ErrorAction 'SilentlyContinue'
+ }
+ ## Build the log file path
+ [string]$logPath = Join-Path -Path $configMSILogDir -ChildPath $logName
+ }
+
+ ## Set the installation Parameters
+ If ($deployModeSilent) {
+ $msiInstallDefaultParams = $configMSISilentParams
+ $msiUninstallDefaultParams = $configMSISilentParams
+ }
+ Else {
+ $msiInstallDefaultParams = $configMSIInstallParams
+ $msiUninstallDefaultParams = $configMSIUninstallParams
+ }
+
+ ## Build the MSI Parameters
+ Switch ($action) {
+ 'Install' { $option = '/i'; [string]$msiLogFile = "$logPath" + '_Install'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'Uninstall' { $option = '/x'; [string]$msiLogFile = "$logPath" + '_Uninstall'; $msiDefaultParams = $msiUninstallDefaultParams }
+ 'Patch' { $option = '/update'; [string]$msiLogFile = "$logPath" + '_Patch'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'Repair' { $option = '/f'; [string]$msiLogFile = "$logPath" + '_Repair'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'ActiveSetup' { $option = '/fups'; [string]$msiLogFile = "$logPath" + '_ActiveSetup' }
+ }
+
+ ## Append ".log" to the MSI logfile path and enclose in quotes
+ If ([IO.Path]::GetExtension($msiLogFile) -ne '.log') {
+ [string]$msiLogFile = $msiLogFile + '.log'
+ [string]$msiLogFile = "`"$msiLogFile`""
+ }
+
+ ## If the MSI is in the Files directory, set the full path to the MSI
+ If (Test-Path -LiteralPath (Join-Path -Path $dirFiles -ChildPath $path -ErrorAction 'SilentlyContinue') -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ [string]$msiFile = Join-Path -Path $dirFiles -ChildPath $path
+ }
+ ElseIf (Test-Path -LiteralPath $Path -ErrorAction 'SilentlyContinue') {
+ [string]$msiFile = (Get-Item -LiteralPath $Path).FullName
+ }
+ ElseIf ($PathIsProductCode) {
+ [string]$msiFile = $Path
+ }
+ Else {
+ Write-Log -Message "Failed to find MSI file [$path]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to find MSI file [$path]."
+ }
+ Continue
+ }
+
+ ## Set the working directory of the MSI
+ If ((-not $PathIsProductCode) -and (-not $workingDirectory)) { [string]$workingDirectory = Split-Path -Path $msiFile -Parent }
+
+ ## Enumerate all transforms specified, qualify the full path if possible and enclose in quotes
+ If ($transform) {
+ [string[]]$transforms = $transform -split ','
+ 0..($transforms.Length - 1) | ForEach-Object {
+ If (Test-Path -LiteralPath (Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $transforms[$_]) -PathType 'Leaf') {
+ $transforms[$_] = Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $transforms[$_].Replace('.\','')
+ }
+ Else {
+ $transforms[$_] = $transforms[$_]
+ }
+ }
+ [string]$mstFile = "`"$($transforms -join ';')`""
+ }
+
+ ## Enumerate all patches specified, qualify the full path if possible and enclose in quotes
+ If ($patch) {
+ [string[]]$patches = $patch -split ','
+ 0..($patches.Length - 1) | ForEach-Object {
+ If (Test-Path -LiteralPath (Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $patches[$_]) -PathType 'Leaf') {
+ $patches[$_] = Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $patches[$_].Replace('.\','')
+ }
+ Else {
+ $patches[$_] = $patches[$_]
+ }
+ }
+ [string]$mspFile = "`"$($patches -join ';')`""
+ }
+
+ ## Get the ProductCode of the MSI
+ If ($PathIsProductCode) {
+ [string]$MSIProductCode = $path
+ }
+ ElseIf ([IO.Path]::GetExtension($msiFile) -eq '.msi') {
+ Try {
+ [hashtable]$GetMsiTablePropertySplat = @{ Path = $msiFile; Table = 'Property'; ContinueOnError = $false }
+ If ($transforms) { $GetMsiTablePropertySplat.Add( 'TransformPath', $transforms ) }
+ [string]$MSIProductCode = Get-MsiTableProperty @GetMsiTablePropertySplat | Select-Object -ExpandProperty 'ProductCode' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to get the ProductCode from the MSI file. Continue with requested action [$Action]..." -Source ${CmdletName}
+ }
+ }
+
+ ## Enclose the MSI file in quotes to avoid issues with spaces when running msiexec
+ [string]$msiFile = "`"$msiFile`""
+
+ ## Start building the MsiExec command line starting with the base action and file
+ [string]$argsMSI = "$option $msiFile"
+ # Add MST
+ If ($transform) { $argsMSI = "$argsMSI TRANSFORMS=$mstFile TRANSFORMSSECURE=1" }
+ # Add MSP
+ If ($patch) { $argsMSI = "$argsMSI PATCH=$mspFile" }
+ # Replace default parameters if specified.
+ If ($Parameters) { $argsMSI = "$argsMSI $Parameters" } Else { $argsMSI = "$argsMSI $msiDefaultParams" }
+ # Append parameters to default parameters if specified.
+ If ($AddParameters) { $argsMSI = "$argsMSI $AddParameters" }
+ # Add custom Logging Options if specified, otherwise, add default Logging Options from Config file
+ If ($LoggingOptions) { $argsMSI = "$argsMSI $LoggingOptions $msiLogFile" } Else { $argsMSI = "$argsMSI $configMSILoggingOptions $msiLogFile" }
+
+ ## Check if the MSI is already installed. If no valid ProductCode to check, then continue with requested MSI action.
+ If ($MSIProductCode) {
+ If ($SkipMSIAlreadyInstalledCheck) {
+ [boolean]$IsMsiInstalled = $false
+ }
+ Else {
+ If ($IncludeUpdatesAndHotfixes) {
+ [psobject]$MsiInstalled = Get-InstalledApplication -ProductCode $MSIProductCode -IncludeUpdatesAndHotfixes
+ }
+ Else {
+ [psobject]$MsiInstalled = Get-InstalledApplication -ProductCode $MSIProductCode
+ }
+ If ($MsiInstalled) { [boolean]$IsMsiInstalled = $true }
+ }
+ }
+ Else {
+ If ($Action -eq 'Install') { [boolean]$IsMsiInstalled = $false } Else { [boolean]$IsMsiInstalled = $true }
+ }
+
+ If (($IsMsiInstalled) -and ($Action -eq 'Install')) {
+ Write-Log -Message "The MSI is already installed on this system. Skipping action [$Action]..." -Source ${CmdletName}
+ }
+ ElseIf (((-not $IsMsiInstalled) -and ($Action -eq 'Install')) -or ($IsMsiInstalled)) {
+ Write-Log -Message "Executing MSI action [$Action]..." -Source ${CmdletName}
+ # Build the hashtable with the options that will be passed to Execute-Process using splatting
+ [hashtable]$ExecuteProcessSplat = @{ Path = $exeMsiexec
+ Parameters = $argsMSI
+ WindowStyle = 'Normal' }
+ If ($WorkingDirectory) { $ExecuteProcessSplat.Add( 'WorkingDirectory', $WorkingDirectory) }
+ If ($ContinueOnError) { $ExecuteProcessSplat.Add( 'ContinueOnError', $ContinueOnError) }
+ If ($SecureParameters) { $ExecuteProcessSplat.Add( 'SecureParameters', $SecureParameters) }
+ If ($PassThru) { $ExecuteProcessSplat.Add( 'PassThru', $PassThru) }
+ # Call the Execute-Process function
+ If ($PassThru) {
+ [psobject]$ExecuteResults = Execute-Process @ExecuteProcessSplat
+ }
+ Else {
+ Execute-Process @ExecuteProcessSplat
+ }
+ # Refresh environment variables for Windows Explorer process as Windows does not consistently update environment variables created by MSIs
+ Update-Desktop
+ }
+ Else {
+ Write-Log -Message "The MSI is not installed on this system. Skipping action [$Action]..." -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $ExecuteResults }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-MSIApplications
+Function Remove-MSIApplications {
+<#
+.SYNOPSIS
+ Removes all MSI applications matching the specified application name.
+.DESCRIPTION
+ Removes all MSI applications matching the specified application name.
+ Enumerates the registry for installed applications matching the specified application name and uninstalls that application using the product code, provided the uninstall string matches "msiexec".
+.PARAMETER Name
+ The name of the application to uninstall. Performs a contains match on the application display name by default.
+.PARAMETER Exact
+ Specifies that the named application must be matched using the exact name.
+.PARAMETER WildCard
+ Specifies that the named application must be matched using a wildcard search.
+.PARAMETER Parameters
+ Overrides the default parameters specified in the XML configuration file. Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER AddParameters
+ Adds to the default parameters specified in the XML configuration file. Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER FilterApplication
+ Two-dimensional array that contains one or more (property, value, match-type) sets that should be used to filter the list of results returned by Get-InstalledApplication to only those that should be uninstalled.
+ Properties that can be filtered upon: ProductCode, DisplayName, DisplayVersion, UninstallString, InstallSource, InstallLocation, InstallDate, Publisher, Is64BitApplication
+.PARAMETER ExcludeFromUninstall
+ Two-dimensional array that contains one or more (property, value, match-type) sets that should be excluded from uninstall if found.
+ Properties that can be excluded: ProductCode, DisplayName, DisplayVersion, UninstallString, InstallSource, InstallLocation, InstallDate, Publisher, Is64BitApplication
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.PARAMETER LoggingOptions
+ Overrides the default logging options specified in the XML configuration file. Default options are: "/L*v".
+.PARAMETER LogName
+ Overrides the default log file name. The default log file name is generated from the MSI file name. If LogName does not end in .log, it will be automatically appended.
+ For uninstallations, by default the product code is resolved to the DisplayName and version of the application.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by msiexec that is not recognized by the App Deploy Toolkit. Default is: $true.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Adobe Flash'
+ Removes all versions of software that match the name "Adobe Flash"
+.EXAMPLE
+ Remove-MSIApplications -Name 'Adobe'
+ Removes all versions of software that match the name "Adobe"
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -FilterApplication ('Is64BitApplication', $false, 'Exact'),('Publisher', 'Oracle Corporation', 'Exact')
+ Removes all versions of software that match the name "Java 8 Update" where the software is 32-bits and the publisher is "Oracle Corporation".
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -FilterApplication (,('Publisher', 'Oracle Corporation', 'Exact')) -ExcludeFromUninstall (,('DisplayName', 'Java 8 Update 45', 'Contains'))
+ Removes all versions of software that match the name "Java 8 Update" and also have "Oracle Corporation" as the Publisher; however, it does not uninstall "Java 8 Update 45" of the software.
+ NOTE: if only specifying a single row in the two-dimensional arrays, the array must have the extra parentheses and leading comma as in this example.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -ExcludeFromUninstall (,('DisplayName', 'Java 8 Update 45', 'Contains'))
+ Removes all versions of software that match the name "Java 8 Update"; however, it does not uninstall "Java 8 Update 45" of the software.
+ NOTE: if only specifying a single row in the two-dimensional array, the array must have the extra parentheses and leading comma as in this example.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -ExcludeFromUninstall
+ ('Is64BitApplication', $true, 'Exact'),
+ ('DisplayName', 'Java 8 Update 45', 'Exact'),
+ ('DisplayName', 'Java 8 Update 4*', 'WildCard'),
+ ('DisplayName', 'Java \d Update \d{3}', 'RegEx'),
+ ('DisplayName', 'Java 8 Update', 'Contains')
+ Removes all versions of software that match the name "Java 8 Update"; however, it does not uninstall 64-bit versions of the software, Update 45 of the software, or any Update that starts with 4.
+.NOTES
+ More reading on how to create arrays if having trouble with -FilterApplication or -ExcludeFromUninstall parameter: http://blogs.msdn.com/b/powershell/archive/2007/01/23/array-literals-in-powershell.aspx
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Exact = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WildCard = $false,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$AddParameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [array]$FilterApplication = @(@()),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [array]$ExcludeFromUninstall = @(@()),
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$LoggingOptions,
+ [Parameter(Mandatory=$false)]
+ [Alias('LogName')]
+ [string]$private:LogName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Build the hashtable with the options that will be passed to Get-InstalledApplication using splatting
+ [hashtable]$GetInstalledApplicationSplat = @{ Name = $name }
+ If ($Exact) { $GetInstalledApplicationSplat.Add( 'Exact', $Exact) }
+ ElseIf ($WildCard) { $GetInstalledApplicationSplat.Add( 'WildCard', $WildCard) }
+ If ($IncludeUpdatesAndHotfixes) { $GetInstalledApplicationSplat.Add( 'IncludeUpdatesAndHotfixes', $IncludeUpdatesAndHotfixes) }
+
+ [psobject[]]$installedApplications = Get-InstalledApplication @GetInstalledApplicationSplat
+
+ Write-Log -Message "Found [$($installedApplications.Count)] application(s) that matched the specified criteria [$Name]." -Source ${CmdletName}
+
+ ## Filter the results from Get-InstalledApplication
+ [Collections.ArrayList]$removeMSIApplications = New-Object -TypeName 'System.Collections.ArrayList'
+ If (($null -ne $installedApplications) -and ($installedApplications.Count)) {
+ ForEach ($installedApplication in $installedApplications) {
+ If ($installedApplication.UninstallString -notmatch 'msiexec') {
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName)] because uninstall string [$($installedApplication.UninstallString)] does not match `"msiexec`"." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ If ([string]::IsNullOrEmpty($installedApplication.ProductCode)) {
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName)] because unable to discover MSI ProductCode from application's registry Uninstall subkey [$($installedApplication.UninstallSubkey)]." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+
+ # Filter the results from Get-InstalledApplication to only those that should be uninstalled
+ If (($null -ne $FilterApplication) -and ($FilterApplication.Count)) {
+ Write-Log -Message "Filter the results to only those that should be uninstalled as specified in parameter [-FilterApplication]." -Source ${CmdletName}
+ [boolean]$addAppToRemoveList = $false
+ ForEach ($Filter in $FilterApplication) {
+ If ($Filter[2] -eq 'RegEx') {
+ If ($installedApplication.($Filter[0]) -match $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of regex match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'Contains') {
+ If ($installedApplication.($Filter[0]) -match [regex]::Escape($Filter[1])) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of contains match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'WildCard') {
+ If ($installedApplication.($Filter[0]) -like $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of wildcard match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'Exact') {
+ If ($installedApplication.($Filter[0]) -eq $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of exact match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Else {
+ [boolean]$addAppToRemoveList = $true
+ }
+
+ # Filter the results from Get-InstalledApplication to remove those that should never be uninstalled
+ If (($null -ne $ExcludeFromUninstall) -and ($ExcludeFromUninstall.Count)) {
+ ForEach ($Exclude in $ExcludeFromUninstall) {
+ If ($Exclude[2] -eq 'RegEx') {
+ If ($installedApplication.($Exclude[0]) -match $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of regex match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'Contains') {
+ If ($installedApplication.($Exclude[0]) -match [regex]::Escape($Exclude[1])) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of contains match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'WildCard') {
+ If ($installedApplication.($Exclude[0]) -like $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of wildcard match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'Exact') {
+ If ($installedApplication.($Exclude[0]) -eq $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of exact match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+
+ If ($addAppToRemoveList) {
+ Write-Log -Message "Adding application to list for removal: [$($installedApplication.DisplayName) $($installedApplication.Version)]." -Source ${CmdletName}
+ $removeMSIApplications.Add($installedApplication)
+ }
+ }
+ }
+
+ ## Build the hashtable with the options that will be passed to Execute-MSI using splatting
+ [hashtable]$ExecuteMSISplat = @{ Action = 'Uninstall'; Path = '' }
+ If ($ContinueOnError) { $ExecuteMSISplat.Add( 'ContinueOnError', $ContinueOnError) }
+ If ($Parameters) { $ExecuteMSISplat.Add( 'Parameters', $Parameters) }
+ ElseIf ($AddParameters) { $ExecuteMSISplat.Add( 'AddParameters', $AddParameters) }
+ If ($LoggingOptions) { $ExecuteMSISplat.Add( 'LoggingOptions', $LoggingOptions) }
+ If ($LogName) { $ExecuteMSISplat.Add( 'LogName', $LogName) }
+ If ($PassThru) { $ExecuteMSISplat.Add( 'PassThru', $PassThru) }
+ If ($IncludeUpdatesAndHotfixes) { $ExecuteMSISplat.Add( 'IncludeUpdatesAndHotfixes', $IncludeUpdatesAndHotfixes) }
+
+ If (($null -ne $removeMSIApplications) -and ($removeMSIApplications.Count)) {
+ ForEach ($removeMSIApplication in $removeMSIApplications) {
+ Write-Log -Message "Remove application [$($removeMSIApplication.DisplayName) $($removeMSIApplication.Version)]." -Source ${CmdletName}
+ $ExecuteMSISplat.Path = $removeMSIApplication.ProductCode
+ If ($PassThru) {
+ [psobject[]]$ExecuteResults += Execute-MSI @ExecuteMSISplat
+ }
+ Else {
+ Execute-MSI @ExecuteMSISplat
+ }
+ }
+ }
+ Else {
+ Write-Log -Message 'No applications found for removal. Continue...' -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $ExecuteResults }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-Process
+Function Execute-Process {
+<#
+.SYNOPSIS
+ Execute a process with optional arguments, working directory, window style.
+.DESCRIPTION
+ Executes a process, e.g. a file included in the Files directory of the App Deploy Toolkit, or a file on the local machine.
+ Provides various options for handling the return codes (see Parameters).
+.PARAMETER Path
+ Path to the file to be executed. If the file is located directly in the "Files" directory of the App Deploy Toolkit, only the file name needs to be specified.
+ Otherwise, the full path of the file must be specified. If the files is in a subdirectory of "Files", use the "$dirFiles" variable as shown in the example.
+.PARAMETER Parameters
+ Arguments to be passed to the executable
+.PARAMETER SecureParameters
+ Hides all parameters passed to the executable from the Toolkit log file
+.PARAMETER WindowStyle
+ Style of the window of the process executed. Options: Normal, Hidden, Maximized, Minimized. Default: Normal.
+ Note: Not all processes honor the "Hidden" flag. If it it not working, then check the command line options for the process being executed to see it has a silent option.
+.PARAMETER CreateNoWindow
+ Specifies whether the process should be started with a new window to contain it. Default is false.
+.PARAMETER WorkingDirectory
+ The working directory used for executing the process. Defaults to the directory of the file being executed.
+.PARAMETER NoWait
+ Immediately continue after executing the process.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER WaitForMsiExec
+ Sometimes an EXE bootstrapper will launch an MSI install. In such cases, this variable will ensure that
+ this function waits for the msiexec engine to become available before starting the install.
+.PARAMETER MsiExecWaitTime
+ Specify the length of time in seconds to wait for the msiexec engine to become available. Default: 600 seconds (10 minutes).
+.PARAMETER IgnoreExitCodes
+ List the exit codes to ignore.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by the process that is not recognized by the App Deploy Toolkit. Default: $false.
+.EXAMPLE
+ Execute-Process -Path 'uninstall_flash_player_64bit.exe' -Parameters '/uninstall' -WindowStyle 'Hidden'
+ If the file is in the "Files" directory of the App Deploy Toolkit, only the file name needs to be specified.
+.EXAMPLE
+ Execute-Process -Path "$dirFiles\Bin\setup.exe" -Parameters '/S' -WindowStyle 'Hidden'
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters '/S' -IgnoreExitCodes '1,2'
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters "-s -f2`"$configToolkitLogDir\$installName.log`""
+ Launch InstallShield "setup.exe" from the ".\Files" sub-directory and force log files to the logging folder.
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters "/s /v`"ALLUSERS=1 /qn /L* \`"$configToolkitLogDir\$installName.log`"`""
+ Launch InstallShield "setup.exe" with embedded MSI and force log files to the logging folder.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [Alias('FilePath')]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Normal','Hidden','Maximized','Minimized')]
+ [Diagnostics.ProcessWindowStyle]$WindowStyle = 'Normal',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$CreateNoWindow = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [switch]$NoWait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WaitForMsiExec = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [timespan]$MsiExecWaitTime = $(New-TimeSpan -Seconds $configMSIMutexWaitTime),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IgnoreExitCodes,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $private:returnCode = $null
+
+ ## Validate and find the fully qualified path for the $Path variable.
+ If (([IO.Path]::IsPathRooted($Path)) -and ([IO.Path]::HasExtension($Path))) {
+ Write-Log -Message "[$Path] is a valid fully qualified path, continue." -Source ${CmdletName}
+ If (-not (Test-Path -LiteralPath $Path -PathType 'Leaf' -ErrorAction 'Stop')) {
+ Throw "File [$Path] not found."
+ }
+ }
+ Else {
+ # The first directory to search will be the 'Files' subdirectory of the script directory
+ [string]$PathFolders = $dirFiles
+ # Add the current location of the console (Windows always searches this location first)
+ [string]$PathFolders = $PathFolders + ';' + (Get-Location -PSProvider 'FileSystem').Path
+ # Add the new path locations to the PATH environment variable
+ $env:PATH = $PathFolders + ';' + $env:PATH
+
+ # Get the fully qualified path for the file. Get-Command searches PATH environment variable to find this value.
+ [string]$FullyQualifiedPath = Get-Command -Name $Path -CommandType 'Application' -TotalCount 1 -Syntax -ErrorAction 'Stop'
+
+ # Revert the PATH environment variable to it's original value
+ $env:PATH = $env:PATH -replace [regex]::Escape($PathFolders + ';'), ''
+
+ If ($FullyQualifiedPath) {
+ Write-Log -Message "[$Path] successfully resolved to fully qualified path [$FullyQualifiedPath]." -Source ${CmdletName}
+ $Path = $FullyQualifiedPath
+ }
+ Else {
+ Throw "[$Path] contains an invalid path or file name."
+ }
+ }
+
+ ## Set the Working directory (if not specified)
+ If (-not $WorkingDirectory) { $WorkingDirectory = Split-Path -Path $Path -Parent -ErrorAction 'Stop' }
+
+ ## If MSI install, check to see if the MSI installer service is available or if another MSI install is already underway.
+ ## Please note that a race condition is possible after this check where another process waiting for the MSI installer
+ ## to become available grabs the MSI Installer mutex before we do. Not too concerned about this possible race condition.
+ If (($Path -match 'msiexec') -or ($WaitForMsiExec)) {
+ [boolean]$MsiExecAvailable = Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds $MsiExecWaitTime.TotalMilliseconds
+ Start-Sleep -Seconds 1
+ If (-not $MsiExecAvailable) {
+ # Default MSI exit code for install already in progress
+ [int32]$returnCode = 1618
+ Throw 'Please complete in progress MSI installation before proceeding with this install.'
+ }
+ }
+
+ Try {
+ ## Disable Zone checking to prevent warnings when running executables
+ $env:SEE_MASK_NOZONECHECKS = 1
+
+ ## Using this variable allows capture of exceptions from .NET methods. Private scope only changes value for current function.
+ $private:previousErrorActionPreference = $ErrorActionPreference
+ $ErrorActionPreference = 'Stop'
+
+ ## Define process
+ $processStartInfo = New-Object -TypeName 'System.Diagnostics.ProcessStartInfo' -ErrorAction 'Stop'
+ $processStartInfo.FileName = $Path
+ $processStartInfo.WorkingDirectory = $WorkingDirectory
+ $processStartInfo.UseShellExecute = $false
+ $processStartInfo.ErrorDialog = $false
+ $processStartInfo.RedirectStandardOutput = $true
+ $processStartInfo.RedirectStandardError = $true
+ $processStartInfo.CreateNoWindow = $CreateNoWindow
+ If ($Parameters) { $processStartInfo.Arguments = $Parameters }
+ If ($windowStyle) { $processStartInfo.WindowStyle = $WindowStyle }
+ $process = New-Object -TypeName 'System.Diagnostics.Process' -ErrorAction 'Stop'
+ $process.StartInfo = $processStartInfo
+
+ ## Add event handler to capture process's standard output redirection
+ [scriptblock]$processEventHandler = { If (-not [string]::IsNullOrEmpty($EventArgs.Data)) { $Event.MessageData.AppendLine($EventArgs.Data) } }
+ $stdOutBuilder = New-Object -TypeName 'System.Text.StringBuilder' -ArgumentList ''
+ $stdOutEvent = Register-ObjectEvent -InputObject $process -Action $processEventHandler -EventName 'OutputDataReceived' -MessageData $stdOutBuilder -ErrorAction 'Stop'
+
+ ## Start Process
+ Write-Log -Message "Working Directory is [$WorkingDirectory]." -Source ${CmdletName}
+ If ($Parameters) {
+ If ($Parameters -match '-Command \&') {
+ Write-Log -Message "Executing [$Path [PowerShell ScriptBlock]]..." -Source ${CmdletName}
+ }
+ Else {
+ If ($SecureParameters) {
+ Write-Log -Message "Executing [$Path (Parameters Hidden)]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Executing [$Path $Parameters]..." -Source ${CmdletName}
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Executing [$Path]..." -Source ${CmdletName}
+ }
+ [boolean]$processStarted = $process.Start()
+
+ If ($NoWait) {
+ Write-Log -Message 'NoWait parameter specified. Continuing without waiting for exit code...' -Source ${CmdletName}
+ }
+ Else {
+ $process.BeginOutputReadLine()
+ $stdErr = $($process.StandardError.ReadToEnd()).ToString() -replace $null,''
+
+ ## Instructs the Process component to wait indefinitely for the associated process to exit.
+ $process.WaitForExit()
+
+ ## HasExited indicates that the associated process has terminated, either normally or abnormally. Wait until HasExited returns $true.
+ While (-not ($process.HasExited)) { $process.Refresh(); Start-Sleep -Seconds 1 }
+
+ ## Get the exit code for the process
+ Try {
+ [int32]$returnCode = $process.ExitCode
+ }
+ Catch [System.Management.Automation.PSInvalidCastException] {
+ # Catch exit codes that are out of int32 range
+ [int32]$returnCode = 60013
+ }
+
+ ## Unregister standard output event to retrieve process output
+ If ($stdOutEvent) { Unregister-Event -SourceIdentifier $stdOutEvent.Name -ErrorAction 'Stop'; $stdOutEvent = $null }
+ $stdOut = $stdOutBuilder.ToString() -replace $null,''
+
+ If ($stdErr.Length -gt 0) {
+ Write-Log -Message "Standard error output from the process: $stdErr" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ Finally {
+ ## Make sure the standard output event is unregistered
+ If ($stdOutEvent) { Unregister-Event -SourceIdentifier $stdOutEvent.Name -ErrorAction 'Stop'}
+
+ ## Free resources associated with the process, this does not cause process to exit
+ If ($process) { $process.Close() }
+
+ ## Re-enable Zone checking
+ Remove-Item -LiteralPath 'env:SEE_MASK_NOZONECHECKS' -ErrorAction 'SilentlyContinue'
+
+ If ($private:previousErrorActionPreference) { $ErrorActionPreference = $private:previousErrorActionPreference }
+ }
+
+ If (-not $NoWait) {
+ ## Check to see whether we should ignore exit codes
+ $ignoreExitCodeMatch = $false
+ If ($ignoreExitCodes) {
+ # Split the processes on a comma
+ [int32[]]$ignoreExitCodesArray = $ignoreExitCodes -split ','
+ ForEach ($ignoreCode in $ignoreExitCodesArray) {
+ If ($returnCode -eq $ignoreCode) { $ignoreExitCodeMatch = $true }
+ }
+ }
+ # Or always ignore exit codes
+ If ($ContinueOnError) { $ignoreExitCodeMatch = $true }
+
+ ## If the passthru switch is specified, return the exit code and any output from process
+ If ($PassThru) {
+ Write-Log -Message "Execution completed with exit code [$returnCode]." -Source ${CmdletName}
+ [psobject]$ExecutionResults = New-Object -TypeName 'PSObject' -Property @{ ExitCode = $returnCode; StdOut = $stdOut; StdErr = $stdErr }
+ Write-Output -InputObject $ExecutionResults
+ }
+ ElseIf ($ignoreExitCodeMatch) {
+ Write-Log -Message "Execution complete and the exit code [$returncode] is being ignored." -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq 3010) -or ($returnCode -eq 1641)) {
+ Write-Log -Message "Execution completed successfully with exit code [$returnCode]. A reboot is required." -Severity 2 -Source ${CmdletName}
+ Set-Variable -Name 'msiRebootDetected' -Value $true -Scope 'Script'
+ }
+ ElseIf (($returnCode -eq 1605) -and ($Path -match 'msiexec')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the product is not currently installed." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq -2145124329) -and ($Path -match 'wusa')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the Windows Update is not applicable to this system." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq 17025) -and ($Path -match 'fullfile')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the Office Update is not applicable to this system." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf ($returnCode -eq 0) {
+ Write-Log -Message "Execution completed successfully with exit code [$returnCode]." -Source ${CmdletName}
+ }
+ Else {
+ [string]$MsiExitCodeMessage = ''
+ If ($Path -match 'msiexec') {
+ [string]$MsiExitCodeMessage = Get-MsiExitCodeMessage -MsiExitCode $returnCode
+ }
+
+ If ($MsiExitCodeMessage) {
+ Write-Log -Message "Execution failed with exit code [$returnCode]: $MsiExitCodeMessage" -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Execution failed with exit code [$returnCode]." -Severity 3 -Source ${CmdletName}
+ }
+ Exit-Script -ExitCode $returnCode
+ }
+ }
+ }
+ Catch {
+ If ([string]::IsNullOrEmpty([string]$returnCode)) {
+ [int32]$returnCode = 60002
+ Write-Log -Message "Function failed, setting exit code to [$returnCode]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Execution completed with exit code [$returnCode]. Function failed. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ If ($PassThru) {
+ [psobject]$ExecutionResults = New-Object -TypeName 'PSObject' -Property @{ ExitCode = $returnCode; StdOut = If ($stdOut) { $stdOut } Else { '' }; StdErr = If ($stdErr) { $stdErr } Else { '' } }
+ Write-Output -InputObject $ExecutionResults
+ }
+ Else {
+ Exit-Script -ExitCode $returnCode
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-MsiExitCodeMessage
+Function Get-MsiExitCodeMessage {
+<#
+.SYNOPSIS
+ Get message for MSI error code
+.DESCRIPTION
+ Get message for MSI error code by reading it from msimsg.dll
+.PARAMETER MsiErrorCode
+ MSI error code
+.EXAMPLE
+ Get-MsiExitCodeMessage -MsiErrorCode 1618
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://msdn.microsoft.com/en-us/library/aa368542(v=vs.85).aspx
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [int32]$MsiExitCode
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get message for exit code [$MsiExitCode]." -Source ${CmdletName}
+ [string]$MsiExitCodeMsg = [PSADT.Msi]::GetMessageFromMsiExitCode($MsiExitCode)
+ Write-Output -InputObject $MsiExitCodeMsg
+ }
+ Catch {
+ Write-Log -Message "Failed to get message for exit code [$MsiExitCode]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-IsMutexAvailable
+Function Test-IsMutexAvailable {
+<#
+.SYNOPSIS
+ Wait, up to a timeout value, to check if current thread is able to acquire an exclusive lock on a system mutex.
+.DESCRIPTION
+ A mutex can be used to serialize applications and prevent multiple instances from being opened at the same time.
+ Wait, up to a timeout (default is 1 millisecond), for the mutex to become available for an exclusive lock.
+.PARAMETER MutexName
+ The name of the system mutex.
+.PARAMETER MutexWaitTime
+ The number of milliseconds the current thread should wait to acquire an exclusive lock of a named mutex. Default is: 1 millisecond.
+ A wait time of -1 milliseconds means to wait indefinitely. A wait time of zero does not acquire an exclusive lock but instead tests the state of the wait handle and returns immediately.
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds 500
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds (New-TimeSpan -Minutes 5).TotalMilliseconds
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds (New-TimeSpan -Seconds 60).TotalMilliseconds
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://msdn.microsoft.com/en-us/library/aa372909(VS.85).asp
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateLength(1,260)]
+ [string]$MutexName,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({($_ -ge -1) -and ($_ -le [int32]::MaxValue)})]
+ [int32]$MutexWaitTimeInMilliseconds = 1
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Initialize Variables
+ [timespan]$MutexWaitTime = [timespan]::FromMilliseconds($MutexWaitTimeInMilliseconds)
+ If ($MutexWaitTime.TotalMinutes -ge 1) {
+ [string]$WaitLogMsg = "$($MutexWaitTime.TotalMinutes) minute(s)"
+ }
+ ElseIf ($MutexWaitTime.TotalSeconds -ge 1) {
+ [string]$WaitLogMsg = "$($MutexWaitTime.TotalSeconds) second(s)"
+ }
+ Else {
+ [string]$WaitLogMsg = "$($MutexWaitTime.Milliseconds) millisecond(s)"
+ }
+ [boolean]$IsUnhandledException = $false
+ [boolean]$IsMutexFree = $false
+ [Threading.Mutex]$OpenExistingMutex = $null
+ }
+ Process {
+ Write-Log -Message "Check to see if mutex [$MutexName] is available. Wait up to [$WaitLogMsg] for the mutex to become available." -Source ${CmdletName}
+ Try {
+ ## Using this variable allows capture of exceptions from .NET methods. Private scope only changes value for current function.
+ $private:previousErrorActionPreference = $ErrorActionPreference
+ $ErrorActionPreference = 'Stop'
+
+ ## Open the specified named mutex, if it already exists, without acquiring an exclusive lock on it. If the system mutex does not exist, this method throws an exception instead of creating the system object.
+ [Threading.Mutex]$OpenExistingMutex = [Threading.Mutex]::OpenExisting($MutexName)
+ ## Attempt to acquire an exclusive lock on the mutex. Use a Timespan to specify a timeout value after which no further attempt is made to acquire a lock on the mutex.
+ $IsMutexFree = $OpenExistingMutex.WaitOne($MutexWaitTime, $false)
+ }
+ Catch [Threading.WaitHandleCannotBeOpenedException] {
+ ## The named mutex does not exist
+ $IsMutexFree = $true
+ }
+ Catch [ObjectDisposedException] {
+ ## Mutex was disposed between opening it and attempting to wait on it
+ $IsMutexFree = $true
+ }
+ Catch [UnauthorizedAccessException] {
+ ## The named mutex exists, but the user does not have the security access required to use it
+ $IsMutexFree = $false
+ }
+ Catch [Threading.AbandonedMutexException] {
+ ## The wait completed because a thread exited without releasing a mutex. This exception is thrown when one thread acquires a mutex object that another thread has abandoned by exiting without releasing it.
+ $IsMutexFree = $true
+ }
+ Catch {
+ $IsUnhandledException = $true
+ ## Return $true, to signify that mutex is available, because function was unable to successfully complete a check due to an unhandled exception. Default is to err on the side of the mutex being available on a hard failure.
+ Write-Log -Message "Unable to check if mutex [$MutexName] is available due to an unhandled exception. Will default to return value of [$true]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ $IsMutexFree = $true
+ }
+ Finally {
+ If ($IsMutexFree) {
+ If (-not $IsUnhandledException) {
+ Write-Log -Message "Mutex [$MutexName] is available for an exclusive lock." -Source ${CmdletName}
+ }
+ }
+ Else {
+ If ($MutexName -eq 'Global\_MSIExecute') {
+ ## Get the command line for the MSI installation in progress
+ Try {
+ [string]$msiInProgressCmdLine = Get-WmiObject -Class 'Win32_Process' -Filter "name = 'msiexec.exe'" -ErrorAction 'Stop' | Where-Object { $_.CommandLine } | Select-Object -ExpandProperty 'CommandLine' | Where-Object { $_ -match '\.msi' } | ForEach-Object { $_.Trim() }
+ }
+ Catch { }
+ Write-Log -Message "Mutex [$MutexName] is not available for an exclusive lock because the following MSI installation is in progress [$msiInProgressCmdLine]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Mutex [$MutexName] is not available because another thread already has an exclusive lock on it." -Source ${CmdletName}
+ }
+ }
+
+ If (($null -ne $OpenExistingMutex) -and ($IsMutexFree)) {
+ ## Release exclusive lock on the mutex
+ $null = $OpenExistingMutex.ReleaseMutex()
+ $OpenExistingMutex.Close()
+ }
+ If ($private:previousErrorActionPreference) { $ErrorActionPreference = $private:previousErrorActionPreference }
+ }
+ }
+ End {
+ Write-Output -InputObject $IsMutexFree
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-Folder
+Function New-Folder {
+<#
+.SYNOPSIS
+ Create a new folder.
+.DESCRIPTION
+ Create a new folder if it does not exist.
+.PARAMETER Path
+ Path to the new folder to create.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ New-Folder -Path "$envWinDir\System32"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If (-not (Test-Path -LiteralPath $Path -PathType 'Container')) {
+ Write-Log -Message "Create folder [$Path]." -Source ${CmdletName}
+ $null = New-Item -Path $Path -ItemType 'Directory' -ErrorAction 'Stop'
+ }
+ Else {
+ Write-Log -Message "Folder [$Path] already exists." -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create folder [$Path]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create folder [$Path]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-Folder
+Function Remove-Folder {
+<#
+.SYNOPSIS
+ Remove folder and files if they exist.
+.DESCRIPTION
+ Remove folder and all files recursively in a given path.
+.PARAMETER Path
+ Path to the folder to remove.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-Folder -Path "$envWinDir\Downloaded Program Files"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If (Test-Path -LiteralPath $Path -PathType 'Container') {
+ Try {
+ Remove-Item -LiteralPath $Path -Force -Recurse -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorRemoveFolder'
+ If ($ErrorRemoveFolder) {
+ Write-Log -Message "The following error(s) took place while deleting folder(s) and file(s) recursively from path [$path]. `n$(Resolve-Error -ErrorRecord $ErrorRemoveFolder)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to delete folder(s) and file(s) recursively from path [$path]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete folder(s) and file(s) recursively from path [$path]: $($_.Exception.Message)"
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Folder [$Path] does not exists..." -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Copy-File
+Function Copy-File {
+<#
+.SYNOPSIS
+ Copy a file or group of files to a destination path.
+.DESCRIPTION
+ Copy a file or group of files to a destination path.
+.PARAMETER Path
+ Path of the file to copy.
+.PARAMETER Destination
+ Destination Path of the file to copy.
+.PARAMETER Recurse
+ Copy files in subdirectories.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. This will continue the deployment script, but will not continue copying files if an error is encountered. Default is: $true.
+.PARAMETER ContinueFileCopyOnError
+ Continue copying files if an error is encountered. This will continue the deployment script and will warn about files that failed to be copied. Default is: $false.
+.EXAMPLE
+ Copy-File -Path "$dirSupportFiles\MyApp.ini" -Destination "$envWindir\MyApp.ini"
+.EXAMPLE
+ Copy-File -Path "$dirSupportFiles\*.*" -Destination "$envTemp\tempfiles"
+ Copy all of the files in a folder to a destination folder.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Path,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Destination,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueFileCopyOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $null = $fileCopyError
+ If ((-not ([IO.Path]::HasExtension($Destination))) -and (-not (Test-Path -LiteralPath $Destination -PathType 'Container'))) {
+ Write-Log -Message "Destination folder does not exist, creating destination folder [$destination]." -Source ${CmdletName}
+ $null = New-Item -Path $Destination -Type 'Directory' -Force -ErrorAction 'Stop'
+ }
+
+ $null = $FileCopyError
+ If ($Recurse) {
+ Write-Log -Message "Copy file(s) recursively in path [$path] to destination [$destination]." -Source ${CmdletName}
+ If (-not $ContinueFileCopyOnError) {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -Recurse -ErrorAction 'Stop'
+ }
+ Else {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -Recurse -ErrorAction 'SilentlyContinue' -ErrorVariable FileCopyError
+ }
+ }
+ Else {
+ Write-Log -Message "Copy file in path [$path] to destination [$destination]." -Source ${CmdletName}
+ If (-not $ContinueFileCopyOnError) {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -ErrorAction 'Stop'
+ }
+ Else {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -ErrorAction 'SilentlyContinue' -ErrorVariable FileCopyError
+ }
+ }
+
+ If ($fileCopyError) {
+ Write-Log -Message "The following warnings were detected while copying file(s) in path [$path] to destination [$destination]. `n$FileCopyError" -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "File copy completed successfully." -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to copy file(s) in path [$path] to destination [$destination]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to copy file(s) in path [$path] to destination [$destination]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-File
+Function Remove-File {
+<#
+.SYNOPSIS
+ Removes one or more items from a given path on the filesystem.
+.DESCRIPTION
+ Removes one or more items from a given path on the filesystem.
+.PARAMETER Path
+ Specifies the path on the filesystem to be resolved. The value of Path will accept wildcards. Will accept an array of values.
+.PARAMETER LiteralPath
+ Specifies the path on the filesystem to be resolved. The value of LiteralPath is used exactly as it is typed; no characters are interpreted as wildcards. Will accept an array of values.
+.PARAMETER Recurse
+ Deletes the files in the specified location(s) and in all child items of the location(s).
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-File -Path 'C:\Windows\Downloaded Program Files\Temp.inf'
+.EXAMPLE
+ Remove-File -LiteralPath 'C:\Windows\Downloaded Program Files' -Recurse
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='Path')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Path,
+ [Parameter(Mandatory=$true,ParameterSetName='LiteralPath')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$LiteralPath,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Build hashtable of parameters/value pairs to be passed to Remove-Item cmdlet
+ [hashtable]$RemoveFileSplat = @{ 'Recurse' = $Recurse
+ 'Force' = $true
+ 'ErrorVariable' = '+ErrorRemoveItem'
+ }
+ If ($ContinueOnError) {
+ $RemoveFileSplat.Add('ErrorAction', 'SilentlyContinue')
+ }
+ Else {
+ $RemoveFileSplat.Add('ErrorAction', 'Stop')
+ }
+
+ ## Resolve the specified path, if the path does not exist, display a warning instead of an error
+ If ($PSCmdlet.ParameterSetName -eq 'Path') { [string[]]$SpecifiedPath = $Path } Else { [string[]]$SpecifiedPath = $LiteralPath }
+ ForEach ($Item in $SpecifiedPath) {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'Path') {
+ [string[]]$ResolvedPath += Resolve-Path -Path $Item -ErrorAction 'Stop' | Where-Object { $_.Path } | Select-Object -ExpandProperty 'Path' -ErrorAction 'Stop'
+ }
+ Else {
+ [string[]]$ResolvedPath += Resolve-Path -LiteralPath $Item -ErrorAction 'Stop' | Where-Object { $_.Path } | Select-Object -ExpandProperty 'Path' -ErrorAction 'Stop'
+ }
+ }
+ Catch [System.Management.Automation.ItemNotFoundException] {
+ Write-Log -Message "Unable to resolve file(s) for deletion in path [$Item] because path does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to resolve file(s) for deletion in path [$Item]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to resolve file(s) for deletion in path [$Item]: $($_.Exception.Message)"
+ }
+ }
+ }
+
+ ## Delete specified path if it was successfully resolved
+ If ($ResolvedPath) {
+ ForEach ($Item in $ResolvedPath) {
+ Try {
+ If (($Recurse) -and (Test-Path -LiteralPath $Item -PathType 'Container')) {
+ Write-Log -Message "Delete file(s) recursively in path [$Item]..." -Source ${CmdletName}
+ }
+ ElseIf ((-not $Recurse) -and (Test-Path -LiteralPath $Item -PathType 'Container')) {
+ Write-Log -Message "Skipping folder [$Item] because the Recurse switch was not specified"
+ Continue
+ }
+ Else {
+ Write-Log -Message "Delete file in path [$Item]..." -Source ${CmdletName}
+ }
+ $null = Remove-Item @RemoveFileSplat -LiteralPath $Item
+ }
+ Catch {
+ Write-Log -Message "Failed to delete file(s) in path [$Item]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete file(s) in path [$Item]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+
+ If ($ErrorRemoveItem) {
+ Write-Log -Message "The following error(s) took place while removing file(s) in path [$SpecifiedPath]. `n$(Resolve-Error -ErrorRecord $ErrorRemoveItem)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Convert-RegistryPath
+Function Convert-RegistryPath {
+<#
+.SYNOPSIS
+ Converts the specified registry key path to a format that is compatible with built-in PowerShell cmdlets.
+.DESCRIPTION
+ Converts the specified registry key path to a format that is compatible with built-in PowerShell cmdlets.
+ Converts registry key hives to their full paths. Example: HKLM is converted to "Registry::HKEY_LOCAL_MACHINE".
+.PARAMETER Key
+ Path to the registry key to convert (can be a registry hive or fully qualified path)
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.EXAMPLE
+ Convert-RegistryPath -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.EXAMPLE
+ Convert-RegistryPath -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Convert the registry key hive to the full path, only match if at the beginning of the line
+ If ($Key -match '^HKLM:\\|^HKCU:\\|^HKCR:\\|^HKU:\\|^HKCC:\\|^HKPD:\\') {
+ # Converts registry paths that start with, e.g.: HKLM:\
+ $key = $key -replace '^HKLM:\\', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR:\\', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU:\\', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU:\\', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC:\\', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD:\\', 'HKEY_PERFORMANCE_DATA\'
+ }
+ ElseIf ($Key -match '^HKLM:|^HKCU:|^HKCR:|^HKU:|^HKCC:|^HKPD:') {
+ # Converts registry paths that start with, e.g.: HKLM:
+ $key = $key -replace '^HKLM:', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR:', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU:', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU:', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC:', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD:', 'HKEY_PERFORMANCE_DATA\'
+ }
+ ElseIf ($Key -match '^HKLM\\|^HKCU\\|^HKCR\\|^HKU\\|^HKCC\\|^HKPD\\') {
+ # Converts registry paths that start with, e.g.: HKLM\
+ $key = $key -replace '^HKLM\\', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR\\', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU\\', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU\\', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC\\', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD\\', 'HKEY_PERFORMANCE_DATA\'
+ }
+
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($key -match '^HKEY_CURRENT_USER\\') { $key = $key -replace '^HKEY_CURRENT_USER\\', "HKEY_USERS\$SID\" }
+ }
+
+ ## Append the PowerShell drive to the registry key path
+ If ($key -notmatch '^Registry::') {[string]$key = "Registry::$key" }
+
+ If($Key -match '^Registry::HKEY_LOCAL_MACHINE|^Registry::HKEY_CLASSES_ROOT|^Registry::HKEY_CURRENT_USER|^Registry::HKEY_USERS|^Registry::HKEY_CURRENT_CONFIG|^Registry::HKEY_PERFORMANCE_DATA') {
+ ## Check for expected key string format
+ Write-Log -Message "Return fully qualified registry key path [$key]." -Source ${CmdletName}
+ Write-Output -InputObject $key
+ }
+ Else{
+ # If key string is not properly formatted, throw an error
+ Throw "Unable to detect target registry hive in string [$key]."
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-RegistryValue
+Function Test-RegistryValue {
+<#
+.SYNOPSIS
+ Test if a registry value exists.
+.DESCRIPTION
+ Checks a registry key path to see if it has a value with a given name. Can correctly handle cases where a value simply has an empty or null value.
+.PARAMETER Key
+ Path of the registry key.
+.PARAMETER Value
+ Specify the registry key value to check the existence of.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.EXAMPLE
+ Test-RegistryValue -Key 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -Value 'PendingFileRenameOperations'
+.NOTES
+ To test if registry key exists, use Test-Path function like so:
+ Test-Path -Path $Key -PathType 'Container'
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ Param (
+ [Parameter(Mandatory=$true,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]$Key,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullOrEmpty()]$Value,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ Try {
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$Key = Convert-RegistryPath -Key $Key -SID $SID
+ }
+ Else {
+ [string]$Key = Convert-RegistryPath -Key $Key
+ }
+ }
+ Catch {
+ Throw
+ }
+ [boolean]$IsRegistryValueExists = $false
+ Try {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ [string[]]$PathProperties = Get-Item -LiteralPath $Key -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Property' -ErrorAction 'Stop'
+ If ($PathProperties -contains $Value) { $IsRegistryValueExists = $true }
+ }
+ }
+ Catch { }
+
+ If ($IsRegistryValueExists) {
+ Write-Log -Message "Registry key value [$Key] [$Value] does exist." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Registry key value [$Key] [$Value] does not exist." -Source ${CmdletName}
+ }
+ Write-Output -InputObject $IsRegistryValueExists
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-RegistryKey
+Function Get-RegistryKey {
+<#
+.SYNOPSIS
+ Retrieves value names and value data for a specified registry key or optionally, a specific value.
+.DESCRIPTION
+ Retrieves value names and value data for a specified registry key or optionally, a specific value.
+ If the registry key does not exist or contain any values, the function will return $null by default. To test for existence of a registry key path, use built-in Test-Path cmdlet.
+.PARAMETER Key
+ Path of the registry key.
+.PARAMETER Value
+ Value to retrieve (optional).
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ReturnEmptyKeyIfExists
+ Return the registry key if it exists but it has no property/value pairs underneath it. Default is: $false.
+.PARAMETER DoNotExpandEnvironmentNames
+ Return unexpanded REG_EXPAND_SZ values. Default is: $false.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\iexplore.exe'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKLM:Software\Wow6432Node\Microsoft\Microsoft SQL Server Compact Edition\v3.5' -Value 'Version'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment' -Value 'Path' -DoNotExpandEnvironmentNames
+ Returns %ProgramFiles%\Java instead of C:\Program Files\Java
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Example' -Value '(Default)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$ReturnEmptyKeyIfExists = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$DoNotExpandEnvironmentNames = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$key = Convert-RegistryPath -Key $key -SID $SID
+ }
+ Else {
+ [string]$key = Convert-RegistryPath -Key $key
+ }
+
+ ## Check if the registry key exists
+ If (-not (Test-Path -LiteralPath $key -ErrorAction 'Stop')) {
+ Write-Log -Message "Registry key [$key] does not exist. Return `$null." -Severity 2 -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ Else {
+ If ($PSBoundParameters.ContainsKey('Value')) {
+ Write-Log -Message "Get registry key [$key] value [$value]." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Get registry key [$key] and all property values." -Source ${CmdletName}
+ }
+
+ ## Get all property values for registry key
+ $regKeyValue = Get-ItemProperty -LiteralPath $key -ErrorAction 'Stop'
+ [int32]$regKeyValuePropertyCount = $regKeyValue | Measure-Object | Select-Object -ExpandProperty 'Count'
+
+ ## Select requested property
+ If ($PSBoundParameters.ContainsKey('Value')) {
+ # Check if registry value exists
+ [boolean]$IsRegistryValueExists = $false
+ If ($regKeyValuePropertyCount -gt 0) {
+ Try {
+ [string[]]$PathProperties = Get-Item -LiteralPath $Key -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Property' -ErrorAction 'Stop'
+ If ($PathProperties -contains $Value) { $IsRegistryValueExists = $true }
+ }
+ Catch { }
+ }
+
+ # Get the Value (do not make a strongly typed variable because it depends entirely on what kind of value is being read)
+ If ($IsRegistryValueExists) {
+ If ($DoNotExpandEnvironmentNames) { #Only useful on 'ExpandString' values
+ If ($Value -like '(Default)') {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($null,$null,[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ }
+ Else {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($Value,$null,[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ }
+ }
+ ElseIf ($Value -like '(Default)') {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($null)
+ }
+ Else {
+ $regKeyValue = $regKeyValue | Select-Object -ExpandProperty $Value -ErrorAction 'SilentlyContinue'
+ }
+ }
+ Else {
+ Write-Log -Message "Registry key value [$Key] [$Value] does not exist. Return `$null." -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ }
+ ## Select all properties or return empty key object
+ Else {
+ If ($regKeyValuePropertyCount -eq 0) {
+ If ($ReturnEmptyKeyIfExists) {
+ Write-Log -Message "No property values found for registry key. Return empty registry key object [$key]." -Source ${CmdletName}
+ $regKeyValue = Get-Item -LiteralPath $key -Force -ErrorAction 'Stop'
+ }
+ Else {
+ Write-Log -Message "No property values found for registry key. Return `$null." -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ }
+ }
+ }
+ Write-Output -InputObject ($regKeyValue)
+ }
+ Catch {
+ If (-not $Value) {
+ Write-Log -Message "Failed to read registry key [$key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read registry key [$key]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to read registry key [$key] value [$value]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read registry key [$key] value [$value]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-RegistryKey
+Function Set-RegistryKey {
+<#
+.SYNOPSIS
+ Creates a registry key name, value, and value data; it sets the same if it already exists.
+.DESCRIPTION
+ Creates a registry key name, value, and value data; it sets the same if it already exists.
+.PARAMETER Key
+ The registry key path.
+.PARAMETER Name
+ The value name.
+.PARAMETER Value
+ The value data.
+.PARAMETER Type
+ The type of registry value to create or set. Options: 'Binary','DWord','ExpandString','MultiString','None','QWord','String','Unknown'. Default: String.
+ Dword should be specified as a decimal.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-RegistryKey -Key $blockedAppPath -Name 'Debugger' -Value $blockedAppDebuggerValue
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE' -Name 'Application' -Type 'Dword' -Value '1'
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce' -Name 'Debugger' -Value $blockedAppDebuggerValue -Type String
+.EXAMPLE
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Example' -Name 'Data' -Value (0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x02,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x02,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x00,0x01,0x01,0x01,0x02,0x02,0x02) -Type 'Binary'
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Example' -Value '(Default)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ $Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Binary','DWord','ExpandString','MultiString','None','QWord','String','Unknown')]
+ [Microsoft.Win32.RegistryValueKind]$Type = 'String',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ [string]$RegistryValueWriteAction = 'set'
+
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$key = Convert-RegistryPath -Key $key -SID $SID
+ }
+ Else {
+ [string]$key = Convert-RegistryPath -Key $key
+ }
+
+ ## Create registry key if it doesn't exist
+ If (-not (Test-Path -LiteralPath $key -ErrorAction 'Stop')) {
+ Try {
+ Write-Log -Message "Create registry key [$key]." -Source ${CmdletName}
+ # No forward slash found in Key. Use New-Item cmdlet to create registry key
+ If ((($Key -split '/').Count - 1) -eq 0)
+ {
+ $null = New-Item -Path $key -ItemType 'Registry' -Force -ErrorAction 'Stop'
+ }
+ # Forward slash was found in Key. Use REG.exe ADD to create registry key
+ Else
+ {
+ [string]$CreateRegkeyResult = & reg.exe Add "$($Key.Substring($Key.IndexOf('::') + 2))"
+ If ($global:LastExitCode -ne 0)
+ {
+ Throw "Failed to create registry key [$Key]"
+ }
+ }
+ }
+ Catch {
+ Throw
+ }
+ }
+
+ If ($Name) {
+ ## Set registry value if it doesn't exist
+ If (-not (Get-ItemProperty -LiteralPath $key -Name $Name -ErrorAction 'SilentlyContinue')) {
+ Write-Log -Message "Set registry key value: [$key] [$name = $value]." -Source ${CmdletName}
+ $null = New-ItemProperty -LiteralPath $key -Name $name -Value $value -PropertyType $Type -ErrorAction 'Stop'
+ }
+ ## Update registry value if it does exist
+ Else {
+ [string]$RegistryValueWriteAction = 'update'
+ If ($Name -eq '(Default)') {
+ ## Set Default registry key value with the following workaround, because Set-ItemProperty contains a bug and cannot set Default registry key value
+ $null = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').OpenSubKey('','ReadWriteSubTree').SetValue($null,$value)
+ }
+ Else {
+ Write-Log -Message "Update registry key value: [$key] [$name = $value]." -Source ${CmdletName}
+ $null = Set-ItemProperty -LiteralPath $key -Name $name -Value $value -ErrorAction 'Stop'
+ }
+ }
+ }
+ }
+ Catch {
+ If ($Name) {
+ Write-Log -Message "Failed to $RegistryValueWriteAction value [$value] for registry key [$key] [$name]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $RegistryValueWriteAction value [$value] for registry key [$key] [$name]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to set registry key [$key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set registry key [$key]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-RegistryKey
+Function Remove-RegistryKey {
+<#
+.SYNOPSIS
+ Deletes the specified registry key or value.
+.DESCRIPTION
+ Deletes the specified registry key or value.
+.PARAMETER Key
+ Path of the registry key to delete.
+.PARAMETER Name
+ Name of the registry value to delete.
+.PARAMETER Recurse
+ Delete registry key recursively.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-RegistryKey -Key 'HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\RunOnce'
+.EXAMPLE
+ Remove-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Run' -Name 'RunAppInstall'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$Key = Convert-RegistryPath -Key $Key -SID $SID
+ }
+ Else {
+ [string]$Key = Convert-RegistryPath -Key $Key
+ }
+
+ If (-not ($Name)) {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ If ($Recurse) {
+ Write-Log -Message "Delete registry key recursively [$Key]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Key -Force -Recurse -ErrorAction 'Stop'
+ }
+ Else {
+ If ($null -eq (Get-ChildItem -LiteralPath $Key -ErrorAction 'Stop')){
+ ## Check if there are subkeys of $Key, if so, executing Remove-Item will hang. Avoiding this with Get-ChildItem.
+ Write-Log -Message "Delete registry key [$Key]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Key -Force -ErrorAction 'Stop'
+ }
+ Else {
+ Throw "Unable to delete child key(s) of [$Key] without [-Recurse] switch."
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Unable to delete registry key [$Key] because it does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Else {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ Write-Log -Message "Delete registry value [$Key] [$Name]." -Source ${CmdletName}
+
+ If ($Name -eq '(Default)') {
+ ## Remove (Default) registry key value with the following workaround because Remove-ItemProperty cannot remove the (Default) registry key value
+ $null = (Get-Item -LiteralPath $Key -ErrorAction 'Stop').OpenSubKey('','ReadWriteSubTree').DeleteValue('')
+ }
+ Else {
+ $null = Remove-ItemProperty -LiteralPath $Key -Name $Name -Force -ErrorAction 'Stop'
+ }
+ }
+ Else {
+ Write-Log -Message "Unable to delete registry value [$Key] [$Name] because registry key does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ Catch [System.Management.Automation.PSArgumentException] {
+ Write-Log -Message "Unable to delete registry value [$Key] [$Name] because it does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ Catch {
+ If (-not ($Name)) {
+ Write-Log -Message "Failed to delete registry key [$Key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete registry key [$Key]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to delete registry value [$Key] [$Name]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete registry value [$Key] [$Name]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-HKCURegistrySettingsForAllUsers
+Function Invoke-HKCURegistrySettingsForAllUsers {
+<#
+.SYNOPSIS
+ Set current user registry settings for all current users and any new users in the future.
+.DESCRIPTION
+ Set HKCU registry settings for all current and future users by loading their NTUSER.dat registry hive file, and making the modifications.
+ This function will modify HKCU settings for all users even when executed under the SYSTEM account.
+ To ensure new users in the future get the registry edits, the Default User registry hive used to provision the registry for new users is modified.
+ This function can be used as an alternative to using ActiveSetup for registry settings.
+ The advantage of using this function over ActiveSetup is that a user does not have to log off and log back on before the changes take effect.
+.PARAMETER RegistrySettings
+ Script block which contains HKCU registry settings which should be modified for all users on the system. Must specify the -SID parameter for all HKCU settings.
+.PARAMETER UserProfiles
+ Specify the user profiles to modify HKCU registry settings for. Default is all user profiles except for system profiles.
+.EXAMPLE
+ [scriptblock]$HKCURegistrySettings = {
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'qmenable' -Value 0 -Type DWord -SID $UserProfile.SID
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'updatereliabilitydata' -Value 1 -Type DWord -SID $UserProfile.SID
+ }
+ Invoke-HKCURegistrySettingsForAllUsers -RegistrySettings $HKCURegistrySettings
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [scriptblock]$RegistrySettings,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [psobject[]]$UserProfiles = (Get-UserProfiles)
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ForEach ($UserProfile in $UserProfiles) {
+ Try {
+ # Set the path to the user's registry hive when it is loaded
+ [string]$UserRegistryPath = "Registry::HKEY_USERS\$($UserProfile.SID)"
+
+ # Set the path to the user's registry hive file
+ [string]$UserRegistryHiveFile = Join-Path -Path $UserProfile.ProfilePath -ChildPath 'NTUSER.DAT'
+
+ # Load the User profile registry hive if it is not already loaded because the User is logged in
+ [boolean]$ManuallyLoadedRegHive = $false
+ If (-not (Test-Path -LiteralPath $UserRegistryPath)) {
+ # Load the User registry hive if the registry hive file exists
+ If (Test-Path -LiteralPath $UserRegistryHiveFile -PathType 'Leaf') {
+ Write-Log -Message "Load the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe load "`"HKEY_USERS\$($UserProfile.SID)`"" "`"$UserRegistryHiveFile`""
+
+ If ($global:LastExitCode -ne 0) {
+ Throw "Failed to load the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. Failure message [$HiveLoadResult]. Continue..."
+ }
+
+ [boolean]$ManuallyLoadedRegHive = $true
+ }
+ Else {
+ Throw "Failed to find the registry hive file [$UserRegistryHiveFile] for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. Continue..."
+ }
+ }
+ Else {
+ Write-Log -Message "The User [$($UserProfile.NTAccount)] registry hive is already loaded in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ }
+
+ ## Execute ScriptBlock which contains code to manipulate HKCU registry.
+ # Make sure read/write calls to the HKCU registry hive specify the -SID parameter or settings will not be changed for all users.
+ # Example: Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'qmenable' -Value 0 -Type DWord -SID $UserProfile.SID
+ Write-Log -Message 'Execute ScriptBlock to modify HKCU registry settings for all users.' -Source ${CmdletName}
+ & $RegistrySettings
+ }
+ Catch {
+ Write-Log -Message "Failed to modify the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)] `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Finally {
+ If ($ManuallyLoadedRegHive) {
+ Try {
+ Write-Log -Message "Unload the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe unload "`"HKEY_USERS\$($UserProfile.SID)`""
+
+ If ($global:LastExitCode -ne 0) {
+ Write-Log -Message "REG.exe failed to unload the registry hive and exited with exit code [$($global:LastExitCode)]. Performing manual garbage collection to ensure successful unloading of registry hive." -Severity 2 -Source ${CmdletName}
+ [GC]::Collect()
+ [GC]::WaitForPendingFinalizers()
+ Start-Sleep -Seconds 5
+
+ Write-Log -Message "Unload the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe unload "`"HKEY_USERS\$($UserProfile.SID)`""
+ If ($global:LastExitCode -ne 0) { Throw "REG.exe failed with exit code [$($global:LastExitCode)] and result [$HiveLoadResult]." }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to unload the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function ConvertTo-NTAccountOrSID
+Function ConvertTo-NTAccountOrSID {
+<#
+.SYNOPSIS
+ Convert between NT Account names and their security identifiers (SIDs).
+.DESCRIPTION
+ Specify either the NT Account name or the SID and get the other. Can also convert well known sid types.
+.PARAMETER AccountName
+ The Windows NT Account name specified in \ format.
+ Use fully qualified account names (e.g., \) instead of isolated names (e.g, ) because they are unambiguous and provide better performance.
+.PARAMETER SID
+ The Windows NT Account SID.
+.PARAMETER WellKnownSIDName
+ Specify the Well Known SID name translate to the actual SID (e.g., LocalServiceSid).
+ To get all well known SIDs available on system: [enum]::GetNames([Security.Principal.WellKnownSidType])
+.PARAMETER WellKnownToNTAccount
+ Convert the Well Known SID to an NTAccount name
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -AccountName 'CONTOSO\User1'
+ Converts a Windows NT Account name to the corresponding SID
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -SID 'S-1-5-21-1220945662-2111687655-725345543-14012660'
+ Converts a Windows NT Account SID to the corresponding NT Account Name
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -WellKnownSIDName 'NetworkServiceSid'
+ Converts a Well Known SID name to a SID
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ The conversion can return an empty result if the user account does not exist anymore or if translation fails.
+ http://blogs.technet.com/b/askds/archive/2011/07/28/troubleshooting-sid-translation-failures-from-the-obvious-to-the-not-so-obvious.aspx
+.LINK
+ http://psappdeploytoolkit.com
+ List of Well Known SIDs: http://msdn.microsoft.com/en-us/library/system.security.principal.wellknownsidtype(v=vs.110).aspx
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='NTAccountToSID',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$AccountName,
+ [Parameter(Mandatory=$true,ParameterSetName='SIDToNTAccount',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$true,ParameterSetName='WellKnownName',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$WellKnownSIDName,
+ [Parameter(Mandatory=$false,ParameterSetName='WellKnownName')]
+ [ValidateNotNullOrEmpty()]
+ [switch]$WellKnownToNTAccount
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Switch ($PSCmdlet.ParameterSetName) {
+ 'SIDToNTAccount' {
+ [string]$msg = "the SID [$SID] to an NT Account name"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ $NTAccountSID = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList $SID
+ $NTAccount = $NTAccountSID.Translate([Security.Principal.NTAccount])
+ Write-Output -InputObject $NTAccount
+ }
+ 'NTAccountToSID' {
+ [string]$msg = "the NT Account [$AccountName] to a SID"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ $NTAccount = New-Object -TypeName 'System.Security.Principal.NTAccount' -ArgumentList $AccountName
+ $NTAccountSID = $NTAccount.Translate([Security.Principal.SecurityIdentifier])
+ Write-Output -InputObject $NTAccountSID
+ }
+ 'WellKnownName' {
+ If ($WellKnownToNTAccount) {
+ [string]$ConversionType = 'NTAccount'
+ }
+ Else {
+ [string]$ConversionType = 'SID'
+ }
+ [string]$msg = "the Well Known SID Name [$WellKnownSIDName] to a $ConversionType"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ # Get the SID for the root domain
+ Try {
+ $MachineRootDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'Stop').Domain.ToLower()
+ $ADDomainObj = New-Object -TypeName 'System.DirectoryServices.DirectoryEntry' -ArgumentList "LDAP://$MachineRootDomain"
+ $DomainSidInBinary = $ADDomainObj.ObjectSid
+ $DomainSid = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ($DomainSidInBinary[0], 0)
+ }
+ Catch {
+ Write-Log -Message 'Unable to get Domain SID from Active Directory. Setting Domain SID to $null.' -Severity 2 -Source ${CmdletName}
+ $DomainSid = $null
+ }
+
+ # Get the SID for the well known SID name
+ $WellKnownSidType = [Security.Principal.WellKnownSidType]::$WellKnownSIDName
+ $NTAccountSID = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ($WellKnownSidType, $DomainSid)
+
+ If ($WellKnownToNTAccount) {
+ $NTAccount = $NTAccountSID.Translate([Security.Principal.NTAccount])
+ Write-Output -InputObject $NTAccount
+ }
+ Else {
+ Write-Output -InputObject $NTAccountSID
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to convert $msg. It may not be a valid account anymore or there is some other problem. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-UserProfiles
+Function Get-UserProfiles {
+<#
+.SYNOPSIS
+ Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine and also the Default User (which does not log on).
+.DESCRIPTION
+ Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine and also the Default User (which does not log on).
+ Please note that the NTAccount property may be empty for some user profiles but the SID and ProfilePath properties will always be populated.
+.PARAMETER ExcludeNTAccount
+ Specify NT account names in Domain\Username format to exclude from the list of user profiles.
+.PARAMETER ExcludeSystemProfiles
+ Exclude system profiles: SYSTEM, LOCAL SERVICE, NETWORK SERVICE. Default is: $true.
+.PARAMETER ExcludeDefaultUser
+ Exclude the Default User. Default is: $false.
+.EXAMPLE
+ Get-UserProfiles
+ Returns the following properties for each user profile on the system: NTAccount, SID, ProfilePath
+.EXAMPLE
+ Get-UserProfiles -ExcludeNTAccount 'CONTOSO\Robot','CONTOSO\ntadmin'
+.EXAMPLE
+ [string[]]$ProfilePaths = Get-UserProfiles | Select-Object -ExpandProperty 'ProfilePath'
+ Returns the user profile path for each user on the system. This information can then be used to make modifications under the user profile on the filesystem.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string[]]$ExcludeNTAccount,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ExcludeSystemProfiles = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$ExcludeDefaultUser = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Get the User Profile Path, User Account SID, and the User Account Name for all users that log onto the machine.' -Source ${CmdletName}
+
+ ## Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine
+ [string]$UserProfileListRegKey = 'Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList'
+ [psobject[]]$UserProfiles = Get-ChildItem -LiteralPath $UserProfileListRegKey -ErrorAction 'Stop' |
+ ForEach-Object {
+ Get-ItemProperty -LiteralPath $_.PSPath -ErrorAction 'Stop' | Where-Object { ($_.ProfileImagePath) } |
+ Select-Object @{ Label = 'NTAccount'; Expression = { $(ConvertTo-NTAccountOrSID -SID $_.PSChildName).Value } }, @{ Label = 'SID'; Expression = { $_.PSChildName } }, @{ Label = 'ProfilePath'; Expression = { $_.ProfileImagePath } }
+ }
+ If ($ExcludeSystemProfiles) {
+ [string[]]$SystemProfiles = 'S-1-5-18', 'S-1-5-19', 'S-1-5-20'
+ [psobject[]]$UserProfiles = $UserProfiles | Where-Object { $SystemProfiles -notcontains $_.SID }
+ }
+ If ($ExcludeNTAccount) {
+ [psobject[]]$UserProfiles = $UserProfiles | Where-Object { $ExcludeNTAccount -notcontains $_.NTAccount }
+ }
+
+ ## Find the path to the Default User profile
+ If (-not $ExcludeDefaultUser) {
+ [string]$UserProfilesDirectory = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'ProfilesDirectory' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'ProfilesDirectory'
+
+ # On Windows Vista or higher
+ If (([version]$envOSVersion).Major -gt 5) {
+ # Path to Default User Profile directory on Windows Vista or higher: By default, C:\Users\Default
+ [string]$DefaultUserProfileDirectory = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'Default' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Default'
+ }
+ # On Windows XP or lower
+ Else {
+ # Default User Profile Name: By default, 'Default User'
+ [string]$DefaultUserProfileName = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'DefaultUserProfile' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'DefaultUserProfile'
+
+ # Path to Default User Profile directory: By default, C:\Documents and Settings\Default User
+ [string]$DefaultUserProfileDirectory = Join-Path -Path $UserProfilesDirectory -ChildPath $DefaultUserProfileName
+ }
+
+ ## Create a custom object for the Default User profile.
+ # Since the Default User is not an actual User account, it does not have a username or a SID.
+ # We will make up a SID and add it to the custom object so that we have a location to load the default registry hive into later on.
+ [psobject]$DefaultUserProfile = New-Object -TypeName 'PSObject' -Property @{
+ NTAccount = 'Default User'
+ SID = 'S-1-5-21-Default-User'
+ ProfilePath = $DefaultUserProfileDirectory
+ }
+
+ ## Add the Default User custom object to the User Profile list.
+ $UserProfiles += $DefaultUserProfile
+ }
+
+ Write-Output -InputObject $UserProfiles
+ }
+ Catch {
+ Write-Log -Message "Failed to create a custom object representing all user profiles on the machine. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-FileVersion
+Function Get-FileVersion {
+<#
+.SYNOPSIS
+ Gets the version of the specified file
+.DESCRIPTION
+ Gets the version of the specified file
+.PARAMETER File
+ Path of the file
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-FileVersion -File "$envProgramFilesX86\Adobe\Reader 11.0\Reader\AcroRd32.exe"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$File,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get file version info for file [$file]." -Source ${CmdletName}
+
+ If (Test-Path -LiteralPath $File -PathType 'Leaf') {
+ $fileVersion = (Get-Command -Name $file -ErrorAction 'Stop').FileVersionInfo.FileVersion
+ If ($fileVersion) {
+ ## Remove product information to leave only the file version
+ $fileVersion = ($fileVersion -split ' ' | Select-Object -First 1)
+
+ Write-Log -Message "File version is [$fileVersion]." -Source ${CmdletName}
+ Write-Output -InputObject $fileVersion
+ }
+ Else {
+ Write-Log -Message 'No file version information found.' -Source ${CmdletName}
+ }
+ }
+ Else {
+ Throw "File path [$file] does not exist."
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get file version info. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get file version info: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-Shortcut
+Function New-Shortcut {
+<#
+.SYNOPSIS
+ Creates a new .lnk or .url type shortcut
+.DESCRIPTION
+ Creates a new shortcut .lnk or .url file, with configurable options
+.PARAMETER Path
+ Path to save the shortcut
+.PARAMETER TargetPath
+ Target path or URL that the shortcut launches
+.PARAMETER Arguments
+ Arguments to be passed to the target path
+.PARAMETER IconLocation
+ Location of the icon used for the shortcut
+.PARAMETER IconIndex
+ Executables, DLLs, ICO files with multiple icons need the icon index to be specified
+.PARAMETER Description
+ Description of the shortcut
+.PARAMETER WorkingDirectory
+ Working Directory to be used for the target path
+.PARAMETER WindowStyle
+ Windows style of the application. Options: Normal, Maximized, Minimized. Default is: Normal.
+.PARAMETER RunAsAdmin
+ Set shortcut to run program as administrator. This option will prompt user to elevate when executing shortcut.
+.PARAMETER Hotkey
+ Create a Hotkey to launch the shortcut, e.g. "CTRL+SHIFT+F"
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ New-Shortcut -Path "$envProgramData\Microsoft\Windows\Start Menu\My Shortcut.lnk" -TargetPath "$envWinDir\system32\notepad.exe" -IconLocation "$envWinDir\system32\notepad.exe" -Description 'Notepad' -WorkingDirectory "$envHomeDrive\$envHomePath"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$TargetPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Arguments,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IconLocation,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IconIndex,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Description,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Normal','Maximized','Minimized')]
+ [string]$WindowStyle,
+ [Parameter(Mandatory=$false)]
+ [switch]$RunAsAdmin,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Hotkey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ If (-not $Shell) { [__comobject]$Shell = New-Object -ComObject 'WScript.Shell' -ErrorAction 'Stop' }
+ }
+ Process {
+ Try {
+ Try {
+ [IO.FileInfo]$Path = [IO.FileInfo]$Path
+ [string]$PathDirectory = $Path.DirectoryName
+
+ If (-not (Test-Path -LiteralPath $PathDirectory -PathType 'Container' -ErrorAction 'Stop')) {
+ Write-Log -Message "Create shortcut directory [$PathDirectory]." -Source ${CmdletName}
+ $null = New-Item -Path $PathDirectory -ItemType 'Directory' -Force -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create shortcut directory [$PathDirectory]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Throw
+ }
+
+ Write-Log -Message "Create shortcut [$($path.FullName)]." -Source ${CmdletName}
+ If (($path.FullName).ToLower().EndsWith('.url')) {
+ [string[]]$URLFile = '[InternetShortcut]'
+ $URLFile += "URL=$targetPath"
+ If ($iconIndex) { $URLFile += "IconIndex=$iconIndex" }
+ If ($IconLocation) { $URLFile += "IconFile=$iconLocation" }
+ $URLFile | Out-File -FilePath $path.FullName -Force -Encoding 'default' -ErrorAction 'Stop'
+ }
+ ElseIf (($path.FullName).ToLower().EndsWith('.lnk')) {
+ If (($iconLocation -and $iconIndex) -and (-not ($iconLocation.Contains(',')))) {
+ $iconLocation = $iconLocation + ",$iconIndex"
+ }
+ Switch ($windowStyle) {
+ 'Normal' { $windowStyleInt = 1 }
+ 'Maximized' { $windowStyleInt = 3 }
+ 'Minimized' { $windowStyleInt = 7 }
+ Default { $windowStyleInt = 1 }
+ }
+ $shortcut = $shell.CreateShortcut($path.FullName)
+ $shortcut.TargetPath = $targetPath
+ $shortcut.Arguments = $arguments
+ $shortcut.Description = $description
+ $shortcut.WorkingDirectory = $workingDirectory
+ $shortcut.WindowStyle = $windowStyleInt
+ If ($hotkey) {$shortcut.Hotkey = $hotkey}
+ If ($iconLocation) { $shortcut.IconLocation = $iconLocation }
+ $shortcut.Save()
+
+ ## Set shortcut to run program as administrator
+ If ($RunAsAdmin) {
+ Write-Log -Message 'Set shortcut to run program as administrator.' -Source ${CmdletName}
+ $TempFileName = [IO.Path]::GetRandomFileName()
+ $TempFile = [IO.FileInfo][IO.Path]::Combine($Path.Directory, $TempFileName)
+ $Writer = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($TempFile, ([IO.FileMode]::Create)) -ErrorAction 'Stop'
+ $Reader = $Path.OpenRead()
+ While ($Reader.Position -lt $Reader.Length) {
+ $Byte = $Reader.ReadByte()
+ If ($Reader.Position -eq 22) { $Byte = 34 }
+ $Writer.WriteByte($Byte)
+ }
+ $Reader.Close()
+ $Writer.Close()
+ $Path.Delete()
+ $null = Rename-Item -Path $TempFile -NewName $Path.Name -Force -ErrorAction 'Stop'
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create shortcut [$($path.FullName)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create shortcut [$($path.FullName)]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-ProcessAsUser
+Function Execute-ProcessAsUser {
+<#
+.SYNOPSIS
+ Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.
+.DESCRIPTION
+ Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.
+.PARAMETER UserName
+ Logged in Username under which to run the process from. Default is: The active console user. If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user.
+.PARAMETER Path
+ Path to the file being executed.
+.PARAMETER Parameters
+ Arguments to be passed to the file being executed.
+.PARAMETER SecureParameters
+ Hides all parameters passed to the executable from the Toolkit log file.
+.PARAMETER RunLevel
+ Specifies the level of user rights that Task Scheduler uses to run the task. The acceptable values for this parameter are:
+ - HighestAvailable: Tasks run by using the highest available privileges (Admin privileges for Administrators). Default Value.
+ - LeastPrivilege: Tasks run by using the least-privileged user account (LUA) privileges.
+.PARAMETER Wait
+ Wait for the process, launched by the scheduled task, to complete execution before accepting more input. Default is $false.
+.PARAMETER PassThru
+ Returns the exit code from this function or the process launched by the scheduled task.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is $true.
+.EXAMPLE
+ Execute-ProcessAsUser -UserName 'CONTOSO\User' -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & `"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait
+ Execute process under a user account by specifying a username under which to execute it.
+.EXAMPLE
+ Execute-ProcessAsUser -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & `"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait
+ Execute process under a user account by using the default active logged in user that was detected when the toolkit was launched.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$UserName = $RunAsActiveUser.NTAccount,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters = '',
+ [Parameter(Mandatory=$false)]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('HighestAvailable','LeastPrivilege')]
+ [string]$RunLevel = 'HighestAvailable',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$Wait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Initialize exit code variable
+ [int32]$executeProcessAsUserExitCode = 0
+
+ ## Confirm that the username field is not empty
+ If (-not $UserName) {
+ [int32]$executeProcessAsUserExitCode = 60009
+ Write-Log -Message "The function [${CmdletName}] has a -UserName parameter that has an empty default value because no logged in users were detected when the toolkit was launched." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The function [${CmdletName}] has a -UserName parameter that has an empty default value because no logged in users were detected when the toolkit was launched."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Confirm if the toolkit is running with administrator privileges
+ If (($RunLevel -eq 'HighestAvailable') -and (-not $IsAdmin)) {
+ [int32]$executeProcessAsUserExitCode = 60003
+ Write-Log -Message "The function [${CmdletName}] requires the toolkit to be running with Administrator privileges if the [-RunLevel] parameter is set to 'HighestAvailable'." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The function [${CmdletName}] requires the toolkit to be running with Administrator privileges if the [-RunLevel] parameter is set to 'HighestAvailable'."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Build the scheduled task XML name
+ [string]$schTaskName = "$appDeployToolkitName-ExecuteAsUser"
+
+ ## Create the temporary App Deploy Toolkit files folder if it doesn't already exist
+ If (-not (Test-Path -LiteralPath $dirAppDeployTemp -PathType 'Container')) {
+ New-Item -Path $dirAppDeployTemp -ItemType 'Directory' -Force -ErrorAction 'Stop'
+ }
+
+ ## If PowerShell.exe is being launched, then create a VBScript to launch PowerShell so that we can suppress the console window that flashes otherwise
+ If (($Path -eq 'PowerShell.exe') -or ((Split-Path -Path $Path -Leaf) -eq 'PowerShell.exe')) {
+ # Permit inclusion of double quotes in parameters
+ If ($($Parameters.Substring($Parameters.Length - 1)) -eq '"') {
+ [string]$executeProcessAsUserParametersVBS = 'chr(34) & ' + "`"$($Path)`"" + ' & chr(34) & ' + '" ' + ($Parameters -replace '"', "`" & chr(34) & `"" -replace ' & chr\(34\) & "$', '') + ' & chr(34)' }
+ Else {
+ [string]$executeProcessAsUserParametersVBS = 'chr(34) & ' + "`"$($Path)`"" + ' & chr(34) & ' + '" ' + ($Parameters -replace '"', "`" & chr(34) & `"" -replace ' & chr\(34\) & "$','') + '"' }
+ [string[]]$executeProcessAsUserScript = "strCommand = $executeProcessAsUserParametersVBS"
+ $executeProcessAsUserScript += 'set oWShell = CreateObject("WScript.Shell")'
+ $executeProcessAsUserScript += 'intReturn = oWShell.Run(strCommand, 0, true)'
+ $executeProcessAsUserScript += 'WScript.Quit intReturn'
+ $executeProcessAsUserScript | Out-File -FilePath "$dirAppDeployTemp\$($schTaskName).vbs" -Force -Encoding 'default' -ErrorAction 'SilentlyContinue'
+ $Path = 'wscript.exe'
+ $Parameters = "`"$dirAppDeployTemp\$($schTaskName).vbs`""
+ }
+
+ ## Specify the scheduled task configuration in XML format
+ [string]$xmlSchTask = @"
+
+
+
+
+
+ StopExisting
+ false
+ false
+ true
+ false
+ false
+
+ false
+ false
+
+ true
+ true
+ false
+ false
+ false
+ PT72H
+ 7
+
+
+
+ $Path
+ $Parameters
+
+
+
+
+ $UserName
+ InteractiveToken
+ $RunLevel
+
+
+
+"@
+ ## Export the XML to file
+ Try {
+ # Specify the filename to export the XML to
+ [string]$xmlSchTaskFilePath = "$dirAppDeployTemp\$schTaskName.xml"
+ [string]$xmlSchTask | Out-File -FilePath $xmlSchTaskFilePath -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ [int32]$executeProcessAsUserExitCode = 60007
+ Write-Log -Message "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]: $($_.Exception.Message)"
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Create Scheduled Task to run the process with a logged-on user account
+ If ($Parameters) {
+ If ($SecureParameters) {
+ Write-Log -Message "Create scheduled task to run the process [$Path] (Parameters Hidden) as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Create scheduled task to run the process [$Path $Parameters] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message "Create scheduled task to run the process [$Path] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/create /f /tn $schTaskName /xml `"$xmlSchTaskFilePath`"" -WindowStyle 'Hidden' -CreateNoWindow -PassThru
+ If ($schTaskResult.ExitCode -ne 0) {
+ [int32]$executeProcessAsUserExitCode = $schTaskResult.ExitCode
+ Write-Log -Message "Failed to create the scheduled task by importing the scheduled task XML file [$xmlSchTaskFilePath]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create the scheduled task by importing the scheduled task XML file [$xmlSchTaskFilePath]."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Trigger the Scheduled Task
+ If ($Parameters) {
+ If ($SecureParameters) {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path] (Parameters Hidden) as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path $Parameters] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/run /i /tn $schTaskName" -WindowStyle 'Hidden' -CreateNoWindow -Passthru
+ If ($schTaskResult.ExitCode -ne 0) {
+ [int32]$executeProcessAsUserExitCode = $schTaskResult.ExitCode
+ Write-Log -Message "Failed to trigger scheduled task [$schTaskName]." -Severity 3 -Source ${CmdletName}
+ # Delete Scheduled Task
+ Write-Log -Message 'Delete the scheduled task which did not trigger.' -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/delete /tn $schTaskName /f" -WindowStyle 'Hidden' -CreateNoWindow -ContinueOnError $true
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger scheduled task [$schTaskName]."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Wait for the process launched by the scheduled task to complete execution
+ If ($Wait) {
+ Write-Log -Message "Waiting for the process launched by the scheduled task [$schTaskName] to complete execution (this may take some time)..." -Source ${CmdletName}
+ Start-Sleep -Seconds 1
+ #If on Windows Vista or higer, Windows Task Scheduler 2.0 is supported. 'Schedule.Service' ComObject output is UI language independent
+ If (([version]$envOSVersion).Major -gt 5) {
+ Try {
+ [__comobject]$ScheduleService = New-Object -ComObject 'Schedule.Service' -ErrorAction Stop
+ $ScheduleService.Connect()
+ $RootFolder = $ScheduleService.GetFolder('\')
+ $Task = $RootFolder.GetTask("$schTaskName")
+ # Task State(Status) 4 = 'Running'
+ While ($Task.State -eq 4) {
+ Start-Sleep -Seconds 5
+ }
+ # Get the exit code from the process launched by the scheduled task
+ [int32]$executeProcessAsUserExitCode = $Task.LastTaskResult
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve information from Task Scheduler. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Finally {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($ScheduleService) } Catch { }
+ }
+ }
+ #Windows Task Scheduler 1.0
+ Else {
+ While ((($exeSchTasksResult = & $exeSchTasks /query /TN $schTaskName /V /FO CSV) | ConvertFrom-CSV | Select-Object -ExpandProperty 'Status' | Select-Object -First 1) -eq 'Running') {
+ Start-Sleep -Seconds 5
+ }
+ # Get the exit code from the process launched by the scheduled task
+ [int32]$executeProcessAsUserExitCode = ($exeSchTasksResult = & $exeSchTasks /query /TN $schTaskName /V /FO CSV) | ConvertFrom-CSV | Select-Object -ExpandProperty 'Last Result' | Select-Object -First 1
+ }
+ Write-Log -Message "Exit code from process launched by scheduled task [$executeProcessAsUserExitCode]." -Source ${CmdletName}
+ }
+ Else {
+ Start-Sleep -Seconds 1
+ }
+
+ ## Delete scheduled task
+ Try {
+ Write-Log -Message "Delete scheduled task [$schTaskName]." -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/delete /tn $schTaskName /f" -WindowStyle 'Hidden' -CreateNoWindow -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to delete scheduled task [$schTaskName]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $executeProcessAsUserExitCode }
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Update-Desktop
+Function Update-Desktop {
+<#
+.SYNOPSIS
+ Refresh the Windows Explorer Shell, which causes the desktop icons and the environment variables to be reloaded.
+.DESCRIPTION
+ Refresh the Windows Explorer Shell, which causes the desktop icons and the environment variables to be reloaded.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-Desktop
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Refresh the Desktop and the Windows Explorer environment process block.' -Source ${CmdletName}
+ [PSADT.Explorer]::RefreshDesktopAndEnvironmentVariables()
+ }
+ Catch {
+ Write-Log -Message "Failed to refresh the Desktop and the Windows Explorer environment process block. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to refresh the Desktop and the Windows Explorer environment process block: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Refresh-Desktop' -Value 'Update-Desktop' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Update-SessionEnvironmentVariables
+Function Update-SessionEnvironmentVariables {
+<#
+.SYNOPSIS
+ Updates the environment variables for the current PowerShell session with any environment variable changes that may have occurred during script execution.
+.DESCRIPTION
+ Environment variable changes that take place during script execution are not visible to the current PowerShell session.
+ Use this function to refresh the current PowerShell session with all environment variable settings.
+.PARAMETER LoadLoggedOnUserEnvironmentVariables
+ If script is running in SYSTEM context, this option allows loading environment variables from the active console user. If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-SessionEnvironmentVariables
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$LoadLoggedOnUserEnvironmentVariables = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ [scriptblock]$GetEnvironmentVar = {
+ Param (
+ $Key,
+ $Scope
+ )
+ [Environment]::GetEnvironmentVariable($Key, $Scope)
+ }
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Refresh the environment variables for this PowerShell session.' -Source ${CmdletName}
+
+ If ($LoadLoggedOnUserEnvironmentVariables -and $RunAsActiveUser) {
+ [string]$CurrentUserEnvironmentSID = $RunAsActiveUser.SID
+ }
+ Else {
+ [string]$CurrentUserEnvironmentSID = [Security.Principal.WindowsIdentity]::GetCurrent().User.Value
+ }
+ [string]$MachineEnvironmentVars = 'Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
+ [string]$UserEnvironmentVars = "Registry::HKEY_USERS\$CurrentUserEnvironmentSID\Environment"
+
+ ## Update all session environment variables. Ordering is important here: $UserEnvironmentVars comes second so that we can override $MachineEnvironmentVars.
+ $MachineEnvironmentVars, $UserEnvironmentVars | Get-Item | Where-Object { $_ } | ForEach-Object { $envRegPath = $_.PSPath; $_ | Select-Object -ExpandProperty 'Property' | ForEach-Object { Set-Item -LiteralPath "env:$($_)" -Value (Get-ItemProperty -LiteralPath $envRegPath -Name $_).$_ } }
+
+ ## Set PATH environment variable separately because it is a combination of the user and machine environment variables
+ [string[]]$PathFolders = 'Machine', 'User' | ForEach-Object { (& $GetEnvironmentVar -Key 'PATH' -Scope $_) } | Where-Object { $_ } | ForEach-Object { $_.Trim(';') } | ForEach-Object { $_.Split(';') } | ForEach-Object { $_.Trim() } | ForEach-Object { $_.Trim('"') } | Select-Object -Unique
+ $env:PATH = $PathFolders -join ';'
+ }
+ Catch {
+ Write-Log -Message "Failed to refresh the environment variables for this PowerShell session. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to refresh the environment variables for this PowerShell session: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Refresh-SessionEnvironmentVariables' -Value 'Update-SessionEnvironmentVariables' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Get-ScheduledTask
+Function Get-ScheduledTask {
+<#
+.SYNOPSIS
+ Retrieve all details for scheduled tasks on the local computer.
+.DESCRIPTION
+ Retrieve all details for scheduled tasks on the local computer using schtasks.exe. All property names have spaces and colons removed.
+.PARAMETER TaskName
+ Specify the name of the scheduled task to retrieve details for. Uses regex match to find scheduled task.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $true.
+.EXAMPLE
+ Get-ScheduledTask
+ To display a list of all scheduled task properties.
+.EXAMPLE
+ Get-ScheduledTask | Out-GridView
+ To display a grid view of all scheduled task properties.
+.EXAMPLE
+ Get-ScheduledTask | Select-Object -Property TaskName
+ To display a list of all scheduled task names.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$TaskName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ If (-not $exeSchTasks) { [string]$exeSchTasks = "$env:WINDIR\system32\schtasks.exe" }
+ [psobject[]]$ScheduledTasks = @()
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Retrieve Scheduled Tasks...' -Source ${CmdletName}
+ [string[]]$exeSchtasksResults = & $exeSchTasks /Query /V /FO CSV
+ If ($global:LastExitCode -ne 0) { Throw "Failed to retrieve scheduled tasks using [$exeSchTasks]." }
+ [psobject[]]$SchtasksResults = $exeSchtasksResults | ConvertFrom-CSV -Header 'HostName', 'TaskName', 'Next Run Time', 'Status', 'Logon Mode', 'Last Run Time', 'Last Result', 'Author', 'Task To Run', 'Start In', 'Comment', 'Scheduled Task State', 'Idle Time', 'Power Management', 'Run As User', 'Delete Task If Not Rescheduled', 'Stop Task If Runs X Hours and X Mins', 'Schedule', 'Schedule Type', 'Start Time', 'Start Date', 'End Date', 'Days', 'Months', 'Repeat: Every', 'Repeat: Until: Time', 'Repeat: Until: Duration', 'Repeat: Stop If Still Running' -ErrorAction 'Stop'
+
+ If ($SchtasksResults) {
+ ForEach ($SchtasksResult in $SchtasksResults) {
+ If ($SchtasksResult.TaskName -match $TaskName) {
+ $SchtasksResult | Get-Member -MemberType 'Properties' |
+ ForEach -Begin {
+ [hashtable]$Task = @{}
+ } -Process {
+ ## Remove spaces and colons in property names. Do not set property value if line being processed is a column header (this will only work on English language machines).
+ ($Task.($($_.Name).Replace(' ','').Replace(':',''))) = If ($_.Name -ne $SchtasksResult.($_.Name)) { $SchtasksResult.($_.Name) }
+ } -End {
+ ## Only add task to the custom object if all property values are not empty
+ If (($Task.Values | Select-Object -Unique | Measure-Object).Count) {
+ $ScheduledTasks += New-Object -TypeName 'PSObject' -Property $Task
+ }
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve scheduled tasks. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve scheduled tasks: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-Output -InputObject $ScheduledTasks
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Block-AppExecution
+Function Block-AppExecution {
+<#
+.SYNOPSIS
+ Block the execution of an application(s)
+.DESCRIPTION
+ This function is called when you pass the -BlockExecution parameter to the Stop-RunningApplications function. It does the following:
+ 1. Makes a copy of this script in a temporary directory on the local machine.
+ 2. Checks for an existing scheduled task from previous failed installation attempt where apps were blocked and if found, calls the Unblock-AppExecution function to restore the original IFEO registry keys.
+ This is to prevent the function from overriding the backup of the original IFEO options.
+ 3. Creates a scheduled task to restore the IFEO registry key values in case the script is terminated uncleanly by calling the local temporary copy of this script with the parameter -CleanupBlockedApps.
+ 4. Modifies the "Image File Execution Options" registry key for the specified process(s) to call this script with the parameter -ShowBlockedAppDialog.
+ 5. When the script is called with those parameters, it will display a custom message to the user to indicate that execution of the application has been blocked while the installation is in progress.
+ The text of this message can be customized in the XML configuration file.
+.PARAMETER ProcessName
+ Name of the process or processes separated by commas
+.EXAMPLE
+ Block-AppExecution -ProcessName ('winword','excel')
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ It is used when the -BlockExecution parameter is specified with the Show-InstallationWelcome function to block applications.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ ## Specify process names separated by commas
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$ProcessName
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Remove illegal characters from the scheduled task arguments string
+ [char[]]$invalidScheduledTaskChars = '$', '!', '''', '"', '(', ')', ';', '\', '`', '*', '?', '{', '}', '[', ']', '<', '>', '|', '&', '%', '#', '~', '@', ' '
+ [string]$SchInstallName = $installName
+ ForEach ($invalidChar in $invalidScheduledTaskChars) { [string]$SchInstallName = $SchInstallName -replace [regex]::Escape($invalidChar),'' }
+ [string]$schTaskUnblockAppsCommand += "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$dirAppDeployTemp\$scriptFileName`" -CleanupBlockedApps -ReferredInstallName `"$SchInstallName`" -ReferredInstallTitle `"$installTitle`" -ReferredLogName `"$logName`" -AsyncToolkitLaunch"
+ ## Specify the scheduled task configuration in XML format
+ [string]$xmlUnblockAppsSchTask = @"
+
+
+
+
+
+ true
+
+
+
+
+ S-1-5-18
+
+
+
+ IgnoreNew
+ false
+ false
+ true
+ false
+ false
+
+ false
+ false
+
+ true
+ true
+ false
+ false
+ false
+ PT1H
+ 7
+
+
+
+ powershell.exe
+ $schTaskUnblockAppsCommand
+
+
+
+"@
+ }
+ Process {
+ ## Bypass if in NonInteractive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Function [${CmdletName}] [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+
+ [string]$schTaskBlockedAppsName = $installName + '_BlockedApps'
+
+ ## Delete this file if it exists as it can cause failures (it is a bug from an older version of the toolkit)
+ If (Test-Path -LiteralPath "$configToolkitTempPath\PSAppDeployToolkit" -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ $null = Remove-Item -LiteralPath "$configToolkitTempPath\PSAppDeployToolkit" -Force -ErrorAction 'SilentlyContinue'
+ }
+ ## Create Temporary directory (if required) and copy Toolkit so it can be called by scheduled task later if required
+ If (-not (Test-Path -LiteralPath $dirAppDeployTemp -PathType 'Container' -ErrorAction 'SilentlyContinue')) {
+ $null = New-Item -Path $dirAppDeployTemp -ItemType 'Directory' -ErrorAction 'SilentlyContinue'
+ }
+
+ Copy-Item -Path "$scriptRoot\*.*" -Destination $dirAppDeployTemp -Exclude 'thumbs.db' -Force -Recurse -ErrorAction 'SilentlyContinue'
+
+ ## Build the debugger block value script
+ [string]$debuggerBlockMessageCmd = "`"powershell.exe -ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `" & chr(34) & `"$dirAppDeployTemp\$scriptFileName`" & chr(34) & `" -ShowBlockedAppDialog -AsyncToolkitLaunch -ReferredInstallTitle `" & chr(34) & `"$installTitle`" & chr(34)"
+ [string[]]$debuggerBlockScript = "strCommand = $debuggerBlockMessageCmd"
+ $debuggerBlockScript += 'set oWShell = CreateObject("WScript.Shell")'
+ $debuggerBlockScript += 'oWShell.Run strCommand, 0, false'
+ $debuggerBlockScript | Out-File -FilePath "$dirAppDeployTemp\AppDeployToolkit_BlockAppExecutionMessage.vbs" -Force -Encoding 'default' -ErrorAction 'SilentlyContinue'
+ [string]$debuggerBlockValue = "wscript.exe `"$dirAppDeployTemp\AppDeployToolkit_BlockAppExecutionMessage.vbs`""
+
+ ## Create a scheduled task to run on startup to call this script and clean up blocked applications in case the installation is interrupted, e.g. user shuts down during installation"
+ Write-Log -Message 'Create scheduled task to cleanup blocked applications in case installation is interrupted.' -Source ${CmdletName}
+ If (Get-ScheduledTask -ContinueOnError $true | Select-Object -Property 'TaskName' | Where-Object { $_.TaskName -eq "\$schTaskBlockedAppsName" }) {
+ Write-Log -Message "Scheduled task [$schTaskBlockedAppsName] already exists." -Source ${CmdletName}
+ }
+ Else {
+ ## Export the scheduled task XML to file
+ Try {
+ # Specify the filename to export the XML to
+ [string]$xmlSchTaskFilePath = "$dirAppDeployTemp\SchTaskUnBlockApps.xml"
+ [string]$xmlUnblockAppsSchTask | Out-File -FilePath $xmlSchTaskFilePath -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Return
+ }
+
+ ## Import the Scheduled Task XML file to create the Scheduled Task
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/create /f /tn $schTaskBlockedAppsName /xml `"$xmlSchTaskFilePath`"" -WindowStyle 'Hidden' -CreateNoWindow -PassThru
+ If ($schTaskResult.ExitCode -ne 0) {
+ Write-Log -Message "Failed to create the scheduled task [$schTaskBlockedAppsName] by importing the scheduled task XML file [$xmlSchTaskFilePath]." -Severity 3 -Source ${CmdletName}
+ Return
+ }
+ }
+
+ [string[]]$blockProcessName = $processName
+ ## Append .exe to match registry keys
+ [string[]]$blockProcessName = $blockProcessName | ForEach-Object { $_ + '.exe' } -ErrorAction 'SilentlyContinue'
+
+ ## Enumerate each process and set the debugger value to block application execution
+ ForEach ($blockProcess in $blockProcessName) {
+ Write-Log -Message "Set the Image File Execution Option registry key to block execution of [$blockProcess]." -Source ${CmdletName}
+ Set-RegistryKey -Key (Join-Path -Path $regKeyAppExecution -ChildPath $blockProcess) -Name 'Debugger' -Value $debuggerBlockValue -ContinueOnError $true
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Unblock-AppExecution
+Function Unblock-AppExecution {
+<#
+.SYNOPSIS
+ Unblocks the execution of applications performed by the Block-AppExecution function
+.DESCRIPTION
+ This function is called by the Exit-Script function or when the script itself is called with the parameters -CleanupBlockedApps
+.EXAMPLE
+ Unblock-AppExecution
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ It is used when the -BlockExecution parameter is specified with the Show-InstallationWelcome function to undo the actions performed by Block-AppExecution.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in NonInteractive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Function [${CmdletName}] [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+
+ ## Remove Debugger values to unblock processes
+ [psobject[]]$unblockProcesses = $null
+ [psobject[]]$unblockProcesses += (Get-ChildItem -LiteralPath $regKeyAppExecution -Recurse -ErrorAction 'SilentlyContinue' | ForEach-Object { Get-ItemProperty -LiteralPath $_.PSPath -ErrorAction 'SilentlyContinue'})
+ ForEach ($unblockProcess in ($unblockProcesses | Where-Object { $_.Debugger -like '*AppDeployToolkit_BlockAppExecutionMessage*' })) {
+ Write-Log -Message "Remove the Image File Execution Options registry key to unblock execution of [$($unblockProcess.PSChildName)]." -Source ${CmdletName}
+ $unblockProcess | Remove-ItemProperty -Name 'Debugger' -ErrorAction 'SilentlyContinue'
+ }
+
+ ## If block execution variable is $true, set it to $false
+ If ($BlockExecution) {
+ # Make this variable globally available so we can check whether we need to call Unblock-AppExecution
+ Set-Variable -Name 'BlockExecution' -Value $false -Scope 'Script'
+ }
+
+ ## Remove the scheduled task if it exists
+ [string]$schTaskBlockedAppsName = $installName + '_BlockedApps'
+ Try {
+ If (Get-ScheduledTask -ContinueOnError $true | Select-Object -Property 'TaskName' | Where-Object { $_.TaskName -eq "\$schTaskBlockedAppsName" }) {
+ Write-Log -Message "Delete Scheduled Task [$schTaskBlockedAppsName]." -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/Delete /TN $schTaskBlockedAppsName /F"
+ }
+ }
+ Catch {
+ Write-Log -Message "Error retrieving/deleting Scheduled Task.`n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-DeferHistory
+Function Get-DeferHistory {
+<#
+.SYNOPSIS
+ Get the history of deferrals from the registry for the current application, if it exists.
+.DESCRIPTION
+ Get the history of deferrals from the registry for the current application, if it exists.
+.EXAMPLE
+ Get-DeferHistory
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message 'Get deferral history...' -Source ${CmdletName}
+ Get-RegistryKey -Key $regKeyDeferHistory -ContinueOnError $true
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-DeferHistory
+Function Set-DeferHistory {
+<#
+.SYNOPSIS
+ Set the history of deferrals in the registry for the current application.
+.DESCRIPTION
+ Set the history of deferrals in the registry for the current application.
+.EXAMPLE
+ Set-DeferHistory
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [string]$deferTimesRemaining,
+ [Parameter(Mandatory=$false)]
+ [string]$deferDeadline
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($deferTimesRemaining -and ($deferTimesRemaining -ge 0)) {
+ Write-Log -Message "Set deferral history: [DeferTimesRemaining = $deferTimesRemaining]." -Source ${CmdletName}
+ Set-RegistryKey -Key $regKeyDeferHistory -Name 'DeferTimesRemaining' -Value $deferTimesRemaining -ContinueOnError $true
+ }
+ If ($deferDeadline) {
+ Write-Log -Message "Set deferral history: [DeferDeadline = $deferDeadline]." -Source ${CmdletName}
+ Set-RegistryKey -Key $regKeyDeferHistory -Name 'DeferDeadline' -Value $deferDeadline -ContinueOnError $true
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-UniversalDate
+Function Get-UniversalDate {
+<#
+.SYNOPSIS
+ Returns the date/time for the local culture in a universal sortable date time pattern.
+.DESCRIPTION
+ Converts the current datetime or a datetime string for the current culture into a universal sortable date time pattern, e.g. 2013-08-22 11:51:52Z
+.PARAMETER DateTime
+ Specify the DateTime in the current culture.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $false.
+.EXAMPLE
+ Get-UniversalDate
+ Returns the current date in a universal sortable date time pattern.
+.EXAMPLE
+ Get-UniversalDate -DateTime '25/08/2013'
+ Returns the date for the current culture in a universal sortable date time pattern.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ # Get the current date
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$DateTime = ((Get-Date -Format ($culture).DateTimeFormat.FullDateTimePattern).ToString()),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If a universal sortable date time pattern was provided, remove the Z, otherwise it could get converted to a different time zone.
+ If ($DateTime -match 'Z$') { $DateTime = $DateTime -replace 'Z$', '' }
+ [datetime]$DateTime = [datetime]::Parse($DateTime, $culture)
+
+ ## Convert the date to a universal sortable date time pattern based on the current culture
+ Write-Log -Message "Convert the date [$DateTime] to a universal sortable date time pattern based on the current culture [$($culture.Name)]." -Source ${CmdletName}
+ [string]$universalDateTime = (Get-Date -Date $DateTime -Format ($culture).DateTimeFormat.UniversalSortableDateTimePattern -ErrorAction 'Stop').ToString()
+ Write-Output -InputObject $universalDateTime
+ }
+ Catch {
+ Write-Log -Message "The specified date/time [$DateTime] is not in a format recognized by the current culture [$($culture.Name)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The specified date/time [$DateTime] is not in a format recognized by the current culture: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-RunningProcesses
+Function Get-RunningProcesses {
+<#
+.SYNOPSIS
+ Gets the processes that are running from a custom list of process objects and also adds a property called ProcessDescription.
+.DESCRIPTION
+ Gets the processes that are running from a custom list of process objects and also adds a property called ProcessDescription.
+.PARAMETER ProcessObjects
+ Custom object containing the process objects to search for.
+.EXAMPLE
+ Get-RunningProcesses
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [psobject[]]$ProcessObjects,
+ [Parameter(Mandatory=$false,Position=1)]
+ [switch]$DisableLogging
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($processObjects) {
+ [string]$runningAppsCheck = ($processObjects | ForEach-Object { $_.ProcessName }) -join ','
+ If (-not($DisableLogging)) {
+ Write-Log -Message "Check for running application(s) [$runningAppsCheck]..." -Source ${CmdletName}
+ }
+ ## Create an array of process names to search for
+ [string[]]$processNames = $processObjects | ForEach-Object { $_.ProcessName }
+
+ ## Get all running processes and escape special characters. Match against the process names to search for to find running processes.
+ [Diagnostics.Process[]]$runningProcesses = Get-Process | Where-Object { $processNames -contains $_.ProcessName }
+
+ If ($runningProcesses) {
+ [string]$runningProcessList = ($runningProcesses | ForEach-Object { $_.ProcessName } | Select-Object -Unique) -join ','
+ If (-not($DisableLogging)) {
+ Write-Log -Message "The following processes are running: [$runningProcessList]." -Source ${CmdletName}
+ Write-Log -Message 'Resolve process descriptions...' -Source ${CmdletName}
+ }
+ ## Resolve the running process names to descriptions
+ ForEach ($runningProcess in $runningProcesses) {
+ ForEach ($processObject in $processObjects) {
+ If ($runningProcess.ProcessName -eq $processObject.ProcessName) {
+ If ($processObject.ProcessDescription) {
+ # The description of the process provided as a Parameter to the function, e.g. -ProcessName "winword=Microsoft Office Word".
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $processObject.ProcessDescription -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ ElseIf ($runningProcess.Description) {
+ # If the process already has a description field specified, then use it
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $runningProcess.Description -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ # Fall back on the process name if no description is provided by the process or as a parameter to the function
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $runningProcess.ProcessName -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+ }
+ }
+ Else {
+ If (-not($DisableLogging)) {
+ Write-Log -Message 'Application(s) are not running.' -Source ${CmdletName}
+ }
+ }
+ Write-Output -InputObject $runningProcesses
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationWelcome
+Function Show-InstallationWelcome {
+<#
+.SYNOPSIS
+ Show a welcome dialog prompting the user with information about the installation and actions to be performed before the installation can begin.
+.DESCRIPTION
+ The following prompts can be included in the welcome dialog:
+ a) Close the specified running applications, or optionally close the applications without showing a prompt (using the -Silent switch).
+ b) Defer the installation a certain number of times, for a certain number of days or until a deadline is reached.
+ c) Countdown until applications are automatically closed.
+ d) Prevent users from launching the specified applications while the installation is in progress.
+ Notes:
+ The process descriptions are retrieved from WMI, with a fall back on the process name if no description is available. Alternatively, you can specify the description yourself with a '=' symbol - see examples.
+ The dialog box will timeout after the timeout specified in the XML configuration file (default 1 hour and 55 minutes) to prevent SCCM installations from timing out and returning a failure code to SCCM. When the dialog times out, the script will exit and return a 1618 code (SCCM fast retry code).
+.PARAMETER CloseApps
+ Name of the process to stop (do not include the .exe). Specify multiple processes separated by a comma. Specify custom descriptions like this: "winword=Microsoft Office Word,excel=Microsoft Office Excel"
+.PARAMETER Silent
+ Stop processes without prompting the user.
+.PARAMETER CloseAppsCountdown
+ Option to provide a countdown in seconds until the specified applications are automatically closed. This only takes effect if deferral is not allowed or has expired.
+.PARAMETER ForceCloseAppsCountdown
+ Option to provide a countdown in seconds until the specified applications are automatically closed regardless of whether deferral is allowed.
+.PARAMETER PromptToSave
+ Specify whether to prompt to save working documents when the user chooses to close applications by selecting the "Close Programs" button. Option does not work in SYSTEM context unless toolkit launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds. The user will have no option but to respond to the prompt. This only takes effect if deferral is not allowed or has expired.
+.PARAMETER BlockExecution
+ Option to prevent the user from launching the process/application during the installation.
+.PARAMETER AllowDefer
+ Enables an optional defer button to allow the user to defer the installation.
+.PARAMETER AllowDeferCloseApps
+ Enables an optional defer button to allow the user to defer the installation only if there are running applications that need to be closed.
+.PARAMETER DeferTimes
+ Specify the number of times the installation can be deferred.
+.PARAMETER DeferDays
+ Specify the number of days since first run that the installation can be deferred. This is converted to a deadline.
+.PARAMETER DeferDeadline
+ Specify the deadline date until which the installation can be deferred.
+ Specify the date in the local culture if the script is intended for that same culture.
+ If the script is intended to run on EN-US machines, specify the date in the format: "08/25/2013" or "08-25-2013" or "08-25-2013 18:00:00"
+ If the script is intended for multiple cultures, specify the date in the universal sortable date/time format: "2013-08-22 11:51:52Z"
+ The deadline date will be displayed to the user in the format of their culture.
+.PARAMETER CheckDiskSpace
+ Specify whether to check if there is enough disk space for the installation to proceed.
+ If this parameter is specified without the RequiredDiskSpace parameter, the required disk space is calculated automatically based on the size of the script source and associated files.
+.PARAMETER RequiredDiskSpace
+ Specify required disk space in MB, used in combination with CheckDiskSpace.
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $true.
+.PARAMETER TopMost
+ Specifies whether the windows is the topmost window. Default: $true.
+.PARAMETER ForceCountdown
+ Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled.
+.PARAMETER CustomText
+ Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'iexplore,winword,excel'
+ Prompt the user to close Internet Explorer, Word and Excel.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -Silent
+ Close Word and Excel without prompting the user.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -BlockExecution
+ Close Word and Excel and prevent the user from launching the applications while the installation is in progress.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword=Microsoft Office Word,excel=Microsoft Office Excel' -CloseAppsCountdown 600
+ Prompt the user to close Word and Excel, with customized descriptions for the applications and automatically close the applications after 10 minutes.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,msaccess,excel' -PersistPrompt
+ Prompt the user to close Word, MSAccess and Excel.
+ By using the PersistPrompt switch, the dialog will return to the center of the screen every 10 seconds so the user cannot ignore it by dragging it aside.
+.EXAMPLE
+ Show-InstallationWelcome -AllowDefer -DeferDeadline '25/08/2013'
+ Allow the user to defer the installation until the deadline is reached.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -BlockExecution -AllowDefer -DeferTimes 10 -DeferDeadline '25/08/2013' -CloseAppsCountdown 600
+ Close Word and Excel and prevent the user from launching the applications while the installation is in progress.
+ Allow the user to defer the installation a maximum of 10 times or until the deadline is reached, whichever happens first.
+ When deferral expires, prompt the user to close the applications and automatically close them after 10 minutes.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParametersetName='None')]
+
+ Param (
+ ## Specify process names separated by commas. Optionally specify a process description with an equals symbol, e.g. "winword=Microsoft Office Word"
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$CloseApps,
+ ## Specify whether to prompt user or force close the applications
+ [Parameter(Mandatory=$false)]
+ [switch]$Silent = $false,
+ ## Specify a countdown to display before automatically closing applications where deferral is not allowed or has expired
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CloseAppsCountdown = 0,
+ ## Specify a countdown to display before automatically closing applications whether or not deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCloseAppsCountdown = 0,
+ ## Specify whether to prompt to save working documents when the user chooses to close applications by selecting the "Close Programs" button
+ [Parameter(Mandatory=$false)]
+ [switch]$PromptToSave = $false,
+ ## Specify whether to make the prompt persist in the center of the screen every 10 seconds.
+ [Parameter(Mandatory=$false)]
+ [switch]$PersistPrompt = $false,
+ ## Specify whether to block execution of the processes during installation
+ [Parameter(Mandatory=$false)]
+ [switch]$BlockExecution = $false,
+ ## Specify whether to enable the optional defer button on the dialog box
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDefer = $false,
+ ## Specify whether to enable the optional defer button on the dialog box only if an app needs to be closed
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDeferCloseApps = $false,
+ ## Specify the number of times the deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$DeferTimes = 0,
+ ## Specify the number of days since first run that the deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$DeferDays = 0,
+ ## Specify the deadline (in format dd/mm/yyyy) for which deferral will expire as an option
+ [Parameter(Mandatory=$false)]
+ [string]$DeferDeadline = '',
+ ## Specify whether to check if there is enough disk space for the installation to proceed. If this parameter is specified without the RequiredDiskSpace parameter, the required disk space is calculated automatically based on the size of the script source and associated files.
+ [Parameter(ParameterSetName = "CheckDiskSpaceParameterSet",Mandatory=$true)]
+ [ValidateScript({$_.IsPresent -eq ($true -or $false)})]
+ [switch]$CheckDiskSpace,
+ ## Specify required disk space in MB, used in combination with $CheckDiskSpace.
+ [Parameter(ParameterSetName = "CheckDiskSpaceParameterSet",Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$RequiredDiskSpace = 0,
+ ## Specify whether to minimize other windows when displaying prompt
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $true,
+ ## Specifies whether the window is the topmost window
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true,
+ ## Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCountdown = 0,
+ ## Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+ [Parameter(Mandatory=$false)]
+ [switch]$CustomText = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If running in NonInteractive mode, force the processes to close silently
+ If ($deployModeNonInteractive) { $Silent = $true }
+
+ ## If using Zero-Config MSI Deployment, append any executables found in the MSI to the CloseApps list
+ If ($useDefaultMsi) { $CloseApps = "$CloseApps,$defaultMsiExecutablesList" }
+
+ ## Check disk space requirements if specified
+ If ($CheckDiskSpace) {
+ Write-Log -Message 'Evaluate disk space requirements.' -Source ${CmdletName}
+ [double]$freeDiskSpace = Get-FreeDiskSpace
+ If ($RequiredDiskSpace -eq 0) {
+ Try {
+ # Determine the size of the Files folder
+ $fso = New-Object -ComObject 'Scripting.FileSystemObject' -ErrorAction 'Stop'
+ $RequiredDiskSpace = [math]::Round((($fso.GetFolder($scriptParentPath).Size) / 1MB))
+ }
+ Catch {
+ Write-Log -Message "Failed to calculate disk space requirement from source files. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ If ($freeDiskSpace -lt $RequiredDiskSpace) {
+ Write-Log -Message "Failed to meet minimum disk space requirement. Space Required [$RequiredDiskSpace MB], Space Available [$freeDiskSpace MB]." -Severity 3 -Source ${CmdletName}
+ If (-not $Silent) {
+ Show-InstallationPrompt -Message ($configDiskSpaceMessage -f $installTitle, $RequiredDiskSpace, ($freeDiskSpace)) -ButtonRightText 'OK' -Icon 'Error'
+ }
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ Else {
+ Write-Log -Message 'Successfully passed minimum disk space requirement check.' -Source ${CmdletName}
+ }
+ }
+
+ If ($CloseApps) {
+ ## Create a Process object with custom descriptions where they are provided (split on an '=' sign)
+ [psobject[]]$processObjects = @()
+ # Split multiple processes on a comma, then split on equal sign, then create custom object with process name and description
+ ForEach ($process in ($CloseApps -split ',' | Where-Object { $_ })) {
+ If ($process.Contains('=')) {
+ [string[]]$ProcessSplit = $process -split '='
+ $processObjects += New-Object -TypeName 'PSObject' -Property @{
+ ProcessName = $ProcessSplit[0]
+ ProcessDescription = $ProcessSplit[1]
+ }
+ }
+ Else {
+ [string]$ProcessInfo = $process
+ $processObjects += New-Object -TypeName 'PSObject' -Property @{
+ ProcessName = $process
+ ProcessDescription = ''
+ }
+ }
+ }
+ }
+
+ ## Check Deferral history and calculate remaining deferrals
+ If (($allowDefer) -or ($AllowDeferCloseApps)) {
+ # Set $allowDefer to true if $AllowDeferCloseApps is true
+ $allowDefer = $true
+
+ # Get the deferral history from the registry
+ $deferHistory = Get-DeferHistory
+ $deferHistoryTimes = $deferHistory | Select-Object -ExpandProperty 'DeferTimesRemaining' -ErrorAction 'SilentlyContinue'
+ $deferHistoryDeadline = $deferHistory | Select-Object -ExpandProperty 'DeferDeadline' -ErrorAction 'SilentlyContinue'
+
+ # Reset Switches
+ $checkDeferDays = $false
+ $checkDeferDeadline = $false
+ If ($DeferDays -ne 0) { $checkDeferDays = $true }
+ If ($DeferDeadline) { $checkDeferDeadline = $true }
+ If ($DeferTimes -ne 0) {
+ If ($deferHistoryTimes -ge 0) {
+ Write-Log -Message "Defer history shows [$($deferHistory.DeferTimesRemaining)] deferrals remaining." -Source ${CmdletName}
+ $DeferTimes = $deferHistory.DeferTimesRemaining - 1
+ }
+ Else {
+ $DeferTimes = $DeferTimes - 1
+ }
+ Write-Log -Message "User has [$deferTimes] deferrals remaining." -Source ${CmdletName}
+ If ($DeferTimes -lt 0) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ Else {
+ If (Test-Path -LiteralPath 'variable:deferTimes') { Remove-Variable -Name 'deferTimes' }
+ $DeferTimes = $null
+ }
+ If ($checkDeferDays -and $allowDefer) {
+ If ($deferHistoryDeadline) {
+ Write-Log -Message "Defer history shows a deadline date of [$deferHistoryDeadline]." -Source ${CmdletName}
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime $deferHistoryDeadline
+ }
+ Else {
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime (Get-Date -Date ((Get-Date).AddDays($deferDays)) -Format ($culture).DateTimeFormat.FullDateTimePattern)
+ }
+ Write-Log -Message "User has until [$deferDeadlineUniversal] before deferral expires." -Source ${CmdletName}
+ If ((Get-UniversalDate) -gt $deferDeadlineUniversal) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ If ($checkDeferDeadline -and $allowDefer) {
+ # Validate Date
+ Try {
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime $deferDeadline -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Date is not in the correct format for the current culture. Type the date in the current locale format, such as 20/08/2014 (Europe) or 08/20/2014 (United States). If the script is intended for multiple cultures, specify the date in the universal sortable date/time format, e.g. '2013-08-22 11:51:52Z'. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Throw "Date is not in the correct format for the current culture. Type the date in the current locale format, such as 20/08/2014 (Europe) or 08/20/2014 (United States). If the script is intended for multiple cultures, specify the date in the universal sortable date/time format, e.g. '2013-08-22 11:51:52Z': $($_.Exception.Message)"
+ }
+ Write-Log -Message "User has until [$deferDeadlineUniversal] remaining." -Source ${CmdletName}
+ If ((Get-UniversalDate) -gt $deferDeadlineUniversal) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ }
+ If (($deferTimes -lt 0) -and (-not ($deferDeadlineUniversal))) { $AllowDefer = $false }
+
+ ## Prompt the user to close running applications and optionally defer if enabled
+ If (-not ($deployModeSilent) -and (-not ($silent))) {
+ If ($forceCloseAppsCountdown -gt 0) {
+ # Keep the same variable for countdown to simplify the code:
+ $closeAppsCountdown = $forceCloseAppsCountdown
+ # Change this variable to a boolean now to switch the countdown on even with deferral
+ [boolean]$forceCloseAppsCountdown = $true
+ }
+ ElseIf ($forceCountdown -gt 0){
+ # Keep the same variable for countdown to simplify the code:
+ $closeAppsCountdown = $forceCountdown
+ # Change this variable to a boolean now to switch the countdown on
+ [boolean]$forceCountdown = $true
+ }
+ Set-Variable -Name 'closeAppsCountdownGlobal' -Value $closeAppsCountdown -Scope 'Script'
+
+ While ((Get-RunningProcesses -ProcessObjects $processObjects -OutVariable 'runningProcesses') -or (($promptResult -ne 'Defer') -and ($promptResult -ne 'Close'))) {
+ [string]$runningProcessDescriptions = ($runningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ # Check if we need to prompt the user to defer, to defer and close apps, or not to prompt them at all
+ If ($allowDefer) {
+ # If there is deferral and closing apps is allowed but there are no apps to be closed, break the while loop
+ If ($AllowDeferCloseApps -and (-not $runningProcessDescriptions)) {
+ Break
+ }
+ # Otherwise, as long as the user has not selected to close the apps or the processes are still running and the user has not selected to continue, prompt user to close running processes with deferral
+ ElseIf (($promptResult -ne 'Close') -or (($runningProcessDescriptions) -and ($promptResult -ne 'Continue'))) {
+ [string]$promptResult = Show-WelcomePrompt -ProcessDescriptions $runningProcessDescriptions -CloseAppsCountdown $closeAppsCountdownGlobal -ForceCloseAppsCountdown $forceCloseAppsCountdown -ForceCountdown $forceCountdown -PersistPrompt $PersistPrompt -AllowDefer -DeferTimes $deferTimes -DeferDeadline $deferDeadlineUniversal -MinimizeWindows $MinimizeWindows -CustomText:$CustomText -TopMost $TopMost
+ }
+ }
+ # If there is no deferral and processes are running, prompt the user to close running processes with no deferral option
+ ElseIf (($runningProcessDescriptions) -or ($forceCountdown)) {
+ [string]$promptResult = Show-WelcomePrompt -ProcessDescriptions $runningProcessDescriptions -CloseAppsCountdown $closeAppsCountdownGlobal -ForceCloseAppsCountdown $forceCloseAppsCountdown -ForceCountdown $forceCountdown -PersistPrompt $PersistPrompt -MinimizeWindows $minimizeWindows -CustomText:$CustomText -TopMost $TopMost
+ }
+ # If there is no deferral and no processes running, break the while loop
+ Else {
+ Break
+ }
+
+ # If the user has clicked OK, wait a few seconds for the process to terminate before evaluating the running processes again
+ If ($promptResult -eq 'Continue') {
+ Write-Log -Message 'User selected to continue...' -Source ${CmdletName}
+ Start-Sleep -Seconds 2
+
+ # Break the while loop if there are no processes to close and the user has clicked OK to continue
+ If (-not $runningProcesses) { Break }
+ }
+ # Force the applications to close
+ ElseIf ($promptResult -eq 'Close') {
+ Write-Log -Message 'User selected to force the application(s) to close...' -Source ${CmdletName}
+ If (($PromptToSave) -and ($SessionZero -and (-not $IsProcessUserInteractive))) {
+ Write-Log -Message 'Specified [-PromptToSave] option will not be available because current process is running in session zero and is not interactive.' -Severity 2 -Source ${CmdletName}
+ }
+
+ ForEach ($runningProcess in $runningProcesses) {
+ [psobject[]]$AllOpenWindowsForRunningProcess = Get-WindowTitle -GetAllWindowTitles -DisableFunctionLogging | Where-Object { $_.ParentProcess -eq $runningProcess.Name }
+ # If the PromptToSave parameter was specified and the process has a window open, then prompt the user to save work if there is work to be saved when closing window
+ If (($PromptToSave) -and (-not ($SessionZero -and (-not $IsProcessUserInteractive))) -and ($AllOpenWindowsForRunningProcess) -and ($runningProcess.MainWindowHandle -ne [IntPtr]::Zero)) {
+ [timespan]$PromptToSaveTimeout = New-TimeSpan -Seconds $configInstallationPromptToSave
+ [Diagnostics.StopWatch]$PromptToSaveStopWatch = [Diagnostics.StopWatch]::StartNew()
+ $PromptToSaveStopWatch.Reset()
+ ForEach ($OpenWindow in $AllOpenWindowsForRunningProcess) {
+ Try {
+ Write-Log -Message "Stop process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)] and prompt to save if there is work to be saved (timeout in [$configInstallationPromptToSave] seconds)..." -Source ${CmdletName}
+ [boolean]$IsBringWindowToFrontSuccess = [PSADT.UiAutomation]::BringWindowToFront($OpenWindow.WindowHandle)
+ [boolean]$IsCloseWindowCallSuccess = $runningProcess.CloseMainWindow()
+ If (-not $IsCloseWindowCallSuccess) {
+ Write-Log -Message "Failed to call the CloseMainWindow() method on process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)] because the main window may be disabled due to a modal dialog being shown." -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ $PromptToSaveStopWatch.Start()
+ Do {
+ [boolean]$IsWindowOpen = [boolean](Get-WindowTitle -GetAllWindowTitles -DisableFunctionLogging | Where-Object { $_.WindowHandle -eq $OpenWindow.WindowHandle })
+ If (-not $IsWindowOpen) { Break }
+ Start-Sleep -Seconds 3
+ } While (($IsWindowOpen) -and ($PromptToSaveStopWatch.Elapsed -lt $PromptToSaveTimeout))
+ $PromptToSaveStopWatch.Reset()
+ If ($IsWindowOpen) {
+ Write-Log -Message "Exceeded the [$configInstallationPromptToSave] seconds timeout value for the user to save work associated with process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Window [$($OpenWindow.WindowTitle)] for process [$($runningProcess.Name)] was successfully closed." -Source ${CmdletName}
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to close window [$($OpenWindow.WindowTitle)] for process [$($runningProcess.Name)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Continue
+ }
+ Finally {
+ $runningProcess.Refresh()
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Stop process $($runningProcess.Name)..." -Source ${CmdletName}
+ Stop-Process -Id $runningProcess.Id -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ Start-Sleep -Seconds 2
+ }
+ # Stop the script (if not actioned before the timeout value)
+ ElseIf ($promptResult -eq 'Timeout') {
+ Write-Log -Message 'Installation not actioned before the timeout value.' -Source ${CmdletName}
+ $BlockExecution = $false
+
+ If (($deferTimes) -or ($deferDeadlineUniversal)) {
+ Set-DeferHistory -DeferTimesRemaining $DeferTimes -DeferDeadline $deferDeadlineUniversal
+ }
+ ## Dispose the welcome prompt timer here because if we dispose it within the Show-WelcomePrompt function we risk resetting the timer and missing the specified timeout period
+ If ($script:welcomeTimer) {
+ Try {
+ $script:welcomeTimer.Dispose()
+ $script:welcomeTimer = $null
+ }
+ Catch { }
+ }
+
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ # Stop the script (user chose to defer)
+ ElseIf ($promptResult -eq 'Defer') {
+ Write-Log -Message 'Installation deferred by the user.' -Source ${CmdletName}
+ $BlockExecution = $false
+
+ Set-DeferHistory -DeferTimesRemaining $DeferTimes -DeferDeadline $deferDeadlineUniversal
+
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+
+ Exit-Script -ExitCode $configInstallationDeferExitCode
+ }
+ }
+ }
+
+ ## Force the processes to close silently, without prompting the user
+ If (($Silent -or $deployModeSilent) -and $CloseApps) {
+ [array]$runningProcesses = $null
+ [array]$runningProcesses = Get-RunningProcesses $processObjects
+ If ($runningProcesses) {
+ [string]$runningProcessDescriptions = ($runningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ Write-Log -Message "Force close application(s) [$($runningProcessDescriptions)] without prompting user." -Source ${CmdletName}
+ $runningProcesses | Stop-Process -Force -ErrorAction 'SilentlyContinue'
+ Start-Sleep -Seconds 2
+ }
+ }
+
+ ## Force nsd.exe to stop if Notes is one of the required applications to close
+ If (($processObjects | Select-Object -ExpandProperty 'ProcessName') -contains 'notes') {
+ ## Get the path where Notes is installed
+ [string]$notesPath = Get-Item -LiteralPath $regKeyLotusNotes -ErrorAction 'SilentlyContinue' | Get-ItemProperty | Select-Object -ExpandProperty 'Path'
+
+ ## Ensure we aren't running as a Local System Account and Notes install directory was found
+ If ((-not $IsLocalSystemAccount) -and ($notesPath)) {
+ # Get a list of all the executables in the Notes folder
+ [string[]]$notesPathExes = Get-ChildItem -LiteralPath $notesPath -Filter '*.exe' -Recurse | Select-Object -ExpandProperty 'BaseName' | Sort-Object
+ ## Check for running Notes executables and run NSD if any are found
+ $notesPathExes | ForEach-Object {
+ If ((Get-Process | Select-Object -ExpandProperty 'Name') -contains $_) {
+ [string]$notesNSDExecutable = Join-Path -Path $notesPath -ChildPath 'NSD.exe'
+ Try {
+ If (Test-Path -LiteralPath $notesNSDExecutable -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "Execute [$notesNSDExecutable] with the -kill argument..." -Source ${CmdletName}
+ [Diagnostics.Process]$notesNSDProcess = Start-Process -FilePath $notesNSDExecutable -ArgumentList '-kill' -WindowStyle 'Hidden' -PassThru -ErrorAction 'SilentlyContinue'
+
+ If (-not ($notesNSDProcess.WaitForExit(10000))) {
+ Write-Log -Message "[$notesNSDExecutable] did not end in a timely manner. Force terminate process." -Source ${CmdletName}
+ Stop-Process -Name 'NSD' -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to launch [$notesNSDExecutable]. `n$(Resolve-Error)" -Source ${CmdletName}
+ }
+
+ Write-Log -Message "[$notesNSDExecutable] returned exit code [$($notesNSDProcess.ExitCode)]." -Source ${CmdletName}
+
+ # Force NSD process to stop in case the previous command was not successful
+ Stop-Process -Name 'NSD' -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+
+ # Strip all Notes processes from the process list except notes.exe, because the other notes processes (e.g. notes2.exe) may be invoked by the Notes installation, so we don't want to block their execution.
+ If ($notesPathExes) {
+ [array]$processesIgnoringNotesExceptions = Compare-Object -ReferenceObject ($processObjects | Select-Object -ExpandProperty 'ProcessName' | Sort-Object) -DifferenceObject $notesPathExes -IncludeEqual | Where-Object { ($_.SideIndicator -eq '<=') -or ($_.InputObject -eq 'notes') } | Select-Object -ExpandProperty 'InputObject'
+ [array]$processObjects = $processObjects | Where-Object { $processesIgnoringNotesExceptions -contains $_.ProcessName }
+ }
+ }
+
+ ## If block execution switch is true, call the function to block execution of these processes
+ If ($BlockExecution) {
+ # Make this variable globally available so we can check whether we need to call Unblock-AppExecution
+ Set-Variable -Name 'BlockExecution' -Value $BlockExecution -Scope 'Script'
+ Write-Log -Message '[-BlockExecution] parameter specified.' -Source ${CmdletName}
+ Block-AppExecution -ProcessName ($processObjects | Select-Object -ExpandProperty 'ProcessName')
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-WelcomePrompt
+Function Show-WelcomePrompt {
+<#
+.SYNOPSIS
+ Called by Show-InstallationWelcome to prompt the user to optionally do the following:
+ 1) Close the specified running applications.
+ 2) Provide an option to defer the installation.
+ 3) Show a countdown before applications are automatically closed.
+.DESCRIPTION
+ The user is presented with a Windows Forms dialog box to close the applications themselves and continue or to have the script close the applications for them.
+ If the -AllowDefer option is set to true, an optional "Defer" button will be shown to the user. If they select this option, the script will exit and return a 1618 code (SCCM fast retry code).
+ The dialog box will timeout after the timeout specified in the XML configuration file (default 1 hour and 55 minutes) to prevent SCCM installations from timing out and returning a failure code to SCCM. When the dialog times out, the script will exit and return a 1618 code (SCCM fast retry code).
+.PARAMETER ProcessDescriptions
+ The descriptive names of the applications that are running and need to be closed.
+.PARAMETER CloseAppsCountdown
+ Specify the countdown time in seconds before running applications are automatically closed when deferral is not allowed or expired.
+.PARAMETER ForceCloseAppsCountdown
+ Specify whether to show the countdown regardless of whether deferral is allowed.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds.
+.PARAMETER AllowDefer
+ Specify whether to provide an option to defer the installation.
+.PARAMETER DeferTimes
+ Specify the number of times the user is allowed to defer.
+.PARAMETER DeferDeadline
+ Specify the deadline date before the user is allowed to defer.
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $true.
+.PARAMETER TopMost
+ Specifies whether the windows is the topmost window. Default: $true.
+.PARAMETER ForceCountdown
+ Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled.
+.PARAMETER CustomText
+ Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+.EXAMPLE
+ Show-WelcomePrompt -ProcessDescriptions 'Lotus Notes, Microsoft Word' -CloseAppsCountdown 600 -AllowDefer -DeferTimes 10
+.NOTES
+ This is an internal script function and should typically not be called directly. It is used by the Show-InstallationWelcome prompt to display a custom prompt.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [string]$ProcessDescriptions,
+ [Parameter(Mandatory=$false)]
+ [int32]$CloseAppsCountdown,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ForceCloseAppsCountdown,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$PersistPrompt = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDefer = $false,
+ [Parameter(Mandatory=$false)]
+ [string]$DeferTimes,
+ [Parameter(Mandatory=$false)]
+ [string]$DeferDeadline,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCountdown = 0,
+ [Parameter(Mandatory=$false)]
+ [switch]$CustomText = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Reset switches
+ [boolean]$showCloseApps = $false
+ [boolean]$showDefer = $false
+ [boolean]$persistWindow = $false
+
+ ## Reset times
+ [datetime]$startTime = Get-Date
+ [datetime]$countdownTime = $startTime
+
+ ## Check if the countdown was specified
+ If ($CloseAppsCountdown) {
+ If ($CloseAppsCountdown -gt $configInstallationUITimeout) {
+ Throw 'The close applications countdown time cannot be longer than the timeout specified in the XML configuration for installation UI dialogs to timeout.'
+ }
+ }
+
+ ## Initial form layout: Close Applications / Allow Deferral
+ If ($processDescriptions) {
+ Write-Log -Message "Prompt user to close application(s) [$processDescriptions]..." -Source ${CmdletName}
+ $showCloseApps = $true
+ }
+ If (($allowDefer) -and (($deferTimes -ge 0) -or ($deferDeadline))) {
+ Write-Log -Message 'User has the option to defer.' -Source ${CmdletName}
+ $showDefer = $true
+ If ($deferDeadline) {
+ # Remove the Z from universal sortable date time format, otherwise it could be converted to a different time zone
+ $deferDeadline = $deferDeadline -replace 'Z',''
+ # Convert the deadline date to a string
+ [string]$deferDeadline = (Get-Date -Date $deferDeadline).ToString()
+ }
+ }
+
+ ## If deferral is being shown and 'close apps countdown' or 'persist prompt' was specified, enable those features.
+ If (-not $showDefer) {
+ If ($closeAppsCountdown -gt 0) {
+ Write-Log -Message "Close applications countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+ }
+ If ($showDefer) {
+ If ($persistPrompt) { $persistWindow = $true }
+ }
+ ## If 'force close apps countdown' was specified, enable that feature.
+ If ($forceCloseAppsCountdown -eq $true) {
+ Write-Log -Message "Close applications countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+ ## If 'force countdown' was specified, enable that feature.
+ If ($forceCountdown -eq $true) {
+ Write-Log -Message "Countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+
+ [string[]]$processDescriptions = $processDescriptions -split ','
+ [Windows.Forms.Application]::EnableVisualStyles()
+
+ $formWelcome = New-Object -TypeName 'System.Windows.Forms.Form'
+ $pictureBanner = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $labelAppName = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelCountdown = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelDefer = New-Object -TypeName 'System.Windows.Forms.Label'
+ $listBoxCloseApps = New-Object -TypeName 'System.Windows.Forms.ListBox'
+ $buttonContinue = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonDefer = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonCloseApps = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonAbort = New-Object -TypeName 'System.Windows.Forms.Button'
+ $formWelcomeWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+ $flowLayoutPanel = New-Object -TypeName 'System.Windows.Forms.FlowLayoutPanel'
+ $panelButtons = New-Object -TypeName 'System.Windows.Forms.Panel'
+ $toolTip = New-Object -TypeName 'System.Windows.Forms.ToolTip'
+
+ ## Remove all event handlers from the controls
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ Try {
+ $labelAppName.remove_Click($handler_labelAppName_Click)
+ $labelDefer.remove_Click($handler_labelDefer_Click)
+ $buttonCloseApps.remove_Click($buttonCloseApps_OnClick)
+ $buttonContinue.remove_Click($buttonContinue_OnClick)
+ $buttonDefer.remove_Click($buttonDefer_OnClick)
+ $buttonAbort.remove_Click($buttonAbort_OnClick)
+ $script:welcomeTimer.remove_Tick($timer_Tick)
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $timerRunningProcesses.remove_Tick($timerRunningProcesses_Tick)
+ $formWelcome.remove_Load($Form_StateCorrection_Load)
+ $formWelcome.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formWelcome.WindowState = 'Normal'
+ $formWelcome.AutoSize = $true
+ $formWelcome.TopMost = $TopMost
+ $formWelcome.BringToFront()
+ # Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formWelcomeStartPosition' -Value $formWelcome.Location -Scope 'Script'
+
+ ## Initialize the countdown timer
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($CloseAppsCountdown)
+ $script:welcomeTimer.Start()
+
+ ## Set up the form
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ [string]$labelCountdownSeconds = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($forceCountdown -eq $true) {
+ If ($deploymentType -ieq 'Install') { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $($configDeploymentTypeInstall.ToLower())) + "`n$labelCountdownSeconds" }
+ Else { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $($configDeploymentTypeUninstall.ToLower())) + "`n$labelCountdownSeconds" }
+ }
+ Else { $labelCountdown.Text = "$configClosePromptCountdownMessage`n$labelCountdownSeconds" }
+ }
+
+ ## Add the timer if it doesn't already exist - this avoids the timer being reset if the continue button is clicked
+ If (-not ($script:welcomeTimer)) {
+ $script:welcomeTimer = New-Object -TypeName 'System.Windows.Forms.Timer'
+ }
+
+ If ($showCountdown) {
+ [scriptblock]$timer_Tick = {
+ ## Get the time information
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($CloseAppsCountdown)
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ Set-Variable -Name 'closeAppsCountdownGlobal' -Value $remainingTime.TotalSeconds -Scope 'Script'
+
+ ## If the countdown is complete, close the application(s) or continue
+ If ($countdownTime -lt $currentTime) {
+ If ($forceCountdown -eq $true) {
+ Write-Log -Message 'Countdown timer has elapsed. Force continue.' -Source ${CmdletName}
+ $buttonContinue.PerformClick()
+ }
+ Else {
+ Write-Log -Message 'Close application(s) countdown timer has elapsed. Force closing application(s).' -Source ${CmdletName}
+ $buttonCloseApps.PerformClick()
+ }
+ }
+ Else {
+ # Update the form
+ [string]$labelCountdownSeconds = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($forceCountdown -eq $true) {
+ If ($deploymentType -ieq 'Install') { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $configDeploymentTypeInstall) + "`n$labelCountdownSeconds" }
+ Else { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $configDeploymentTypeUninstall) + "`n$labelCountdownSeconds" }
+ }
+ Else { $labelCountdown.Text = "$configClosePromptCountdownMessage`n$labelCountdownSeconds" }
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+ }
+ Else {
+ $script:welcomeTimer.Interval = ($configInstallationUITimeout * 1000)
+ [scriptblock]$timer_Tick = { $buttonAbort.PerformClick() }
+ }
+
+ $script:welcomeTimer.add_Tick($timer_Tick)
+
+ ## Persistence Timer
+ If ($persistWindow) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = { Update-InstallationWelcome }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ ## Process Re-Enumeration Timer
+ If ($configInstallationWelcomePromptDynamicRunningProcessEvaluation) {
+ $timerRunningProcesses = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerRunningProcesses.Interval = ($configInstallationWelcomePromptDynamicRunningProcessEvaluationInterval * 1000)
+ [scriptblock]$timerRunningProcesses_Tick = { Get-RunningProcessesDynamically }
+ $timerRunningProcesses.add_Tick($timerRunningProcesses_Tick)
+ $timerRunningProcesses.Start()
+ }
+
+ ## Form
+ $formWelcome.Controls.Add($pictureBanner)
+ $formWelcome.Controls.Add($buttonAbort)
+
+ ##----------------------------------------------
+ ## Create padding object
+ $paddingNone = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $paddingNone.Top = 0
+ $paddingNone.Bottom = 0
+ $paddingNone.Left = 0
+ $paddingNone.Right = 0
+
+ ## Generic Button properties
+ $buttonWidth = 110
+ $buttonHeight = 23
+ $buttonPadding = 50
+ $buttonSize = New-Object -TypeName 'System.Drawing.Size'
+ $buttonSize.Width = $buttonWidth
+ $buttonSize.Height = $buttonHeight
+ $buttonPadding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $buttonPadding.Top = 0
+ $buttonPadding.Bottom = 5
+ $buttonPadding.Left = 50
+ $buttonPadding.Right = 0
+
+ ## Picture Banner
+ $pictureBanner.DataBindings.DefaultDataSourceUpdateMode = 0
+ $pictureBanner.ImageLocation = $appDeployLogoBanner
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $pictureBanner.Location = $System_Drawing_Point
+ $pictureBanner.Name = 'pictureBanner'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 50
+ $System_Drawing_Size.Width = 450
+ $pictureBanner.Size = $System_Drawing_Size
+ $pictureBanner.SizeMode = 'CenterImage'
+ $pictureBanner.Margin = $paddingNone
+ $pictureBanner.TabIndex = 0
+ $pictureBanner.TabStop = $false
+
+ ## Label App Name
+ $labelAppName.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelAppName.Name = 'labelAppName'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ If (-not $showCloseApps) {
+ $System_Drawing_Size.Height = 40
+ }
+ Else {
+ $System_Drawing_Size.Height = 65
+ }
+ $System_Drawing_Size.Width = 450
+ $labelAppName.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelAppName.MaximumSize = $System_Drawing_Size
+ $labelAppName.Margin = '0,15,0,15'
+ $labelAppName.Padding = '20,0,20,0'
+ $labelAppName.TabIndex = 1
+
+ ## Initial form layout: Close Applications / Allow Deferral
+ If ($showCloseApps) {
+ $labelAppNameText = $configClosePromptMessage
+ }
+ ElseIf (($showDefer) -or ($forceCountdown)) {
+ $labelAppNameText = "$configDeferPromptWelcomeMessage `n$installTitle"
+ }
+ If ($CustomText) {
+ $labelAppNameText = "$labelAppNameText `n`n$configWelcomePromptCustomMessage"
+ }
+ $labelAppName.Text = $labelAppNameText
+ $labelAppName.TextAlign = 'TopCenter'
+ $labelAppName.Anchor = 'Top'
+ $labelAppName.AutoSize = $true
+ $labelAppName.add_Click($handler_labelAppName_Click)
+
+ ## Listbox Close Applications
+ $listBoxCloseApps.DataBindings.DefaultDataSourceUpdateMode = 0
+ $listBoxCloseApps.FormattingEnabled = $true
+ $listBoxCloseApps.HorizontalScrollbar = $true
+ $listBoxCloseApps.Name = 'listBoxCloseApps'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 100
+ $System_Drawing_Size.Width = 300
+ $listBoxCloseApps.Size = $System_Drawing_Size
+ $listBoxCloseApps.Margin = '75,0,0,0'
+ $listBoxCloseApps.TabIndex = 3
+ $ProcessDescriptions | ForEach-Object { $null = $listboxCloseApps.Items.Add($_) }
+
+ ## Label Defer
+ $labelDefer.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelDefer.Name = 'labelDefer'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 90
+ $System_Drawing_Size.Width = 450
+ $labelDefer.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelDefer.MaximumSize = $System_Drawing_Size
+ $labelDefer.Margin = $paddingNone
+ $labelDefer.Padding = '40,0,20,0'
+ $labelDefer.TabIndex = 4
+ $deferralText = "$configDeferPromptExpiryMessage`n"
+
+ If ($deferTimes -ge 0) {
+ $deferralText = "$deferralText `n$configDeferPromptRemainingDeferrals $([int32]$deferTimes + 1)"
+ }
+ If ($deferDeadline) {
+ $deferralText = "$deferralText `n$configDeferPromptDeadline $deferDeadline"
+ }
+ If (($deferTimes -lt 0) -and (-not $DeferDeadline)) {
+ $deferralText = "$deferralText `n$configDeferPromptNoDeadline"
+ }
+ $deferralText = "$deferralText `n`n$configDeferPromptWarningMessage"
+ $labelDefer.Text = $deferralText
+ $labelDefer.TextAlign = 'MiddleCenter'
+ $labelDefer.AutoSize = $true
+ $labelDefer.add_Click($handler_labelDefer_Click)
+
+ ## Label Countdown
+ $labelCountdown.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelCountdown.Name = 'labelCountdown'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 40
+ $System_Drawing_Size.Width = 450
+ $labelCountdown.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelCountdown.MaximumSize = $System_Drawing_Size
+ $labelCountdown.Margin = $paddingNone
+ $labelCountdown.Padding = '40,0,20,0'
+ $labelCountdown.TabIndex = 4
+ $labelCountdown.Font = 'Microsoft Sans Serif, 9pt, style=Bold'
+ $labelCountdown.Text = '00:00:00'
+ $labelCountdown.TextAlign = 'MiddleCenter'
+ $labelCountdown.AutoSize = $true
+ $labelCountdown.add_Click($handler_labelDefer_Click)
+
+ ## Panel Flow Layout
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 50
+ $flowLayoutPanel.Location = $System_Drawing_Point
+ $flowLayoutPanel.AutoSize = $true
+ $flowLayoutPanel.Anchor = 'Top'
+ $flowLayoutPanel.FlowDirection = 'TopDown'
+ $flowLayoutPanel.WrapContents = $true
+ $flowLayoutPanel.Controls.Add($labelAppName)
+ If ($showCloseApps) { $flowLayoutPanel.Controls.Add($listBoxCloseApps) }
+ If ($showDefer) {
+ $flowLayoutPanel.Controls.Add($labelDefer)
+ }
+ If ($showCountdown) {
+ $flowLayoutPanel.Controls.Add($labelCountdown)
+ }
+
+ ## Button Close For Me
+ $buttonCloseApps.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonCloseApps.Location = '15,0'
+ $buttonCloseApps.Name = 'buttonCloseApps'
+ $buttonCloseApps.Size = $buttonSize
+ $buttonCloseApps.TabIndex = 5
+ $buttonCloseApps.Text = $configClosePromptButtonClose
+ $buttonCloseApps.DialogResult = 'Yes'
+ $buttonCloseApps.AutoSize = $true
+ $buttonCloseApps.UseVisualStyleBackColor = $true
+ $buttonCloseApps.add_Click($buttonCloseApps_OnClick)
+
+ ## Button Defer
+ $buttonDefer.DataBindings.DefaultDataSourceUpdateMode = 0
+ If (-not $showCloseApps) {
+ $buttonDefer.Location = '15,0'
+ }
+ Else {
+ $buttonDefer.Location = '170,0'
+ }
+ $buttonDefer.Name = 'buttonDefer'
+ $buttonDefer.Size = $buttonSize
+ $buttonDefer.TabIndex = 6
+ $buttonDefer.Text = $configClosePromptButtonDefer
+ $buttonDefer.DialogResult = 'No'
+ $buttonDefer.AutoSize = $true
+ $buttonDefer.UseVisualStyleBackColor = $true
+ $buttonDefer.add_Click($buttonDefer_OnClick)
+
+ ## Button Continue
+ $buttonContinue.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonContinue.Location = '325,0'
+ $buttonContinue.Name = 'buttonContinue'
+ $buttonContinue.Size = $buttonSize
+ $buttonContinue.TabIndex = 7
+ $buttonContinue.Text = $configClosePromptButtonContinue
+ $buttonContinue.DialogResult = 'OK'
+ $buttonContinue.AutoSize = $true
+ $buttonContinue.UseVisualStyleBackColor = $true
+ $buttonContinue.add_Click($buttonContinue_OnClick)
+ If ($showCloseApps) {
+ # Add tooltip to Continue button
+ $toolTip.BackColor = [Drawing.Color]::LightGoldenrodYellow
+ $toolTip.IsBalloon = $false
+ $toolTip.InitialDelay = 100
+ $toolTip.ReshowDelay = 100
+ $toolTip.SetToolTip($buttonContinue, $configClosePromptButtonContinueTooltip)
+ }
+
+ ## Button Abort (Hidden)
+ $buttonAbort.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonAbort.Name = 'buttonAbort'
+ $buttonAbort.Size = '1,1'
+ $buttonAbort.TabStop = $false
+ $buttonAbort.DialogResult = 'Abort'
+ $buttonAbort.TabIndex = 5
+ $buttonAbort.UseVisualStyleBackColor = $true
+ $buttonAbort.add_Click($buttonAbort_OnClick)
+
+ ## Form Welcome
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 0
+ $System_Drawing_Size.Width = 0
+ $formWelcome.Size = $System_Drawing_Size
+ $formWelcome.Padding = $paddingNone
+ $formWelcome.Margin = $paddingNone
+ $formWelcome.DataBindings.DefaultDataSourceUpdateMode = 0
+ $formWelcome.Name = 'WelcomeForm'
+ $formWelcome.Text = $installTitle
+ $formWelcome.StartPosition = 'CenterScreen'
+ $formWelcome.FormBorderStyle = 'FixedDialog'
+ $formWelcome.MaximizeBox = $false
+ $formWelcome.MinimizeBox = $false
+ $formWelcome.TopMost = $TopMost
+ $formWelcome.TopLevel = $true
+ $formWelcome.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formWelcome.AutoSize = $true
+ $formWelcome.Controls.Add($pictureBanner)
+ $formWelcome.Controls.Add($flowLayoutPanel)
+
+ ## Panel Button
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ # Calculate the position of the panel relative to the size of the form
+ $System_Drawing_Point.Y = (($formWelcome.Size | Select-Object -ExpandProperty 'Height') - 10)
+ $panelButtons.Location = $System_Drawing_Point
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 40
+ $System_Drawing_Size.Width = 450
+ $panelButtons.Size = $System_Drawing_Size
+ $panelButtons.AutoSize = $true
+ $panelButtons.Anchor = 'Top'
+ $padding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $padding.Top = 0
+ $padding.Bottom = 0
+ $padding.Left = 0
+ $padding.Right = 0
+ $panelButtons.Margin = $padding
+ If ($showCloseApps) { $panelButtons.Controls.Add($buttonCloseApps) }
+ If ($showDefer) { $panelButtons.Controls.Add($buttonDefer) }
+ $panelButtons.Controls.Add($buttonContinue)
+
+ ## Add the Buttons Panel to the form
+ $formWelcome.Controls.Add($panelButtons)
+
+ ## Save the initial state of the form
+ $formWelcomeWindowState = $formWelcome.WindowState
+ # Init the OnLoad event to correct the initial state of the form
+ $formWelcome.add_Load($Form_StateCorrection_Load)
+ # Clean up the control events
+ $formWelcome.add_FormClosed($Form_Cleanup_FormClosed)
+
+ Function Update-InstallationWelcome {
+ $formWelcome.BringToFront()
+ $formWelcome.Location = "$($formWelcomeStartPosition.X),$($formWelcomeStartPosition.Y)"
+ $formWelcome.Refresh()
+ }
+
+ # Function invoked by a timer to periodically check running processes dynamically whilst showing the welcome prompt
+ Function Get-RunningProcessesDynamically {
+ $dynamicRunningProcesses = $null
+ Get-RunningProcesses -ProcessObjects $processObjects -DisableLogging -OutVariable 'dynamicRunningProcesses'
+ [string]$dynamicRunningProcessDescriptions = ($dynamicRunningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ If ($dynamicRunningProcessDescriptions -ne $script:runningProcessDescriptions) {
+ # Update the runningProcessDescriptions variable for the next time this function runs
+ Set-Variable -Name 'runningProcessDescriptions' -Value $dynamicRunningProcessDescriptions -Force -Scope 'Script'
+ If ($dynamicrunningProcesses) {
+ Write-Log -Message "The running processes have changed. Updating the apps to close: [$script:runningProcessDescriptions]..." -Source ${CmdletName}
+ }
+ # Update the list box with the processes to close
+ $listboxCloseApps.Items.Clear()
+ $script:runningProcessDescriptions -split "," | ForEach-Object { $null = $listboxCloseApps.Items.Add($_) }
+ }
+ # If CloseApps processes were running when the prompt was shown, and they are subsequently detected to be closed while the form is showing, then close the form. The deferral and CloseApps conditions will be re-evaluated.
+ If ($ProcessDescriptions) {
+ If (-not ($dynamicRunningProcesses)) {
+ Write-Log -Message 'Previously detected running processes are no longer running.' -Source ${CmdletName}
+ $formWelcome.Dispose()
+ }
+ }
+ # If CloseApps processes were not running when the prompt was shown, and they are subsequently detected to be running while the form is showing, then close the form for relaunch. The deferral and CloseApps conditions will be re-evaluated.
+ ElseIf (-not $ProcessDescriptions) {
+ If ($dynamicRunningProcesses) {
+ Write-Log -Message 'New running processes detected. Updating the form to prompt to close the running applications.' -Source ${CmdletName}
+ $formWelcome.Dispose()
+ }
+ }
+ }
+
+ ## Minimize all other windows
+ If ($minimizeWindows) { $null = $shellApp.MinimizeAll() }
+
+ ## Show the form
+ $result = $formWelcome.ShowDialog()
+ $formWelcome.Dispose()
+
+ Switch ($result) {
+ OK { $result = 'Continue' }
+ No { $result = 'Defer' }
+ Yes { $result = 'Close' }
+ Abort { $result = 'Timeout' }
+ }
+
+ Write-Output -InputObject $result
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationRestartPrompt
+Function Show-InstallationRestartPrompt {
+<#
+.SYNOPSIS
+ Displays a restart prompt with a countdown to a forced restart.
+.DESCRIPTION
+ Displays a restart prompt with a countdown to a forced restart.
+.PARAMETER CountdownSeconds
+ Specifies the number of seconds to countdown before the system restart.
+.PARAMETER CountdownNoHideSeconds
+ Specifies the number of seconds to display the restart prompt without allowing the window to be hidden.
+.PARAMETER NoCountdown
+ Specifies not to show a countdown, just the Restart Now and Restart Later buttons.
+ The UI will restore/reposition itself persistently based on the interval value specified in the config file.
+.EXAMPLE
+ Show-InstallationRestartPrompt -Countdownseconds 600 -CountdownNoHideSeconds 60
+.EXAMPLE
+ Show-InstallationRestartPrompt -NoCountdown
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CountdownSeconds = 60,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CountdownNoHideSeconds = 30,
+ [Parameter(Mandatory=$false)]
+ [switch]$NoCountdown = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in non-interactive mode
+ If ($deployModeSilent) {
+ Write-Log -Message "Bypass Installation Restart Prompt [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+ ## Get the parameters passed to the function for invoking the function asynchronously
+ [hashtable]$installRestartPromptParameters = $psBoundParameters
+
+ ## Check if we are already displaying a restart prompt
+ If (Get-Process | Where-Object { $_.MainWindowTitle -match $configRestartPromptTitle }) {
+ Write-Log -Message "${CmdletName} was invoked, but an existing restart prompt was detected. Cancelling restart prompt." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ [datetime]$startTime = Get-Date
+ [datetime]$countdownTime = $startTime
+
+ [Windows.Forms.Application]::EnableVisualStyles()
+ $formRestart = New-Object -TypeName 'System.Windows.Forms.Form'
+ $labelCountdown = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelTimeRemaining = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelMessage = New-Object -TypeName 'System.Windows.Forms.Label'
+ $buttonRestartLater = New-Object -TypeName 'System.Windows.Forms.Button'
+ $picturebox = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $buttonRestartNow = New-Object -TypeName 'System.Windows.Forms.Button'
+ $timerCountdown = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $InitialFormWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ [scriptblock]$RestartComputer = {
+ Write-Log -Message 'Force restart the computer...' -Source ${CmdletName}
+ Restart-Computer -Force
+ }
+
+ [scriptblock]$FormEvent_Load = {
+ ## Initialize the countdown timer
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($countdownSeconds)
+ $timerCountdown.Start()
+ ## Set up the form
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ $labelCountdown.Text = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($remainingTime.TotalSeconds -le $countdownNoHideSeconds) { $buttonRestartLater.Enabled = $false }
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formRestart.WindowState = $InitialFormWindowState
+ $formRestart.AutoSize = $true
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ ## Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formInstallationRestartPromptStartPosition' -Value $formRestart.Location -Scope 'Script'
+ }
+
+ ## Persistence Timer
+ If ($NoCountdown) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationRestartPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = {
+ # Show the Restart Popup
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ $formRestart.Location = "$($formInstallationRestartPromptStartPosition.X),$($formInstallationRestartPromptStartPosition.Y)"
+ $formRestart.Refresh()
+ [Windows.Forms.Application]::DoEvents()
+ }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ [scriptblock]$buttonRestartLater_Click = {
+ ## Minimize the form
+ $formRestart.WindowState = 'Minimized'
+ If ($NoCountdown) {
+ ## Reset the persistence timer
+ $timerPersist.Stop()
+ $timerPersist.Start()
+ }
+ }
+
+ ## Restart the computer
+ [scriptblock]$buttonRestartNow_Click = { & $RestartComputer }
+
+ ## Hide the form if minimized
+ [scriptblock]$formRestart_Resize = { If ($formRestart.WindowState -eq 'Minimized') { $formRestart.WindowState = 'Minimized' } }
+
+ [scriptblock]$timerCountdown_Tick = {
+ ## Get the time information
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($countdownSeconds)
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ ## If the countdown is complete, restart the machine
+ If ($countdownTime -lt $currentTime) {
+ $buttonRestartNow.PerformClick()
+ }
+ Else {
+ ## Update the form
+ $labelCountdown.Text = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($remainingTime.TotalSeconds -le $countdownNoHideSeconds) {
+ $buttonRestartLater.Enabled = $false
+ # If the form is hidden when we hit the "No Hide", bring it back up
+ If ($formRestart.WindowState -eq 'Minimized') {
+ # Show Popup
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ $formRestart.Location = "$($formInstallationRestartPromptStartPosition.X),$($formInstallationRestartPromptStartPosition.Y)"
+ $formRestart.Refresh()
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+
+ ## Remove all event handlers from the controls
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ Try {
+ $buttonRestartLater.remove_Click($buttonRestartLater_Click)
+ $buttonRestartNow.remove_Click($buttonRestartNow_Click)
+ $formRestart.remove_Load($FormEvent_Load)
+ $formRestart.remove_Resize($formRestart_Resize)
+ $timerCountdown.remove_Tick($timerCountdown_Tick)
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $formRestart.remove_Load($Form_StateCorrection_Load)
+ $formRestart.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ ## Form
+ If (-not $NoCountdown) {
+ $formRestart.Controls.Add($labelCountdown)
+ $formRestart.Controls.Add($labelTimeRemaining)
+ }
+ $formRestart.Controls.Add($labelMessage)
+ $formRestart.Controls.Add($buttonRestartLater)
+ $formRestart.Controls.Add($picturebox)
+ $formRestart.Controls.Add($buttonRestartNow)
+ $formRestart.ClientSize = '450,260'
+ $formRestart.ControlBox = $false
+ $formRestart.FormBorderStyle = 'FixedDialog'
+ $formRestart.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formRestart.MaximizeBox = $false
+ $formRestart.MinimizeBox = $false
+ $formRestart.Name = 'formRestart'
+ $formRestart.StartPosition = 'CenterScreen'
+ $formRestart.Text = "$($configRestartPromptTitle): $installTitle"
+ $formRestart.add_Load($FormEvent_Load)
+ $formRestart.add_Resize($formRestart_Resize)
+
+ ## Banner
+ $picturebox.Anchor = 'Top'
+ $picturebox.Image = [Drawing.Image]::Fromfile($AppDeployLogoBanner)
+ $picturebox.Location = '0,0'
+ $picturebox.Name = 'picturebox'
+ $picturebox.Size = '450,50'
+ $picturebox.SizeMode = 'CenterImage'
+ $picturebox.TabIndex = 1
+ $picturebox.TabStop = $false
+
+ ## Label Message
+ $labelMessage.Location = '20,58'
+ $labelMessage.Name = 'labelMessage'
+ $labelMessage.Size = '400,79'
+ $labelMessage.TabIndex = 3
+ $labelMessage.Text = "$configRestartPromptMessage $configRestartPromptMessageTime `n`n$configRestartPromptMessageRestart"
+ If ($NoCountdown) { $labelMessage.Text = $configRestartPromptMessage }
+ $labelMessage.TextAlign = 'MiddleCenter'
+
+ ## Label Time Remaining
+ $labelTimeRemaining.Location = '20,138'
+ $labelTimeRemaining.Name = 'labelTimeRemaining'
+ $labelTimeRemaining.Size = '400,23'
+ $labelTimeRemaining.TabIndex = 4
+ $labelTimeRemaining.Text = $configRestartPromptTimeRemaining
+ $labelTimeRemaining.TextAlign = 'MiddleCenter'
+
+ ## Label Countdown
+ $labelCountdown.Font = 'Microsoft Sans Serif, 18pt, style=Bold'
+ $labelCountdown.Location = '20,165'
+ $labelCountdown.Name = 'labelCountdown'
+ $labelCountdown.Size = '400,30'
+ $labelCountdown.TabIndex = 5
+ $labelCountdown.Text = '00:00:00'
+ $labelCountdown.TextAlign = 'MiddleCenter'
+
+ ## Label Restart Later
+ $buttonRestartLater.Anchor = 'Bottom,Left'
+ $buttonRestartLater.Location = '20,216'
+ $buttonRestartLater.Name = 'buttonRestartLater'
+ $buttonRestartLater.Size = '159,23'
+ $buttonRestartLater.TabIndex = 0
+ $buttonRestartLater.Text = $configRestartPromptButtonRestartLater
+ $buttonRestartLater.UseVisualStyleBackColor = $true
+ $buttonRestartLater.add_Click($buttonRestartLater_Click)
+
+ ## Label Restart Now
+ $buttonRestartNow.Anchor = 'Bottom,Right'
+ $buttonRestartNow.Location = '265,216'
+ $buttonRestartNow.Name = 'buttonRestartNow'
+ $buttonRestartNow.Size = '159,23'
+ $buttonRestartNow.TabIndex = 2
+ $buttonRestartNow.Text = $configRestartPromptButtonRestartNow
+ $buttonRestartNow.UseVisualStyleBackColor = $true
+ $buttonRestartNow.add_Click($buttonRestartNow_Click)
+
+ ## Timer Countdown
+ If (-not $NoCountdown) { $timerCountdown.add_Tick($timerCountdown_Tick) }
+
+ ##----------------------------------------------
+
+ ## Save the initial state of the form
+ $InitialFormWindowState = $formRestart.WindowState
+ # Init the OnLoad event to correct the initial state of the form
+ $formRestart.add_Load($Form_StateCorrection_Load)
+ # Clean up the control events
+ $formRestart.add_FormClosed($Form_Cleanup_FormClosed)
+ $formRestartClosing = [Windows.Forms.FormClosingEventHandler]{ If ($_.CloseReason -eq 'UserClosing') { $_.Cancel = $true } }
+ $formRestart.add_FormClosing($formRestartClosing)
+
+ ## If the script has been dot-source invoked by the deploy app script, display the restart prompt asynchronously
+ If ($deployAppScriptFriendlyName) {
+ If ($NoCountdown) {
+ Write-Log -Message "Invoking ${CmdletName} asynchronously with no countdown..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Invoking ${CmdletName} asynchronously with a [$countDownSeconds] second countdown..." -Source ${CmdletName}
+ }
+ [string]$installRestartPromptParameters = ($installRestartPromptParameters.GetEnumerator() | ForEach-Object {
+ If ($_.Value.GetType().Name -eq 'SwitchParameter') {
+ "-$($_.Key)"
+ }
+ ElseIf ($_.Value.GetType().Name -eq 'Boolean') {
+ "-$($_.Key) `$" + "$($_.Value)".ToLower()
+ }
+ ElseIf ($_.Value.GetType().Name -eq 'Int32') {
+ "-$($_.Key) $($_.Value)"
+ }
+ Else {
+ "-$($_.Key) `"$($_.Value)`""
+ }
+ }) -join ' '
+ Start-Process -FilePath "$PSHOME\powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$scriptPath`" -ReferredInstallTitle `"$installTitle`" -ReferredInstallName `"$installName`" -ReferredLogName `"$logName`" -ShowInstallationRestartPrompt $installRestartPromptParameters -AsyncToolkitLaunch" -WindowStyle 'Hidden' -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ If ($NoCountdown) {
+ Write-Log -Message 'Display restart prompt with no countdown.' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Display restart prompt with a [$countDownSeconds] second countdown." -Source ${CmdletName}
+ }
+
+ # Show the Form
+ Write-Output -InputObject $formRestart.ShowDialog()
+ $formRestart.Dispose()
+
+ # Activate the Window
+ [Diagnostics.Process]$powershellProcess = Get-Process | Where-Object { $_.MainWindowTitle -match $installTitle }
+ [Microsoft.VisualBasic.Interaction]::AppActivate($powershellProcess.ID)
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-BalloonTip
+Function Show-BalloonTip {
+<#
+.SYNOPSIS
+ Displays a balloon tip notification in the system tray.
+.DESCRIPTION
+ Displays a balloon tip notification in the system tray.
+.PARAMETER BalloonTipText
+ Text of the balloon tip.
+.PARAMETER BalloonTipTitle
+ Title of the balloon tip.
+.PARAMETER BalloonTipIcon
+ Icon to be used. Options: 'Error', 'Info', 'None', 'Warning'. Default is: Info.
+.PARAMETER BalloonTipTime
+ Time in milliseconds to display the balloon tip. Default: 500.
+.EXAMPLE
+ Show-BalloonTip -BalloonTipText 'Installation Started' -BalloonTipTitle 'Application Name'
+.EXAMPLE
+ Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText 'Installation Started' -BalloonTipTitle 'Application Name' -BalloonTipTime 1000
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullOrEmpty()]
+ [string]$BalloonTipText,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$BalloonTipTitle = $installTitle,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateSet('Error','Info','None','Warning')]
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = 'Info',
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [int32]$BalloonTipTime = 10000
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Skip balloon if in silent mode
+ If (($deployModeSilent) -or (-not $configShowBalloonNotifications) -or (Test-PowerPoint)) { Return }
+
+ ## Dispose of previous balloon
+ If ($script:notifyIcon) { Try { $script:notifyIcon.Dispose() } Catch {} }
+
+ ## Get the calling function so we know when to display the exiting balloon tip notification in an asynchronous script
+ Try { [string]$callingFunction = (Get-Variable -Name MyInvocation -Scope 1).Value.Mycommand.Name } Catch { }
+
+ If ($callingFunction -eq 'Exit-Script') {
+ Write-Log -Message "Display balloon tip notification asynchronously with message [$BalloonTipText]." -Source ${CmdletName}
+ ## Create a script block to display the balloon notification in a new PowerShell process so that we can wait to cleanly dispose of the balloon tip without having to make the deployment script wait
+ [scriptblock]$notifyIconScriptBlock = {
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullOrEmpty()]
+ [string]$BalloonTipText,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$BalloonTipTitle,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateSet('Error','Info','None','Warning')]
+ $BalloonTipIcon, # Don't strongly type variable as System.Drawing; assembly not loaded yet in asynchronous scriptblock so will throw error
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [int32]$BalloonTipTime,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [string]$AppDeployLogoIcon
+ )
+
+ ## Load assembly containing class System.Windows.Forms and System.Drawing
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'System.Drawing' -ErrorAction 'Stop'
+
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = $BalloonTipIcon
+ $script:notifyIcon = New-Object -TypeName 'System.Windows.Forms.NotifyIcon' -Property @{
+ BalloonTipIcon = $BalloonTipIcon
+ BalloonTipText = $BalloonTipText
+ BalloonTipTitle = $BalloonTipTitle
+ Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ Text = -join $BalloonTipText[0..62]
+ Visible = $true
+ }
+
+ ## Display the balloon tip notification asynchronously
+ $script:NotifyIcon.ShowBalloonTip($BalloonTipTime)
+
+ ## Keep the asynchronous PowerShell process running so that we can dispose of the balloon tip icon
+ Start-Sleep -Milliseconds ($BalloonTipTime)
+ $script:notifyIcon.Dispose()
+ }
+
+ ## Invoke a separate PowerShell process passing the script block as a command and associated parameters to display the balloon tip notification asynchronously
+ Try {
+ Execute-Process -Path "$PSHOME\powershell.exe" -Parameters "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -Command & {$notifyIconScriptBlock} '$BalloonTipText' '$BalloonTipTitle' '$BalloonTipIcon' '$BalloonTipTime' '$AppDeployLogoIcon'" -NoWait -WindowStyle 'Hidden' -CreateNoWindow
+ }
+ Catch { }
+ }
+ ## Otherwise create the balloontip icon synchronously
+ Else {
+ Write-Log -Message "Display balloon tip notification with message [$BalloonTipText]." -Source ${CmdletName}
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = $BalloonTipIcon
+ $script:notifyIcon = New-Object -TypeName 'System.Windows.Forms.NotifyIcon' -Property @{
+ BalloonTipIcon = $BalloonTipIcon
+ BalloonTipText = $BalloonTipText
+ BalloonTipTitle = $BalloonTipTitle
+ Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ Text = -join $BalloonTipText[0..62]
+ Visible = $true
+ }
+
+ ## Display the balloon tip notification
+ $script:NotifyIcon.ShowBalloonTip($BalloonTipTime)
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationProgress
+Function Show-InstallationProgress {
+<#
+.SYNOPSIS
+ Displays a progress dialog in a separate thread with an updateable custom message.
+.DESCRIPTION
+ Create a WPF window in a separate thread to display a marquee style progress ellipse with a custom message that can be updated.
+ The status message supports line breaks.
+ The first time this function is called in a script, it will display a balloon tip notification to indicate that the installation has started (provided balloon tips are enabled in the configuration).
+.PARAMETER StatusMessage
+ The status message to be displayed. The default status message is taken from the XML configuration file.
+.PARAMETER WindowLocation
+ The location of the progress window. Default: just below top, centered.
+.PARAMETER TopMost
+ Specifies whether the progress window should be topmost. Default: $true.
+.EXAMPLE
+ Show-InstallationProgress
+ Uses the default status message from the XML configuration file.
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage 'Installation in Progress...'
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage "Installation in Progress...`nThe installation may take 20 minutes to complete."
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage 'Installation in Progress...' -WindowLocation 'BottomRight' -TopMost $false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$StatusMessage = $configProgressMessageInstall,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Default','BottomRight')]
+ [string]$WindowLocation = 'Default',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($deployModeSilent) { Return }
+
+ ## If the default progress message hasn't been overridden and the deployment type is uninstall, use the default uninstallation message
+ If (($StatusMessage -eq $configProgressMessageInstall) -and ($deploymentType -eq 'Uninstall')) {
+ $StatusMessage = $configProgressMessageUninstall
+ }
+
+ If ($envHost.Name -match 'PowerGUI') {
+ Write-Log -Message "$($envHost.Name) is not a supported host for WPF multi-threading. Progress dialog with message [$statusMessage] will not be displayed." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ ## Check if the progress thread is running before invoking methods on it
+ If ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -ne 'Running') {
+ # Notify user that the software installation has started
+ $balloonText = "$deploymentTypeName $configBalloonTextStart"
+ Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText $balloonText
+ # Create a synchronized hashtable to share objects between runspaces
+ $script:ProgressSyncHash = [hashtable]::Synchronized(@{ })
+ # Create a new runspace for the progress bar
+ $script:ProgressRunspace = [runspacefactory]::CreateRunspace()
+ $script:ProgressRunspace.ApartmentState = 'STA'
+ $script:ProgressRunspace.ThreadOptions = 'ReuseThread'
+ $script:ProgressRunspace.Open()
+ # Add the sync hash to the runspace
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('progressSyncHash', $script:ProgressSyncHash)
+ # Add other variables from the parent thread required in the progress runspace
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('installTitle', $installTitle)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('windowLocation', $windowLocation)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('topMost', $topMost.ToString())
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('appDeployLogoBanner', $appDeployLogoBanner)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('progressStatusMessage', $statusMessage)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('AppDeployLogoIcon', $AppDeployLogoIcon)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('dpiScale', $dpiScale)
+
+ # Add the script block to be executed in the progress runspace
+ $progressCmd = [PowerShell]::Create().AddScript({
+ [Xml.XmlDocument]$xamlProgress = @'
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+'@
+
+ ## Set the configurable values using variables added to the runspace from the parent thread
+ # Calculate the position on the screen where the progress dialog should be placed
+ $screen = [Windows.Forms.Screen]::PrimaryScreen
+ $screenWorkingArea = $screen.WorkingArea
+ [int32]$screenWidth = $screenWorkingArea | Select-Object -ExpandProperty 'Width'
+ [int32]$screenHeight = $screenWorkingArea | Select-Object -ExpandProperty 'Height'
+ # Set the start position of the Window based on the screen size
+ If ($windowLocation -eq 'BottomRight') {
+ $xamlProgress.Window.Left = [string](($screenWidth / ($dpiscale / 100)) - ($xamlProgress.Window.Width))
+ $xamlProgress.Window.Top = [string](($screenHeight / ($dpiscale / 100)) - ($xamlProgress.Window.Height))
+ }
+ # Show the default location (Top center)
+ Else {
+ # Center the progress window by calculating the center of the workable screen based on the width of the screen relative to the DPI scale minus half the width of the progress bar
+ $xamlProgress.Window.Left = [string](($screenWidth / (2 * ($dpiscale / 100) )) - (($xamlProgress.Window.Width / 2)))
+ $xamlProgress.Window.Top = [string]($screenHeight / 9.5)
+ }
+ $xamlProgress.Window.TopMost = $topMost
+ $xamlProgress.Window.Icon = $AppDeployLogoIcon
+ $xamlProgress.Window.Grid.Image.Source = $appDeployLogoBanner
+ $xamlProgress.Window.Grid.TextBlock.Text = $ProgressStatusMessage
+ $xamlProgress.Window.Title = $installTitle
+ # Parse the XAML
+ $progressReader = New-Object -TypeName 'System.Xml.XmlNodeReader' -ArgumentList $xamlProgress
+ $script:ProgressSyncHash.Window = [Windows.Markup.XamlReader]::Load($progressReader)
+ $script:ProgressSyncHash.ProgressText = $script:ProgressSyncHash.Window.FindName('ProgressText')
+ # Add an action to the Window.Closing event handler to disable the close button
+ $script:ProgressSyncHash.Window.Add_Closing({ $_.Cancel = $true })
+ # Allow the window to be dragged by clicking on it anywhere
+ $script:ProgressSyncHash.Window.Add_MouseLeftButtonDown({ $script:ProgressSyncHash.Window.DragMove() })
+ # Add a tooltip
+ $script:ProgressSyncHash.Window.ToolTip = $installTitle
+ $null = $script:ProgressSyncHash.Window.ShowDialog()
+ $script:ProgressSyncHash.Error = $Error
+ })
+
+ $progressCmd.Runspace = $script:ProgressRunspace
+ Write-Log -Message "Spin up progress dialog in a separate thread with message: [$statusMessage]." -Source ${CmdletName}
+ # Invoke the progress runspace
+ $progressData = $progressCmd.BeginInvoke()
+ # Allow the thread to be spun up safely before invoking actions against it.
+ Start-Sleep -Seconds 1
+ If ($script:ProgressSyncHash.Error) {
+ Write-Log -Message "Failure while displaying progress dialog. `n$(Resolve-Error -ErrorRecord $script:ProgressSyncHash.Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ ## Check if the progress thread is running before invoking methods on it
+ ElseIf ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -eq 'Running') {
+ # Update the progress text
+ Try {
+ $script:ProgressSyncHash.Window.Dispatcher.Invoke([Windows.Threading.DispatcherPriority]'Send', [Windows.Input.InputEventHandler]{ $script:ProgressSyncHash.ProgressText.Text = $statusMessage }, $null, $null)
+ Write-Log -Message "Updated progress message: [$statusMessage]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Unable to update the progress message. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Close-InstallationProgress
+Function Close-InstallationProgress {
+<#
+.SYNOPSIS
+ Closes the dialog created by Show-InstallationProgress.
+.DESCRIPTION
+ Closes the dialog created by Show-InstallationProgress.
+ This function is called by the Exit-Script function to close a running instance of the progress dialog if found.
+.EXAMPLE
+ Close-InstallationProgress
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -eq 'Running') {
+ ## Close the progress thread
+ Write-Log -Message 'Close the installation progress dialog.' -Source ${CmdletName}
+ $script:ProgressSyncHash.Window.Dispatcher.InvokeShutdown()
+ $script:ProgressSyncHash.Clear()
+ $script:ProgressRunspace.Close()
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-PinnedApplication
+Function Set-PinnedApplication {
+<#
+.SYNOPSIS
+ Pins or unpins a shortcut to the start menu or task bar.
+.DESCRIPTION
+ Pins or unpins a shortcut to the start menu or task bar.
+ This should typically be run in the user context, as pinned items are stored in the user profile.
+.PARAMETER Action
+ Action to be performed. Options: 'PintoStartMenu','UnpinfromStartMenu','PintoTaskbar','UnpinfromTaskbar'.
+.PARAMETER FilePath
+ Path to the shortcut file to be pinned or unpinned.
+.EXAMPLE
+ Set-PinnedApplication -Action 'PintoStartMenu' -FilePath "$envProgramFilesX86\IBM\Lotus\Notes\notes.exe"
+.EXAMPLE
+ Set-PinnedApplication -Action 'UnpinfromTaskbar' -FilePath "$envProgramFilesX86\IBM\Lotus\Notes\notes.exe"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('PintoStartMenu','UnpinfromStartMenu','PintoTaskbar','UnpinfromTaskbar')]
+ [string]$Action,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ #region Function Get-PinVerb
+ Function Get-PinVerb {
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [int32]$VerbId
+ )
+
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-Log -Message "Get localized pin verb for verb id [$VerbID]." -Source ${CmdletName}
+ [string]$PinVerb = [PSADT.FileVerb]::GetPinVerb($VerbId)
+ Write-Log -Message "Verb ID [$VerbID] has a localized pin verb of [$PinVerb]." -Source ${CmdletName}
+ Write-Output -InputObject $PinVerb
+ }
+ #endregion
+
+ #region Function Invoke-Verb
+ Function Invoke-Verb {
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Verb
+ )
+
+ Try {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ $verb = $verb.Replace('&','')
+ $path = Split-Path -Path $FilePath -Parent -ErrorAction 'Stop'
+ $folder = $shellApp.Namespace($path)
+ $item = $folder.ParseName((Split-Path -Path $FilePath -Leaf -ErrorAction 'Stop'))
+ $itemVerb = $item.Verbs() | Where-Object { $_.Name.Replace('&','') -eq $verb } -ErrorAction 'Stop'
+
+ If ($null -eq $itemVerb) {
+ Write-Log -Message "Performing action [$verb] is not programmatically supported for this file [$FilePath]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Perform action [$verb] on [$FilePath]." -Source ${CmdletName}
+ $itemVerb.DoIt()
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to perform action [$verb] on [$FilePath]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ #endregion
+
+ If (([version]$envOSVersion).Major -ge 10) {
+ Write-Log -Message "Detected Windows 10 or higher, using Windows 10 verb codes." -Source ${CmdletName}
+ [hashtable]$Verbs = @{
+ 'PintoStartMenu' = 51201
+ 'UnpinfromStartMenu' = 51394
+ 'PintoTaskbar' = 5386
+ 'UnpinfromTaskbar' = 5387
+ }
+ }
+ Else {
+ [hashtable]$Verbs = @{
+ 'PintoStartMenu' = 5381
+ 'UnpinfromStartMenu' = 5382
+ 'PintoTaskbar' = 5386
+ 'UnpinfromTaskbar' = 5387
+ }
+ }
+
+ }
+ Process {
+ Try {
+ Write-Log -Message "Execute action [$Action] for file [$FilePath]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf' -ErrorAction 'Stop')) {
+ Throw "Path [$filePath] does not exist."
+ }
+
+ If (-not ($Verbs.$Action)) {
+ Throw "Action [$Action] not supported. Supported actions are [$($Verbs.Keys -join ', ')]."
+ }
+
+ [string]$PinVerbAction = Get-PinVerb -VerbId $Verbs.$Action
+ If (-not ($PinVerbAction)) {
+ Throw "Failed to get a localized pin verb for action [$Action]. Action is not supported on this operating system."
+ }
+
+ Invoke-Verb -FilePath $FilePath -Verb $PinVerbAction
+ }
+ Catch {
+ Write-Log -Message "Failed to execute action [$Action]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-IniValue
+Function Get-IniValue {
+<#
+.SYNOPSIS
+ Parses an INI file and returns the value of the specified section and key.
+.DESCRIPTION
+ Parses an INI file and returns the value of the specified section and key.
+.PARAMETER FilePath
+ Path to the INI file.
+.PARAMETER Section
+ Section within the INI file.
+.PARAMETER Key
+ Key within the section of the INI file.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-IniValue -FilePath "$envProgramFilesX86\IBM\Notes\notes.ini" -Section 'Notes' -Key 'KeyFileName'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Section,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Read INI Key: [Section = $Section] [Key = $Key]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ $IniValue = [PSADT.IniFile]::GetIniValue($Section, $Key, $FilePath)
+ Write-Log -Message "INI Key Value: [Section = $Section] [Key = $Key] [Value = $IniValue]." -Source ${CmdletName}
+
+ Write-Output -InputObject $IniValue
+ }
+ Catch {
+ Write-Log -Message "Failed to read INI file key value. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read INI file key value: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-IniValue
+Function Set-IniValue {
+<#
+.SYNOPSIS
+ Opens an INI file and sets the value of the specified section and key.
+.DESCRIPTION
+ Opens an INI file and sets the value of the specified section and key.
+.PARAMETER FilePath
+ Path to the INI file.
+.PARAMETER Section
+ Section within the INI file.
+.PARAMETER Key
+ Key within the section of the INI file.
+.PARAMETER Value
+ Value for the key within the section of the INI file. To remove a value, set this variable to $null.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-IniValue -FilePath "$envProgramFilesX86\IBM\Notes\notes.ini" -Section 'Notes' -Key 'KeyFileName' -Value 'MyFile.ID'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Section,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ # Don't strongly type this variable as [string] b/c PowerShell replaces [string]$Value = $null with an empty string
+ [Parameter(Mandatory=$true)]
+ [AllowNull()]
+ $Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Write INI Key Value: [Section = $Section] [Key = $Key] [Value = $Value]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ [PSADT.IniFile]::SetIniValue($Section, $Key, ([Text.StringBuilder]$Value), $FilePath)
+ }
+ Catch {
+ Write-Log -Message "Failed to write INI file key value. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to write INI file key value: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-PEFileArchitecture
+Function Get-PEFileArchitecture {
+<#
+.SYNOPSIS
+ Determine if a PE file is a 32-bit or a 64-bit file.
+.DESCRIPTION
+ Determine if a PE file is a 32-bit or a 64-bit file by examining the file's image file header.
+ PE file extensions: .exe, .dll, .ocx, .drv, .sys, .scr, .efi, .cpl, .fon
+.PARAMETER FilePath
+ Path to the PE file to examine.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.PARAMETER PassThru
+ Get the file object, attach a property indicating the file binary type, and write to pipeline
+.EXAMPLE
+ Get-PEFileArchitecture -FilePath "$env:windir\notepad.exe"
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [IO.FileInfo[]]$FilePath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ [string[]]$PEFileExtensions = '.exe', '.dll', '.ocx', '.drv', '.sys', '.scr', '.efi', '.cpl', '.fon'
+ [int32]$MACHINE_OFFSET = 4
+ [int32]$PE_POINTER_OFFSET = 60
+ }
+ Process {
+ ForEach ($Path in $filePath) {
+ Try {
+ If ($PEFileExtensions -notcontains $Path.Extension) {
+ Throw "Invalid file type. Please specify one of the following PE file types: $($PEFileExtensions -join ', ')"
+ }
+
+ [byte[]]$data = New-Object -TypeName 'System.Byte[]' -ArgumentList 4096
+ $stream = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($Path.FullName, 'Open', 'Read')
+ $null = $stream.Read($data, 0, 4096)
+ $stream.Flush()
+ $stream.Close()
+
+ [int32]$PE_HEADER_ADDR = [BitConverter]::ToInt32($data, $PE_POINTER_OFFSET)
+ [uint16]$PE_IMAGE_FILE_HEADER = [BitConverter]::ToUInt16($data, $PE_HEADER_ADDR + $MACHINE_OFFSET)
+ Switch ($PE_IMAGE_FILE_HEADER) {
+ 0 { $PEArchitecture = 'Native' } # The contents of this file are assumed to be applicable to any machine type
+ 0x014c { $PEArchitecture = '32BIT' } # File for Windows 32-bit systems
+ 0x0200 { $PEArchitecture = 'Itanium-x64' } # File for Intel Itanium x64 processor family
+ 0x8664 { $PEArchitecture = '64BIT' } # File for Windows 64-bit systems
+ Default { $PEArchitecture = 'Unknown' }
+ }
+ Write-Log -Message "File [$($Path.FullName)] has a detected file architecture of [$PEArchitecture]." -Source ${CmdletName}
+
+ If ($PassThru) {
+ # Get the file object, attach a property indicating the type, and write to pipeline
+ Get-Item -LiteralPath $Path.FullName -Force | Add-Member -MemberType 'NoteProperty' -Name 'BinaryType' -Value $PEArchitecture -Force -PassThru | Write-Output
+ }
+ Else {
+ Write-Output -InputObject $PEArchitecture
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get the PE file architecture. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the PE file architecture: $($_.Exception.Message)"
+ }
+ Continue
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-RegisterOrUnregisterDLL
+Function Invoke-RegisterOrUnregisterDLL {
+<#
+.SYNOPSIS
+ Register or unregister a DLL file.
+.DESCRIPTION
+ Register or unregister a DLL file using regsvr32.exe. Function can be invoked using alias: 'Register-DLL' or 'Unregister-DLL'.
+.PARAMETER FilePath
+ Path to the DLL file.
+.PARAMETER DLLAction
+ Specify whether to register or unregister the DLL. Optional if function is invoked using 'Register-DLL' or 'Unregister-DLL' alias.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Register-DLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll"
+ Register DLL file using the "Register-DLL" alias for this function
+.EXAMPLE
+ UnRegister-DLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll"
+ Unregister DLL file using the "Unregister-DLL" alias for this function
+.EXAMPLE
+ Invoke-RegisterOrUnregisterDLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll" -DLLAction 'Register'
+ Register DLL file using the actual name of this function
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Register','Unregister')]
+ [string]$DLLAction,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Get name used to invoke this function in case the 'Register-DLL' or 'Unregister-DLL' alias was used and set the correct DLL action
+ [string]${InvokedCmdletName} = $MyInvocation.InvocationName
+ # Set the correct register/unregister action based on the alias used to invoke this function
+ If (${InvokedCmdletName} -ne ${CmdletName}) {
+ Switch (${InvokedCmdletName}) {
+ 'Register-DLL' { [string]$DLLAction = 'Register' }
+ 'Unregister-DLL' { [string]$DLLAction = 'Unregister' }
+ }
+ }
+ # Set the correct DLL register/unregister action parameters
+ If (-not $DLLAction) { Throw 'Parameter validation failed. Please specify the [-DLLAction] parameter to determine whether to register or unregister the DLL.' }
+ [string]$DLLAction = ((Get-Culture).TextInfo).ToTitleCase($DLLAction.ToLower())
+ Switch ($DLLAction) {
+ 'Register' { [string]$DLLActionParameters = "/s `"$FilePath`"" }
+ 'Unregister' { [string]$DLLActionParameters = "/s /u `"$FilePath`"" }
+ }
+ }
+ Process {
+ Try {
+ Write-Log -Message "$DLLAction DLL file [$filePath]." -Source ${CmdletName}
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ [string]$DLLFileBitness = Get-PEFileArchitecture -FilePath $filePath -ContinueOnError $false -ErrorAction 'Stop'
+ If (($DLLFileBitness -ne '64BIT') -and ($DLLFileBitness -ne '32BIT')) {
+ Throw "File [$filePath] has a detected file architecture of [$DLLFileBitness]. Only 32-bit or 64-bit DLL files can be $($DLLAction.ToLower() + 'ed')."
+ }
+
+ If ($Is64Bit) {
+ If ($DLLFileBitness -eq '64BIT') {
+ If ($Is64BitProcess) {
+ [string]$RegSvr32Path = "$envWinDir\system32\regsvr32.exe"
+ }
+ Else {
+ [string]$RegSvr32Path = "$envWinDir\sysnative\regsvr32.exe"
+ }
+ }
+ ElseIf ($DLLFileBitness -eq '32BIT') {
+ [string]$RegSvr32Path = "$envWinDir\SysWOW64\regsvr32.exe"
+ }
+ }
+ Else {
+ If ($DLLFileBitness -eq '64BIT') {
+ Throw "File [$filePath] cannot be $($DLLAction.ToLower()) because it is a 64-bit file on a 32-bit operating system."
+ }
+ ElseIf ($DLLFileBitness -eq '32BIT') {
+ [string]$RegSvr32Path = "$envWinDir\system32\regsvr32.exe"
+ }
+ }
+
+ [psobject]$ExecuteResult = Execute-Process -Path $RegSvr32Path -Parameters $DLLActionParameters -WindowStyle 'Hidden' -PassThru
+
+ If ($ExecuteResult.ExitCode -ne 0) {
+ If ($ExecuteResult.ExitCode -eq 60002) {
+ Throw "Execute-Process function failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ Else {
+ Throw "regsvr32.exe failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to $($DLLAction.ToLower()) DLL file. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $($DLLAction.ToLower()) DLL file: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Register-DLL' -Value 'Invoke-RegisterOrUnregisterDLL' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+Set-Alias -Name 'Unregister-DLL' -Value 'Invoke-RegisterOrUnregisterDLL' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Invoke-ObjectMethod
+Function Invoke-ObjectMethod {
+<#
+.SYNOPSIS
+ Invoke method on any object.
+.DESCRIPTION
+ Invoke method on any object with or without using named parameters.
+.PARAMETER InputObject
+ Specifies an object which has methods that can be invoked.
+.PARAMETER MethodName
+ Specifies the name of a method to invoke.
+.PARAMETER ArgumentList
+ Argument to pass to the method being executed. Allows execution of method without specifying named parameters.
+.PARAMETER Parameter
+ Argument to pass to the method being executed. Allows execution of method by using named parameters.
+.EXAMPLE
+ $ShellApp = New-Object -ComObject 'Shell.Application'
+ $null = Invoke-ObjectMethod -InputObject $ShellApp -MethodName 'MinimizeAll'
+ Minimizes all windows.
+.EXAMPLE
+ $ShellApp = New-Object -ComObject 'Shell.Application'
+ $null = Invoke-ObjectMethod -InputObject $ShellApp -MethodName 'Explore' -Parameter @{'vDir'='C:\Windows'}
+ Opens the C:\Windows folder in a Windows Explorer window.
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='Positional')]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNull()]
+ [object]$InputObject,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$MethodName,
+ [Parameter(Mandatory=$false,Position=2,ParameterSetName='Positional')]
+ [object[]]$ArgumentList,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='Named')]
+ [ValidateNotNull()]
+ [hashtable]$Parameter
+ )
+
+ Begin { }
+ Process {
+ If ($PSCmdlet.ParameterSetName -eq 'Named') {
+ ## Invoke method by using parameter names
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($MethodName, [Reflection.BindingFlags]::InvokeMethod, $null, $InputObject, ([object[]]($Parameter.Values)), $null, $null, ([string[]]($Parameter.Keys)))
+ }
+ Else {
+ ## Invoke method without using parameter names
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($MethodName, [Reflection.BindingFlags]::InvokeMethod, $null, $InputObject, $ArgumentList, $null, $null, $null)
+ }
+ }
+ End { }
+}
+#endregion
+
+
+#region Function Get-ObjectProperty
+Function Get-ObjectProperty {
+<#
+.SYNOPSIS
+ Get a property from any object.
+.DESCRIPTION
+ Get a property from any object.
+.PARAMETER InputObject
+ Specifies an object which has properties that can be retrieved.
+.PARAMETER PropertyName
+ Specifies the name of a property to retrieve.
+.PARAMETER ArgumentList
+ Argument to pass to the property being retrieved.
+.EXAMPLE
+ Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @(1)
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNull()]
+ [object]$InputObject,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyName,
+ [Parameter(Mandatory=$false,Position=2)]
+ [object[]]$ArgumentList
+ )
+
+ Begin { }
+ Process {
+ ## Retrieve property
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($PropertyName, [Reflection.BindingFlags]::GetProperty, $null, $InputObject, $ArgumentList, $null, $null, $null)
+ }
+ End { }
+}
+#endregion
+
+
+#region Function Get-MsiTableProperty
+Function Get-MsiTableProperty {
+<#
+.SYNOPSIS
+ Get all of the properties from a Windows Installer database table or the Summary Information stream and return as a custom object.
+.DESCRIPTION
+ Use the Windows Installer object to read all of the properties from a Windows Installer database table or the Summary Information stream.
+.PARAMETER Path
+ The fully qualified path to an database file. Supports .msi and .msp files.
+.PARAMETER TransformPath
+ The fully qualified path to a list of MST file(s) which should be applied to the MSI file.
+.PARAMETER Table
+ The name of the the MSI table from which all of the properties must be retrieved. Default is: 'Property'.
+.PARAMETER TablePropertyNameColumnNum
+ Specify the table column number which contains the name of the properties. Default is: 1 for MSIs and 2 for MSPs.
+.PARAMETER TablePropertyValueColumnNum
+ Specify the table column number which contains the value of the properties. Default is: 2 for MSIs and 3 for MSPs.
+.PARAMETER GetSummaryInformation
+ Retrieves the Summary Information for the Windows Installer database.
+ Summary Information property descriptions: https://msdn.microsoft.com/en-us/library/aa372049(v=vs.85).aspx
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -TransformPath 'C:\Package\AppDeploy.mst'
+ Retrieve all of the properties from the default 'Property' table.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -TransformPath 'C:\Package\AppDeploy.mst' -Table 'Property' | Select-Object -ExpandProperty ProductCode
+ Retrieve all of the properties from the 'Property' table and then pipe to Select-Object to select the ProductCode property.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -GetSummaryInformation
+ Retrieves the Summary Information for the Windows Installer database.
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='TableInfo')]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string[]]$TransformPath,
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullOrEmpty()]
+ [string]$Table = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 'Property' } Else { 'MsiPatchMetadata' }),
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullorEmpty()]
+ [int32]$TablePropertyNameColumnNum = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 1 } Else { 2 }),
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullorEmpty()]
+ [int32]$TablePropertyValueColumnNum = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 2 } Else { 3 }),
+ [Parameter(Mandatory=$true,ParameterSetName='SummaryInfo')]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetSummaryInformation = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'TableInfo') {
+ Write-Log -Message "Read data from Windows Installer database file [$Path] in table [$Table]." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Read the Summary Information from the Windows Installer database file [$Path]." -Source ${CmdletName}
+ }
+
+ ## Create a Windows Installer object
+ [__comobject]$Installer = New-Object -ComObject 'WindowsInstaller.Installer' -ErrorAction 'Stop'
+ ## Determine if the database file is a patch (.msp) or not
+ If ([IO.Path]::GetExtension($Path) -eq '.msp') { [boolean]$IsMspFile = $true }
+ ## Define properties for how the MSI database is opened
+ [int32]$msiOpenDatabaseModeReadOnly = 0
+ [int32]$msiSuppressApplyTransformErrors = 63
+ [int32]$msiOpenDatabaseMode = $msiOpenDatabaseModeReadOnly
+ [int32]$msiOpenDatabaseModePatchFile = 32
+ If ($IsMspFile) { [int32]$msiOpenDatabaseMode = $msiOpenDatabaseModePatchFile }
+ ## Open database in read only mode
+ [__comobject]$Database = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($Path, $msiOpenDatabaseMode)
+ ## Apply a list of transform(s) to the database
+ If (($TransformPath) -and (-not $IsMspFile)) {
+ ForEach ($Transform in $TransformPath) {
+ $null = Invoke-ObjectMethod -InputObject $Database -MethodName 'ApplyTransform' -ArgumentList @($Transform, $msiSuppressApplyTransformErrors)
+ }
+ }
+
+ ## Get either the requested windows database table information or summary information
+ If ($PSCmdlet.ParameterSetName -eq 'TableInfo') {
+ ## Open the requested table view from the database
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $Database -MethodName 'OpenView' -ArgumentList @("SELECT * FROM $Table")
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+
+ ## Create an empty object to store properties in
+ [psobject]$TableProperties = New-Object -TypeName 'PSObject'
+
+ ## Retrieve the first row from the requested table. If the first row was successfully retrieved, then save data and loop through the entire table.
+ # https://msdn.microsoft.com/en-us/library/windows/desktop/aa371136(v=vs.85).aspx
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+ While ($Record) {
+ # Read string data from record and add property/value pair to custom object
+ $TableProperties | Add-Member -MemberType 'NoteProperty' -Name (Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @($TablePropertyNameColumnNum)) -Value (Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @($TablePropertyValueColumnNum)) -Force
+ # Retrieve the next row in the table
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+ }
+ Write-Output -InputObject $TableProperties
+ }
+ Else {
+ ## Get the SummaryInformation from the windows installer database
+ [__comobject]$SummaryInformation = Get-ObjectProperty -InputObject $Database -PropertyName 'SummaryInformation'
+ [hashtable]$SummaryInfoProperty = @{}
+ ## Summary property descriptions: https://msdn.microsoft.com/en-us/library/aa372049(v=vs.85).aspx
+ $SummaryInfoProperty.Add('CodePage', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(1)))
+ $SummaryInfoProperty.Add('Title', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(2)))
+ $SummaryInfoProperty.Add('Subject', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(3)))
+ $SummaryInfoProperty.Add('Author', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(4)))
+ $SummaryInfoProperty.Add('Keywords', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(5)))
+ $SummaryInfoProperty.Add('Comments', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(6)))
+ $SummaryInfoProperty.Add('Template', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(7)))
+ $SummaryInfoProperty.Add('LastSavedBy', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(8)))
+ $SummaryInfoProperty.Add('RevisionNumber', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(9)))
+ $SummaryInfoProperty.Add('LastPrinted', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(11)))
+ $SummaryInfoProperty.Add('CreateTimeDate', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(12)))
+ $SummaryInfoProperty.Add('LastSaveTimeDate', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(13)))
+ $SummaryInfoProperty.Add('PageCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(14)))
+ $SummaryInfoProperty.Add('WordCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(15)))
+ $SummaryInfoProperty.Add('CharacterCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(16)))
+ $SummaryInfoProperty.Add('CreatingApplication', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(18)))
+ $SummaryInfoProperty.Add('Security', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(19)))
+ [psobject]$SummaryInfoProperties = New-Object -TypeName 'PSObject' -Property $SummaryInfoProperty
+ Write-Output -InputObject $SummaryInfoProperties
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get the MSI table [$Table]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the MSI table [$Table]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try {
+ If ($View) {
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View) } Catch { }
+ }
+ ElseIf($SummaryInformation) {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SummaryInformation) } Catch { }
+ }
+ }
+ Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($DataBase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-MsiProperty
+Function Set-MsiProperty {
+<#
+.SYNOPSIS
+ Set a property in the MSI property table.
+.DESCRIPTION
+ Set a property in the MSI property table.
+.PARAMETER DataBase
+ Specify a ComObject representing an MSI database opened in view/modify/update mode.
+.PARAMETER PropertyName
+ The name of the property to be set/modified.
+.PARAMETER PropertyValue
+ The value of the property to be set/modified.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-MsiProperty -DataBase $TempMsiPathDatabase -PropertyName 'ALLUSERS' -PropertyValue '1'
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [__comobject]$DataBase,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyName,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyValue,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]." -Source ${CmdletName}
+
+ ## Open the requested table view from the database
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("SELECT * FROM Property WHERE Property='$PropertyName'")
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+
+ ## Retrieve the requested property from the requested table.
+ # https://msdn.microsoft.com/en-us/library/windows/desktop/aa371136(v=vs.85).aspx
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+
+ ## Close the previous view on the MSI database
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View)
+
+ ## Set the MSI property
+ If ($Record) {
+ # If the property already exists, then create the view for updating the property
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("UPDATE Property SET Value='$PropertyValue' WHERE Property='$PropertyName'")
+ }
+ Else {
+ # If property does not exist, then create view for inserting the property
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("INSERT INTO Property (Property, Value) VALUES ('$PropertyName','$PropertyValue')")
+ }
+ # Execute the view to set the MSI property
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+ }
+ Catch {
+ Write-Log -Message "Failed to set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try {
+ If ($View) {
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View)
+ }
+ }
+ Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-MsiTransform
+Function New-MsiTransform {
+<#
+.SYNOPSIS
+ Create a transform file for an MSI database.
+.DESCRIPTION
+ Create a transform file for an MSI database and create/modify properties in the Properties table.
+.PARAMETER MsiPath
+ Specify the path to an MSI file.
+.PARAMETER ApplyTransformPath
+ Specify the path to a transform which should be applied to the MSI database before any new properties are created or modified.
+.PARAMETER NewTransformPath
+ Specify the path where the new transform file with the desired properties will be created. If a transform file of the same name already exists, it will be deleted before a new one is created.
+ Default is: a) If -ApplyTransformPath was specified but not -NewTransformPath, then .new.mst
+ b) If only -MsiPath was specified, then .mst
+.PARAMETER TransformProperties
+ Hashtable which contains calls to Set-MsiProperty for configuring the desired properties which should be included in new transform file.
+ Example hashtable: [hashtable]$TransformProperties = @{ 'ALLUSERS' = '1' }
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ [hashtable]$TransformProperties = {
+ 'ALLUSERS' = '1'
+ 'AgreeToLicense' = 'Yes'
+ 'REBOOT' = 'ReallySuppress'
+ 'RebootYesNo' = 'No'
+ 'ROOTDRIVE' = 'C:'
+ }
+ New-MsiTransform -MsiPath 'C:\Temp\PSADTInstall.msi' -TransformProperties $TransformProperties
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$MsiPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$ApplyTransformPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$NewTransformPath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [hashtable]$TransformProperties,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Define properties for how the MSI database is opened
+ [int32]$msiOpenDatabaseModeReadOnly = 0
+ [int32]$msiOpenDatabaseModeTransact = 1
+ [int32]$msiViewModifyUpdate = 2
+ [int32]$msiViewModifyReplace = 4
+ [int32]$msiViewModifyDelete = 6
+ [int32]$msiTransformErrorNone = 0
+ [int32]$msiTransformValidationNone = 0
+ [int32]$msiSuppressApplyTransformErrors = 63
+ }
+ Process {
+ Try {
+ Write-Log -Message "Create a transform file for MSI [$MsiPath]." -Source ${CmdletName}
+
+ ## Discover the parent folder that the MSI file resides in
+ [string]$MsiParentFolder = Split-Path -Path $MsiPath -Parent -ErrorAction 'Stop'
+
+ ## Create a temporary file name for storing a second copy of the MSI database
+ [string]$TempMsiPath = Join-Path -Path $MsiParentFolder -ChildPath ([IO.Path]::GetFileName(([IO.Path]::GetTempFileName()))) -ErrorAction 'Stop'
+
+ ## Create a second copy of the MSI database
+ Write-Log -Message "Copy MSI database in path [$MsiPath] to destination [$TempMsiPath]." -Source ${CmdletName}
+ $null = Copy-Item -LiteralPath $MsiPath -Destination $TempMsiPath -Force -ErrorAction 'Stop'
+
+ ## Create a Windows Installer object
+ [__comobject]$Installer = New-Object -ComObject 'WindowsInstaller.Installer' -ErrorAction 'Stop'
+
+ ## Open both copies of the MSI database
+ # Open the original MSI database in read only mode
+ Write-Log -Message "Open the MSI database [$MsiPath] in read only mode." -Source ${CmdletName}
+ [__comobject]$MsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($MsiPath, $msiOpenDatabaseModeReadOnly)
+ # Open the temporary copy of the MSI database in view/modify/update mode
+ Write-Log -Message "Open the MSI database [$TempMsiPath] in view/modify/update mode." -Source ${CmdletName}
+ [__comobject]$TempMsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($TempMsiPath, $msiViewModifyUpdate)
+
+ ## If a MSI transform file was specified, then apply it to the temporary copy of the MSI database
+ If ($ApplyTransformPath) {
+ Write-Log -Message "Apply transform file [$ApplyTransformPath] to MSI database [$TempMsiPath]." -Source ${CmdletName}
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'ApplyTransform' -ArgumentList @($ApplyTransformPath, $msiSuppressApplyTransformErrors)
+ }
+
+ ## Determine the path for the new transform file that will be generated
+ If (-not $NewTransformPath) {
+ If ($ApplyTransformPath) {
+ [string]$NewTransformFileName = [IO.Path]::GetFileNameWithoutExtension($ApplyTransformPath) + '.new' + [IO.Path]::GetExtension($ApplyTransformPath)
+ }
+ Else {
+ [string]$NewTransformFileName = [IO.Path]::GetFileNameWithoutExtension($MsiPath) + '.mst'
+ }
+ [string]$NewTransformPath = Join-Path -Path $MsiParentFolder -ChildPath $NewTransformFileName -ErrorAction 'Stop'
+ }
+
+ ## Set the MSI properties in the temporary copy of the MSI database
+ $TransformProperties.GetEnumerator() | ForEach-Object { Set-MsiProperty -DataBase $TempMsiPathDatabase -PropertyName $_.Key -PropertyValue $_.Value }
+
+ ## Commit the new properties to the temporary copy of the MSI database
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'Commit'
+
+ ## Reopen the temporary copy of the MSI database in read only mode
+ # Release the database object for the temporary copy of the MSI database
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($TempMsiPathDatabase)
+ # Open the temporary copy of the MSI database in read only mode
+ Write-Log -Message "Re-open the MSI database [$TempMsiPath] in read only mode." -Source ${CmdletName}
+ [__comobject]$TempMsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($TempMsiPath, $msiOpenDatabaseModeReadOnly)
+
+ ## Delete the new transform file path if it already exists
+ If (Test-Path -LiteralPath $NewTransformPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "A transform file of the same name already exists. Deleting transform file [$NewTransformPath]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $NewTransformPath -Force -ErrorAction 'Stop'
+ }
+
+ ## Generate the new transform file by taking the difference between the temporary copy of the MSI database and the original MSI database
+ Write-Log -Message "Generate new transform file [$NewTransformPath]." -Source ${CmdletName}
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'GenerateTransform' -ArgumentList @($MsiPathDatabase, $NewTransformPath)
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'CreateTransformSummaryInfo' -ArgumentList @($MsiPathDatabase, $NewTransformPath, $msiTransformErrorNone, $msiTransformValidationNone)
+
+ If (Test-Path -LiteralPath $NewTransformPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "Successfully created new transform file in path [$NewTransformPath]." -Source ${CmdletName}
+ }
+ Else {
+ Throw "Failed to generate transform file in path [$NewTransformPath]."
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create new transform file in path [$NewTransformPath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create new transform file in path [$NewTransformPath]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($TempMsiPathDatabase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($MsiPathDatabase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ Try {
+ ## Delete the temporary copy of the MSI database
+ If (Test-Path -LiteralPath $TempMsiPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ $null = Remove-Item -LiteralPath $TempMsiPath -Force -ErrorAction 'Stop'
+ }
+ }
+ Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-MSUpdates
+Function Test-MSUpdates {
+<#
+.SYNOPSIS
+ Test whether a Microsoft Windows update is installed.
+.DESCRIPTION
+ Test whether a Microsoft Windows update is installed.
+.PARAMETER KBNumber
+ KBNumber of the update.
+.PARAMETER ContinueOnError
+ Suppress writing log message to console on failure to write message to log file. Default is: $true.
+.EXAMPLE
+ Test-MSUpdates -KBNumber 'KB2549864'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,HelpMessage='Enter the KB Number for the Microsoft Update')]
+ [ValidateNotNullorEmpty()]
+ [string]$KBNumber,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Check if Microsoft Update [$kbNumber] is installed." -Source ${CmdletName}
+
+ ## Default is not found
+ [boolean]$kbFound = $false
+
+ ## Check for update using built in PS cmdlet which uses WMI in the background to gather details
+ Get-Hotfix -Id $kbNumber -ErrorAction 'SilentlyContinue' | ForEach-Object { $kbFound = $true }
+
+ If (-not $kbFound) {
+ Write-Log -Message 'Unable to detect Windows update history via Get-Hotfix cmdlet. Trying via COM object.' -Source ${CmdletName}
+
+ ## Check for update using ComObject method (to catch Office updates)
+ [__comobject]$UpdateSession = New-Object -ComObject "Microsoft.Update.Session"
+ [__comobject]$UpdateSearcher = $UpdateSession.CreateUpdateSearcher()
+ # Indicates whether the search results include updates that are superseded by other updates in the search results
+ $UpdateSearcher.IncludePotentiallySupersededUpdates = $false
+ # Indicates whether the UpdateSearcher goes online to search for updates.
+ $UpdateSearcher.Online = $false
+ [int32]$UpdateHistoryCount = $UpdateSearcher.GetTotalHistoryCount()
+ If ($UpdateHistoryCount -gt 0) {
+ [psobject]$UpdateHistory = $UpdateSearcher.QueryHistory(0, $UpdateHistoryCount) |
+ Select-Object -Property 'Title','Date',
+ @{Name = 'Operation'; Expression = { Switch ($_.Operation) { 1 {'Installation'}; 2 {'Uninstallation'}; 3 {'Other'} } } },
+ @{Name = 'Status'; Expression = { Switch ($_.ResultCode) { 0 {'Not Started'}; 1 {'In Progress'}; 2 {'Successful'}; 3 {'Incomplete'}; 4 {'Failed'}; 5 {'Aborted'} } } },
+ 'Description' |
+ Sort-Object -Property 'Date' -Descending
+ ForEach ($Update in $UpdateHistory) {
+ If (($Update.Operation -ne 'Other') -and ($Update.Title -match "\($KBNumber\)")) {
+ $LatestUpdateHistory = $Update
+ Break
+ }
+ }
+ If (($LatestUpdateHistory.Operation -eq 'Installation') -and ($LatestUpdateHistory.Status -eq 'Successful')) {
+ Write-Log -Message "Discovered the following Microsoft Update: `n$($LatestUpdateHistory | Format-List | Out-String)" -Source ${CmdletName}
+ $kbFound = $true
+ }
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($UpdateSession)
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($UpdateSearcher)
+ }
+ Else {
+ Write-Log -Message 'Unable to detect Windows update history via COM object.' -Source ${CmdletName}
+ }
+ }
+
+ ## Return Result
+ If (-not $kbFound) {
+ Write-Log -Message "Microsoft Update [$kbNumber] is not installed." -Source ${CmdletName}
+ Write-Output -InputObject $false
+ }
+ Else {
+ Write-Log -Message "Microsoft Update [$kbNumber] is installed." -Source ${CmdletName}
+ Write-Output -InputObject $true
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed discovering Microsoft Update [$kbNumber]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed discovering Microsoft Update [$kbNumber]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Install-MSUpdates
+Function Install-MSUpdates {
+<#
+.SYNOPSIS
+ Install all Microsoft Updates in a given directory.
+.DESCRIPTION
+ Install all Microsoft Updates of type ".exe", ".msu", or ".msp" in a given directory (recursively search directory).
+.PARAMETER Directory
+ Directory containing the updates.
+.EXAMPLE
+ Install-MSUpdates -Directory "$dirFiles\MSUpdates"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Directory
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message "Recursively install all Microsoft Updates in directory [$Directory]." -Source ${CmdletName}
+
+ ## KB Number pattern match
+ $kbPattern = '(?i)kb\d{6,8}'
+
+ ## Get all hotfixes and install if required
+ [IO.FileInfo[]]$files = Get-ChildItem -LiteralPath $Directory -Recurse -Include ('*.exe','*.msu','*.msp')
+ ForEach ($file in $files) {
+ If ($file.Name -match 'redist') {
+ [version]$redistVersion = [Diagnostics.FileVersionInfo]::GetVersionInfo($file.FullName).ProductVersion
+ [string]$redistDescription = [Diagnostics.FileVersionInfo]::GetVersionInfo($file.FullName).FileDescription
+
+ Write-Log -Message "Install [$redistDescription $redistVersion]..." -Source ${CmdletName}
+ # Handle older redistributables (ie, VC++ 2005)
+ If ($redistDescription -match 'Win32 Cabinet Self-Extractor') {
+ Execute-Process -Path $file.FullName -Parameters '/q' -WindowStyle 'Hidden' -ContinueOnError $true
+ }
+ Else {
+ Execute-Process -Path $file.FullName -Parameters '/quiet /norestart' -WindowStyle 'Hidden' -ContinueOnError $true
+ }
+ }
+ Else {
+ # Get the KB number of the file
+ [string]$kbNumber = [regex]::Match($file.Name, $kbPattern).ToString()
+ If (-not $kbNumber) { Continue }
+
+ # Check to see whether the KB is already installed
+ If (-not (Test-MSUpdates -KBNumber $kbNumber)) {
+ Write-Log -Message "KB Number [$KBNumber] was not detected and will be installed." -Source ${CmdletName}
+ Switch ($file.Extension) {
+ # Installation type for executables (i.e., Microsoft Office Updates)
+ '.exe' { Execute-Process -Path $file.FullName -Parameters '/quiet /norestart' -WindowStyle 'Hidden' -ContinueOnError $true }
+ # Installation type for Windows updates using Windows Update Standalone Installer
+ '.msu' { Execute-Process -Path 'wusa.exe' -Parameters "`"$($file.FullName)`" /quiet /norestart" -WindowStyle 'Hidden' -ContinueOnError $true }
+ # Installation type for Windows Installer Patch
+ '.msp' { Execute-MSI -Action 'Patch' -Path $file.FullName -ContinueOnError $true }
+ }
+ }
+ Else {
+ Write-Log -Message "KB Number [$kbNumber] is already installed. Continue..." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-WindowTitle
+Function Get-WindowTitle {
+<#
+.SYNOPSIS
+ Search for an open window title and return details about the window.
+.DESCRIPTION
+ Search for a window title. If window title searched for returns more than one result, then details for each window will be displayed.
+ Returns the following properties for each window: WindowTitle, WindowHandle, ParentProcess, ParentProcessMainWindowHandle, ParentProcessId.
+ Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER WindowTitle
+ The title of the application window to search for using regex matching.
+.PARAMETER GetAllWindowTitles
+ Get titles for all open windows on the system.
+.PARAMETER DisableFunctionLogging
+ Disables logging messages to the script log file.
+.EXAMPLE
+ Get-WindowTitle -WindowTitle 'Microsoft Word'
+ Gets details for each window that has the words "Microsoft Word" in the title.
+.EXAMPLE
+ Get-WindowTitle -GetAllWindowTitles
+ Gets details for all windows with a title.
+.EXAMPLE
+ Get-WindowTitle -GetAllWindowTitles | Where-Object { $_.ParentProcess -eq 'WINWORD' }
+ Get details for all windows belonging to Microsoft Word process with name "WINWORD".
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='SearchWinTitle')]
+ [AllowEmptyString()]
+ [string]$WindowTitle,
+ [Parameter(Mandatory=$true,ParameterSetName='GetAllWinTitles')]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetAllWindowTitles = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$DisableFunctionLogging = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'SearchWinTitle') {
+ If (-not $DisableFunctionLogging) { Write-Log -Message "Find open window title(s) [$WindowTitle] using regex matching." -Source ${CmdletName} }
+ }
+ ElseIf ($PSCmdlet.ParameterSetName -eq 'GetAllWinTitles') {
+ If (-not $DisableFunctionLogging) { Write-Log -Message 'Find all open window title(s).' -Source ${CmdletName} }
+ }
+
+ ## Get all window handles for visible windows
+ [IntPtr[]]$VisibleWindowHandles = [PSADT.UiAutomation]::EnumWindows() | Where-Object { [PSADT.UiAutomation]::IsWindowVisible($_) }
+
+ ## Discover details about each visible window that was discovered
+ ForEach ($VisibleWindowHandle in $VisibleWindowHandles) {
+ If (-not $VisibleWindowHandle) { Continue }
+ ## Get the window title
+ [string]$VisibleWindowTitle = [PSADT.UiAutomation]::GetWindowText($VisibleWindowHandle)
+ If ($VisibleWindowTitle) {
+ ## Get the process that spawned the window
+ [Diagnostics.Process]$Process = Get-Process -ErrorAction 'Stop' | Where-Object { $_.Id -eq [PSADT.UiAutomation]::GetWindowThreadProcessId($VisibleWindowHandle) }
+ If ($Process) {
+ ## Build custom object with details about the window and the process
+ [psobject]$VisibleWindow = New-Object -TypeName 'PSObject' -Property @{
+ WindowTitle = $VisibleWindowTitle
+ WindowHandle = $VisibleWindowHandle
+ ParentProcess= $Process.Name
+ ParentProcessMainWindowHandle = $Process.MainWindowHandle
+ ParentProcessId = $Process.Id
+ }
+
+ ## Only save/return the window and process details which match the search criteria
+ If ($PSCmdlet.ParameterSetName -eq 'SearchWinTitle') {
+ $MatchResult = $VisibleWindow.WindowTitle -match $WindowTitle
+ If ($MatchResult) {
+ [psobject[]]$VisibleWindows += $VisibleWindow
+ }
+ }
+ ElseIf ($PSCmdlet.ParameterSetName -eq 'GetAllWinTitles') {
+ [psobject[]]$VisibleWindows += $VisibleWindow
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ If (-not $DisableFunctionLogging) { Write-Log -Message "Failed to get requested window title(s). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName} }
+ }
+ }
+ End {
+ Write-Output -InputObject $VisibleWindows
+
+ If ($DisableFunctionLogging) { . $RevertScriptLogging }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Send-Keys
+Function Send-Keys {
+<#
+.SYNOPSIS
+ Send a sequence of keys to one or more application windows.
+.DESCRIPTION
+ Send a sequence of keys to one or more application window. If window title searched for returns more than one window, then all of them will receive the sent keys.
+ Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER WindowTitle
+ The title of the application window to search for using regex matching.
+.PARAMETER GetAllWindowTitles
+ Get titles for all open windows on the system.
+.PARAMETER WindowHandle
+ Send keys to a specific window where the Window Handle is already known.
+.PARAMETER Keys
+ The sequence of keys to send. Info on Key input at: http://msdn.microsoft.com/en-us/library/System.Windows.Forms.SendKeys(v=vs.100).aspx
+.PARAMETER WaitSeconds
+ An optional number of seconds to wait after the sending of the keys.
+.EXAMPLE
+ Send-Keys -WindowTitle 'foobar - Notepad' -Key 'Hello world'
+ Send the sequence of keys "Hello world" to the application titled "foobar - Notepad".
+.EXAMPLE
+ Send-Keys -WindowTitle 'foobar - Notepad' -Key 'Hello world' -WaitSeconds 5
+ Send the sequence of keys "Hello world" to the application titled "foobar - Notepad" and wait 5 seconds.
+.EXAMPLE
+ Send-Keys -WindowHandle ([IntPtr]17368294) -Key 'Hello world'
+ Send the sequence of keys "Hello world" to the application with a Window Handle of '17368294'.
+.NOTES
+.LINK
+ http://msdn.microsoft.com/en-us/library/System.Windows.Forms.SendKeys(v=vs.100).aspx
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false,Position=0)]
+ [AllowEmptyString()]
+ [ValidateNotNull()]
+ [string]$WindowTitle,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetAllWindowTitles = $false,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNullorEmpty()]
+ [IntPtr]$WindowHandle,
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [string]$Keys,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [int32]$WaitSeconds
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Load assembly containing class System.Windows.Forms.SendKeys
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+
+ [scriptblock]$SendKeys = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [IntPtr]$WindowHandle
+ )
+ Try {
+ ## Bring the window to the foreground
+ [boolean]$IsBringWindowToFrontSuccess = [PSADT.UiAutomation]::BringWindowToFront($WindowHandle)
+ If (-not $IsBringWindowToFrontSuccess) { Throw 'Failed to bring window to foreground.'}
+
+ ## Send the Key sequence
+ If ($Keys) {
+ [boolean]$IsWindowModal = If ([PSADT.UiAutomation]::IsWindowEnabled($WindowHandle)) { $false } Else { $true }
+ If ($IsWindowModal) { Throw 'Unable to send keys to window because it may be disabled due to a modal dialog being shown.' }
+ [Windows.Forms.SendKeys]::SendWait($Keys)
+ Write-Log -Message "Sent key(s) [$Keys] to window title [$($Window.WindowTitle)] with window handle [$WindowHandle]." -Source ${CmdletName}
+
+ If ($WaitSeconds) {
+ Write-Log -Message "Sleeping for [$WaitSeconds] seconds." -Source ${CmdletName}
+ Start-Sleep -Seconds $WaitSeconds
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to send keys to window title [$($Window.WindowTitle)] with window handle [$WindowHandle]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ Process {
+ Try {
+ If ($WindowHandle) {
+ [psobject]$Window = Get-WindowTitle -GetAllWindowTitles | Where-Object { $_.WindowHandle -eq $WindowHandle }
+ If (-not $Window) {
+ Write-Log -Message "No windows with Window Handle [$WindowHandle] were discovered." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+ & $SendKeys -WindowHandle $Window.WindowHandle
+ }
+ Else {
+ [hashtable]$GetWindowTitleSplat = @{}
+ If ($GetAllWindowTitles) { $GetWindowTitleSplat.Add( 'GetAllWindowTitles', $GetAllWindowTitles) }
+ Else { $GetWindowTitleSplat.Add( 'WindowTitle', $WindowTitle) }
+ [psobject[]]$AllWindows = Get-WindowTitle @GetWindowTitleSplat
+ If (-not $AllWindows) {
+ Write-Log -Message 'No windows with the specified details were discovered.' -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ ForEach ($Window in $AllWindows) {
+ & $SendKeys -WindowHandle $Window.WindowHandle
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to send keys to specified window. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-Battery
+Function Test-Battery {
+<#
+.SYNOPSIS
+ Tests whether the local machine is running on AC power or not.
+.DESCRIPTION
+ Tests whether the local machine is running on AC power and returns true/false. For detailed information, use -PassThru option.
+.PARAMETER PassThru
+ Outputs a hashtable containing the following properties:
+ IsLaptop, IsUsingACPower, ACPowerLineStatus, BatteryChargeStatus, BatteryLifePercent, BatteryLifeRemaining, BatteryFullLifetime
+.EXAMPLE
+ Test-Battery
+.EXAMPLE
+ (Test-Battery -PassThru).IsLaptop
+ Determines if the current system is a laptop or not.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## PowerStatus class found in this assembly is more reliable than WMI in cases where the battery is failing.
+ Add-Type -Assembly 'System.Windows.Forms' -ErrorAction 'SilentlyContinue'
+
+ ## Initialize a hashtable to store information about system type and power status
+ [hashtable]$SystemTypePowerStatus = @{ }
+ }
+ Process {
+ Write-Log -Message 'Check if system is using AC power or if it is running on battery...' -Source ${CmdletName}
+
+ [Windows.Forms.PowerStatus]$PowerStatus = [Windows.Forms.SystemInformation]::PowerStatus
+
+ ## Get the system power status. Indicates whether the system is using AC power or if the status is unknown. Possible values:
+ # Offline : The system is not using AC power.
+ # Online : The system is using AC power.
+ # Unknown : The power status of the system is unknown.
+ [string]$PowerLineStatus = $PowerStatus.PowerLineStatus
+ $SystemTypePowerStatus.Add('ACPowerLineStatus', $PowerStatus.PowerLineStatus)
+
+ ## Get the current battery charge status. Possible values: High, Low, Critical, Charging, NoSystemBattery, Unknown.
+ [string]$BatteryChargeStatus = $PowerStatus.BatteryChargeStatus
+ $SystemTypePowerStatus.Add('BatteryChargeStatus', $PowerStatus.BatteryChargeStatus)
+
+ ## Get the approximate amount, from 0.00 to 1.0, of full battery charge remaining.
+ # This property can report 1.0 when the battery is damaged and Windows can't detect a battery.
+ # Therefore, this property is only indicative of battery charge remaining if 'BatteryChargeStatus' property is not reporting 'NoSystemBattery' or 'Unknown'.
+ [single]$BatteryLifePercent = $PowerStatus.BatteryLifePercent
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ [single]$BatteryLifePercent = 0.0
+ }
+ $SystemTypePowerStatus.Add('BatteryLifePercent', $PowerStatus.BatteryLifePercent)
+
+ ## The reported approximate number of seconds of battery life remaining. It will report –1 if the remaining life is unknown because the system is on AC power.
+ [int32]$BatteryLifeRemaining = $PowerStatus.BatteryLifeRemaining
+ $SystemTypePowerStatus.Add('BatteryLifeRemaining', $PowerStatus.BatteryLifeRemaining)
+
+ ## Get the manufacturer reported full charge lifetime of the primary battery power source in seconds.
+ # The reported number of seconds of battery life available when the battery is fully charged, or -1 if it is unknown.
+ # This will only be reported if the battery supports reporting this information. You will most likely get -1, indicating unknown.
+ [int32]$BatteryFullLifetime = $PowerStatus.BatteryFullLifetime
+ $SystemTypePowerStatus.Add('BatteryFullLifetime', $PowerStatus.BatteryFullLifetime)
+
+ ## Determine if the system is using AC power
+ [boolean]$OnACPower = $false
+ If ($PowerLineStatus -eq 'Online') {
+ Write-Log -Message 'System is using AC power.' -Source ${CmdletName}
+ $OnACPower = $true
+ }
+ ElseIf ($PowerLineStatus -eq 'Offline') {
+ Write-Log -Message 'System is using battery power.' -Source ${CmdletName}
+ }
+ ElseIf ($PowerLineStatus -eq 'Unknown') {
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ Write-Log -Message "System power status is [$PowerLineStatus] and battery charge status is [$BatteryChargeStatus]. This is most likely due to a damaged battery so we will report system is using AC power." -Source ${CmdletName}
+ $OnACPower = $true
+ }
+ Else {
+ Write-Log -Message "System power status is [$PowerLineStatus] and battery charge status is [$BatteryChargeStatus]. Therefore, we will report system is using battery power." -Source ${CmdletName}
+ }
+ }
+ $SystemTypePowerStatus.Add('IsUsingACPower', $OnACPower)
+
+ ## Determine if the system is a laptop
+ [boolean]$IsLaptop = $false
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ $IsLaptop = $false
+ }
+ Else {
+ $IsLaptop = $true
+ }
+ # Chassis Types
+ [int32[]]$ChassisTypes = Get-WmiObject -Class 'Win32_SystemEnclosure' | Where-Object { $_.ChassisTypes } | Select-Object -ExpandProperty 'ChassisTypes'
+ Write-Log -Message "The following system chassis types were detected [$($ChassisTypes -join ',')]." -Source ${CmdletName}
+ ForEach ($ChassisType in $ChassisTypes) {
+ Switch ($ChassisType) {
+ { $_ -eq 9 -or $_ -eq 10 -or $_ -eq 14 } { $IsLaptop = $true } # 9=Laptop, 10=Notebook, 14=Sub Notebook
+ { $_ -eq 3 } { $IsLaptop = $false } # 3=Desktop
+ }
+ }
+ # Add IsLaptop property to hashtable
+ $SystemTypePowerStatus.Add('IsLaptop', $IsLaptop)
+
+ If ($PassThru) {
+ Write-Output -InputObject $SystemTypePowerStatus
+ }
+ Else {
+ Write-Output -InputObject $OnACPower
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-NetworkConnection
+Function Test-NetworkConnection {
+<#
+.SYNOPSIS
+ Tests for an active local network connection, excluding wireless and virtual network adapters.
+.DESCRIPTION
+ Tests for an active local network connection, excluding wireless and virtual network adapters, by querying the Win32_NetworkAdapter WMI class.
+.EXAMPLE
+ Test-NetworkConnection
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message 'Check if system is using a wired network connection...' -Source ${CmdletName}
+
+ [psobject[]]$networkConnected = Get-WmiObject -Class 'Win32_NetworkAdapter' | Where-Object { ($_.NetConnectionStatus -eq 2) -and ($_.NetConnectionID -match 'Local') -and ($_.NetConnectionID -notmatch 'Wireless') -and ($_.Name -notmatch 'Virtual') } -ErrorAction 'SilentlyContinue'
+ [boolean]$onNetwork = $false
+ If ($networkConnected) {
+ Write-Log -Message 'Wired network connection found.' -Source ${CmdletName}
+ [boolean]$onNetwork = $true
+ }
+ Else {
+ Write-Log -Message 'Wired network connection not found.' -Source ${CmdletName}
+ }
+
+ Write-Output -InputObject $onNetwork
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-PowerPoint
+Function Test-PowerPoint {
+<#
+.SYNOPSIS
+ Tests whether PowerPoint is running in either fullscreen slideshow mode or presentation mode.
+.DESCRIPTION
+ Tests whether someone is presenting using PowerPoint in either fullscreen slideshow mode or presentation mode.
+.EXAMPLE
+ Test-PowerPoint
+.NOTES
+ This function can only execute detection logic if the process is in interactive mode.
+ There is a possiblity of a false positive if the PowerPoint filename starts with "PowerPoint Slide Show".
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Check if PowerPoint is in either fullscreen slideshow mode or presentation mode...' -Source ${CmdletName}
+ Try {
+ [Diagnostics.Process[]]$PowerPointProcess = Get-Process -ErrorAction 'Stop' | Where-Object { $_.ProcessName -eq 'POWERPNT' }
+ If ($PowerPointProcess) {
+ [boolean]$IsPowerPointRunning = $true
+ Write-Log -Message 'PowerPoint application is running.' -Source ${CmdletName}
+ }
+ Else {
+ [boolean]$IsPowerPointRunning = $false
+ Write-Log -Message 'PowerPoint application is not running.' -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Throw
+ }
+
+ [nullable[boolean]]$IsPowerPointFullScreen = $false
+ If ($IsPowerPointRunning) {
+ ## Detect if PowerPoint is in fullscreen mode or Presentation Mode, detection method only works if process is interactive
+ If ([Environment]::UserInteractive) {
+ # Check if "POWERPNT" process has a window with a title that begins with "PowerPoint Slide Show" or "Powerpoint-" for non-English language systems.
+ # There is a possiblity of a false positive if the PowerPoint filename starts with "PowerPoint Slide Show"
+ [psobject]$PowerPointWindow = Get-WindowTitle -GetAllWindowTitles | Where { $_.WindowTitle -match '^PowerPoint Slide Show' -or $_.WindowTitle -match '^PowerPoint-' } | Where-Object { $_.ParentProcess -eq 'POWERPNT'} | Select-Object -First 1
+ If ($PowerPointWindow) {
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ Write-Log -Message 'Detected that PowerPoint process [POWERPNT] has a window with a title that beings with [PowerPoint Slide Show] or [PowerPoint-].' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message 'Detected that PowerPoint process [POWERPNT] does not have a window with a title that beings with [PowerPoint Slide Show] or [PowerPoint-].' -Source ${CmdletName}
+ Try {
+ [int32[]]$PowerPointProcessIDs = $PowerPointProcess | Select-Object -ExpandProperty 'Id' -ErrorAction 'Stop'
+ Write-Log -Message "PowerPoint process [POWERPNT] has process id(s) [$($PowerPointProcessIDs -join ', ')]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Unable to retrieve process id(s) for [POWERPNT] process. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+
+ ## If previous detection method did not detect PowerPoint in fullscreen mode, then check if PowerPoint is in Presentation Mode (check only works on Windows Vista or higher)
+ If ((-not $IsPowerPointFullScreen) -and (([version]$envOSVersion).Major -gt 5)) {
+ # Note: below method does not detect PowerPoint presentation mode if the presentation is on a monitor that does not have current mouse input control
+ [string]$UserNotificationState = [PSADT.UiAutomation]::GetUserNotificationState()
+ Write-Log -Message "Detected user notification state [$UserNotificationState]." -Source ${CmdletName}
+ Switch ($UserNotificationState) {
+ 'PresentationMode' {
+ Write-Log -Message "Detected that system is in [Presentation Mode]." -Source ${CmdletName}
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ }
+ 'FullScreenOrPresentationModeOrLoginScreen' {
+ If (([string]$PowerPointProcessIDs) -and ($PowerPointProcessIDs -contains [PSADT.UIAutomation]::GetWindowThreadProcessID([PSADT.UIAutomation]::GetForeGroundWindow()))) {
+ Write-Log -Message "Detected that fullscreen foreground window matches PowerPoint process id." -Source ${CmdletName}
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ }
+ }
+ }
+ }
+ }
+ Else {
+ [nullable[boolean]]$IsPowerPointFullScreen = $null
+ Write-Log -Message 'Unable to run check to see if PowerPoint is in fullscreen mode or Presentation Mode because current process is not interactive. Configure script to run in interactive mode in your deployment tool. If using SCCM Application Model, then make sure "Allow users to view and interact with the program installation" is selected. If using SCCM Package Model, then make sure "Allow users to interact with this program" is selected.' -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsPowerPointFullScreen = $null
+ Write-Log -Message "Failed check to see if PowerPoint is running in fullscreen slideshow mode. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-Log -Message "PowerPoint is running in fullscreen mode [$IsPowerPointFullScreen]." -Source ${CmdletName}
+ Write-Output -InputObject $IsPowerPointFullScreen
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-SCCMTask
+Function Invoke-SCCMTask {
+<#
+.SYNOPSIS
+ Triggers SCCM to invoke the requested schedule task id.
+.DESCRIPTION
+ Triggers SCCM to invoke the requested schedule task id.
+.PARAMETER ScheduleId
+ Name of the schedule id to trigger.
+ Options: HardwareInventory, SoftwareInventory, HeartbeatDiscovery, SoftwareInventoryFileCollection, RequestMachinePolicy, EvaluateMachinePolicy,
+ LocationServicesCleanup, SoftwareMeteringReport, SourceUpdate, PolicyAgentCleanup, RequestMachinePolicy2, CertificateMaintenance, PeerDistributionPointStatus,
+ PeerDistributionPointProvisioning, ComplianceIntervalEnforcement, SoftwareUpdatesAgentAssignmentEvaluation, UploadStateMessage, StateMessageManager,
+ SoftwareUpdatesScan, AMTProvisionCycle, UpdateStorePolicy, StateSystemBulkSend, ApplicationManagerPolicyAction, PowerManagementStartSummarizer
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Invoke-SCCMTask 'SoftwareUpdatesScan'
+.EXAMPLE
+ Invoke-SCCMTask
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('HardwareInventory','SoftwareInventory','HeartbeatDiscovery','SoftwareInventoryFileCollection','RequestMachinePolicy','EvaluateMachinePolicy','LocationServicesCleanup','SoftwareMeteringReport','SourceUpdate','PolicyAgentCleanup','RequestMachinePolicy2','CertificateMaintenance','PeerDistributionPointStatus','PeerDistributionPointProvisioning','ComplianceIntervalEnforcement','SoftwareUpdatesAgentAssignmentEvaluation','UploadStateMessage','StateMessageManager','SoftwareUpdatesScan','AMTProvisionCycle','UpdateStorePolicy','StateSystemBulkSend','ApplicationManagerPolicyAction','PowerManagementStartSummarizer')]
+ [string]$ScheduleID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Invoke SCCM Schedule Task ID [$ScheduleId]..." -Source ${CmdletName}
+
+ ## Make sure SCCM client is installed and running
+ Write-Log -Message 'Check to see if SCCM Client service [ccmexec] is installed and running.' -Source ${CmdletName}
+ If (Test-ServiceExists -Name 'ccmexec') {
+ If ($(Get-Service -Name 'ccmexec' -ErrorAction 'SilentlyContinue').Status -ne 'Running') {
+ Throw "SCCM Client Service [ccmexec] exists but it is not in a 'Running' state."
+ }
+ } Else {
+ Throw 'SCCM Client Service [ccmexec] does not exist. The SCCM Client may not be installed.'
+ }
+
+ ## Determine the SCCM Client Version
+ Try {
+ [version]$SCCMClientVersion = Get-WmiObject -Namespace 'ROOT\CCM' -Class 'CCM_InstalledComponent' -ErrorAction 'Stop' | Where-Object { $_.Name -eq 'SmsClient' } | Select-Object -ExpandProperty 'Version' -ErrorAction 'Stop'
+ Write-Log -Message "Installed SCCM Client Version Number [$SCCMClientVersion]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to determine the SCCM client version number. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to determine the SCCM client version number.'
+ }
+
+ ## Create a hashtable of Schedule IDs compatible with SCCM Client 2007
+ [hashtable]$ScheduleIds = @{
+ HardwareInventory = '{00000000-0000-0000-0000-000000000001}'; # Hardware Inventory Collection Task
+ SoftwareInventory = '{00000000-0000-0000-0000-000000000002}'; # Software Inventory Collection Task
+ HeartbeatDiscovery = '{00000000-0000-0000-0000-000000000003}'; # Heartbeat Discovery Cycle
+ SoftwareInventoryFileCollection = '{00000000-0000-0000-0000-000000000010}'; # Software Inventory File Collection Task
+ RequestMachinePolicy = '{00000000-0000-0000-0000-000000000021}'; # Request Machine Policy Assignments
+ EvaluateMachinePolicy = '{00000000-0000-0000-0000-000000000022}'; # Evaluate Machine Policy Assignments
+ RefreshDefaultMp = '{00000000-0000-0000-0000-000000000023}'; # Refresh Default MP Task
+ RefreshLocationServices = '{00000000-0000-0000-0000-000000000024}'; # Refresh Location Services Task
+ LocationServicesCleanup = '{00000000-0000-0000-0000-000000000025}'; # Location Services Cleanup Task
+ SoftwareMeteringReport = '{00000000-0000-0000-0000-000000000031}'; # Software Metering Report Cycle
+ SourceUpdate = '{00000000-0000-0000-0000-000000000032}'; # Source Update Manage Update Cycle
+ PolicyAgentCleanup = '{00000000-0000-0000-0000-000000000040}'; # Policy Agent Cleanup Cycle
+ RequestMachinePolicy2 = '{00000000-0000-0000-0000-000000000042}'; # Request Machine Policy Assignments
+ CertificateMaintenance = '{00000000-0000-0000-0000-000000000051}'; # Certificate Maintenance Cycle
+ PeerDistributionPointStatus = '{00000000-0000-0000-0000-000000000061}'; # Peer Distribution Point Status Task
+ PeerDistributionPointProvisioning = '{00000000-0000-0000-0000-000000000062}'; # Peer Distribution Point Provisioning Status Task
+ ComplianceIntervalEnforcement = '{00000000-0000-0000-0000-000000000071}'; # Compliance Interval Enforcement
+ SoftwareUpdatesAgentAssignmentEvaluation = '{00000000-0000-0000-0000-000000000108}'; # Software Updates Agent Assignment Evaluation Cycle
+ UploadStateMessage = '{00000000-0000-0000-0000-000000000111}'; # Send Unsent State Messages
+ StateMessageManager = '{00000000-0000-0000-0000-000000000112}'; # State Message Manager Task
+ SoftwareUpdatesScan = '{00000000-0000-0000-0000-000000000113}'; # Force Update Scan
+ AMTProvisionCycle = '{00000000-0000-0000-0000-000000000120}'; # AMT Provision Cycle
+ }
+
+ ## If SCCM 2012 Client or higher, modify hashtabe containing Schedule IDs so that it only has the ones compatible with this version of the SCCM client
+ If ($SCCMClientVersion.Major -ge 5) {
+ $ScheduleIds.Remove('PeerDistributionPointStatus')
+ $ScheduleIds.Remove('PeerDistributionPointProvisioning')
+ $ScheduleIds.Remove('ComplianceIntervalEnforcement')
+ $ScheduleIds.Add('UpdateStorePolicy','{00000000-0000-0000-0000-000000000114}') # Update Store Policy
+ $ScheduleIds.Add('StateSystemBulkSend','{00000000-0000-0000-0000-000000000116}') # State System Policy Bulk Send Low
+ $ScheduleIds.Add('ApplicationManagerPolicyAction','{00000000-0000-0000-0000-000000000121}') # Application Manager Policy Action
+ $ScheduleIds.Add('PowerManagementStartSummarizer','{00000000-0000-0000-0000-000000000131}') # Power Management Start Summarizer
+ }
+
+ ## Determine if the requested Schedule ID is available on this version of the SCCM Client
+ If (-not ($ScheduleIds.ContainsKey($ScheduleId))) {
+ Throw "The requested ScheduleId [$ScheduleId] is not available with this version of the SCCM Client [$SCCMClientVersion]."
+ }
+
+ ## Trigger SCCM task
+ Write-Log -Message "Trigger SCCM Task ID [$ScheduleId]." -Source ${CmdletName}
+ [Management.ManagementClass]$SmsClient = [WMIClass]'ROOT\CCM:SMS_Client'
+ $null = $SmsClient.TriggerSchedule($ScheduleIds.$ScheduleID)
+ }
+ Catch {
+ Write-Log -Message "Failed to trigger SCCM Schedule Task ID [$($ScheduleIds.$ScheduleId)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger SCCM Schedule Task ID [$($ScheduleIds.$ScheduleId)]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Install-SCCMSoftwareUpdates
+Function Install-SCCMSoftwareUpdates {
+<#
+.SYNOPSIS
+ Scans for outstanding SCCM updates to be installed and installs the pending updates.
+.DESCRIPTION
+ Scans for outstanding SCCM updates to be installed and installs the pending updates.
+ Only compatible with SCCM 2012 Client or higher. This function can take several minutes to run.
+.PARAMETER SoftwareUpdatesScanWaitInSeconds
+ The amount of time to wait in seconds for the software updates scan to complete. Default is: 180 seconds.
+.PARAMETER WaitForPendingUpdatesTimeout
+ The amount of time to wait for missing and pending updates to install before exiting the function. Default is: 45 minutes.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Install-SCCMSoftwareUpdates
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$SoftwareUpdatesScanWaitInSeconds = 180,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [timespan]$WaitForPendingUpdatesTimeout = $(New-TimeSpan -Minutes 45),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Scan for and install pending SCCM software updates.' -Source ${CmdletName}
+
+ ## Make sure SCCM client is installed and running
+ Write-Log -Message 'Check to see if SCCM Client service [ccmexec] is installed and running.' -Source ${CmdletName}
+ If (Test-ServiceExists -Name 'ccmexec') {
+ If ($(Get-Service -Name 'ccmexec' -ErrorAction 'SilentlyContinue').Status -ne 'Running') {
+ Throw "SCCM Client Service [ccmexec] exists but it is not in a 'Running' state."
+ }
+ } Else {
+ Throw 'SCCM Client Service [ccmexec] does not exist. The SCCM Client may not be installed.'
+ }
+
+ ## Determine the SCCM Client Version
+ Try {
+ [version]$SCCMClientVersion = Get-WmiObject -Namespace 'ROOT\CCM' -Class 'CCM_InstalledComponent' -ErrorAction 'Stop' | Where-Object { $_.Name -eq 'SmsClient' } | Select-Object -ExpandProperty 'Version' -ErrorAction 'Stop'
+ Write-Log -Message "Installed SCCM Client Version Number [$SCCMClientVersion]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to determine the SCCM client version number. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to determine the SCCM client version number.'
+ }
+ # If SCCM 2007 Client or lower, exit function
+ If ($SCCMClientVersion.Major -le 4) {
+ Throw 'SCCM 2007 or lower, which is incompatible with this function, was detected on this system.'
+ }
+
+ $StartTime = Get-Date
+ ## Trigger SCCM client scan for Software Updates
+ Write-Log -Message 'Trigger SCCM client scan for Software Updates...' -Source ${CmdletName}
+ Invoke-SCCMTask -ScheduleId 'SoftwareUpdatesScan'
+
+ Write-Log -Message "The SCCM client scan for Software Updates has been triggered. The script is suspended for [$SoftwareUpdatesScanWaitInSeconds] seconds to let the update scan finish." -Source ${CmdletName}
+ Start-Sleep -Seconds $SoftwareUpdatesScanWaitInSeconds
+
+ ## Find the number of missing updates
+ Try {
+ [Management.ManagementObject[]]$CMMissingUpdates = @(Get-WmiObject -Namespace 'ROOT\CCM\ClientSDK' -Query "SELECT * FROM CCM_SoftwareUpdate WHERE ComplianceState = '0'" -ErrorAction 'Stop')
+ }
+ Catch {
+ Write-Log -Message "Failed to find the number of missing software updates. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to find the number of missing software updates.'
+ }
+
+ ## Install missing updates and wait for pending updates to finish installing
+ If ($CMMissingUpdates.Count) {
+ # Install missing updates
+ Write-Log -Message "Install missing updates. The number of missing updates is [$($CMMissingUpdates.Count)]." -Source ${CmdletName}
+ $CMInstallMissingUpdates = (Get-WmiObject -Namespace 'ROOT\CCM\ClientSDK' -Class 'CCM_SoftwareUpdatesManager' -List).InstallUpdates($CMMissingUpdates)
+
+ # Wait for pending updates to finish installing or the timeout value to expire
+ Do {
+ Start-Sleep -Seconds 60
+ [array]$CMInstallPendingUpdates = @(Get-WmiObject -Namespace "ROOT\CCM\ClientSDK" -Query "SELECT * FROM CCM_SoftwareUpdate WHERE EvaluationState = 6 or EvaluationState = 7")
+ Write-Log -Message "The number of updates pending installation is [$($CMInstallPendingUpdates.Count)]." -Source ${CmdletName}
+ } While (($CMInstallPendingUpdates.Count -ne 0) -and ((New-TimeSpan -Start $StartTime -End $(Get-Date)) -lt $WaitForPendingUpdatesTimeout))
+ }
+ Else {
+ Write-Log -Message 'There are no missing updates.' -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to trigger installation of missing software updates. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger installation of missing software updates: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Update-GroupPolicy
+Function Update-GroupPolicy {
+<#
+.SYNOPSIS
+ Performs a gpupdate command to refresh Group Policies on the local machine.
+.DESCRIPTION
+ Performs a gpupdate command to refresh Group Policies on the local machine.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-GroupPolicy
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ [string[]]$GPUpdateCmds = '/C echo N | gpupdate.exe /Target:Computer /Force', '/C echo N | gpupdate.exe /Target:User /Force'
+ [int32]$InstallCount = 0
+ ForEach ($GPUpdateCmd in $GPUpdateCmds) {
+ Try {
+ If ($InstallCount -eq 0) {
+ [string]$InstallMsg = 'Update Group Policies for the Machine'
+ Write-Log -Message "$($InstallMsg)..." -Source ${CmdletName}
+ }
+ Else {
+ [string]$InstallMsg = 'Update Group Policies for the User'
+ Write-Log -Message "$($InstallMsg)..." -Source ${CmdletName}
+ }
+ [psobject]$ExecuteResult = Execute-Process -Path "$envWindir\system32\cmd.exe" -Parameters $GPUpdateCmd -WindowStyle 'Hidden' -PassThru
+
+ If ($ExecuteResult.ExitCode -ne 0) {
+ If ($ExecuteResult.ExitCode -eq 60002) {
+ Throw "Execute-Process function failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ Else {
+ Throw "gpupdate.exe failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ }
+ $InstallCount++
+ }
+ Catch {
+ Write-Log -Message "Failed to $($InstallMsg). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $($InstallMsg): $($_.Exception.Message)"
+ }
+ Continue
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Enable-TerminalServerInstallMode
+Function Enable-TerminalServerInstallMode {
+<#
+.SYNOPSIS
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.DESCRIPTION
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Enable-TerminalServerInstall
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Change terminal server into user install mode...' -Source ${CmdletName}
+ $terminalServerResult = & change.exe User /Install
+
+ If ($global:LastExitCode -ne 1) { Throw $terminalServerResult }
+ }
+ Catch {
+ Write-Log -Message "Failed to change terminal server into user install mode. `n$(Resolve-Error) " -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to change terminal server into user install mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Disable-TerminalServerInstallMode
+Function Disable-TerminalServerInstallMode {
+<#
+.SYNOPSIS
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.DESCRIPTION
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Disable-TerminalServerInstall
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Change terminal server into user execute mode...' -Source ${CmdletName}
+ $terminalServerResult = & change.exe User /Execute
+
+ If ($global:LastExitCode -ne 1) { Throw $terminalServerResult }
+ }
+ Catch {
+ Write-Log -Message "Failed to change terminal server into user execute mode. `n$(Resolve-Error) " -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to change terminal server into user execute mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-ActiveSetup
+Function Set-ActiveSetup {
+<#
+.SYNOPSIS
+ Creates an Active Setup entry in the registry to execute a file for each user upon login.
+.DESCRIPTION
+ Active Setup allows handling of per-user changes registry/file changes upon login.
+ A registry key is created in the HKLM registry hive which gets replicated to the HKCU hive when a user logs in.
+ If the "Version" value of the Active Setup entry in HKLM is higher than the version value in HKCU, the file referenced in "StubPath" is executed.
+ This Function:
+ - Creates the registry entries in HKLM:SOFTWARE\Microsoft\Active Setup\Installed Components\$installName.
+ - Creates StubPath value depending on the file extension of the $StubExePath parameter.
+ - Handles Version value with YYYYMMDDHHMMSS granularity to permit re-installs on the same day and still trigger Active Setup after Version increase.
+ - Copies/overwrites the StubPath file to $StubExePath destination path if file exists in 'Files' subdirectory of script directory.
+ - Executes the StubPath file for the current user as long as not in Session 0 (no need to logout/login to trigger Active Setup).
+.PARAMETER StubExePath
+ Full destination path to the file that will be executed for each user that logs in.
+ If this file exists in the 'Files' subdirectory of the script directory, it will be copied to the destination path.
+.PARAMETER Arguments
+ Arguments to pass to the file being executed.
+.PARAMETER Description
+ Description for the Active Setup. Users will see "Setting up personalized settings for: $Description" at logon. Default is: $installName.
+.PARAMETER Key
+ Name of the registry key for the Active Setup entry. Default is: $installName.
+.PARAMETER Version
+ Optional. Specify version for Active setup entry. Active Setup is not triggered if Version value has more than 8 consecutive digits. Use commas to get around this limitation.
+.PARAMETER Locale
+ Optional. Arbitrary string used to specify the installation language of the file being executed. Not replicated to HKCU.
+.PARAMETER PurgeActiveSetupKey
+ Remove Active Setup entry from HKLM registry hive. Will also load each logon user's HKCU registry hive to remove Active Setup entry.
+.PARAMETER DisableActiveSetup
+ Disables the Active Setup entry so that the StubPath file will not be executed.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-ActiveSetup -StubExePath 'C:\Users\Public\Company\ProgramUserConfig.vbs' -Arguments '/Silent' -Description 'Program User Config' -Key 'ProgramUserConfig' -Locale 'en'
+.EXAMPLE
+ Set-ActiveSetup -StubExePath "$envWinDir\regedit.exe" -Arguments "/S `"%SystemDrive%\Program Files (x86)\PS App Deploy\PSAppDeployHKCUSettings.reg`"" -Description 'PS App Deploy Config' -Key 'PS_App_Deploy_Config' -ContinueOnError $true
+.EXAMPLE
+ Set-ActiveSetup -Key 'ProgramUserConfig' -PurgeActiveSetupKey
+ Deletes "ProgramUserConfig" active setup entry from all registry hives.
+.NOTES
+ Original code borrowed from: Denis St-Pierre (Ottawa, Canada), Todd MacNaught (Ottawa, Canada)
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$StubExePath,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Arguments,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Description = $installName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key = $installName,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Version = ((Get-Date -Format 'yyMM,ddHH,mmss').ToString()), # Ex: 1405,1515,0522
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Locale,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [switch]$DisableActiveSetup = $false,
+ [Parameter(Mandatory=$true,ParameterSetName='Purge')]
+ [switch]$PurgeActiveSetupKey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ [string]$ActiveSetupKey = "HKLM:SOFTWARE\Microsoft\Active Setup\Installed Components\$Key"
+ [string]$HKCUActiveSetupKey = "HKCU:Software\Microsoft\Active Setup\Installed Components\$Key"
+
+ ## Delete Active Setup registry entry from the HKLM hive and for all logon user registry hives on the system
+ If ($PurgeActiveSetupKey) {
+ Write-Log -Message "Remove Active Setup entry [$ActiveSetupKey]." -Source ${CmdletName}
+ Remove-RegistryKey -Key $ActiveSetupKey -Recurse
+
+ Write-Log -Message "Remove Active Setup entry [$HKCUActiveSetupKey] for all log on user registry hives on the system." -Source ${CmdletName}
+ [scriptblock]$RemoveHKCUActiveSetupKey = { Remove-RegistryKey -Key $HKCUActiveSetupKey -SID $UserProfile.SID -Recurse }
+ Invoke-HKCURegistrySettingsForAllUsers -RegistrySettings $RemoveHKCUActiveSetupKey -UserProfiles (Get-UserProfiles -ExcludeDefaultUser)
+ Return
+ }
+
+ ## Verify a file with a supported file extension was specified in $StubExePath
+ [string[]]$StubExePathFileExtensions = '.exe', '.vbs', '.cmd', '.ps1', '.js'
+ [string]$StubExeExt = [IO.Path]::GetExtension($StubExePath)
+ If ($StubExePathFileExtensions -notcontains $StubExeExt) {
+ Throw "Unsupported Active Setup StubPath file extension [$StubExeExt]."
+ }
+
+ ## Copy file to $StubExePath from the 'Files' subdirectory of the script directory (if it exists there)
+ [string]$StubExePath = [Environment]::ExpandEnvironmentVariables($StubExePath)
+ [string]$ActiveSetupFileName = [IO.Path]::GetFileName($StubExePath)
+ [string]$StubExeFile = Join-Path -Path $dirFiles -ChildPath $ActiveSetupFileName
+ If (Test-Path -LiteralPath $StubExeFile -PathType 'Leaf') {
+ # This will overwrite the StubPath file if $StubExePath already exists on target
+ Copy-File -Path $StubExeFile -Destination $StubExePath -ContinueOnError $false
+ }
+
+ ## Check if the $StubExePath file exists
+ If (-not (Test-Path -LiteralPath $StubExePath -PathType 'Leaf')) { Throw "Active Setup StubPath file [$ActiveSetupFileName] is missing." }
+
+ ## Define Active Setup StubPath according to file extension of $StubExePath
+ Switch ($StubExeExt) {
+ '.exe' {
+ [string]$CUStubExePath = $StubExePath
+ [string]$CUArguments = $Arguments
+ [string]$StubPath = "$CUStubExePath"
+ }
+ {'.vbs','.js' -contains $StubExeExt} {
+ [string]$CUStubExePath = "$envWinDir\system32\cscript.exe"
+ [string]$CUArguments = "//nologo `"$StubExePath`""
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ '.cmd' {
+ [string]$CUStubExePath = "$envWinDir\system32\CMD.exe"
+ [string]$CUArguments = "/C `"$StubExePath`""
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ '.ps1' {
+ [string]$CUStubExePath = "$PSHOME\powershell.exe"
+ [string]$CUArguments = "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -Command & { & `\`"$StubExePath`\`"}"
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ }
+ If ($Arguments) {
+ [string]$StubPath = "$StubPath $Arguments"
+ If ($StubExeExt -ne '.exe') { [string]$CUArguments = "$CUArguments $Arguments" }
+ }
+
+ ## Create the Active Setup entry in the registry
+ [scriptblock]$SetActiveSetupRegKeys = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$ActiveSetupRegKey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+ If ($SID) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name '(Default)' -Value $Description -SID $SID -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'StubPath' -Value $StubPath -Type 'String' -SID $SID -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Version' -Value $Version -SID $SID -ContinueOnError $false
+ If ($Locale) { Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Locale' -Value $Locale -SID $SID -ContinueOnError $false }
+ If ($DisableActiveSetup) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 0 -Type 'DWord' -SID $SID -ContinueOnError $false
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 1 -Type 'DWord' -SID $SID -ContinueOnError $false
+ }
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name '(Default)' -Value $Description -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'StubPath' -Value $StubPath -Type 'String' -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Version' -Value $Version -ContinueOnError $false
+ If ($Locale) { Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Locale' -Value $Locale -ContinueOnError $false }
+ If ($DisableActiveSetup) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 0 -Type 'DWord' -ContinueOnError $false
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 1 -Type 'DWord' -ContinueOnError $false
+ }
+ }
+
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $ActiveSetupKey
+
+ ## Execute the StubPath file for the current user as long as not in Session 0
+ If ($SessionZero) {
+ If ($RunAsActiveUser) {
+ Write-Log -Message "Session 0 detected: Execute Active Setup StubPath file for currently logged in user [$($RunAsActiveUser.NTAccount)]." -Source ${CmdletName}
+ If ($CUArguments) {
+ Execute-ProcessAsUser -Path $CUStubExePath -Parameters $CUArguments -Wait -ContinueOnError $true
+ }
+ Else {
+ Execute-ProcessAsUser -Path $CUStubExePath -Wait -ContinueOnError $true
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $HKCUActiveSetupKey -SID $RunAsActiveUser.SID
+ }
+ Else {
+ Write-Log -Message 'Session 0 detected: No logged in users detected. Active Setup StubPath file will execute when users first log into their account.' -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message 'Execute Active Setup StubPath file for the current user.' -Source ${CmdletName}
+ If ($CUArguments) {
+ $ExecuteResults = Execute-Process -FilePath $CUStubExePath -Parameters $CUArguments -PassThru
+ }
+ Else {
+ $ExecuteResults = Execute-Process -FilePath $CUStubExePath -PassThru
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $HKCUActiveSetupKey
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to set Active Setup registry entry. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set Active Setup registry entry: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-ServiceExists
+Function Test-ServiceExists {
+<#
+.SYNOPSIS
+ Check to see if a service exists.
+.DESCRIPTION
+ Check to see if a service exists (using WMI method because Get-Service will generate ErrorRecord if service doesn't exist).
+.PARAMETER Name
+ Specify the name of the service.
+ Note: Service name can be found by executing "Get-Service | Format-Table -AutoSize -Wrap" or by using the properties screen of a service in services.msc.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER PassThru
+ Return the WMI service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Test-ServiceExists -Name 'wuauserv'
+.EXAMPLE
+ Test-ServiceExists -Name 'testservice' -PassThru | Where-Object { $_ } | ForEach-Object { $_.Delete() }
+ Check if a service exists and then delete it by using the -PassThru parameter.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $ServiceObject = Get-WmiObject -ComputerName $ComputerName -Class 'Win32_Service' -Filter "Name='$Name'" -ErrorAction 'Stop'
+ # If nothing is returned from Win32_Service, check Win32_BaseService
+ If (-not ($ServiceObject) ) {
+ $ServiceObject = Get-WmiObject -ComputerName $ComputerName -Class 'Win32_BaseService' -Filter "Name='$Name'" -ErrorAction 'Stop'
+ }
+
+ If ($ServiceObject) {
+ Write-Log -Message "Service [$Name] exists." -Source ${CmdletName}
+ If ($PassThru) { Write-Output -InputObject $ServiceObject } Else { Write-Output -InputObject $true }
+ }
+ Else {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName}
+ If ($PassThru) { Write-Output -InputObject $ServiceObject } Else { Write-Output -InputObject $false }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed check to see if service [$Name] exists." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed check to see if service [$Name] exists: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Stop-ServiceAndDependencies
+Function Stop-ServiceAndDependencies {
+<#
+.SYNOPSIS
+ Stop Windows service and its dependencies.
+.DESCRIPTION
+ Stop Windows service and its dependencies.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER SkipServiceExistsTest
+ Choose to skip the test to check whether or not the service exists if it was already done outside of this function.
+.PARAMETER SkipDependentServices
+ Choose to skip checking for and stopping dependent services. Default is: $false.
+.PARAMETER PendingStatusWait
+ The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.
+.PARAMETER PassThru
+ Return the System.ServiceProcess.ServiceController service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Stop-ServiceAndDependencies -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipServiceExistsTest,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipDependentServices,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [timespan]$PendingStatusWait = (New-TimeSpan -Seconds 60),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Check to see if the service exists
+ If ((-not $SkipServiceExistsTest) -and (-not (Test-ServiceExists -ComputerName $ComputerName -Name $Name -ContinueOnError $false))) {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName} -Severity 2
+ Throw "Service [$Name] does not exist."
+ }
+
+ ## Get the service object
+ Write-Log -Message "Get the service object for service [$Name]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction 'Stop'
+ ## Wait up to 60 seconds if service is in a pending state
+ [string[]]$PendingStatus = 'ContinuePending', 'PausePending', 'StartPending', 'StopPending'
+ If ($PendingStatus -contains $Service.Status) {
+ Switch ($Service.Status) {
+ 'ContinuePending' { $DesiredStatus = 'Running' }
+ 'PausePending' { $DesiredStatus = 'Paused' }
+ 'StartPending' { $DesiredStatus = 'Running' }
+ 'StopPending' { $DesiredStatus = 'Stopped' }
+ }
+ Write-Log -Message "Waiting for up to [$($PendingStatusWait.TotalSeconds)] seconds to allow service pending status [$($Service.Status)] to reach desired status [$DesiredStatus]." -Source ${CmdletName}
+ $Service.WaitForStatus([ServiceProcess.ServiceControllerStatus]$DesiredStatus, $PendingStatusWait)
+ $Service.Refresh()
+ }
+ ## Discover if the service is currently running
+ Write-Log -Message "Service [$($Service.ServiceName)] with display name [$($Service.DisplayName)] has a status of [$($Service.Status)]." -Source ${CmdletName}
+ If ($Service.Status -ne 'Stopped') {
+ # Discover all dependent services that are running and stop them
+ If (-not $SkipDependentServices) {
+ Write-Log -Message "Discover all dependent service(s) for service [$Name] which are not 'Stopped'." -Source ${CmdletName}
+ [ServiceProcess.ServiceController[]]$DependentServices = Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -DependentServices -ErrorAction 'Stop' | Where-Object { $_.Status -ne 'Stopped' }
+ If ($DependentServices) {
+ ForEach ($DependentService in $DependentServices) {
+ Write-Log -Message "Stop dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]." -Source ${CmdletName}
+ Try {
+ Stop-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $DependentService.ServiceName -ErrorAction 'Stop') -Force -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]. Continue..." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Dependent service(s) were not discovered for service [$Name]." -Source ${CmdletName}
+ }
+ }
+ # Stop the parent service
+ Write-Log -Message "Stop parent service [$($Service.ServiceName)] with display name [$($Service.DisplayName)]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Stop-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -ErrorAction 'Stop') -Force -PassThru -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to stop the service [$Name]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to stop the service [$Name]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ # Return the service object if option selected
+ If ($PassThru -and $Service) { Write-Output -InputObject $Service }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Start-ServiceAndDependencies
+Function Start-ServiceAndDependencies {
+<#
+.SYNOPSIS
+ Start Windows service and its dependencies.
+.DESCRIPTION
+ Start Windows service and its dependencies.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER SkipServiceExistsTest
+ Choose to skip the test to check whether or not the service exists if it was already done outside of this function.
+.PARAMETER SkipDependentServices
+ Choose to skip checking for and starting dependent services. Default is: $false.
+.PARAMETER PendingStatusWait
+ The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.
+.PARAMETER PassThru
+ Return the System.ServiceProcess.ServiceController service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Start-ServiceAndDependencies -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipServiceExistsTest,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipDependentServices,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [timespan]$PendingStatusWait = (New-TimeSpan -Seconds 60),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Check to see if the service exists
+ If ((-not $SkipServiceExistsTest) -and (-not (Test-ServiceExists -ComputerName $ComputerName -Name $Name -ContinueOnError $false))) {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName} -Severity 2
+ Throw "Service [$Name] does not exist."
+ }
+
+ ## Get the service object
+ Write-Log -Message "Get the service object for service [$Name]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction 'Stop'
+ ## Wait up to 60 seconds if service is in a pending state
+ [string[]]$PendingStatus = 'ContinuePending', 'PausePending', 'StartPending', 'StopPending'
+ If ($PendingStatus -contains $Service.Status) {
+ Switch ($Service.Status) {
+ 'ContinuePending' { $DesiredStatus = 'Running' }
+ 'PausePending' { $DesiredStatus = 'Paused' }
+ 'StartPending' { $DesiredStatus = 'Running' }
+ 'StopPending' { $DesiredStatus = 'Stopped' }
+ }
+ Write-Log -Message "Waiting for up to [$($PendingStatusWait.TotalSeconds)] seconds to allow service pending status [$($Service.Status)] to reach desired status [$DesiredStatus]." -Source ${CmdletName}
+ $Service.WaitForStatus([ServiceProcess.ServiceControllerStatus]$DesiredStatus, $PendingStatusWait)
+ $Service.Refresh()
+ }
+ ## Discover if the service is currently stopped
+ Write-Log -Message "Service [$($Service.ServiceName)] with display name [$($Service.DisplayName)] has a status of [$($Service.Status)]." -Source ${CmdletName}
+ If ($Service.Status -ne 'Running') {
+ # Start the parent service
+ Write-Log -Message "Start parent service [$($Service.ServiceName)] with display name [$($Service.DisplayName)]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Start-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -ErrorAction 'Stop') -PassThru -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+
+ # Discover all dependent services that are stopped and start them
+ If (-not $SkipDependentServices) {
+ Write-Log -Message "Discover all dependent service(s) for service [$Name] which are not 'Running'." -Source ${CmdletName}
+ [ServiceProcess.ServiceController[]]$DependentServices = Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -DependentServices -ErrorAction 'Stop' | Where-Object { $_.Status -ne 'Running' }
+ If ($DependentServices) {
+ ForEach ($DependentService in $DependentServices) {
+ Write-Log -Message "Start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]." -Source ${CmdletName}
+ Try {
+ Start-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $DependentService.ServiceName -ErrorAction 'Stop') -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]. Continue..." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Dependent service(s) were not discovered for service [$Name]." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to start the service [$Name]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to start the service [$Name]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ # Return the service object if option selected
+ If ($PassThru -and $Service) { Write-Output -InputObject $Service }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-ServiceStartMode
+Function Get-ServiceStartMode
+{
+<#
+.SYNOPSIS
+ Get the service startup mode.
+.DESCRIPTION
+ Get the service startup mode.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-ServiceStartMode -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdLetBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get the service [$Name] startup mode." -Source ${CmdletName}
+ [string]$ServiceStartMode = (Get-WmiObject -ComputerName $ComputerName -Class 'Win32_Service' -Filter "Name='$Name'" -Property 'StartMode' -ErrorAction 'Stop').StartMode
+ ## If service start mode is set to 'Auto', change value to 'Automatic' to be consistent with 'Set-ServiceStartMode' function
+ If ($ServiceStartMode -eq 'Auto') { $ServiceStartMode = 'Automatic'}
+
+ ## If on Windows Vista or higher, check to see if service is set to Automatic (Delayed Start)
+ If (($ServiceStartMode -eq 'Automatic') -and (([version]$envOSVersion).Major -gt 5)) {
+ Try {
+ [string]$ServiceRegistryPath = "HKLM:SYSTEM\CurrentControlSet\Services\$Name"
+ [int32]$DelayedAutoStart = Get-ItemProperty -LiteralPath $ServiceRegistryPath -ErrorAction 'Stop' | Select-Object -ExpandProperty 'DelayedAutoStart' -ErrorAction 'Stop'
+ If ($DelayedAutoStart -eq 1) { $ServiceStartMode = 'Automatic (Delayed Start)' }
+ }
+ Catch { }
+ }
+
+ Write-Log -Message "Service [$Name] startup mode is set to [$ServiceStartMode]." -Source ${CmdletName}
+ Write-Output -InputObject $ServiceStartMode
+ }
+ Catch {
+ Write-Log -Message "Failed to get the service [$Name] startup mode. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the service [$Name] startup mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-ServiceStartMode
+Function Set-ServiceStartMode
+{
+<#
+.SYNOPSIS
+ Set the service startup mode.
+.DESCRIPTION
+ Set the service startup mode.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER StartMode
+ Specify startup mode for the service. Options: Automatic, Automatic (Delayed Start), Manual, Disabled, Boot, System.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-ServiceStartMode -Name 'wuauserv' -StartMode 'Automatic (Delayed Start)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdLetBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('Automatic','Automatic (Delayed Start)','Manual','Disabled','Boot','System')]
+ [string]$StartMode,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If on lower than Windows Vista and 'Automatic (Delayed Start)' selected, then change to 'Automatic' because 'Delayed Start' is not supported.
+ If (($StartMode -eq 'Automatic (Delayed Start)') -and (([version]$envOSVersion).Major -lt 6)) { $StartMode = 'Automatic' }
+
+ Write-Log -Message "Set service [$Name] startup mode to [$StartMode]." -Source ${CmdletName}
+
+ ## Set the name of the start up mode that will be passed to sc.exe
+ [string]$ScExeStartMode = $StartMode
+ If ($StartMode -eq 'Automatic') { $ScExeStartMode = 'Auto' }
+ If ($StartMode -eq 'Automatic (Delayed Start)') { $ScExeStartMode = 'Delayed-Auto' }
+ If ($StartMode -eq 'Manual') { $ScExeStartMode = 'Demand' }
+
+ ## Set the start up mode using sc.exe. Note: we found that the ChangeStartMode method in the Win32_Service WMI class set services to 'Automatic (Delayed Start)' even when you specified 'Automatic' on Win7, Win8, and Win10.
+ $ChangeStartMode = & sc.exe config $Name start= $ScExeStartMode
+
+ If ($global:LastExitCode -ne 0) {
+ Throw "sc.exe failed with exit code [$($global:LastExitCode)] and message [$ChangeStartMode]."
+ }
+
+ Write-Log -Message "Successfully set service [$Name] startup mode to [$StartMode]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to set service [$Name] startup mode to [$StartMode]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to set service [$Name] startup mode to [$StartMode]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-LoggedOnUser
+Function Get-LoggedOnUser {
+<#
+.SYNOPSIS
+ Get session details for all local and RDP logged on users.
+.DESCRIPTION
+ Get session details for all local and RDP logged on users using Win32 APIs. Get the following session details:
+ NTAccount, SID, UserName, DomainName, SessionId, SessionName, ConnectState, IsCurrentSession, IsConsoleSession, IsUserSession, IsActiveUserSession
+ IsRdpSession, IsLocalAdmin, LogonTime, IdleTime, DisconnectTime, ClientName, ClientProtocolType, ClientDirectory, ClientBuildNumber
+.EXAMPLE
+ Get-LoggedOnUser
+.NOTES
+ Description of ConnectState property:
+ Value Description
+ ----- -----------
+ Active A user is logged on to the session.
+ ConnectQuery The session is in the process of connecting to a client.
+ Connected A client is connected to the session.
+ Disconnected The session is active, but the client has disconnected from it.
+ Down The session is down due to an error.
+ Idle The session is waiting for a client to connect.
+ Initializing The session is initializing.
+ Listening The session is listening for connections.
+ Reset The session is being reset.
+ Shadowing This session is shadowing another session.
+
+ Description of IsActiveUserSession property:
+ If a console user exists, then that will be the active user session.
+ If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user that is either 'Active' or 'Connected' is the active user.
+
+ Description of IsRdpSession property:
+ Gets a value indicating whether the user is associated with an RDP client session.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Get session information for all logged on users.' -Source ${CmdletName}
+ Write-Output -InputObject ([PSADT.QueryUser]::GetUserSessionInfo("$env:ComputerName"))
+ }
+ Catch {
+ Write-Log -Message "Failed to get session information for all logged on users. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-PendingReboot
+Function Get-PendingReboot {
+<#
+.SYNOPSIS
+ Get the pending reboot status on a local computer.
+.DESCRIPTION
+ Check WMI and the registry to determine if the system has a pending reboot operation from any of the following:
+ a) Component Based Servicing (Vista, Windows 2008)
+ b) Windows Update / Auto Update (XP, Windows 2003 / 2008)
+ c) SCCM 2012 Clients (DetermineIfRebootPending WMI method)
+ d) App-V Pending Tasks (global based Appv 5.0 SP2)
+ e) Pending File Rename Operations (XP, Windows 2003 / 2008)
+.EXAMPLE
+ Get-PendingReboot
+
+ Returns custom object with following properties:
+ ComputerName, LastBootUpTime, IsSystemRebootPending, IsCBServicingRebootPending, IsWindowsUpdateRebootPending, IsSCCMClientRebootPending, IsFileRenameRebootPending, PendingFileRenameOperations, ErrorMsg
+
+ *Notes: ErrorMsg only contains something if an error occurred
+.EXAMPLE
+ (Get-PendingReboot).IsSystemRebootPending
+ Returns boolean value determining whether or not there is a pending reboot operation.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Initialize variables
+ [string]$private:ComputerName = ([Net.Dns]::GetHostEntry('')).HostName
+ $PendRebootErrorMsg = $null
+ }
+ Process {
+ Write-Log -Message "Get the pending reboot status on the local computer [$ComputerName]." -Source ${CmdletName}
+
+ ## Get the date/time that the system last booted up
+ Try {
+ [nullable[datetime]]$LastBootUpTime = (Get-Date -ErrorAction 'Stop') - ([timespan]::FromMilliseconds([math]::Abs([Environment]::TickCount)))
+ }
+ Catch {
+ [nullable[datetime]]$LastBootUpTime = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get LastBootUpTime: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get LastBootUpTime. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if a Windows Vista/Server 2008 and above machine has a pending reboot from a Component Based Servicing (CBS) operation
+ Try {
+ If (([version]$envOSVersion).Major -ge 5) {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending' -ErrorAction 'Stop') {
+ [nullable[boolean]]$IsCBServicingRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsCBServicingRebootPending = $false
+ }
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsCBServicingRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsCBServicingRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsCBServicingRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from a Windows Update
+ Try {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired' -ErrorAction 'Stop') {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $false
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsWindowsUpdateRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsWindowsUpdateRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from a pending file rename operation
+ [boolean]$IsFileRenameRebootPending = $false
+ $PendingFileRenameOperations = $null
+ If (Test-RegistryValue -Key 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -Value 'PendingFileRenameOperations') {
+ # If PendingFileRenameOperations value exists, set $IsFileRenameRebootPending variable to $true
+ [boolean]$IsFileRenameRebootPending = $true
+ # Get the value of PendingFileRenameOperations
+ Try {
+ [string[]]$PendingFileRenameOperations = Get-ItemProperty -LiteralPath 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'PendingFileRenameOperations' -ErrorAction 'Stop'
+ }
+ Catch {
+ [string[]]$PendRebootErrorMsg += "Failed to get PendingFileRenameOperations: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get PendingFileRenameOperations. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+
+ ## Determine SCCM 2012 Client reboot pending status
+ Try {
+ [boolean]$IsSccmClientNamespaceExists = $false
+ [psobject]$SCCMClientRebootStatus = Invoke-WmiMethod -ComputerName $ComputerName -NameSpace 'ROOT\CCM\ClientSDK' -Class 'CCM_ClientUtilities' -Name 'DetermineIfRebootPending' -ErrorAction 'Stop'
+ [boolean]$IsSccmClientNamespaceExists = $true
+ If ($SCCMClientRebootStatus.ReturnValue -ne 0) {
+ Throw "'DetermineIfRebootPending' method of 'ROOT\CCM\ClientSDK\CCM_ClientUtilities' class returned error code [$($SCCMClientRebootStatus.ReturnValue)]"
+ }
+ Else {
+ Write-Log -Message 'Successfully queried SCCM client for reboot status.' -Source ${CmdletName}
+ [nullable[boolean]]$IsSCCMClientRebootPending = $false
+ If ($SCCMClientRebootStatus.IsHardRebootPending -or $SCCMClientRebootStatus.RebootPending) {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $true
+ Write-Log -Message 'Pending SCCM reboot detected.' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message 'Pending SCCM reboot not detected.' -Source ${CmdletName}
+ }
+ }
+ }
+ Catch [System.Management.ManagementException] {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $null
+ [boolean]$IsSccmClientNamespaceExists = $false
+ Write-Log -Message "Failed to get IsSCCMClientRebootPending. Failed to detect the SCCM client WMI class." -Severity 3 -Source ${CmdletName}
+ }
+ Catch {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsSCCMClientRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsSCCMClientRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from an App-V global Pending Task. (User profile based tasks will complete on logoff/logon)
+ Try {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Software\Microsoft\AppV\Client\PendingTasks' -ErrorAction 'Stop') {
+
+ [nullable[boolean]]$IsAppVRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsAppVRebootPending = $false
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsAppVRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsAppVRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsAppVRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot for the system
+ [boolean]$IsSystemRebootPending = $false
+ If ($IsCBServicingRebootPending -or $IsWindowsUpdateRebootPending -or $IsSCCMClientRebootPending -or $IsFileRenameRebootPending) {
+ [boolean]$IsSystemRebootPending = $true
+ }
+
+ ## Create a custom object containing pending reboot information for the system
+ [psobject]$PendingRebootInfo = New-Object -TypeName 'PSObject' -Property @{
+ ComputerName = $ComputerName
+ LastBootUpTime = $LastBootUpTime
+ IsSystemRebootPending = $IsSystemRebootPending
+ IsCBServicingRebootPending = $IsCBServicingRebootPending
+ IsWindowsUpdateRebootPending = $IsWindowsUpdateRebootPending
+ IsSCCMClientRebootPending = $IsSCCMClientRebootPending
+ IsAppVRebootPending = $IsAppVRebootPending
+ IsFileRenameRebootPending = $IsFileRenameRebootPending
+ PendingFileRenameOperations = $PendingFileRenameOperations
+ ErrorMsg = $PendRebootErrorMsg
+ }
+ Write-Log -Message "Pending reboot status on the local computer [$ComputerName]: `n$($PendingRebootInfo | Format-List | Out-String)" -Source ${CmdletName}
+ }
+ End {
+ Write-Output -InputObject ($PendingRebootInfo | Select-Object -Property 'ComputerName','LastBootUpTime','IsSystemRebootPending','IsCBServicingRebootPending','IsWindowsUpdateRebootPending','IsSCCMClientRebootPending','IsAppVRebootPending','IsFileRenameRebootPending','PendingFileRenameOperations','ErrorMsg')
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#endregion
+##*=============================================
+##* END FUNCTION LISTINGS
+##*=============================================
+
+##*=============================================
+##* SCRIPT BODY
+##*=============================================
+#region ScriptBody
+
+## If the script was invoked by the Help Console, exit the script now
+If ($invokingScript) {
+ If ((Split-Path -Path $invokingScript -Leaf) -eq 'AppDeployToolkitHelp.ps1') { Return }
+}
+
+## Add the custom types required for the toolkit
+If (-not ([Management.Automation.PSTypeName]'PSADT.UiAutomation').Type) {
+ [string[]]$ReferencedAssemblies = 'System.Drawing', 'System.Windows.Forms', 'System.DirectoryServices'
+ Add-Type -Path $appDeployCustomTypesSourceCode -ReferencedAssemblies $ReferencedAssemblies -IgnoreWarnings -ErrorAction 'Stop'
+}
+
+## Define ScriptBlocks to disable/revert script logging
+[scriptblock]$DisableScriptLogging = { $OldDisableLoggingValue = $DisableLogging ; $DisableLogging = $true }
+[scriptblock]$RevertScriptLogging = { $DisableLogging = $OldDisableLoggingValue }
+
+## Define ScriptBlock for getting details for all logged on users
+[scriptblock]$GetLoggedOnUserDetails = {
+ [psobject[]]$LoggedOnUserSessions = Get-LoggedOnUser
+ [string[]]$usersLoggedOn = $LoggedOnUserSessions | ForEach-Object { $_.NTAccount }
+
+ If ($usersLoggedOn) {
+ # Get account and session details for the logged on user session that the current process is running under. Note that the account used to execute the current process may be different than the account that is logged into the session (i.e. you can use "RunAs" to launch with different credentials when logged into an account).
+ [psobject]$CurrentLoggedOnUserSession = $LoggedOnUserSessions | Where-Object { $_.IsCurrentSession }
+
+ # Get account and session details for the account running as the console user (user with control of the physical monitor, keyboard, and mouse)
+ [psobject]$CurrentConsoleUserSession = $LoggedOnUserSessions | Where-Object { $_.IsConsoleSession }
+
+ ## Determine the account that will be used to execute commands in the user session when toolkit is running under the SYSTEM account
+ # If a console user exists, then that will be the active user session.
+ # If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user that is either 'Active' or 'Connected' is the active user.
+ [psobject]$RunAsActiveUser = $LoggedOnUserSessions | Where-Object { $_.IsActiveUserSession }
+ }
+}
+
+## Define ScriptBlock to test for and attempt to make a service healthy by checking if it exists, is currently running, and has the specified start mode.
+[scriptblock]$TestServiceHealth = {
+ Param (
+ [string]$ServiceName,
+ [string]$ServiceStartMode = 'Automatic'
+ )
+ Try {
+ [boolean]$IsServiceHealthy = $true
+ If (Test-ServiceExists -Name $ServiceName -ContinueOnError $false) {
+ If ((Get-ServiceStartMode -Name $ServiceName -ContinueOnError $false) -ne $ServiceStartMode) {
+ Set-ServiceStartMode -Name $ServiceName -StartMode $ServiceStartMode -ContinueOnError $false
+ }
+ Start-ServiceAndDependencies -Name $ServiceName -SkipServiceExistsTest -ContinueOnError $false
+ }
+ Else {
+ [boolean]$IsServiceHealthy = $false
+ }
+ }
+ Catch {
+ [boolean]$IsServiceHealthy = $false
+ }
+ Write-Output -InputObject $IsServiceHealthy
+}
+
+## Disable logging until log file details are available
+. $DisableScriptLogging
+
+## If the default Deploy-Application.ps1 hasn't been modified, and the main script was not called by a referring script, check for MSI / MST and modify the install accordingly
+If ((-not $appName) -and (-not $ReferredInstallName)){
+ # Find the first MSI file in the Files folder and use that as our install
+ [string]$defaultMsiFile = Get-ChildItem -LiteralPath $dirFiles -ErrorAction 'SilentlyContinue' | Where-Object { (-not $_.PsIsContainer) -and ([IO.Path]::GetExtension($_.Name) -eq '.msi') } | Select-Object -ExpandProperty 'FullName' -First 1
+ If ($defaultMsiFile) {
+ Try {
+ [boolean]$useDefaultMsi = $true
+ Write-Log -Message "Discovered Zero-Config MSI installation file [$defaultMsiFile]." -Source $appDeployToolkitName
+ # Discover if there is a zero-config MST file
+ [string]$defaultMstFile = [IO.Path]::ChangeExtension($defaultMsiFile, 'mst')
+ If (Test-Path -LiteralPath $defaultMstFile -PathType 'Leaf') {
+ Write-Log -Message "Discovered Zero-Config MST installation file [$defaultMstFile]." -Source $appDeployToolkitName
+ }
+ Else {
+ [string]$defaultMstFile = ''
+ }
+ # Discover if there are zero-config MSP files. Name multiple MSP files in alphabetical order to control order in which they are installed.
+ [string[]]$defaultMspFiles = Get-ChildItem -LiteralPath $dirFiles -ErrorAction 'SilentlyContinue' | Where-Object { (-not $_.PsIsContainer) -and ([IO.Path]::GetExtension($_.Name) -eq '.msp') } | Select-Object -ExpandProperty 'FullName'
+ If ($defaultMspFiles) {
+ Write-Log -Message "Discovered Zero-Config MSP installation file(s) [$($defaultMspFiles -join ',')]." -Source $appDeployToolkitName
+ }
+
+ ## Read the MSI and get the installation details
+ [hashtable]$GetDefaultMsiTablePropertySplat = @{ Path = $defaultMsiFile; Table = 'Property'; ContinueOnError = $false; ErrorAction = 'Stop' }
+ If ($defaultMstFile) { $GetDefaultMsiTablePropertySplat.Add('TransformPath', $defaultMstFile) }
+ [psobject]$defaultMsiPropertyList = Get-MsiTableProperty @GetDefaultMsiTablePropertySplat
+ [string]$appVendor = $defaultMsiPropertyList.Manufacturer
+ [string]$appName = $defaultMsiPropertyList.ProductName
+ [string]$appVersion = $defaultMsiPropertyList.ProductVersion
+ $GetDefaultMsiTablePropertySplat.Set_Item('Table', 'File')
+ [psobject]$defaultMsiFileList = Get-MsiTableProperty @GetDefaultMsiTablePropertySplat
+ [string[]]$defaultMsiExecutables = Get-Member -InputObject $defaultMsiFileList -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Name' -ErrorAction 'Stop' | Where-Object { [IO.Path]::GetExtension($_) -eq '.exe' } | ForEach-Object { [IO.Path]::GetFileNameWithoutExtension($_) }
+ [string]$defaultMsiExecutablesList = $defaultMsiExecutables -join ','
+ Write-Log -Message "App Vendor [$appVendor]." -Source $appDeployToolkitName
+ Write-Log -Message "App Name [$appName]." -Source $appDeployToolkitName
+ Write-Log -Message "App Version [$appVersion]." -Source $appDeployToolkitName
+ Write-Log -Message "MSI Executable List [$defaultMsiExecutablesList]." -Source $appDeployToolkitName
+ }
+ Catch {
+ Write-Log -Message "Failed to process Zero-Config MSI Deployment. `n$(Resolve-Error)" -Source $appDeployToolkitName
+ $useDefaultMsi = $false ; $appVendor = '' ; $appName = '' ; $appVersion = ''
+ }
+ }
+}
+
+## Set up sample variables if Dot Sourcing the script, app details have not been specified, or InstallName not passed as parameter to the script
+If (-not $appName) {
+ [string]$appName = $appDeployMainScriptFriendlyName
+ If (-not $appVendor) { [string]$appVendor = 'PS' }
+ If (-not $appVersion) { [string]$appVersion = $appDeployMainScriptVersion }
+ If (-not $appLang) { [string]$appLang = $currentLanguage }
+ If (-not $appRevision) { [string]$appRevision = '01' }
+ If (-not $appArch) { [string]$appArch = '' }
+}
+If ($ReferredInstallTitle) { [string]$installTitle = $ReferredInstallTitle }
+If (-not $installTitle) {
+ [string]$installTitle = ("$appVendor $appName $appVersion").Trim()
+}
+
+## Sanitize the application details, as they can cause issues in the script
+[char[]]$invalidFileNameChars = [IO.Path]::GetInvalidFileNameChars()
+[string]$appVendor = $appVendor -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appName = $appName -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appVersion = $appVersion -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appArch = $appArch -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appLang = $appLang -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appRevision = $appRevision -replace "[$invalidFileNameChars]",'' -replace ' ',''
+
+## Build the Installation Name
+If ($ReferredInstallName) { [string]$installName = $ReferredInstallName }
+If (-not $installName) {
+ If ($appArch) {
+ [string]$installName = $appVendor + '_' + $appName + '_' + $appVersion + '_' + $appArch + '_' + $appLang + '_' + $appRevision
+ }
+ Else {
+ [string]$installName = $appVendor + '_' + $appName + '_' + $appVersion + '_' + $appLang + '_' + $appRevision
+ }
+}
+[string]$installName = $installName -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$installName = $installName.Trim('_') -replace '[_]+','_'
+
+## Set the Defer History registry path
+[string]$regKeyDeferHistory = "$configToolkitRegPath\$appDeployToolkitName\DeferHistory\$installName"
+
+## Variables: Log Files
+If ($ReferredLogName) { [string]$logName = $ReferredLogName }
+If (-not $logName) { [string]$logName = $installName + '_' + $appDeployToolkitName + '_' + $deploymentType + '.log' }
+# If option to compress logs is selected, then log will be created in temp log folder ($logTempFolder) and then copied to actual log folder ($configToolkitLogDir) after being zipped.
+[string]$logTempFolder = Join-Path -Path $envTemp -ChildPath "${installName}_$deploymentType"
+If ($configToolkitCompressLogs) {
+ # If the temp log folder already exists from a previous ZIP operation, then delete all files in it to avoid issues
+ If (Test-Path -LiteralPath $logTempFolder -PathType 'Container' -ErrorAction 'SilentlyContinue') {
+ $null = Remove-Item -LiteralPath $logTempFolder -Recurse -Force -ErrorAction 'SilentlyContinue'
+ }
+}
+
+## Revert script logging to original setting
+. $RevertScriptLogging
+
+## Initialize Logging
+$installPhase = 'Initialization'
+$scriptSeparator = '*' * 79
+Write-Log -Message ($scriptSeparator,$scriptSeparator) -Source $appDeployToolkitName
+Write-Log -Message "[$installName] setup started." -Source $appDeployToolkitName
+
+## Assemblies: Load
+Try {
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'PresentationFramework' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'Microsoft.VisualBasic' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'System.Drawing' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'PresentationCore' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'WindowsBase' -ErrorAction 'Stop'
+}
+Catch {
+ Write-Log -Message "Failed to load assembly. `n$(Resolve-Error)" -Severity 3 -Source $appDeployToolkitName
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Continue despite assembly load error since deployment mode is [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ Exit-Script -ExitCode 60004
+ }
+}
+
+## Check how the script was invoked
+If ($invokingScript) {
+ Write-Log -Message "Script [$scriptPath] dot-source invoked by [$invokingScript]" -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "Script [$scriptPath] invoked directly" -Source $appDeployToolkitName
+}
+
+## Dot Source script extensions
+If (Test-Path -LiteralPath "$scriptRoot\$appDeployToolkitDotSourceExtensions" -PathType 'Leaf') {
+ . "$scriptRoot\$appDeployToolkitDotSourceExtensions"
+}
+
+## Evaluate non-default parameters passed to the scripts
+If ($deployAppScriptParameters) { [string]$deployAppScriptParameters = ($deployAppScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+# Save main script parameters hashtable for async execution of the toolkit
+[hashtable]$appDeployMainScriptAsyncParameters = $appDeployMainScriptParameters
+If ($appDeployMainScriptParameters) { [string]$appDeployMainScriptParameters = ($appDeployMainScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+If ($appDeployExtScriptParameters) { [string]$appDeployExtScriptParameters = ($appDeployExtScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+
+## Check the XML config file version
+If ($configConfigVersion -lt $appDeployMainScriptMinimumConfigVersion) {
+ [string]$XMLConfigVersionErr = "The XML configuration file version [$configConfigVersion] is lower than the supported version required by the Toolkit [$appDeployMainScriptMinimumConfigVersion]. Please upgrade the configuration file."
+ Write-Log -Message $XMLConfigVersionErr -Severity 3 -Source $appDeployToolkitName
+ Throw $XMLConfigVersionErr
+}
+
+## Log system/script information
+If ($appScriptVersion) { Write-Log -Message "[$installName] script version is [$appScriptVersion]" -Source $appDeployToolkitName }
+If ($deployAppScriptFriendlyName) { Write-Log -Message "[$deployAppScriptFriendlyName] script version is [$deployAppScriptVersion]" -Source $appDeployToolkitName }
+If ($deployAppScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$deployAppScriptFriendlyName]: [$deployAppScriptParameters]" -Source $appDeployToolkitName }
+If ($appDeployMainScriptFriendlyName) { Write-Log -Message "[$appDeployMainScriptFriendlyName] script version is [$appDeployMainScriptVersion]" -Source $appDeployToolkitName }
+If ($appDeployMainScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$appDeployMainScriptFriendlyName]: [$appDeployMainScriptParameters]" -Source $appDeployToolkitName }
+If ($appDeployExtScriptFriendlyName) { Write-Log -Message "[$appDeployExtScriptFriendlyName] version is [$appDeployExtScriptVersion]" -Source $appDeployToolkitName }
+If ($appDeployExtScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$appDeployExtScriptFriendlyName]: [$appDeployExtScriptParameters]" -Source $appDeployToolkitName }
+Write-Log -Message "Computer Name is [$envComputerNameFQDN]" -Source $appDeployToolkitName
+Write-Log -Message "Current User is [$ProcessNTAccount]" -Source $appDeployToolkitName
+If ($envOSServicePack) {
+ Write-Log -Message "OS Version is [$envOSName $envOSServicePack $envOSArchitecture $envOSVersion]" -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "OS Version is [$envOSName $envOSArchitecture $envOSVersion]" -Source $appDeployToolkitName
+}
+Write-Log -Message "OS Type is [$envOSProductTypeName]" -Source $appDeployToolkitName
+Write-Log -Message "Current Culture is [$($culture.Name)], language is [$currentLanguage] and UI language is [$currentUILanguage]" -Source $appDeployToolkitName
+Write-Log -Message "Hardware Platform is [$(. $DisableScriptLogging; Get-HardwarePlatform; . $RevertScriptLogging)]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell Host is [$($envHost.Name)] with version [$($envHost.Version)]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell Version is [$envPSVersion $psArchitecture]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell CLR (.NET) version is [$envCLRVersion]" -Source $appDeployToolkitName
+Write-Log -Message $scriptSeparator -Source $appDeployToolkitName
+
+## Disable logging
+. $DisableScriptLogging
+
+## Dot source ScriptBlock to get a list of all users logged on to the system (both local and RDP users), and discover session details for account executing script
+. $GetLoggedOnUserDetails
+
+## Dot source ScriptBlock to load localized UI messages from config XML
+. $xmlLoadLocalizedUIMessages
+
+## Dot source ScriptBlock to get system DPI scale factor
+. $GetDisplayScaleFactor
+
+## Revert script logging to original setting
+. $RevertScriptLogging
+
+## Set the install phase to asynchronous if the script was not dot sourced, i.e. called with parameters
+If ($AsyncToolkitLaunch) {
+ $installPhase = 'Asynchronous'
+}
+
+## If the ShowInstallationPrompt Parameter is specified, only call that function.
+If ($showInstallationPrompt) {
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowInstallationPrompt]." -Source $appDeployToolkitName
+ $appDeployMainScriptAsyncParameters.Remove('ShowInstallationPrompt')
+ $appDeployMainScriptAsyncParameters.Remove('AsyncToolkitLaunch')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallName')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallTitle')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredLogName')
+ Show-InstallationPrompt @appDeployMainScriptAsyncParameters
+ Exit 0
+}
+
+## If the ShowInstallationRestartPrompt Parameter is specified, only call that function.
+If ($showInstallationRestartPrompt) {
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowInstallationRestartPrompt]." -Source $appDeployToolkitName
+ $appDeployMainScriptAsyncParameters.Remove('ShowInstallationRestartPrompt')
+ $appDeployMainScriptAsyncParameters.Remove('AsyncToolkitLaunch')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallName')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallTitle')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredLogName')
+ Show-InstallationRestartPrompt @appDeployMainScriptAsyncParameters
+ Exit 0
+}
+
+## If the CleanupBlockedApps Parameter is specified, only call that function.
+If ($cleanupBlockedApps) {
+ $deployModeSilent = $true
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-CleanupBlockedApps]." -Source $appDeployToolkitName
+ Unblock-AppExecution
+ Exit 0
+}
+
+## If the ShowBlockedAppDialog Parameter is specified, only call that function.
+If ($showBlockedAppDialog) {
+ Try {
+ . $DisableScriptLogging
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowBlockedAppDialog]." -Source $appDeployToolkitName
+ # Create a mutex and specify a name without acquiring a lock on the mutex
+ [boolean]$showBlockedAppDialogMutexLocked = $false
+ [string]$showBlockedAppDialogMutexName = 'Global\PSADT_ShowBlockedAppDialog_Message'
+ [Threading.Mutex]$showBlockedAppDialogMutex = New-Object -TypeName 'System.Threading.Mutex' -ArgumentList ($false, $showBlockedAppDialogMutexName)
+ # Attempt to acquire an exclusive lock on the mutex, attempt will fail after 1 millisecond if unable to acquire exclusive lock
+ If ((Test-IsMutexAvailable -MutexName $showBlockedAppDialogMutexName -MutexWaitTimeInMilliseconds 1) -and ($showBlockedAppDialogMutex.WaitOne(1))) {
+ [boolean]$showBlockedAppDialogMutexLocked = $true
+ Show-InstallationPrompt -Title $installTitle -Message $configBlockExecutionMessage -Icon 'Warning' -ButtonRightText 'OK'
+ Exit 0
+ }
+ Else {
+ # If attempt to acquire an exclusive lock on the mutex failed, then exit script as another blocked app dialog window is already open
+ Write-Log -Message "Unable to acquire an exclusive lock on mutex [$showBlockedAppDialogMutexName] because another blocked application dialog window is already open. Exiting script..." -Severity 2 -Source $appDeployToolkitName
+ Exit 0
+ }
+ }
+ Catch {
+ Write-Log -Message "There was an error in displaying the Installation Prompt. `n$(Resolve-Error)" -Severity 3 -Source $appDeployToolkitName
+ Exit 60005
+ }
+ Finally {
+ If ($showBlockedAppDialogMutexLocked) { $null = $showBlockedAppDialogMutex.ReleaseMutex() }
+ If ($showBlockedAppDialogMutex) { $showBlockedAppDialogMutex.Close() }
+ }
+}
+
+## Log details for all currently logged in users
+Write-Log -Message "Display session information for all logged on users: `n$($LoggedOnUserSessions | Format-List | Out-String)" -Source $appDeployToolkitName
+If ($usersLoggedOn) {
+ Write-Log -Message "The following users are logged on to the system: [$($usersLoggedOn -join ', ')]." -Source $appDeployToolkitName
+
+ # Check if the current process is running in the context of one of the logged in users
+ If ($CurrentLoggedOnUserSession) {
+ Write-Log -Message "Current process is running with user account [$ProcessNTAccount] under logged in user session for [$($CurrentLoggedOnUserSession.NTAccount)]." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message "Current process is running under a system account [$ProcessNTAccount]." -Source $appDeployToolkitName
+ }
+
+ # Display account and session details for the account running as the console user (user with control of the physical monitor, keyboard, and mouse)
+ If ($CurrentConsoleUserSession) {
+ Write-Log -Message "The following user is the console user [$($CurrentConsoleUserSession.NTAccount)] (user with control of physical monitor, keyboard, and mouse)." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message 'There is no console user logged in (user with control of physical monitor, keyboard, and mouse).' -Source $appDeployToolkitName
+ }
+
+ # Display the account that will be used to execute commands in the user session when toolkit is running under the SYSTEM account
+ If ($RunAsActiveUser) {
+ Write-Log -Message "The active logged on user is [$($RunAsActiveUser.NTAccount)]." -Source $appDeployToolkitName
+ }
+}
+Else {
+ Write-Log -Message 'No users are logged on to the system.' -Source $appDeployToolkitName
+}
+
+## Log which language's UI messages are loaded from the config XML file
+If ($HKUPrimaryLanguageShort) {
+ Write-Log -Message "The active logged on user [$($RunAsActiveUser.NTAccount)] has a primary UI language of [$HKUPrimaryLanguageShort]." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "The current system account [$ProcessNTAccount] has a primary UI language of [$currentLanguage]." -Source $appDeployToolkitName
+}
+If ($configInstallationUILanguageOverride) { Write-Log -Message "The config XML file was configured to override the detected primary UI language with the following UI language: [$configInstallationUILanguageOverride]." -Source $appDeployToolkitName }
+Write-Log -Message "The following UI messages were imported from the config XML file: [$xmlUIMessageLanguage]." -Source $appDeployToolkitName
+
+## Log system DPI scale factor of active logged on user
+If ($UserDisplayScaleFactor) {
+ Write-Log -Message "The active logged on user [$($RunAsActiveUser.NTAccount)] has a DPI scale factor of [$dpiScale] with DPI pixels [$dpiPixels]." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "The system has a DPI scale factor of [$dpiScale] with DPI pixels [$dpiPixels]." -Source $appDeployToolkitName
+}
+
+## Check if script is running from a SCCM Task Sequence
+Try {
+ [__comobject]$SMSTSEnvironment = New-Object -ComObject 'Microsoft.SMS.TSEnvironment' -ErrorAction 'Stop'
+ Write-Log -Message 'Successfully loaded COM Object [Microsoft.SMS.TSEnvironment]. Therefore, script is currently running from a SCCM Task Sequence.' -Source $appDeployToolkitName
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SMSTSEnvironment)
+ $runningTaskSequence = $true
+}
+Catch {
+ Write-Log -Message 'Unable to load COM Object [Microsoft.SMS.TSEnvironment]. Therefore, script is not currently running from a SCCM Task Sequence.' -Source $appDeployToolkitName
+ $runningTaskSequence = $false
+}
+
+
+## Check to see if the Task Scheduler service is in a healthy state by checking its services to see if they exist, are currently running, and have a start mode of 'Automatic'.
+## The task scheduler service and the services it is dependent on can/should only be started/stopped/modified when running in the SYSTEM context.
+[boolean]$IsTaskSchedulerHealthy = $true
+If ($IsLocalSystemAccount) {
+ # Check the health of the 'COM+ Event System' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'EventSystem'
+ # Check the health of the 'Remote Procedure Call (RPC)' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'RpcSs'
+ # Check the health of the 'Windows Event Log' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'EventLog'
+ # Check the health of the 'Task Scheduler' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'Schedule'
+
+ Write-Log -Message "The task scheduler service is in a healthy state: $IsTaskSchedulerHealthy." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "Skipping attempt to check for and make the task scheduler services healthy because the App Deployment Toolkit is not running under the [$LocalSystemNTAccount] account." -Source $appDeployToolkitName
+}
+
+## If script is running in session zero
+If ($SessionZero) {
+ ## If the script was launched with deployment mode set to NonInteractive, then continue
+ If ($deployMode -eq 'NonInteractive') {
+ Write-Log -Message "Session 0 detected but deployment mode was manually set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ ## If the process is not able to display a UI, enable NonInteractive mode
+ If (-not $IsProcessUserInteractive) {
+ $deployMode = 'NonInteractive'
+ Write-Log -Message "Session 0 detected, process not running in user interactive mode; deployment mode set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ If (-not $usersLoggedOn) {
+ $deployMode = 'NonInteractive'
+ Write-Log -Message "Session 0 detected, process running in user interactive mode, no users logged in; deployment mode set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message 'Session 0 detected, process running in user interactive mode, user(s) logged in.' -Source $appDeployToolkitName
+ }
+ }
+ }
+}
+Else {
+ Write-Log -Message 'Session 0 not detected.' -Source $appDeployToolkitName
+}
+
+## Set Deploy Mode switches
+If ($deployMode) {
+ Write-Log -Message "Installation is running in [$deployMode] mode." -Source $appDeployToolkitName
+}
+Switch ($deployMode) {
+ 'Silent' { $deployModeSilent = $true }
+ 'NonInteractive' { $deployModeNonInteractive = $true; $deployModeSilent = $true }
+ Default { $deployModeNonInteractive = $false; $deployModeSilent = $false }
+}
+
+## Check deployment type (install/uninstall)
+Switch ($deploymentType) {
+ 'Install' { $deploymentTypeName = $configDeploymentTypeInstall }
+ 'Uninstall' { $deploymentTypeName = $configDeploymentTypeUnInstall }
+ Default { $deploymentTypeName = $configDeploymentTypeInstall }
+}
+If ($deploymentTypeName) { Write-Log -Message "Deployment type is [$deploymentTypeName]." -Source $appDeployToolkitName }
+
+If ($useDefaultMsi) { Write-Log -Message "Discovered Zero-Config MSI installation file [$defaultMsiFile]." -Source $appDeployToolkitName }
+
+## Check current permissions and exit if not running with Administrator rights
+If ($configToolkitRequireAdmin) {
+ # Check if the current process is running with elevated administrator permissions
+ If ((-not $IsAdmin) -and (-not $ShowBlockedAppDialog)) {
+ [string]$AdminPermissionErr = "[$appDeployToolkitName] has an XML config file option [Toolkit_RequireAdmin] set to [True] so as to require Administrator rights for the toolkit to function. Please re-run the deployment script as an Administrator or change the option in the XML config file to not require Administrator rights."
+ Write-Log -Message $AdminPermissionErr -Severity 3 -Source $appDeployToolkitName
+ Show-DialogBox -Text $AdminPermissionErr -Icon 'Stop'
+ Throw $AdminPermissionErr
+ }
+}
+
+## If terminal server mode was specified, change the installation mode to support it
+If ($terminalServerMode) { Enable-TerminalServerInstallMode }
+
+#endregion
+##*=============================================
+##* END SCRIPT BODY
+##*=============================================
diff --git a/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/Thumbs.db b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/Thumbs.db
new file mode 100644
index 0000000..3c1f662
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/AppDeployToolkit/Thumbs.db differ
diff --git a/CFX Maestro/1.1/PS_Deployment/Deploy-Application.exe b/CFX Maestro/1.1/PS_Deployment/Deploy-Application.exe
new file mode 100644
index 0000000..4000f07
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/Deploy-Application.exe differ
diff --git a/CFX Maestro/1.1/PS_Deployment/Deploy-Application.exe.config b/CFX Maestro/1.1/PS_Deployment/Deploy-Application.exe.config
new file mode 100644
index 0000000..99844ed
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/Deploy-Application.exe.config
@@ -0,0 +1,7 @@
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/CFX Maestro/1.1/PS_Deployment/Deploy-Application.ps1 b/CFX Maestro/1.1/PS_Deployment/Deploy-Application.ps1
new file mode 100644
index 0000000..a565bfb
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/Deploy-Application.ps1
@@ -0,0 +1,235 @@
+<#
+.SYNOPSIS
+ This script performs the installation or uninstallation of an application(s).
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script is provided as a template to perform an install or uninstall of an application(s).
+ The script either performs an "Install" deployment type or an "Uninstall" deployment type.
+ The install deployment type is broken down into 3 main sections/phases: Pre-Install, Install, and Post-Install.
+ The script dot-sources the AppDeployToolkitMain.ps1 script which contains the logic and functions required to install or uninstall an application.
+.PARAMETER DeploymentType
+ The type of deployment to perform. Default is: Install.
+.PARAMETER DeployMode
+ Specifies whether the installation should be run in Interactive, Silent, or NonInteractive mode. Default is: Interactive. Options: Interactive = Shows dialogs, Silent = No dialogs, NonInteractive = Very silent, i.e. no blocking apps. NonInteractive mode is automatically set if it is detected that the process is not user interactive.
+.PARAMETER AllowRebootPassThru
+ Allows the 3010 return code (requires restart) to be passed back to the parent process (e.g. SCCM) if detected from an installation. If 3010 is passed back to SCCM, a reboot prompt will be triggered.
+.PARAMETER TerminalServerMode
+ Changes to "user install mode" and back to "user execute mode" for installing/uninstalling applications for Remote Destkop Session Hosts/Citrix servers.
+.PARAMETER DisableLogging
+ Disables logging to file for the script. Default is: $false.
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -DeployMode 'Silent'; Exit $LastExitCode }"
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -AllowRebootPassThru; Exit $LastExitCode }"
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -DeploymentType 'Uninstall'; Exit $LastExitCode }"
+.EXAMPLE
+ Deploy-Application.exe -DeploymentType "Install" -DeployMode "Silent"
+.NOTES
+ Toolkit Exit Code Ranges:
+ 60000 - 68999: Reserved for built-in exit codes in Deploy-Application.ps1, Deploy-Application.exe, and AppDeployToolkitMain.ps1
+ 69000 - 69999: Recommended for user customized exit codes in Deploy-Application.ps1
+ 70000 - 79999: Recommended for user customized exit codes in AppDeployToolkitExtensions.ps1
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Install','Uninstall')]
+ [string]$DeploymentType = 'Install',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Interactive','Silent','NonInteractive')]
+ [string]$DeployMode = 'Interactive',
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowRebootPassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$TerminalServerMode = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$DisableLogging = $false
+)
+
+Try {
+ ## Set the script execution policy for this process
+ Try { Set-ExecutionPolicy -ExecutionPolicy 'ByPass' -Scope 'Process' -Force -ErrorAction 'Stop' } Catch {}
+
+ ##*===============================================
+ ##* VARIABLE DECLARATION
+ ##*===============================================
+ ## Variables: Application
+ [string]$appVendor = 'Bio-Rad'
+ [string]$appName = 'CFX Maestro'
+ [string]$appVersion = '1.1'
+ [string]$appArch = 'x86'
+ [string]$appLang = 'EN'
+ [string]$appRevision = '01'
+ [string]$appScriptVersion = '1.0.0'
+ [string]$appScriptDate = '04/23/2018'
+ [string]$appScriptAuthor = 'John Palmer'
+ ##*===============================================
+ ## Variables: Install Titles (Only set here to override defaults set by the toolkit)
+ [string]$installName = ''
+ [string]$installTitle = ''
+
+ ##* Do not modify section below
+ #region DoNotModify
+
+ ## Variables: Exit Code
+ [int32]$mainExitCode = 0
+
+ ## Variables: Script
+ [string]$deployAppScriptFriendlyName = 'Deploy Application'
+ [version]$deployAppScriptVersion = [version]'3.7.0'
+ [string]$deployAppScriptDate = '02/13/2018'
+ [hashtable]$deployAppScriptParameters = $psBoundParameters
+
+ ## Variables: Environment
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $InvocationInfo = $HostInvocation } Else { $InvocationInfo = $MyInvocation }
+ [string]$scriptDirectory = Split-Path -Path $InvocationInfo.MyCommand.Definition -Parent
+
+ ## Dot source the required App Deploy Toolkit Functions
+ Try {
+ [string]$moduleAppDeployToolkitMain = "$scriptDirectory\AppDeployToolkit\AppDeployToolkitMain.ps1"
+ If (-not (Test-Path -LiteralPath $moduleAppDeployToolkitMain -PathType 'Leaf')) { Throw "Module does not exist at the specified location [$moduleAppDeployToolkitMain]." }
+ If ($DisableLogging) { . $moduleAppDeployToolkitMain -DisableLogging } Else { . $moduleAppDeployToolkitMain }
+ }
+ Catch {
+ If ($mainExitCode -eq 0){ [int32]$mainExitCode = 60008 }
+ Write-Error -Message "Module [$moduleAppDeployToolkitMain] failed to load: `n$($_.Exception.Message)`n `n$($_.InvocationInfo.PositionMessage)" -ErrorAction 'Continue'
+ ## Exit the script, returning the exit code to SCCM
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $script:ExitCode = $mainExitCode; Exit } Else { Exit $mainExitCode }
+ }
+
+ #endregion
+ ##* Do not modify section above
+ ##*===============================================
+ ##* END VARIABLE DECLARATION
+ ##*===============================================
+
+ If ($deploymentType -ine 'Uninstall') {
+ ##*===============================================
+ ##* PRE-INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Pre-Installation'
+
+ ## Show Welcome Message, close Internet Explorer if required, allow up to 3 deferrals, verify there is enough disk space to complete the install, and persist the prompt
+ Show-InstallationWelcome -CloseApps 'BioRadC1000Server, BioRadCFXManager, BioRADMiniOpticonDiscovery' #-AllowDefer -DeferTimes 3 -CheckDiskSpace -PersistPrompt
+
+ ## Show Progress Message (with the default message)
+ Show-InstallationProgress
+
+ ##
+
+ ## Import the Trusted Certs required for installation. ##
+
+ Copy-File -Path "$dirSupportFiles\*.cer" -Destination 'C:\TEMP\'
+
+ # The following only works on W10, so I left it for futue reference #
+
+ #Import-Certificate "C:\TEMP\BioRad.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher\
+
+ #Import-Certificate "C:\TEMP\Jungo.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher\
+
+ certutil -addstore "TrustedPublisher" C:\TEMP\BioRad.cer
+
+ certutil -addstore "TrustedPublisher" C:\TEMP\Jungo.cer
+
+ ##*===============================================
+ ##* INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Installation'
+
+ ## Handle Zero-Config MSI Installations
+ If ($useDefaultMsi) {
+ [hashtable]$ExecuteDefaultMSISplat = @{ Action = 'Install'; Path = $defaultMsiFile }; If ($defaultMstFile) { $ExecuteDefaultMSISplat.Add('Transform', $defaultMstFile) }
+ Execute-MSI @ExecuteDefaultMSISplat; If ($defaultMspFiles) { $defaultMspFiles | ForEach-Object { Execute-MSI -Action 'Patch' -Path $_ } }
+ }
+
+ ##
+
+ ## MSI Example with a Transform -> Execute-MSI -Action Install -Path 'Application.msi' -Transform 'TrasformFile.mst'
+
+ ## .EXE Example -> Execute-Process -Path 'setup.exe' -Parameters '/S'
+
+ Execute-Process -Path "$dirFiles\CFX\CFXMaestroSetup1.1.exe" -Parameters '/S /v/qn'
+
+
+ ##*===============================================
+ ##* POST-INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Post-Installation'
+
+ ##
+
+ ## Remove the Certificates that were copied locally for import.
+
+ Remove-Item 'C:\TEMP' -Recurse
+
+ ## Display a message at the end of the install
+ If (-not $useDefaultMsi) { Show-InstallationPrompt -Message 'You can customize text to appear at the end of an install or remove it completely for unattended installations.' -ButtonRightText 'OK' -Icon Information -NoWait }
+ }
+ ElseIf ($deploymentType -ieq 'Uninstall')
+ {
+ ##*===============================================
+ ##* PRE-UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Pre-Uninstallation'
+
+ ## Show Welcome Message, close Internet Explorer with a 60 second countdown before automatically closing
+ Show-InstallationWelcome -CloseApps 'BioRadC1000Server, BioRadCFXManager, BioRADMiniOpticonDiscovery' -CloseAppsCountdown 60
+
+ ## Show Progress Message (with the default message)
+ Show-InstallationProgress
+
+ ##
+
+
+ ##*===============================================
+ ##* UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Uninstallation'
+
+ ## Handle Zero-Config MSI Uninstallations
+ If ($useDefaultMsi) {
+ [hashtable]$ExecuteDefaultMSISplat = @{ Action = 'Uninstall'; Path = $defaultMsiFile }; If ($defaultMstFile) { $ExecuteDefaultMSISplat.Add('Transform', $defaultMstFile) }
+ Execute-MSI @ExecuteDefaultMSISplat
+ }
+
+ #
+
+ #Uninstall MSI Example
+ #Execute-MSI -Action Uninstall -Path '{6E6D2BB7-B844-4842-B62D-0A7F0AA7884E}' -Parameters '/q /norestart'
+
+ Execute-MSI -Action Uninstall -Path '{AD42E531-6D66-4493-AEEB-E01AFC28B5A2}'
+
+ Remove-Item 'C:\TEMP' -Recurse
+
+
+ ##*===============================================
+ ##* POST-UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Post-Uninstallation'
+
+ ##
+
+
+ }
+
+ ##*===============================================
+ ##* END SCRIPT BODY
+ ##*===============================================
+
+ ## Call the Exit-Script function to perform final cleanup operations
+ Exit-Script -ExitCode $mainExitCode
+}
+Catch {
+ [int32]$mainExitCode = 60001
+ [string]$mainErrorMessage = "$(Resolve-Error)"
+ Write-Log -Message $mainErrorMessage -Severity 3 -Source $deployAppScriptFriendlyName
+ Show-DialogBox -Text $mainErrorMessage -Icon 'Stop'
+ Exit-Script -ExitCode $mainExitCode
+}
\ No newline at end of file
diff --git a/CFX Maestro/1.1/PS_Deployment/Install - CFX Maestro.lnk b/CFX Maestro/1.1/PS_Deployment/Install - CFX Maestro.lnk
new file mode 100644
index 0000000..33994d4
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/Install - CFX Maestro.lnk differ
diff --git a/CFX Maestro/1.1/PS_Deployment/Readme.txt b/CFX Maestro/1.1/PS_Deployment/Readme.txt
new file mode 100644
index 0000000..114b7c7
--- /dev/null
+++ b/CFX Maestro/1.1/PS_Deployment/Readme.txt
@@ -0,0 +1 @@
+Instructions for using this script are included in the PSAppDeployToolkitAdminGuide document in the "Examples" section.
\ No newline at end of file
diff --git a/CFX Maestro/1.1/PS_Deployment/SupportFiles/BioRad.cer b/CFX Maestro/1.1/PS_Deployment/SupportFiles/BioRad.cer
new file mode 100644
index 0000000..6ba4907
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/SupportFiles/BioRad.cer differ
diff --git a/CFX Maestro/1.1/PS_Deployment/SupportFiles/Jungo.cer b/CFX Maestro/1.1/PS_Deployment/SupportFiles/Jungo.cer
new file mode 100644
index 0000000..33740b2
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/SupportFiles/Jungo.cer differ
diff --git a/CFX Maestro/1.1/PS_Deployment/Uninstall - CFX Maestro.lnk b/CFX Maestro/1.1/PS_Deployment/Uninstall - CFX Maestro.lnk
new file mode 100644
index 0000000..cc0f251
Binary files /dev/null and b/CFX Maestro/1.1/PS_Deployment/Uninstall - CFX Maestro.lnk differ
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitBanner.png b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitBanner.png
new file mode 100644
index 0000000..60c2ed1
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitBanner.png differ
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitConfig.xml b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitConfig.xml
new file mode 100644
index 0000000..67fe1f1
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitConfig.xml differ
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitExtensions.ps1 b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitExtensions.ps1
new file mode 100644
index 0000000..08fd4ed
--- /dev/null
+++ b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitExtensions.ps1
@@ -0,0 +1,57 @@
+<#
+.SYNOPSIS
+ This script is a template that allows you to extend the toolkit with your own custom functions.
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script is automatically dot-sourced by the AppDeployToolkitMain.ps1 script.
+.NOTES
+ Toolkit Exit Code Ranges:
+ 60000 - 68999: Reserved for built-in exit codes in Deploy-Application.ps1, Deploy-Application.exe, and AppDeployToolkitMain.ps1
+ 69000 - 69999: Recommended for user customized exit codes in Deploy-Application.ps1
+ 70000 - 79999: Recommended for user customized exit codes in AppDeployToolkitExtensions.ps1
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+)
+
+##*===============================================
+##* VARIABLE DECLARATION
+##*===============================================
+
+# Variables: Script
+[string]$appDeployToolkitExtName = 'PSAppDeployToolkitExt'
+[string]$appDeployExtScriptFriendlyName = 'App Deploy Toolkit Extensions'
+[version]$appDeployExtScriptVersion = [version]'1.5.0'
+[string]$appDeployExtScriptDate = '02/12/2017'
+[hashtable]$appDeployExtScriptParameters = $PSBoundParameters
+
+##*===============================================
+##* FUNCTION LISTINGS
+##*===============================================
+
+#
+
+##*===============================================
+##* END FUNCTION LISTINGS
+##*===============================================
+
+##*===============================================
+##* SCRIPT BODY
+##*===============================================
+
+If ($scriptParentPath) {
+ Write-Log -Message "Script [$($MyInvocation.MyCommand.Definition)] dot-source invoked by [$(((Get-Variable -Name MyInvocation).Value).ScriptName)]" -Source $appDeployToolkitExtName
+}
+Else {
+ Write-Log -Message "Script [$($MyInvocation.MyCommand.Definition)] invoked directly" -Source $appDeployToolkitExtName
+}
+
+##*===============================================
+##* END SCRIPT BODY
+##*===============================================
\ No newline at end of file
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitHelp.ps1 b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitHelp.ps1
new file mode 100644
index 0000000..83c6e4a
--- /dev/null
+++ b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitHelp.ps1
@@ -0,0 +1,132 @@
+<#
+.SYNOPSIS
+ Displays a graphical console to browse the help for the App Deployment Toolkit functions
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ Displays a graphical console to browse the help for the App Deployment Toolkit functions
+.EXAMPLE
+ AppDeployToolkitHelp.ps1
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+
+##*===============================================
+##* VARIABLE DECLARATION
+##*===============================================
+
+## Variables: Script
+[string]$appDeployToolkitHelpName = 'PSAppDeployToolkitHelp'
+[string]$appDeployHelpScriptFriendlyName = 'App Deploy Toolkit Help'
+[version]$appDeployHelpScriptVersion = [version]'3.6.5'
+[string]$appDeployHelpScriptDate = '02/12/2017'
+
+## Variables: Environment
+[string]$scriptDirectory = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+# Dot source the App Deploy Toolkit Functions
+. "$scriptDirectory\AppDeployToolkitMain.ps1" -DisableLogging
+
+##*===============================================
+##* END VARIABLE DECLARATION
+##*===============================================
+
+##*===============================================
+##* FUNCTION LISTINGS
+##*===============================================
+
+Function Show-HelpConsole {
+ ## Import the Assemblies
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName System.Drawing -ErrorAction 'Stop'
+
+ ## Form Objects
+ $HelpForm = New-Object -TypeName 'System.Windows.Forms.Form'
+ $HelpListBox = New-Object -TypeName 'System.Windows.Forms.ListBox'
+ $HelpTextBox = New-Object -TypeName 'System.Windows.Forms.RichTextBox'
+ $InitialFormWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ ## Form Code
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 665
+ $System_Drawing_Size.Width = 957
+ $HelpForm.ClientSize = $System_Drawing_Size
+ $HelpForm.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpForm.Name = 'HelpForm'
+ $HelpForm.Text = 'PowerShell App Deployment Toolkit Help Console'
+ $HelpForm.WindowState = 'Normal'
+ $HelpForm.ShowInTaskbar = $true
+ $HelpForm.FormBorderStyle = 'Fixed3D'
+ $HelpForm.MaximizeBox = $false
+ $HelpForm.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $HelpListBox.Anchor = 7
+ $HelpListBox.BorderStyle = 1
+ $HelpListBox.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpListBox.Font = New-Object -TypeName 'System.Drawing.Font' -ArgumentList ('Microsoft Sans Serif', 9.75, 1, 3, 1)
+ $HelpListBox.FormattingEnabled = $true
+ $HelpListBox.ItemHeight = 16
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $HelpListBox.Location = $System_Drawing_Point
+ $HelpListBox.Name = 'HelpListBox'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 658
+ $System_Drawing_Size.Width = 271
+ $HelpListBox.Size = $System_Drawing_Size
+ $HelpListBox.Sorted = $true
+ $HelpListBox.TabIndex = 2
+ $HelpListBox.add_SelectedIndexChanged({ $HelpTextBox.Text = Get-Help -Name $HelpListBox.SelectedItem -Full | Out-String })
+ $helpFunctions = Get-Command -CommandType 'Function' | Where-Object { ($_.HelpUri -match 'psappdeploytoolkit') -and ($_.Definition -notmatch 'internal script function') } | Select-Object -ExpandProperty Name
+ ForEach ($helpFunction in $helpFunctions) {
+ $null = $HelpListBox.Items.Add($helpFunction)
+ }
+ $HelpForm.Controls.Add($HelpListBox)
+ $HelpTextBox.Anchor = 11
+ $HelpTextBox.BorderStyle = 1
+ $HelpTextBox.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpTextBox.Font = New-Object -TypeName 'System.Drawing.Font' -ArgumentList ('Microsoft Sans Serif', 8.5, 0, 3, 1)
+ $HelpTextBox.ForeColor = [System.Drawing.Color]::FromArgb(255, 0, 0, 0)
+ $System_Drawing_Point = New-Object -TypeName System.Drawing.Point
+ $System_Drawing_Point.X = 277
+ $System_Drawing_Point.Y = 0
+ $HelpTextBox.Location = $System_Drawing_Point
+ $HelpTextBox.Name = 'HelpTextBox'
+ $HelpTextBox.ReadOnly = $True
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 658
+ $System_Drawing_Size.Width = 680
+ $HelpTextBox.Size = $System_Drawing_Size
+ $HelpTextBox.TabIndex = 1
+ $HelpTextBox.Text = ''
+ $HelpForm.Controls.Add($HelpTextBox)
+
+ ## Save the initial state of the form
+ $InitialFormWindowState = $HelpForm.WindowState
+ ## Init the OnLoad event to correct the initial state of the form
+ $HelpForm.add_Load($OnLoadForm_StateCorrection)
+ ## Show the Form
+ $null = $HelpForm.ShowDialog()
+}
+
+##*===============================================
+##* END FUNCTION LISTINGS
+##*===============================================
+
+##*===============================================
+##* SCRIPT BODY
+##*===============================================
+
+Write-Log -Message "Load [$appDeployHelpScriptFriendlyName] console..." -Source $appDeployToolkitHelpName
+
+## Show the help console
+Show-HelpConsole
+
+Write-Log -Message "[$appDeployHelpScriptFriendlyName] console closed." -Source $appDeployToolkitHelpName
+
+##*===============================================
+##* END SCRIPT BODY
+##*===============================================
\ No newline at end of file
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitLogo.ico b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitLogo.ico
new file mode 100644
index 0000000..411f4ab
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitLogo.ico differ
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.cs b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.cs
new file mode 100644
index 0000000..b1653b0
--- /dev/null
+++ b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.cs
@@ -0,0 +1,775 @@
+// Date Modified: 01-08-2016
+// Version Number: 3.6.8
+
+using System;
+using System.Text;
+using System.Collections;
+using System.ComponentModel;
+using System.DirectoryServices;
+using System.Security.Principal;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Text.RegularExpressions;
+using FILETIME = System.Runtime.InteropServices.ComTypes.FILETIME;
+
+namespace PSADT
+{
+ public class Msi
+ {
+ enum LoadLibraryFlags : int
+ {
+ DONT_RESOLVE_DLL_REFERENCES = 0x00000001,
+ LOAD_IGNORE_CODE_AUTHZ_LEVEL = 0x00000010,
+ LOAD_LIBRARY_AS_DATAFILE = 0x00000002,
+ LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE = 0x00000040,
+ LOAD_LIBRARY_AS_IMAGE_RESOURCE = 0x00000020,
+ LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008
+ }
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern IntPtr LoadLibraryEx(string lpFileName, IntPtr hFile, LoadLibraryFlags dwFlags);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern int LoadString(IntPtr hInstance, int uID, StringBuilder lpBuffer, int nBufferMax);
+
+ // Get MSI exit code message from msimsg.dll resource dll
+ public static string GetMessageFromMsiExitCode(int errCode)
+ {
+ IntPtr hModuleInstance = LoadLibraryEx("msimsg.dll", IntPtr.Zero, LoadLibraryFlags.LOAD_LIBRARY_AS_DATAFILE);
+
+ StringBuilder sb = new StringBuilder(255);
+ LoadString(hModuleInstance, errCode, sb, sb.Capacity + 1);
+
+ return sb.ToString();
+ }
+ }
+
+ public class Explorer
+ {
+ private static readonly IntPtr HWND_BROADCAST = new IntPtr(0xffff);
+ private const int WM_SETTINGCHANGE = 0x1a;
+ private const int SMTO_ABORTIFHUNG = 0x0002;
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern bool SendNotifyMessage(IntPtr hWnd, int Msg, IntPtr wParam, IntPtr lParam);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr SendMessageTimeout(IntPtr hWnd, int Msg, IntPtr wParam, string lParam, int fuFlags, int uTimeout, IntPtr lpdwResult);
+
+ [DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern int SHChangeNotify(int eventId, int flags, IntPtr item1, IntPtr item2);
+
+ public static void RefreshDesktopAndEnvironmentVariables()
+ {
+ // Update desktop icons
+ SHChangeNotify(0x8000000, 0x1000, IntPtr.Zero, IntPtr.Zero);
+ SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, IntPtr.Zero, null, SMTO_ABORTIFHUNG, 100, IntPtr.Zero);
+ // Update environment variables
+ SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, IntPtr.Zero, "Environment", SMTO_ABORTIFHUNG, 100, IntPtr.Zero);
+ }
+ }
+
+ public sealed class FileVerb
+ {
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int LoadString(IntPtr h, int id, StringBuilder sb, int maxBuffer);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr LoadLibrary(string s);
+
+ public static string GetPinVerb(int VerbId)
+ {
+ IntPtr hShell32 = LoadLibrary("shell32.dll");
+ const int nChars = 255;
+ StringBuilder Buff = new StringBuilder("", nChars);
+
+ LoadString(hShell32, VerbId, Buff, Buff.Capacity);
+ return Buff.ToString();
+ }
+ }
+
+ public sealed class IniFile
+ {
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetPrivateProfileString(string lpAppName, string lpKeyName, string lpDefault, StringBuilder lpReturnedString, int nSize, string lpFileName);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool WritePrivateProfileString(string lpAppName, string lpKeyName, StringBuilder lpString, string lpFileName);
+
+ public static string GetIniValue(string section, string key, string filepath)
+ {
+ string sDefault = "";
+ const int nChars = 1024;
+ StringBuilder Buff = new StringBuilder(nChars);
+
+ GetPrivateProfileString(section, key, sDefault, Buff, Buff.Capacity, filepath);
+ return Buff.ToString();
+ }
+
+ public static void SetIniValue(string section, string key, StringBuilder value, string filepath)
+ {
+ WritePrivateProfileString(section, key, value, filepath);
+ }
+ }
+
+ public class UiAutomation
+ {
+ public enum GetWindow_Cmd : int
+ {
+ GW_HWNDFIRST = 0,
+ GW_HWNDLAST = 1,
+ GW_HWNDNEXT = 2,
+ GW_HWNDPREV = 3,
+ GW_OWNER = 4,
+ GW_CHILD = 5,
+ GW_ENABLEDPOPUP = 6
+ }
+
+ public enum ShowWindowEnum
+ {
+ Hide = 0,
+ ShowNormal = 1,
+ ShowMinimized = 2,
+ ShowMaximized = 3,
+ Maximize = 3,
+ ShowNormalNoActivate = 4,
+ Show = 5,
+ Minimize = 6,
+ ShowMinNoActivate = 7,
+ ShowNoActivate = 8,
+ Restore = 9,
+ ShowDefault = 10,
+ ForceMinimized = 11
+ }
+
+ public enum UserNotificationState
+ {
+ // http://msdn.microsoft.com/en-us/library/bb762533(v=vs.85).aspx
+ ScreenSaverOrLockedOrFastUserSwitching =1, // A screen saver is displayed, the machine is locked, or a nonactive Fast User Switching session is in progress.
+ FullScreenOrPresentationModeOrLoginScreen =2, // A full-screen application is running or Presentation Settings are applied. Presentation Settings allow a user to put their machine into a state fit for an uninterrupted presentation, such as a set of PowerPoint slides, with a single click. Also returns this state if machine is at the login screen.
+ RunningDirect3DFullScreen =3, // A full-screen, exclusive mode, Direct3D application is running.
+ PresentationMode =4, // The user has activated Windows presentation settings to block notifications and pop-up messages.
+ AcceptsNotifications =5, // None of the other states are found, notifications can be freely sent.
+ QuietTime =6, // Introduced in Windows 7. The current user is in "quiet time", which is the first hour after a new user logs into his or her account for the first time.
+ WindowsStoreAppRunning =7 // Introduced in Windows 8. A Windows Store app is running.
+ }
+
+ // Only for Vista or above
+ [DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern int SHQueryUserNotificationState(out UserNotificationState pquns);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool EnumWindows(EnumWindowsProcD lpEnumFunc, ref IntPtr lParam);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowText(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowTextLength(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr GetDesktopWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr GetShellWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool IsWindowEnabled(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool IsWindowVisible(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool IsIconic(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool ShowWindow(IntPtr hWnd, ShowWindowEnum flags);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr SetActiveWindow(IntPtr hwnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool SetForegroundWindow(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetForegroundWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr SetFocus(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool BringWindowToTop(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int lpdwProcessId);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetCurrentThreadId();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool AttachThreadInput(int idAttach, int idAttachTo, bool fAttach);
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLong", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetWindowLong32(IntPtr hWnd, int nIndex);
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLongPtr", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetWindowLongPtr64(IntPtr hWnd, int nIndex);
+
+ public delegate bool EnumWindowsProcD(IntPtr hWnd, ref IntPtr lItems);
+
+ public static bool EnumWindowsProc(IntPtr hWnd, ref IntPtr lItems)
+ {
+ if (hWnd != IntPtr.Zero)
+ {
+ GCHandle hItems = GCHandle.FromIntPtr(lItems);
+ List items = hItems.Target as List;
+ items.Add(hWnd);
+ return true;
+ }
+ else
+ {
+ return false;
+ }
+ }
+
+ public static List EnumWindows()
+ {
+ try
+ {
+ List items = new List();
+ EnumWindowsProcD CallBackPtr = new EnumWindowsProcD(EnumWindowsProc);
+ GCHandle hItems = GCHandle.Alloc(items);
+ IntPtr lItems = GCHandle.ToIntPtr(hItems);
+ EnumWindows(CallBackPtr, ref lItems);
+ return items;
+ }
+ catch (Exception ex)
+ {
+ throw new Exception("An error occured during window enumeration: " + ex.Message);
+ }
+ }
+
+ public static string GetWindowText(IntPtr hWnd)
+ {
+ int iTextLength = GetWindowTextLength(hWnd);
+ if (iTextLength > 0)
+ {
+ StringBuilder sb = new StringBuilder(iTextLength);
+ GetWindowText(hWnd, sb, iTextLength + 1);
+ return sb.ToString();
+ }
+ else
+ {
+ return String.Empty;
+ }
+ }
+
+ public static bool BringWindowToFront(IntPtr windowHandle)
+ {
+ bool breturn = false;
+ if (IsIconic(windowHandle))
+ {
+ // Show minimized window because SetForegroundWindow does not work for minimized windows
+ ShowWindow(windowHandle, ShowWindowEnum.ShowMaximized);
+ }
+
+ int lpdwProcessId;
+ int windowThreadProcessId = GetWindowThreadProcessId(GetForegroundWindow(), out lpdwProcessId);
+ int currentThreadId = GetCurrentThreadId();
+ AttachThreadInput(windowThreadProcessId, currentThreadId, true);
+
+ BringWindowToTop(windowHandle);
+ breturn = SetForegroundWindow(windowHandle);
+ SetActiveWindow(windowHandle);
+ SetFocus(windowHandle);
+
+ AttachThreadInput(windowThreadProcessId, currentThreadId, false);
+ return breturn;
+ }
+
+ public static int GetWindowThreadProcessId(IntPtr windowHandle)
+ {
+ int processID = 0;
+ GetWindowThreadProcessId(windowHandle, out processID);
+ return processID;
+ }
+
+ public static IntPtr GetWindowLong(IntPtr hWnd, int nIndex)
+ {
+ if (IntPtr.Size == 4)
+ {
+ return GetWindowLong32(hWnd, nIndex);
+ }
+ return GetWindowLongPtr64(hWnd, nIndex);
+ }
+
+ public static string GetUserNotificationState()
+ {
+ // Only works for Windows Vista or higher
+ UserNotificationState state;
+ int returnVal = SHQueryUserNotificationState(out state);
+ return state.ToString();
+ }
+ }
+
+ public class QueryUser
+ {
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr WTSOpenServer(string pServerName);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern void WTSCloseServer(IntPtr hServer);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Ansi, SetLastError = false)]
+ public static extern bool WTSQuerySessionInformation(IntPtr hServer, int sessionId, WTS_INFO_CLASS wtsInfoClass, out IntPtr pBuffer, out int pBytesReturned);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Ansi, SetLastError = false)]
+ public static extern int WTSEnumerateSessions(IntPtr hServer, int Reserved, int Version, out IntPtr pSessionInfo, out int pCount);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern void WTSFreeMemory(IntPtr pMemory);
+
+ [DllImport("winsta.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int WinStationQueryInformation(IntPtr hServer, int sessionId, int information, ref WINSTATIONINFORMATIONW pBuffer, int bufferLength, ref int returnedLength);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetCurrentProcessId();
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool ProcessIdToSessionId(int processId, ref int pSessionId);
+
+ public class TerminalSessionData
+ {
+ public int SessionId;
+ public string ConnectionState;
+ public string SessionName;
+ public bool IsUserSession;
+ public TerminalSessionData(int sessionId, string connState, string sessionName, bool isUserSession)
+ {
+ SessionId = sessionId;
+ ConnectionState = connState;
+ SessionName = sessionName;
+ IsUserSession = isUserSession;
+ }
+ }
+
+ public class TerminalSessionInfo
+ {
+ public string NTAccount;
+ public string SID;
+ public string UserName;
+ public string DomainName;
+ public int SessionId;
+ public string SessionName;
+ public string ConnectState;
+ public bool IsCurrentSession;
+ public bool IsConsoleSession;
+ public bool IsActiveUserSession;
+ public bool IsUserSession;
+ public bool IsRdpSession;
+ public bool IsLocalAdmin;
+ public DateTime? LogonTime;
+ public TimeSpan? IdleTime;
+ public DateTime? DisconnectTime;
+ public string ClientName;
+ public string ClientProtocolType;
+ public string ClientDirectory;
+ public int ClientBuildNumber;
+ }
+
+ [StructLayout(LayoutKind.Sequential)]
+ private struct WTS_SESSION_INFO
+ {
+ public Int32 SessionId;
+ [MarshalAs(UnmanagedType.LPStr)]
+ public string SessionName;
+ public WTS_CONNECTSTATE_CLASS State;
+ }
+
+ [StructLayout(LayoutKind.Sequential)]
+ public struct WINSTATIONINFORMATIONW
+ {
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 70)]
+ private byte[] Reserved1;
+ public int SessionId;
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)]
+ private byte[] Reserved2;
+ public FILETIME ConnectTime;
+ public FILETIME DisconnectTime;
+ public FILETIME LastInputTime;
+ public FILETIME LoginTime;
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1096)]
+ private byte[] Reserved3;
+ public FILETIME CurrentTime;
+ }
+
+ public enum WINSTATIONINFOCLASS
+ {
+ WinStationInformation = 8
+ }
+
+ public enum WTS_CONNECTSTATE_CLASS
+ {
+ Active,
+ Connected,
+ ConnectQuery,
+ Shadow,
+ Disconnected,
+ Idle,
+ Listen,
+ Reset,
+ Down,
+ Init
+ }
+
+ public enum WTS_INFO_CLASS
+ {
+ SessionId=4,
+ UserName,
+ SessionName,
+ DomainName,
+ ConnectState,
+ ClientBuildNumber,
+ ClientName,
+ ClientDirectory,
+ ClientProtocolType=16
+ }
+
+ private static IntPtr OpenServer(string Name)
+ {
+ IntPtr server = WTSOpenServer(Name);
+ return server;
+ }
+
+ private static void CloseServer(IntPtr ServerHandle)
+ {
+ WTSCloseServer(ServerHandle);
+ }
+
+ private static IList PtrToStructureList(IntPtr ppList, int count) where T : struct
+ {
+ List result = new List();
+ long pointer = ppList.ToInt64();
+ int sizeOf = Marshal.SizeOf(typeof(T));
+
+ for (int index = 0; index < count; index++)
+ {
+ T item = (T) Marshal.PtrToStructure(new IntPtr(pointer), typeof(T));
+ result.Add(item);
+ pointer += sizeOf;
+ }
+ return result;
+ }
+
+ public static DateTime? FileTimeToDateTime(FILETIME ft)
+ {
+ if (ft.dwHighDateTime == 0 && ft.dwLowDateTime == 0)
+ {
+ return null;
+ }
+ long hFT = (((long) ft.dwHighDateTime) << 32) + ft.dwLowDateTime;
+ return DateTime.FromFileTime(hFT);
+ }
+
+ public static WINSTATIONINFORMATIONW GetWinStationInformation(IntPtr server, int sessionId)
+ {
+ int retLen = 0;
+ WINSTATIONINFORMATIONW wsInfo = new WINSTATIONINFORMATIONW();
+ WinStationQueryInformation(server, sessionId, (int) WINSTATIONINFOCLASS.WinStationInformation, ref wsInfo, Marshal.SizeOf(typeof(WINSTATIONINFORMATIONW)), ref retLen);
+ return wsInfo;
+ }
+
+ public static TerminalSessionData[] ListSessions(string ServerName)
+ {
+ IntPtr server = IntPtr.Zero;
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+
+ List results = new List();
+
+ try
+ {
+ server = OpenServer(ServerName);
+ IntPtr ppSessionInfo = IntPtr.Zero;
+ int count;
+ bool _isUserSession = false;
+ IList sessionsInfo;
+
+ if (WTSEnumerateSessions(server, 0, 1, out ppSessionInfo, out count) == 0)
+ {
+ throw new Win32Exception();
+ }
+
+ try
+ {
+ sessionsInfo = PtrToStructureList(ppSessionInfo, count);
+ }
+ finally
+ {
+ WTSFreeMemory(ppSessionInfo);
+ }
+
+ foreach (WTS_SESSION_INFO sessionInfo in sessionsInfo)
+ {
+ if (sessionInfo.SessionName != "Services" && sessionInfo.SessionName != "RDP-Tcp")
+ {
+ _isUserSession = true;
+ }
+ results.Add(new TerminalSessionData(sessionInfo.SessionId, sessionInfo.State.ToString(), sessionInfo.SessionName, _isUserSession));
+ _isUserSession = false;
+ }
+ }
+ finally
+ {
+ CloseServer(server);
+ }
+
+ TerminalSessionData[] returnData = results.ToArray();
+ return returnData;
+ }
+
+ public static TerminalSessionInfo GetSessionInfo(string ServerName, int SessionId)
+ {
+ IntPtr server = IntPtr.Zero;
+ IntPtr buffer = IntPtr.Zero;
+ int bytesReturned;
+ TerminalSessionInfo data = new TerminalSessionInfo();
+ bool _IsCurrentSessionId = false;
+ bool _IsConsoleSession = false;
+ bool _IsUserSession = false;
+ int currentSessionID = 0;
+ string _NTAccount = String.Empty;
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+ if (ProcessIdToSessionId(GetCurrentProcessId(), ref currentSessionID) == false)
+ {
+ currentSessionID = -1;
+ }
+
+ // Get all members of the local administrators group
+ bool _IsLocalAdminCheckSuccess = false;
+ List localAdminGroupSidsList = new List();
+ try
+ {
+ DirectoryEntry localMachine = new DirectoryEntry("WinNT://" + ServerName + ",Computer");
+ string localAdminGroupName = new SecurityIdentifier("S-1-5-32-544").Translate(typeof(NTAccount)).Value.Split('\\')[1];
+ DirectoryEntry admGroup = localMachine.Children.Find(localAdminGroupName, "group");
+ object members = admGroup.Invoke("members", null);
+ foreach (object groupMember in (IEnumerable)members)
+ {
+ DirectoryEntry member = new DirectoryEntry(groupMember);
+ if (member.Name != String.Empty)
+ {
+ localAdminGroupSidsList.Add((new NTAccount(member.Name)).Translate(typeof(SecurityIdentifier)).Value);
+ }
+ }
+ _IsLocalAdminCheckSuccess = true;
+ }
+ catch { }
+
+ try
+ {
+ server = OpenServer(ServerName);
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientBuildNumber, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ int lData = Marshal.ReadInt32(buffer);
+ data.ClientBuildNumber = lData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientDirectory, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ string strData = Marshal.PtrToStringAnsi(buffer);
+ data.ClientDirectory = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.ClientName = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientProtocolType, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ Int16 intData = Marshal.ReadInt16(buffer);
+ if (intData == 2)
+ {
+ strData = "RDP";
+ data.IsRdpSession = true;
+ }
+ else
+ {
+ strData = "";
+ data.IsRdpSession = false;
+ }
+ data.ClientProtocolType = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ConnectState, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ lData = Marshal.ReadInt32(buffer);
+ data.ConnectState = ((WTS_CONNECTSTATE_CLASS) lData).ToString();
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.SessionId, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ lData = Marshal.ReadInt32(buffer);
+ data.SessionId = lData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.DomainName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer).ToUpper();
+ data.DomainName = strData;
+ if (strData != String.Empty)
+ {
+ _NTAccount = strData;
+ }
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.UserName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.UserName = strData;
+ if (strData != String.Empty)
+ {
+ data.NTAccount = _NTAccount + "\\" + strData;
+ string _Sid = (new NTAccount(_NTAccount + "\\" + strData)).Translate(typeof(SecurityIdentifier)).Value;
+ data.SID = _Sid;
+ if (_IsLocalAdminCheckSuccess == true)
+ {
+ foreach (string localAdminGroupSid in localAdminGroupSidsList)
+ {
+ if (localAdminGroupSid == _Sid)
+ {
+ data.IsLocalAdmin = true;
+ break;
+ }
+ else
+ {
+ data.IsLocalAdmin = false;
+ }
+ }
+ }
+ }
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.SessionName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.SessionName = strData;
+ if (strData != "Services" && strData != "RDP-Tcp" && data.UserName != String.Empty)
+ {
+ _IsUserSession = true;
+ }
+ data.IsUserSession = _IsUserSession;
+ if (strData == "Console")
+ {
+ _IsConsoleSession = true;
+ }
+ data.IsConsoleSession = _IsConsoleSession;
+
+ WINSTATIONINFORMATIONW wsInfo = GetWinStationInformation(server, SessionId);
+ DateTime? _loginTime = FileTimeToDateTime(wsInfo.LoginTime);
+ DateTime? _lastInputTime = FileTimeToDateTime(wsInfo.LastInputTime);
+ DateTime? _disconnectTime = FileTimeToDateTime(wsInfo.DisconnectTime);
+ DateTime? _currentTime = FileTimeToDateTime(wsInfo.CurrentTime);
+ TimeSpan? _idleTime = (_currentTime != null && _lastInputTime != null) ? _currentTime.Value - _lastInputTime.Value : TimeSpan.Zero;
+ data.LogonTime = _loginTime;
+ data.IdleTime = _idleTime;
+ data.DisconnectTime = _disconnectTime;
+
+ if (currentSessionID == SessionId)
+ {
+ _IsCurrentSessionId = true;
+ }
+ data.IsCurrentSession = _IsCurrentSessionId;
+ }
+ finally
+ {
+ WTSFreeMemory(buffer);
+ buffer = IntPtr.Zero;
+ CloseServer(server);
+ }
+ return data;
+ }
+
+ public static TerminalSessionInfo[] GetUserSessionInfo(string ServerName)
+ {
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+
+ // Find and get detailed information for all user sessions
+ // Also determine the active user session. If a console user exists, then that will be the active user session.
+ // If no console user exists but users are logged in, such as on terminal servers, then select the first logged-in non-console user that is either 'Active' or 'Connected' as the active user.
+ TerminalSessionData[] sessions = ListSessions(ServerName);
+ TerminalSessionInfo sessionInfo = new TerminalSessionInfo();
+ List userSessionsInfo = new List();
+ string firstActiveUserNTAccount = String.Empty;
+ bool IsActiveUserSessionSet = false;
+ foreach (TerminalSessionData session in sessions)
+ {
+ if (session.IsUserSession == true)
+ {
+ sessionInfo = GetSessionInfo(ServerName, session.SessionId);
+ if (sessionInfo.IsUserSession == true)
+ {
+ if ((firstActiveUserNTAccount == String.Empty) && (sessionInfo.ConnectState == "Active" || sessionInfo.ConnectState == "Connected"))
+ {
+ firstActiveUserNTAccount = sessionInfo.NTAccount;
+ }
+
+ if (sessionInfo.IsConsoleSession == true)
+ {
+ sessionInfo.IsActiveUserSession = true;
+ IsActiveUserSessionSet = true;
+ }
+ else
+ {
+ sessionInfo.IsActiveUserSession = false;
+ }
+
+ userSessionsInfo.Add(sessionInfo);
+ }
+ }
+ }
+
+ TerminalSessionInfo[] userSessions = userSessionsInfo.ToArray();
+ if (IsActiveUserSessionSet == false)
+ {
+ foreach (TerminalSessionInfo userSession in userSessions)
+ {
+ if (userSession.NTAccount == firstActiveUserNTAccount)
+ {
+ userSession.IsActiveUserSession = true;
+ break;
+ }
+ }
+ }
+
+ return userSessions;
+ }
+ }
+}
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.ps1 b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.ps1
new file mode 100644
index 0000000..9687117
--- /dev/null
+++ b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/AppDeployToolkitMain.ps1
@@ -0,0 +1,10830 @@
+<#
+.SYNOPSIS
+ This script contains the functions and logic engine for the Deploy-Application.ps1 script.
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script can be called directly to dot-source the toolkit functions for testing, but it is usually called by the Deploy-Application.ps1 script.
+ The script can usually be updated to the latest version without impacting your per-application Deploy-Application scripts.
+ Please check release notes before upgrading.
+.PARAMETER CleanupBlockedApps
+ Clean up the blocked applications.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ShowBlockedAppDialog
+ Display a dialog box showing that the application execution is blocked.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredInstallName
+ Name of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredInstallTitle
+ Title of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredLogname
+ Logfile name of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER AsyncToolkitLaunch
+ This parameter is passed to the script when it is being called externally, e.g. from a scheduled task or asynchronously.
+.NOTES
+ The other parameters specified for this script that are not documented in this help section are for use only by functions in this script that call themselves by running this script again asynchronously.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+ ## Script Parameters: These parameters are passed to the script when it is called externally from a scheduled task or because of an Image File Execution Options registry setting
+ [switch]$ShowInstallationPrompt = $false,
+ [switch]$ShowInstallationRestartPrompt = $false,
+ [switch]$CleanupBlockedApps = $false,
+ [switch]$ShowBlockedAppDialog = $false,
+ [switch]$DisableLogging = $false,
+ [string]$ReferredInstallName = '',
+ [string]$ReferredInstallTitle = '',
+ [string]$ReferredLogName = '',
+ [string]$Message = '',
+ [string]$MessageAlignment = '',
+ [string]$ButtonRightText = '',
+ [string]$ButtonLeftText = '',
+ [string]$ButtonMiddleText = '',
+ [string]$Icon = '',
+ [string]$Timeout = '',
+ [switch]$ExitOnTimeout = $false,
+ [boolean]$MinimizeWindows = $false,
+ [switch]$PersistPrompt = $false,
+ [int32]$CountdownSeconds,
+ [int32]$CountdownNoHideSeconds,
+ [switch]$NoCountdown = $false,
+ [switch]$AsyncToolkitLaunch = $false
+)
+
+##*=============================================
+##* VARIABLE DECLARATION
+##*=============================================
+#region VariableDeclaration
+
+## Variables: Toolkit Name
+[string]$appDeployToolkitName = 'PSAppDeployToolkit'
+[string]$appDeployMainScriptFriendlyName = 'App Deploy Toolkit Main'
+
+## Variables: Script Info
+[version]$appDeployMainScriptVersion = [version]'3.7.0'
+[version]$appDeployMainScriptMinimumConfigVersion = [version]'3.6.9'
+[string]$appDeployMainScriptDate = '02/13/2018'
+[hashtable]$appDeployMainScriptParameters = $PSBoundParameters
+
+## Variables: Datetime and Culture
+[datetime]$currentDateTime = Get-Date
+[string]$currentTime = Get-Date -Date $currentDateTime -UFormat '%T'
+[string]$currentDate = Get-Date -Date $currentDateTime -UFormat '%d-%m-%Y'
+[timespan]$currentTimeZoneBias = [timezone]::CurrentTimeZone.GetUtcOffset([datetime]::Now)
+[Globalization.CultureInfo]$culture = Get-Culture
+[string]$currentLanguage = $culture.TwoLetterISOLanguageName.ToUpper()
+[Globalization.CultureInfo]$uiculture = Get-UICulture
+[string]$currentUILanguage = $uiculture.TwoLetterISOLanguageName.ToUpper()
+
+## Variables: Environment Variables
+[psobject]$envHost = $Host
+[psobject]$envShellFolders = Get-ItemProperty -Path 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders' -ErrorAction 'SilentlyContinue'
+[string]$envAllUsersProfile = $env:ALLUSERSPROFILE
+[string]$envAppData = [Environment]::GetFolderPath('ApplicationData')
+[string]$envArchitecture = $env:PROCESSOR_ARCHITECTURE
+[string]$envCommonProgramFiles = [Environment]::GetFolderPath('CommonProgramFiles')
+[string]$envCommonProgramFilesX86 = ${env:CommonProgramFiles(x86)}
+[string]$envCommonDesktop = $envShellFolders | Select-Object -ExpandProperty 'Common Desktop' -ErrorAction 'SilentlyContinue'
+[string]$envCommonDocuments = $envShellFolders | Select-Object -ExpandProperty 'Common Documents' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartMenuPrograms = $envShellFolders | Select-Object -ExpandProperty 'Common Programs' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartMenu = $envShellFolders | Select-Object -ExpandProperty 'Common Start Menu' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartUp = $envShellFolders | Select-Object -ExpandProperty 'Common Startup' -ErrorAction 'SilentlyContinue'
+[string]$envCommonTemplates = $envShellFolders | Select-Object -ExpandProperty 'Common Templates' -ErrorAction 'SilentlyContinue'
+[string]$envComputerName = [Environment]::MachineName.ToUpper()
+[string]$envComputerNameFQDN = ([Net.Dns]::GetHostEntry('localhost')).HostName
+[string]$envHomeDrive = $env:HOMEDRIVE
+[string]$envHomePath = $env:HOMEPATH
+[string]$envHomeShare = $env:HOMESHARE
+[string]$envLocalAppData = [Environment]::GetFolderPath('LocalApplicationData')
+[string[]]$envLogicalDrives = [Environment]::GetLogicalDrives()
+[string]$envProgramFiles = [Environment]::GetFolderPath('ProgramFiles')
+[string]$envProgramFilesX86 = ${env:ProgramFiles(x86)}
+[string]$envProgramData = [Environment]::GetFolderPath('CommonApplicationData')
+[string]$envPublic = $env:PUBLIC
+[string]$envSystemDrive = $env:SYSTEMDRIVE
+[string]$envSystemRoot = $env:SYSTEMROOT
+[string]$envTemp = [IO.Path]::GetTempPath()
+[string]$envUserCookies = [Environment]::GetFolderPath('Cookies')
+[string]$envUserDesktop = [Environment]::GetFolderPath('DesktopDirectory')
+[string]$envUserFavorites = [Environment]::GetFolderPath('Favorites')
+[string]$envUserInternetCache = [Environment]::GetFolderPath('InternetCache')
+[string]$envUserInternetHistory = [Environment]::GetFolderPath('History')
+[string]$envUserMyDocuments = [Environment]::GetFolderPath('MyDocuments')
+[string]$envUserName = [Environment]::UserName
+[string]$envUserPictures = [Environment]::GetFolderPath('MyPictures')
+[string]$envUserProfile = $env:USERPROFILE
+[string]$envUserSendTo = [Environment]::GetFolderPath('SendTo')
+[string]$envUserStartMenu = [Environment]::GetFolderPath('StartMenu')
+[string]$envUserStartMenuPrograms = [Environment]::GetFolderPath('Programs')
+[string]$envUserStartUp = [Environment]::GetFolderPath('StartUp')
+[string]$envUserTemplates = [Environment]::GetFolderPath('Templates')
+[string]$envSystem32Directory = [Environment]::SystemDirectory
+[string]$envWinDir = $env:WINDIR
+# Handle X86 environment variables so they are never empty
+If (-not $envCommonProgramFilesX86) { [string]$envCommonProgramFilesX86 = $envCommonProgramFiles }
+If (-not $envProgramFilesX86) { [string]$envProgramFilesX86 = $envProgramFiles }
+
+## Variables: Domain Membership
+[boolean]$IsMachinePartOfDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').PartOfDomain
+[string]$envMachineWorkgroup = ''
+[string]$envMachineADDomain = ''
+[string]$envLogonServer = ''
+[string]$MachineDomainController = ''
+If ($IsMachinePartOfDomain) {
+ [string]$envMachineADDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').Domain | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+ Try {
+ [string]$envLogonServer = $env:LOGONSERVER | Where-Object { (($_) -and (-not $_.Contains('\\MicrosoftAccount'))) } | ForEach-Object { $_.TrimStart('\') } | ForEach-Object { ([Net.Dns]::GetHostEntry($_)).HostName }
+ # If running in system context, fall back on the logonserver value stored in the registry
+ If (-not $envLogonServer) { [string]$envLogonServer = Get-ItemProperty -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Group Policy\History' -ErrorAction 'SilentlyContinue' | Select-Object -ExpandProperty 'DCName' -ErrorAction 'SilentlyContinue' }
+ [string]$MachineDomainController = [DirectoryServices.ActiveDirectory.Domain]::GetCurrentDomain().FindDomainController().Name
+ }
+ Catch { }
+}
+Else {
+ [string]$envMachineWorkgroup = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').Domain | Where-Object { $_ } | ForEach-Object { $_.ToUpper() }
+}
+[string]$envMachineDNSDomain = [Net.NetworkInformation.IPGlobalProperties]::GetIPGlobalProperties().DomainName | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+[string]$envUserDNSDomain = $env:USERDNSDOMAIN | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+Try {
+ [string]$envUserDomain = [Environment]::UserDomainName.ToUpper()
+}
+Catch { }
+
+## Variables: Operating System
+[psobject]$envOS = Get-WmiObject -Class 'Win32_OperatingSystem' -ErrorAction 'SilentlyContinue'
+[string]$envOSName = $envOS.Caption.Trim()
+[string]$envOSServicePack = $envOS.CSDVersion
+[version]$envOSVersion = $envOS.Version
+[string]$envOSVersionMajor = $envOSVersion.Major
+[string]$envOSVersionMinor = $envOSVersion.Minor
+[string]$envOSVersionBuild = $envOSVersion.Build
+If ($envOSVersionMajor -eq 10) {$envOSVersionRevision = (Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'UBR' -ErrorAction SilentlyContinue).UBR}
+Else { [string]$envOSVersionRevision = ,((Get-ItemProperty -Path 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'BuildLabEx' -ErrorAction 'SilentlyContinue').BuildLabEx -split '\.') | ForEach-Object { $_[1] } }
+If ($envOSVersionRevision -notmatch '^[\d\.]+$') { $envOSVersionRevision = '' }
+If ($envOSVersionRevision) { [string]$envOSVersion = "$($envOSVersion.ToString()).$envOSVersionRevision" } Else { "$($envOSVersion.ToString())" }
+# Get the operating system type
+[int32]$envOSProductType = $envOS.ProductType
+[boolean]$IsServerOS = [boolean]($envOSProductType -eq 3)
+[boolean]$IsDomainControllerOS = [boolean]($envOSProductType -eq 2)
+[boolean]$IsWorkStationOS = [boolean]($envOSProductType -eq 1)
+Switch ($envOSProductType) {
+ 3 { [string]$envOSProductTypeName = 'Server' }
+ 2 { [string]$envOSProductTypeName = 'Domain Controller' }
+ 1 { [string]$envOSProductTypeName = 'Workstation' }
+ Default { [string]$envOSProductTypeName = 'Unknown' }
+}
+# Get the OS Architecture
+[boolean]$Is64Bit = [boolean]((Get-WmiObject -Class 'Win32_Processor' -ErrorAction 'SilentlyContinue' | Where-Object { $_.DeviceID -eq 'CPU0' } | Select-Object -ExpandProperty 'AddressWidth') -eq 64)
+If ($Is64Bit) { [string]$envOSArchitecture = '64-bit' } Else { [string]$envOSArchitecture = '32-bit' }
+
+## Variables: Current Process Architecture
+[boolean]$Is64BitProcess = [boolean]([IntPtr]::Size -eq 8)
+If ($Is64BitProcess) { [string]$psArchitecture = 'x64' } Else { [string]$psArchitecture = 'x86' }
+
+## Variables: Hardware
+[int32]$envSystemRAM = Get-WMIObject -Class Win32_PhysicalMemory -ComputerName $env:COMPUTERNAME -ErrorAction 'SilentlyContinue' | Measure-Object -Property Capacity -Sum -ErrorAction SilentlyContinue | % {[Math]::Round(($_.sum / 1GB),2)}
+
+## Variables: PowerShell And CLR (.NET) Versions
+[hashtable]$envPSVersionTable = $PSVersionTable
+# PowerShell Version
+[version]$envPSVersion = $envPSVersionTable.PSVersion
+[string]$envPSVersionMajor = $envPSVersion.Major
+[string]$envPSVersionMinor = $envPSVersion.Minor
+[string]$envPSVersionBuild = $envPSVersion.Build
+[string]$envPSVersionRevision = $envPSVersion.Revision
+[string]$envPSVersion = $envPSVersion.ToString()
+# CLR (.NET) Version used by PowerShell
+[version]$envCLRVersion = $envPSVersionTable.CLRVersion
+[string]$envCLRVersionMajor = $envCLRVersion.Major
+[string]$envCLRVersionMinor = $envCLRVersion.Minor
+[string]$envCLRVersionBuild = $envCLRVersion.Build
+[string]$envCLRVersionRevision = $envCLRVersion.Revision
+[string]$envCLRVersion = $envCLRVersion.ToString()
+
+## Variables: Permissions/Accounts
+[Security.Principal.WindowsIdentity]$CurrentProcessToken = [Security.Principal.WindowsIdentity]::GetCurrent()
+[Security.Principal.SecurityIdentifier]$CurrentProcessSID = $CurrentProcessToken.User
+[string]$ProcessNTAccount = $CurrentProcessToken.Name
+[string]$ProcessNTAccountSID = $CurrentProcessSID.Value
+[boolean]$IsAdmin = [boolean]($CurrentProcessToken.Groups -contains [Security.Principal.SecurityIdentifier]'S-1-5-32-544')
+[boolean]$IsLocalSystemAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'LocalSystemSid')
+[boolean]$IsLocalServiceAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'LocalServiceSid')
+[boolean]$IsNetworkServiceAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'NetworkServiceSid')
+[boolean]$IsServiceAccount = [boolean]($CurrentProcessToken.Groups -contains [Security.Principal.SecurityIdentifier]'S-1-5-6')
+[boolean]$IsProcessUserInteractive = [Environment]::UserInteractive
+[string]$LocalSystemNTAccount = (New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ([Security.Principal.WellKnownSidType]::'LocalSystemSid', $null)).Translate([Security.Principal.NTAccount]).Value
+# Check if script is running in session zero
+If ($IsLocalSystemAccount -or $IsLocalServiceAccount -or $IsNetworkServiceAccount -or $IsServiceAccount) { $SessionZero = $true } Else { $SessionZero = $false }
+
+## Variables: Script Name and Script Paths
+[string]$scriptPath = $MyInvocation.MyCommand.Definition
+[string]$scriptName = [IO.Path]::GetFileNameWithoutExtension($scriptPath)
+[string]$scriptFileName = Split-Path -Path $scriptPath -Leaf
+[string]$scriptRoot = Split-Path -Path $scriptPath -Parent
+[string]$invokingScript = (Get-Variable -Name 'MyInvocation').Value.ScriptName
+# Get the invoking script directory
+If ($invokingScript) {
+ # If this script was invoked by another script
+ [string]$scriptParentPath = Split-Path -Path $invokingScript -Parent
+}
+Else {
+ # If this script was not invoked by another script, fall back to the directory one level above this script
+ [string]$scriptParentPath = (Get-Item -LiteralPath $scriptRoot).Parent.FullName
+}
+
+## Variables: App Deploy Script Dependency Files
+[string]$appDeployLogoIcon = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitLogo.ico'
+[string]$appDeployLogoBanner = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitBanner.png'
+[string]$appDeployConfigFile = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitConfig.xml'
+[string]$appDeployCustomTypesSourceCode = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitMain.cs'
+# App Deploy Optional Extensions File
+[string]$appDeployToolkitDotSourceExtensions = 'AppDeployToolkitExtensions.ps1'
+# Check that dependency files are present
+If (-not (Test-Path -LiteralPath $appDeployLogoIcon -PathType 'Leaf')) { Throw 'App Deploy logo icon file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployLogoBanner -PathType 'Leaf')) { Throw 'App Deploy logo banner file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployConfigFile -PathType 'Leaf')) { Throw 'App Deploy XML configuration file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployCustomTypesSourceCode -PathType 'Leaf')) { Throw 'App Deploy custom types source code file not found.' }
+
+## Import variables from XML configuration file
+[Xml.XmlDocument]$xmlConfigFile = Get-Content -LiteralPath $AppDeployConfigFile
+[Xml.XmlElement]$xmlConfig = $xmlConfigFile.AppDeployToolkit_Config
+# Get Config File Details
+[Xml.XmlElement]$configConfigDetails = $xmlConfig.Config_File
+[string]$configConfigVersion = [version]$configConfigDetails.Config_Version
+[string]$configConfigDate = $configConfigDetails.Config_Date
+# Get Toolkit Options
+[Xml.XmlElement]$xmlToolkitOptions = $xmlConfig.Toolkit_Options
+[boolean]$configToolkitRequireAdmin = [boolean]::Parse($xmlToolkitOptions.Toolkit_RequireAdmin)
+[string]$configToolkitTempPath = $ExecutionContext.InvokeCommand.ExpandString($xmlToolkitOptions.Toolkit_TempPath)
+[string]$configToolkitRegPath = $xmlToolkitOptions.Toolkit_RegPath
+[string]$configToolkitLogDir = $ExecutionContext.InvokeCommand.ExpandString($xmlToolkitOptions.Toolkit_LogPath)
+[boolean]$configToolkitCompressLogs = [boolean]::Parse($xmlToolkitOptions.Toolkit_CompressLogs)
+[string]$configToolkitLogStyle = $xmlToolkitOptions.Toolkit_LogStyle
+[double]$configToolkitLogMaxSize = $xmlToolkitOptions.Toolkit_LogMaxSize
+[boolean]$configToolkitLogWriteToHost = [boolean]::Parse($xmlToolkitOptions.Toolkit_LogWriteToHost)
+[boolean]$configToolkitLogDebugMessage = [boolean]::Parse($xmlToolkitOptions.Toolkit_LogDebugMessage)
+# Get MSI Options
+[Xml.XmlElement]$xmlConfigMSIOptions = $xmlConfig.MSI_Options
+[string]$configMSILoggingOptions = $xmlConfigMSIOptions.MSI_LoggingOptions
+[string]$configMSIInstallParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_InstallParams)
+[string]$configMSISilentParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_SilentParams)
+[string]$configMSIUninstallParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_UninstallParams)
+[string]$configMSILogDir = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_LogPath)
+[int32]$configMSIMutexWaitTime = $xmlConfigMSIOptions.MSI_MutexWaitTime
+# Get UI Options
+[Xml.XmlElement]$xmlConfigUIOptions = $xmlConfig.UI_Options
+[string]$configInstallationUILanguageOverride = $xmlConfigUIOptions.InstallationUI_LanguageOverride
+[boolean]$configShowBalloonNotifications = [boolean]::Parse($xmlConfigUIOptions.ShowBalloonNotifications)
+[int32]$configInstallationUITimeout = $xmlConfigUIOptions.InstallationUI_Timeout
+[int32]$configInstallationUIExitCode = $xmlConfigUIOptions.InstallationUI_ExitCode
+[int32]$configInstallationDeferExitCode = $xmlConfigUIOptions.InstallationDefer_ExitCode
+[int32]$configInstallationPersistInterval = $xmlConfigUIOptions.InstallationPrompt_PersistInterval
+[int32]$configInstallationRestartPersistInterval = $xmlConfigUIOptions.InstallationRestartPrompt_PersistInterval
+[int32]$configInstallationPromptToSave = $xmlConfigUIOptions.InstallationPromptToSave_Timeout
+[boolean]$configInstallationWelcomePromptDynamicRunningProcessEvaluation = [boolean]::Parse($xmlConfigUIOptions.InstallationWelcomePrompt_DynamicRunningProcessEvaluation)
+[int32]$configInstallationWelcomePromptDynamicRunningProcessEvaluationInterval = $xmlConfigUIOptions.InstallationWelcomePrompt_DynamicRunningProcessEvaluationInterval
+# Define ScriptBlock for Loading Message UI Language Options (default for English if no localization found)
+[scriptblock]$xmlLoadLocalizedUIMessages = {
+ # If a user is logged on, then get primary UI language for logged on user (even if running in session 0)
+ If ($RunAsActiveUser) {
+ # Read language defined by Group Policy
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKLM:SOFTWARE\Policies\Microsoft\MUI\Settings' -Value 'PreferredUILanguages'
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Software\Policies\Microsoft\Windows\Control Panel\Desktop' -Value 'PreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ # Read language for Win Vista & higher machines
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop' -Value 'PreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop\MuiCached' -Value 'MachinePreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\International' -Value 'LocaleName' -SID $RunAsActiveUser.SID
+ }
+ # Read language for Win XP machines
+ If (-not $HKULanguages) {
+ [string]$HKULocale = Get-RegistryKey -Key 'HKCU\Control Panel\International' -Value 'Locale' -SID $RunAsActiveUser.SID
+ If ($HKULocale) {
+ [int32]$HKULocale = [Convert]::ToInt32('0x' + $HKULocale, 16)
+ [string[]]$HKULanguages = ([Globalization.CultureInfo]($HKULocale)).Name
+ }
+ }
+ If ($HKULanguages) {
+ [Globalization.CultureInfo]$PrimaryWindowsUILanguage = [Globalization.CultureInfo]($HKULanguages[0])
+ [string]$HKUPrimaryLanguageShort = $PrimaryWindowsUILanguage.TwoLetterISOLanguageName.ToUpper()
+
+ # If the detected language is Chinese, determine if it is simplified or traditional Chinese
+ If ($HKUPrimaryLanguageShort -eq 'ZH') {
+ If ($PrimaryWindowsUILanguage.EnglishName -match 'Simplified') {
+ [string]$HKUPrimaryLanguageShort = 'ZH-Hans'
+ }
+ If ($PrimaryWindowsUILanguage.EnglishName -match 'Traditional') {
+ [string]$HKUPrimaryLanguageShort = 'ZH-Hant'
+ }
+ }
+
+ # If the detected language is Portuguese, determine if it is Brazilian Portuguese
+ If ($HKUPrimaryLanguageShort -eq 'PT') {
+ If ($PrimaryWindowsUILanguage.ThreeLetterWindowsLanguageName -eq 'PTB') {
+ [string]$HKUPrimaryLanguageShort = 'PT-BR'
+ }
+ }
+ }
+ }
+
+ If ($HKUPrimaryLanguageShort) {
+ # Use the primary UI language of the logged in user
+ [string]$xmlUIMessageLanguage = "UI_Messages_$HKUPrimaryLanguageShort"
+ }
+ Else {
+ # Default to UI language of the account executing current process (even if it is the SYSTEM account)
+ [string]$xmlUIMessageLanguage = "UI_Messages_$currentLanguage"
+ }
+ # Default to English if the detected UI language is not available in the XMl config file
+ If (-not ($xmlConfig.$xmlUIMessageLanguage)) { [string]$xmlUIMessageLanguage = 'UI_Messages_EN' }
+ # Override the detected language if the override option was specified in the XML config file
+ If ($configInstallationUILanguageOverride) { [string]$xmlUIMessageLanguage = "UI_Messages_$configInstallationUILanguageOverride" }
+
+ [Xml.XmlElement]$xmlUIMessages = $xmlConfig.$xmlUIMessageLanguage
+ [string]$configDiskSpaceMessage = $xmlUIMessages.DiskSpace_Message
+ [string]$configBalloonTextStart = $xmlUIMessages.BalloonText_Start
+ [string]$configBalloonTextComplete = $xmlUIMessages.BalloonText_Complete
+ [string]$configBalloonTextRestartRequired = $xmlUIMessages.BalloonText_RestartRequired
+ [string]$configBalloonTextFastRetry = $xmlUIMessages.BalloonText_FastRetry
+ [string]$configBalloonTextError = $xmlUIMessages.BalloonText_Error
+ [string]$configProgressMessageInstall = $xmlUIMessages.Progress_MessageInstall
+ [string]$configProgressMessageUninstall = $xmlUIMessages.Progress_MessageUninstall
+ [string]$configClosePromptMessage = $xmlUIMessages.ClosePrompt_Message
+ [string]$configClosePromptButtonClose = $xmlUIMessages.ClosePrompt_ButtonClose
+ [string]$configClosePromptButtonDefer = $xmlUIMessages.ClosePrompt_ButtonDefer
+ [string]$configClosePromptButtonContinue = $xmlUIMessages.ClosePrompt_ButtonContinue
+ [string]$configClosePromptButtonContinueTooltip = $xmlUIMessages.ClosePrompt_ButtonContinueTooltip
+ [string]$configClosePromptCountdownMessage = $xmlUIMessages.ClosePrompt_CountdownMessage
+ [string]$configDeferPromptWelcomeMessage = $xmlUIMessages.DeferPrompt_WelcomeMessage
+ [string]$configDeferPromptExpiryMessage = $xmlUIMessages.DeferPrompt_ExpiryMessage
+ [string]$configDeferPromptWarningMessage = $xmlUIMessages.DeferPrompt_WarningMessage
+ [string]$configDeferPromptRemainingDeferrals = $xmlUIMessages.DeferPrompt_RemainingDeferrals
+ [string]$configDeferPromptDeadline = $xmlUIMessages.DeferPrompt_Deadline
+ [string]$configBlockExecutionMessage = $xmlUIMessages.BlockExecution_Message
+ [string]$configDeploymentTypeInstall = $xmlUIMessages.DeploymentType_Install
+ [string]$configDeploymentTypeUnInstall = $xmlUIMessages.DeploymentType_UnInstall
+ [string]$configRestartPromptTitle = $xmlUIMessages.RestartPrompt_Title
+ [string]$configRestartPromptMessage = $xmlUIMessages.RestartPrompt_Message
+ [string]$configRestartPromptMessageTime = $xmlUIMessages.RestartPrompt_MessageTime
+ [string]$configRestartPromptMessageRestart = $xmlUIMessages.RestartPrompt_MessageRestart
+ [string]$configRestartPromptTimeRemaining = $xmlUIMessages.RestartPrompt_TimeRemaining
+ [string]$configRestartPromptButtonRestartLater = $xmlUIMessages.RestartPrompt_ButtonRestartLater
+ [string]$configRestartPromptButtonRestartNow = $xmlUIMessages.RestartPrompt_ButtonRestartNow
+ [string]$configWelcomePromptCountdownMessage = $xmlUIMessages.WelcomePrompt_CountdownMessage
+ [string]$configWelcomePromptCustomMessage = $xmlUIMessages.WelcomePrompt_CustomMessage
+}
+
+## Variables: Script Directories
+[string]$dirFiles = Join-Path -Path $scriptParentPath -ChildPath 'Files'
+[string]$dirSupportFiles = Join-Path -Path $scriptParentPath -ChildPath 'SupportFiles'
+[string]$dirAppDeployTemp = Join-Path -Path $configToolkitTempPath -ChildPath $appDeployToolkitName
+
+## Set the deployment type to "Install" if it has not been specified
+If (-not $deploymentType) { [string]$deploymentType = 'Install' }
+
+## Variables: Executables
+[string]$exeWusa = 'wusa.exe' # Installs Standalone Windows Updates
+[string]$exeMsiexec = 'msiexec.exe' # Installs MSI Installers
+[string]$exeSchTasks = "$envWinDir\System32\schtasks.exe" # Manages Scheduled Tasks
+
+## Variables: RegEx Patterns
+[string]$MSIProductCodeRegExPattern = '^(\{{0,1}([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}\}{0,1})$'
+
+## Variables: Registry Keys
+# Registry keys for native and WOW64 applications
+[string[]]$regKeyApplications = 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall','HKLM:SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall'
+If ($is64Bit) {
+ [string]$regKeyLotusNotes = 'HKLM:SOFTWARE\Wow6432Node\Lotus\Notes'
+}
+Else {
+ [string]$regKeyLotusNotes = 'HKLM:SOFTWARE\Lotus\Notes'
+}
+[string]$regKeyAppExecution = 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options'
+
+## COM Objects: Initialize
+[__comobject]$Shell = New-Object -ComObject 'WScript.Shell' -ErrorAction 'SilentlyContinue'
+[__comobject]$ShellApp = New-Object -ComObject 'Shell.Application' -ErrorAction 'SilentlyContinue'
+
+## Variables: Reset/Remove Variables
+[boolean]$msiRebootDetected = $false
+[boolean]$BlockExecution = $false
+[boolean]$installationStarted = $false
+[boolean]$runningTaskSequence = $false
+If (Test-Path -LiteralPath 'variable:welcomeTimer') { Remove-Variable -Name 'welcomeTimer' -Scope 'Script'}
+# Reset the deferral history
+If (Test-Path -LiteralPath 'variable:deferHistory') { Remove-Variable -Name 'deferHistory' }
+If (Test-Path -LiteralPath 'variable:deferTimes') { Remove-Variable -Name 'deferTimes' }
+If (Test-Path -LiteralPath 'variable:deferDays') { Remove-Variable -Name 'deferDays' }
+
+## Variables: System DPI Scale Factor
+[scriptblock]$GetDisplayScaleFactor = {
+ # If a user is logged on, then get display scale factor for logged on user (even if running in session 0)
+ [boolean]$UserDisplayScaleFactor = $false
+ If ($RunAsActiveUser) {
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop\WindowMetrics' -Value 'AppliedDPI' -SID $RunAsActiveUser.SID
+ If (-not ([string]$dpiPixels)) {
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop' -Value 'LogPixels' -SID $RunAsActiveUser.SID
+ }
+ [boolean]$UserDisplayScaleFactor = $true
+ }
+ If (-not ([string]$dpiPixels)) {
+ # This registry setting only exists if system scale factor has been changed at least once
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion\FontDPI' -Value 'LogPixels'
+ [boolean]$UserDisplayScaleFactor = $false
+ }
+ Switch ($dpiPixels) {
+ 96 { [int32]$dpiScale = 100 }
+ 120 { [int32]$dpiScale = 125 }
+ 144 { [int32]$dpiScale = 150 }
+ 192 { [int32]$dpiScale = 200 }
+ Default { [int32]$dpiScale = 100 }
+ }
+}
+#endregion
+##*=============================================
+##* END VARIABLE DECLARATION
+##*=============================================
+
+##*=============================================
+##* FUNCTION LISTINGS
+##*=============================================
+#region FunctionListings
+
+#region Function Write-FunctionHeaderOrFooter
+Function Write-FunctionHeaderOrFooter {
+<#
+.SYNOPSIS
+ Write the function header or footer to the log upon first entering or exiting a function.
+.DESCRIPTION
+ Write the "Function Start" message, the bound parameters the function was invoked with, or the "Function End" message when entering or exiting a function.
+ Messages are debug messages so will only be logged if LogDebugMessage option is enabled in XML config file.
+.PARAMETER CmdletName
+ The name of the function this function is invoked from.
+.PARAMETER CmdletBoundParameters
+ The bound parameters of the function this function is invoked from.
+.PARAMETER Header
+ Write the function header.
+.PARAMETER Footer
+ Write the function footer.
+.EXAMPLE
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+.EXAMPLE
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$CmdletName,
+ [Parameter(Mandatory=$true,ParameterSetName='Header')]
+ [AllowEmptyCollection()]
+ [hashtable]$CmdletBoundParameters,
+ [Parameter(Mandatory=$true,ParameterSetName='Header')]
+ [switch]$Header,
+ [Parameter(Mandatory=$true,ParameterSetName='Footer')]
+ [switch]$Footer
+ )
+
+ If ($Header) {
+ Write-Log -Message 'Function Start' -Source ${CmdletName} -DebugMessage
+
+ ## Get the parameters that the calling function was invoked with
+ [string]$CmdletBoundParameters = $CmdletBoundParameters | Format-Table -Property @{ Label = 'Parameter'; Expression = { "[-$($_.Key)]" } }, @{ Label = 'Value'; Expression = { $_.Value }; Alignment = 'Left' }, @{ Label = 'Type'; Expression = { $_.Value.GetType().Name }; Alignment = 'Left' } -AutoSize -Wrap | Out-String
+ If ($CmdletBoundParameters) {
+ Write-Log -Message "Function invoked with bound parameter(s): `n$CmdletBoundParameters" -Source ${CmdletName} -DebugMessage
+ }
+ Else {
+ Write-Log -Message 'Function invoked without any bound parameters.' -Source ${CmdletName} -DebugMessage
+ }
+ }
+ ElseIf ($Footer) {
+ Write-Log -Message 'Function End' -Source ${CmdletName} -DebugMessage
+ }
+}
+#endregion
+#region Function Execute-MSP
+Function Execute-MSP {
+<#
+.SYNOPSIS
+ Reads SummaryInfo targeted product codes in MSP file and determines if the MSP file applies to any installed products
+ If a valid installed product is found, triggers the Execute-MSI function to patch the installation.
+.PARAMETER Path
+.EXAMPLE
+ Execute-MSP -Path 'Adobe_Reader_11.0.3_EN.msp'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,HelpMessage='Please enter the path to the MSP file')]
+ [ValidateScript({('.msp' -contains [IO.Path]::GetExtension($_))})]
+ [Alias('FilePath')]
+ [string]$Path
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If the MSP is in the Files directory, set the full path to the MSP
+ If (Test-Path -LiteralPath (Join-Path -Path $dirFiles -ChildPath $path -ErrorAction 'SilentlyContinue') -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ [string]$mspFile = Join-Path -Path $dirFiles -ChildPath $path
+ }
+ ElseIf (Test-Path -LiteralPath $Path -ErrorAction 'SilentlyContinue') {
+ [string]$mspFile = (Get-Item -LiteralPath $Path).FullName
+ }
+ Else {
+ Write-Log -Message "Failed to find MSP file [$path]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to find MSP file [$path]."
+ }
+ Continue
+ }
+ Write-Log -Message 'Checking MSP file for valid product codes' -Source ${CmdletName}
+
+ [boolean]$IsMSPNeeded = $false
+
+ $Installer = New-Object -com WindowsInstaller.Installer
+ $Database = $Installer.GetType().InvokeMember(“OpenDatabase”, “InvokeMethod”, $Null, $Installer, $($mspFile,([int32]32)))
+ [__comobject]$SummaryInformation = Get-ObjectProperty -InputObject $Database -PropertyName 'SummaryInformation'
+ [hashtable]$SummaryInfoProperty = @{}
+ $all = (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(7)).Split(";")
+ Foreach($FormattedProductCode in $all) {
+ [psobject]$MSIInstalled = Get-InstalledApplication -ProductCode $FormattedProductCode
+ If ($MSIInstalled) {[boolean]$IsMSPNeeded = $true }
+ }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SummaryInformation) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($DataBase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ If ($IsMSPNeeded) { Execute-MSI -Action Patch -Path $Path }
+ }
+}
+#endregion
+
+#region Function Write-Log
+Function Write-Log {
+<#
+.SYNOPSIS
+ Write messages to a log file in CMTrace.exe compatible format or Legacy text file format.
+.DESCRIPTION
+ Write messages to a log file in CMTrace.exe compatible format or Legacy text file format and optionally display in the console.
+.PARAMETER Message
+ The message to write to the log file or output to the console.
+.PARAMETER Severity
+ Defines message type. When writing to console or CMTrace.exe log format, it allows highlighting of message type.
+ Options: 1 = Information (default), 2 = Warning (highlighted in yellow), 3 = Error (highlighted in red)
+.PARAMETER Source
+ The source of the message being logged.
+.PARAMETER ScriptSection
+ The heading for the portion of the script that is being executed. Default is: $script:installPhase.
+.PARAMETER LogType
+ Choose whether to write a CMTrace.exe compatible log file or a Legacy text log file.
+.PARAMETER LogFileDirectory
+ Set the directory where the log file will be saved.
+.PARAMETER LogFileName
+ Set the name of the log file.
+.PARAMETER MaxLogFileSizeMB
+ Maximum file size limit for log file in megabytes (MB). Default is 10 MB.
+.PARAMETER WriteHost
+ Write the log message to the console.
+.PARAMETER ContinueOnError
+ Suppress writing log message to console on failure to write message to log file. Default is: $true.
+.PARAMETER PassThru
+ Return the message that was passed to the function
+.PARAMETER DebugMessage
+ Specifies that the message is a debug message. Debug messages only get logged if -LogDebugMessage is set to $true.
+.PARAMETER LogDebugMessage
+ Debug messages only get logged if this parameter is set to $true in the config XML file.
+.EXAMPLE
+ Write-Log -Message "Installing patch MS15-031" -Source 'Add-Patch' -LogType 'CMTrace'
+.EXAMPLE
+ Write-Log -Message "Script is running on Windows 8" -Source 'Test-ValidOS' -LogType 'Legacy'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [AllowEmptyCollection()]
+ [Alias('Text')]
+ [string[]]$Message,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateRange(1,3)]
+ [int16]$Severity = 1,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNull()]
+ [string]$Source = '',
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [string]$ScriptSection = $script:installPhase,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateSet('CMTrace','Legacy')]
+ [string]$LogType = $configToolkitLogStyle,
+ [Parameter(Mandatory=$false,Position=5)]
+ [ValidateNotNullorEmpty()]
+ [string]$LogFileDirectory = $(If ($configToolkitCompressLogs) { $logTempFolder } Else { $configToolkitLogDir }),
+ [Parameter(Mandatory=$false,Position=6)]
+ [ValidateNotNullorEmpty()]
+ [string]$LogFileName = $logName,
+ [Parameter(Mandatory=$false,Position=7)]
+ [ValidateNotNullorEmpty()]
+ [decimal]$MaxLogFileSizeMB = $configToolkitLogMaxSize,
+ [Parameter(Mandatory=$false,Position=8)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$WriteHost = $configToolkitLogWriteToHost,
+ [Parameter(Mandatory=$false,Position=9)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [Parameter(Mandatory=$false,Position=10)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false,Position=11)]
+ [switch]$DebugMessage = $false,
+ [Parameter(Mandatory=$false,Position=12)]
+ [boolean]$LogDebugMessage = $configToolkitLogDebugMessage
+ )
+
+ Begin {
+ ## Get the name of this function
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ ## Logging Variables
+ # Log file date/time
+ [string]$LogTime = (Get-Date -Format 'HH:mm:ss.fff').ToString()
+ [string]$LogDate = (Get-Date -Format 'MM-dd-yyyy').ToString()
+ If (-not (Test-Path -LiteralPath 'variable:LogTimeZoneBias')) { [int32]$script:LogTimeZoneBias = [timezone]::CurrentTimeZone.GetUtcOffset([datetime]::Now).TotalMinutes }
+ [string]$LogTimePlusBias = $LogTime + $script:LogTimeZoneBias
+ # Initialize variables
+ [boolean]$ExitLoggingFunction = $false
+ If (-not (Test-Path -LiteralPath 'variable:DisableLogging')) { $DisableLogging = $false }
+ # Check if the script section is defined
+ [boolean]$ScriptSectionDefined = [boolean](-not [string]::IsNullOrEmpty($ScriptSection))
+ # Get the file name of the source script
+ Try {
+ If ($script:MyInvocation.Value.ScriptName) {
+ [string]$ScriptSource = Split-Path -Path $script:MyInvocation.Value.ScriptName -Leaf -ErrorAction 'Stop'
+ }
+ Else {
+ [string]$ScriptSource = Split-Path -Path $script:MyInvocation.MyCommand.Definition -Leaf -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ $ScriptSource = ''
+ }
+
+ ## Create script block for generating CMTrace.exe compatible log entry
+ [scriptblock]$CMTraceLogString = {
+ Param (
+ [string]$lMessage,
+ [string]$lSource,
+ [int16]$lSeverity
+ )
+ "" + ""
+ }
+
+ ## Create script block for writing log entry to the console
+ [scriptblock]$WriteLogLineToHost = {
+ Param (
+ [string]$lTextLogLine,
+ [int16]$lSeverity
+ )
+ If ($WriteHost) {
+ # Only output using color options if running in a host which supports colors.
+ If ($Host.UI.RawUI.ForegroundColor) {
+ Switch ($lSeverity) {
+ 3 { Write-Host -Object $lTextLogLine -ForegroundColor 'Red' -BackgroundColor 'Black' }
+ 2 { Write-Host -Object $lTextLogLine -ForegroundColor 'Yellow' -BackgroundColor 'Black' }
+ 1 { Write-Host -Object $lTextLogLine }
+ }
+ }
+ # If executing "powershell.exe -File .ps1 > log.txt", then all the Write-Host calls are converted to Write-Output calls so that they are included in the text log.
+ Else {
+ Write-Output -InputObject $lTextLogLine
+ }
+ }
+ }
+
+ ## Exit function if it is a debug message and logging debug messages is not enabled in the config XML file
+ If (($DebugMessage) -and (-not $LogDebugMessage)) { [boolean]$ExitLoggingFunction = $true; Return }
+ ## Exit function if logging to file is disabled and logging to console host is disabled
+ If (($DisableLogging) -and (-not $WriteHost)) { [boolean]$ExitLoggingFunction = $true; Return }
+ ## Exit Begin block if logging is disabled
+ If ($DisableLogging) { Return }
+ ## Exit function function if it is an [Initialization] message and the toolkit has been relaunched
+ If (($AsyncToolkitLaunch) -and ($ScriptSection -eq 'Initialization')) { [boolean]$ExitLoggingFunction = $true; Return }
+
+ ## Create the directory where the log file will be saved
+ If (-not (Test-Path -LiteralPath $LogFileDirectory -PathType 'Container')) {
+ Try {
+ $null = New-Item -Path $LogFileDirectory -Type 'Directory' -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ [boolean]$ExitLoggingFunction = $true
+ # If error creating directory, write message to console
+ If (-not $ContinueOnError) {
+ Write-Host -Object "[$LogDate $LogTime] [${CmdletName}] $ScriptSection :: Failed to create the log directory [$LogFileDirectory]. `n$(Resolve-Error)" -ForegroundColor 'Red'
+ }
+ Return
+ }
+ }
+
+ ## Assemble the fully qualified path to the log file
+ [string]$LogFilePath = Join-Path -Path $LogFileDirectory -ChildPath $LogFileName
+ }
+ Process {
+ ## Exit function if logging is disabled
+ If ($ExitLoggingFunction) { Return }
+
+ ForEach ($Msg in $Message) {
+ ## If the message is not $null or empty, create the log entry for the different logging methods
+ [string]$CMTraceMsg = ''
+ [string]$ConsoleLogLine = ''
+ [string]$LegacyTextLogLine = ''
+ If ($Msg) {
+ # Create the CMTrace log message
+ If ($ScriptSectionDefined) { [string]$CMTraceMsg = "[$ScriptSection] :: $Msg" }
+
+ # Create a Console and Legacy "text" log entry
+ [string]$LegacyMsg = "[$LogDate $LogTime]"
+ If ($ScriptSectionDefined) { [string]$LegacyMsg += " [$ScriptSection]" }
+ If ($Source) {
+ [string]$ConsoleLogLine = "$LegacyMsg [$Source] :: $Msg"
+ Switch ($Severity) {
+ 3 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Error] :: $Msg" }
+ 2 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Warning] :: $Msg" }
+ 1 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Info] :: $Msg" }
+ }
+ }
+ Else {
+ [string]$ConsoleLogLine = "$LegacyMsg :: $Msg"
+ Switch ($Severity) {
+ 3 { [string]$LegacyTextLogLine = "$LegacyMsg [Error] :: $Msg" }
+ 2 { [string]$LegacyTextLogLine = "$LegacyMsg [Warning] :: $Msg" }
+ 1 { [string]$LegacyTextLogLine = "$LegacyMsg [Info] :: $Msg" }
+ }
+ }
+ }
+
+ ## Execute script block to create the CMTrace.exe compatible log entry
+ [string]$CMTraceLogLine = & $CMTraceLogString -lMessage $CMTraceMsg -lSource $Source -lSeverity $Severity
+
+ ## Choose which log type to write to file
+ If ($LogType -ieq 'CMTrace') {
+ [string]$LogLine = $CMTraceLogLine
+ }
+ Else {
+ [string]$LogLine = $LegacyTextLogLine
+ }
+
+ ## Write the log entry to the log file if logging is not currently disabled
+ If (-not $DisableLogging) {
+ Try {
+ $LogLine | Out-File -FilePath $LogFilePath -Append -NoClobber -Force -Encoding 'UTF8' -ErrorAction 'Stop'
+ }
+ Catch {
+ If (-not $ContinueOnError) {
+ Write-Host -Object "[$LogDate $LogTime] [$ScriptSection] [${CmdletName}] :: Failed to write message [$Msg] to the log file [$LogFilePath]. `n$(Resolve-Error)" -ForegroundColor 'Red'
+ }
+ }
+ }
+
+ ## Execute script block to write the log entry to the console if $WriteHost is $true
+ & $WriteLogLineToHost -lTextLogLine $ConsoleLogLine -lSeverity $Severity
+ }
+ }
+ End {
+ ## Archive log file if size is greater than $MaxLogFileSizeMB and $MaxLogFileSizeMB > 0
+ Try {
+ If ((-not $ExitLoggingFunction) -and (-not $DisableLogging)) {
+ [IO.FileInfo]$LogFile = Get-ChildItem -LiteralPath $LogFilePath -ErrorAction 'Stop'
+ [decimal]$LogFileSizeMB = $LogFile.Length/1MB
+ If (($LogFileSizeMB -gt $MaxLogFileSizeMB) -and ($MaxLogFileSizeMB -gt 0)) {
+ ## Change the file extension to "lo_"
+ [string]$ArchivedOutLogFile = [IO.Path]::ChangeExtension($LogFilePath, 'lo_')
+ [hashtable]$ArchiveLogParams = @{ ScriptSection = $ScriptSection; Source = ${CmdletName}; Severity = 2; LogFileDirectory = $LogFileDirectory; LogFileName = $LogFileName; LogType = $LogType; MaxLogFileSizeMB = 0; WriteHost = $WriteHost; ContinueOnError = $ContinueOnError; PassThru = $false }
+
+ ## Log message about archiving the log file
+ $ArchiveLogMessage = "Maximum log file size [$MaxLogFileSizeMB MB] reached. Rename log file to [$ArchivedOutLogFile]."
+ Write-Log -Message $ArchiveLogMessage @ArchiveLogParams
+
+ ## Archive existing log file from .log to .lo_. Overwrites any existing .lo_ file. This is the same method SCCM uses for log files.
+ Move-Item -LiteralPath $LogFilePath -Destination $ArchivedOutLogFile -Force -ErrorAction 'Stop'
+
+ ## Start new log file and Log message about archiving the old log file
+ $NewLogMessage = "Previous log file was renamed to [$ArchivedOutLogFile] because maximum log file size of [$MaxLogFileSizeMB MB] was reached."
+ Write-Log -Message $NewLogMessage @ArchiveLogParams
+ }
+ }
+ }
+ Catch {
+ ## If renaming of file fails, script will continue writing to log file even if size goes over the max file size
+ }
+ Finally {
+ If ($PassThru) { Write-Output -InputObject $Message }
+ }
+ }
+}
+#endregion
+
+
+#region Function New-ZipFile
+Function New-ZipFile {
+<#
+.SYNOPSIS
+ Create a new zip archive or add content to an existing archive.
+.DESCRIPTION
+ Create a new zip archive or add content to an existing archive by using the Shell object .CopyHere method.
+.PARAMETER DestinationArchiveDirectoryPath
+ The path to the directory path where the zip archive will be saved.
+.PARAMETER DestinationArchiveFileName
+ The name of the zip archive.
+.PARAMETER SourceDirectoryPath
+ The path to the directory to be archived, specified as absolute paths.
+.PARAMETER SourceFilePath
+ The path to the file to be archived, specified as absolute paths.
+.PARAMETER RemoveSourceAfterArchiving
+ Remove the source path after successfully archiving the content. Default is: $false.
+.PARAMETER OverWriteArchive
+ Overwrite the destination archive path if it already exists. Default is: $false.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $true.
+.EXAMPLE
+ New-ZipFile -DestinationArchiveDirectoryPath 'E:\Testing' -DestinationArchiveFileName 'TestingLogs.zip' -SourceDirectory 'E:\Testing\Logs'
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='CreateFromDirectory')]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullorEmpty()]
+ [string]$DestinationArchiveDirectoryPath,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$DestinationArchiveFileName,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='CreateFromDirectory')]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Container' })]
+ [string[]]$SourceDirectoryPath,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='CreateFromFile')]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string[]]$SourceFilePath,
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [switch]$RemoveSourceAfterArchiving = $false,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [switch]$OverWriteArchive = $false,
+ [Parameter(Mandatory=$false,Position=5)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Get the full destination path where the archive will be stored
+ [string]$DestinationPath = Join-Path -Path $DestinationArchiveDirectoryPath -ChildPath $DestinationArchiveFileName -ErrorAction 'Stop'
+ Write-Log -Message "Create a zip archive with the requested content at destination path [$DestinationPath]." -Source ${CmdletName}
+
+ ## If the destination archive already exists, delete it if the -OverWriteArchive option was selected
+ If (($OverWriteArchive) -and (Test-Path -LiteralPath $DestinationPath)) {
+ Write-Log -Message "An archive at the destination path already exists, deleting file [$DestinationPath]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $DestinationPath -Force -ErrorAction 'Stop'
+ }
+
+ ## If archive file does not exist, then create a zero-byte zip archive
+ If (-not (Test-Path -LiteralPath $DestinationPath)) {
+ ## Create a zero-byte file
+ Write-Log -Message "Create a zero-byte file [$DestinationPath]." -Source ${CmdletName}
+ $null = New-Item -Path $DestinationArchiveDirectoryPath -Name $DestinationArchiveFileName -ItemType 'File' -Force -ErrorAction 'Stop'
+
+ ## Write the file header for a zip file to the zero-byte file
+ [byte[]]$ZipArchiveByteHeader = 80, 75, 5, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+ [IO.FileStream]$FileStream = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($DestinationPath, ([IO.FileMode]::Create))
+ [IO.BinaryWriter]$BinaryWriter = New-Object -TypeName 'System.IO.BinaryWriter' -ArgumentList ($FileStream)
+ Write-Log -Message "Write the file header for a zip archive to the zero-byte file [$DestinationPath]." -Source ${CmdletName}
+ $null = $BinaryWriter.Write($ZipArchiveByteHeader)
+ $BinaryWriter.Close()
+ $FileStream.Close()
+ }
+
+ ## Create a Shell object
+ [__comobject]$ShellApp = New-Object -ComObject 'Shell.Application' -ErrorAction 'Stop'
+ ## Create an object representing the archive file
+ [__comobject]$Archive = $ShellApp.NameSpace($DestinationPath)
+
+ ## Create the archive file
+ If ($PSCmdlet.ParameterSetName -eq 'CreateFromDirectory') {
+ ## Create the archive file from a source directory
+ ForEach ($Directory in $SourceDirectoryPath) {
+ Try {
+ # Create an object representing the source directory
+ [__comobject]$CreateFromDirectory = $ShellApp.NameSpace($Directory)
+ # Copy all of the files and folders from the source directory to the archive
+ $null = $Archive.CopyHere($CreateFromDirectory.Items())
+ # Wait for archive operation to complete. Archive file count property returns 0 if archive operation is in progress.
+ Write-Log -Message "Compressing [$($CreateFromDirectory.Count)] file(s) in source directory [$Directory] to destination path [$DestinationPath]..." -Source ${CmdletName}
+ Do { Start-Sleep -Milliseconds 250 } While ($Archive.Items().Count -eq 0)
+ }
+ Finally {
+ # Release the ComObject representing the source directory
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($CreateFromDirectory)
+ }
+
+ # If option was selected, recursively delete the source directory after successfully archiving the contents
+ If ($RemoveSourceAfterArchiving) {
+ Try {
+ Write-Log -Message "Recursively delete the source directory [$Directory] as contents have been successfully archived." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Directory -Recurse -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to recursively delete the source directory [$Directory]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Else {
+ ## Create the archive file from a list of one or more files
+ [IO.FileInfo[]]$SourceFilePath = [IO.FileInfo[]]$SourceFilePath
+ ForEach ($File in $SourceFilePath) {
+ # Copy the files and folders from the source directory to the archive
+ $null = $Archive.CopyHere($File.FullName)
+ # Wait for archive operation to complete. Archive file count property returns 0 if archive operation is in progress.
+ Write-Log -Message "Compressing file [$($File.FullName)] to destination path [$DestinationPath]..." -Source ${CmdletName}
+ Do { Start-Sleep -Milliseconds 250 } While ($Archive.Items().Count -eq 0)
+
+ # If option was selected, delete the source file after successfully archiving the content
+ If ($RemoveSourceAfterArchiving) {
+ Try {
+ Write-Log -Message "Delete the source file [$($File.FullName)] as it has been successfully archived." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $File.FullName -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to delete the source file [$($File.FullName)]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+
+ ## If the archive was created in session 0 or by an Admin, then it may only be readable by elevated users.
+ # Apply the parent folder's permissions to the archive file to fix the problem.
+ Write-Log -Message "If the archive was created in session 0 or by an Admin, then it may only be readable by elevated users. Apply permissions from parent folder [$DestinationArchiveDirectoryPath] to file [$DestinationPath]." -Source ${CmdletName}
+ Try {
+ [Security.AccessControl.DirectorySecurity]$DestinationArchiveDirectoryPathAcl = Get-Acl -Path $DestinationArchiveDirectoryPath -ErrorAction 'Stop'
+ Set-Acl -Path $DestinationPath -AclObject $DestinationArchiveDirectoryPathAcl -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to apply parent folder's [$DestinationArchiveDirectoryPath] permissions to file [$DestinationPath]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to archive the requested file(s). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to archive the requested file(s): $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ ## Release the ComObject representing the archive
+ If ($Archive) { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Archive) }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Exit-Script
+Function Exit-Script {
+<#
+.SYNOPSIS
+ Exit the script, perform cleanup actions, and pass an exit code to the parent process.
+.DESCRIPTION
+ Always use when exiting the script to ensure cleanup actions are performed.
+.PARAMETER ExitCode
+ The exit code to be passed from the script to the parent process, e.g. SCCM
+.EXAMPLE
+ Exit-Script -ExitCode 0
+.EXAMPLE
+ Exit-Script -ExitCode 1618
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ExitCode = 0
+ )
+
+ ## Get the name of this function
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ ## Stop the Close Program Dialog if running
+ If ($formCloseApps) { $formCloseApps.Close }
+
+ ## Close the Installation Progress Dialog if running
+ Close-InstallationProgress
+
+ ## If block execution variable is true, call the function to unblock execution
+ If ($BlockExecution) { Unblock-AppExecution }
+
+ ## If Terminal Server mode was set, turn it off
+ If ($terminalServerMode) { Disable-TerminalServerInstallMode }
+
+ ## Determine action based on exit code
+ Switch ($exitCode) {
+ $configInstallationUIExitCode { $installSuccess = $false }
+ $configInstallationDeferExitCode { $installSuccess = $false }
+ 3010 { $installSuccess = $true }
+ 1641 { $installSuccess = $true }
+ 0 { $installSuccess = $true }
+ Default { $installSuccess = $false }
+ }
+
+ ## Determine if balloon notification should be shown
+ If ($deployModeSilent) { [boolean]$configShowBalloonNotifications = $false }
+
+ If ($installSuccess) {
+ If (Test-Path -LiteralPath $regKeyDeferHistory -ErrorAction 'SilentlyContinue') {
+ Write-Log -Message 'Remove deferral history...' -Source ${CmdletName}
+ Remove-RegistryKey -Key $regKeyDeferHistory -Recurse
+ }
+
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextComplete"
+ ## Handle reboot prompts on successful script completion
+ If (($AllowRebootPassThru) -and ((($msiRebootDetected) -or ($exitCode -eq 3010)) -or ($exitCode -eq 1641))) {
+ Write-Log -Message 'A restart has been flagged as required.' -Source ${CmdletName}
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextRestartRequired"
+ If (($msiRebootDetected) -and ($exitCode -ne 1641)) { [int32]$exitCode = 3010 }
+ }
+ Else {
+ [int32]$exitCode = 0
+ }
+
+ Write-Log -Message "$installName $deploymentTypeName completed with exit code [$exitcode]." -Source ${CmdletName}
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText $balloonText }
+ }
+ ElseIf (-not $installSuccess) {
+ Write-Log -Message "$installName $deploymentTypeName completed with exit code [$exitcode]." -Source ${CmdletName}
+ If (($exitCode -eq $configInstallationUIExitCode) -or ($exitCode -eq $configInstallationDeferExitCode)) {
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextFastRetry"
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Warning' -BalloonTipText $balloonText }
+ }
+ Else {
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextError"
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Error' -BalloonTipText $balloonText }
+ }
+ }
+
+ [string]$LogDash = '-' * 79
+ Write-Log -Message $LogDash -Source ${CmdletName}
+
+ ## Archive the log files to zip format and then delete the temporary logs folder
+ If ($configToolkitCompressLogs) {
+ ## Disable logging to file so that we can archive the log files
+ . $DisableScriptLogging
+
+ [string]$DestinationArchiveFileName = $installName + '_' + $deploymentType + '_' + ((Get-Date -Format 'yyyy-MM-dd-hh-mm-ss').ToString()) + '.zip'
+ New-ZipFile -DestinationArchiveDirectoryPath $configToolkitLogDir -DestinationArchiveFileName $DestinationArchiveFileName -SourceDirectory $logTempFolder -RemoveSourceAfterArchiving
+ }
+
+ If ($script:notifyIcon) { Try { $script:notifyIcon.Dispose() } Catch {} }
+ ## Exit the script, returning the exit code to SCCM
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $script:ExitCode = $exitCode; Exit } Else { Exit $exitCode }
+}
+#endregion
+
+
+#region Function Resolve-Error
+Function Resolve-Error {
+<#
+.SYNOPSIS
+ Enumerate error record details.
+.DESCRIPTION
+ Enumerate an error record, or a collection of error record, properties. By default, the details for the last error will be enumerated.
+.PARAMETER ErrorRecord
+ The error record to resolve. The default error record is the latest one: $global:Error[0]. This parameter will also accept an array of error records.
+.PARAMETER Property
+ The list of properties to display from the error record. Use "*" to display all properties.
+ Default list of error properties is: Message, FullyQualifiedErrorId, ScriptStackTrace, PositionMessage, InnerException
+.PARAMETER GetErrorRecord
+ Get error record details as represented by $_.
+.PARAMETER GetErrorInvocation
+ Get error record invocation information as represented by $_.InvocationInfo.
+.PARAMETER GetErrorException
+ Get error record exception details as represented by $_.Exception.
+.PARAMETER GetErrorInnerException
+ Get error record inner exception details as represented by $_.Exception.InnerException. Will retrieve all inner exceptions if there is more than one.
+.EXAMPLE
+ Resolve-Error
+.EXAMPLE
+ Resolve-Error -Property *
+.EXAMPLE
+ Resolve-Error -Property InnerException
+.EXAMPLE
+ Resolve-Error -GetErrorInvocation:$false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [AllowEmptyCollection()]
+ [array]$ErrorRecord,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Property = ('Message','InnerException','FullyQualifiedErrorId','ScriptStackTrace','PositionMessage'),
+ [Parameter(Mandatory=$false,Position=2)]
+ [switch]$GetErrorRecord = $true,
+ [Parameter(Mandatory=$false,Position=3)]
+ [switch]$GetErrorInvocation = $true,
+ [Parameter(Mandatory=$false,Position=4)]
+ [switch]$GetErrorException = $true,
+ [Parameter(Mandatory=$false,Position=5)]
+ [switch]$GetErrorInnerException = $true
+ )
+
+ Begin {
+ ## If function was called without specifying an error record, then choose the latest error that occurred
+ If (-not $ErrorRecord) {
+ If ($global:Error.Count -eq 0) {
+ #Write-Warning -Message "The `$Error collection is empty"
+ Return
+ }
+ Else {
+ [array]$ErrorRecord = $global:Error[0]
+ }
+ }
+
+ ## Allows selecting and filtering the properties on the error object if they exist
+ [scriptblock]$SelectProperty = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ $InputObject,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Property
+ )
+
+ [string[]]$ObjectProperty = $InputObject | Get-Member -MemberType '*Property' | Select-Object -ExpandProperty 'Name'
+ ForEach ($Prop in $Property) {
+ If ($Prop -eq '*') {
+ [string[]]$PropertySelection = $ObjectProperty
+ Break
+ }
+ ElseIf ($ObjectProperty -contains $Prop) {
+ [string[]]$PropertySelection += $Prop
+ }
+ }
+ Write-Output -InputObject $PropertySelection
+ }
+
+ # Initialize variables to avoid error if 'Set-StrictMode' is set
+ $LogErrorRecordMsg = $null
+ $LogErrorInvocationMsg = $null
+ $LogErrorExceptionMsg = $null
+ $LogErrorMessageTmp = $null
+ $LogInnerMessage = $null
+ }
+ Process {
+ If (-not $ErrorRecord) { Return }
+ ForEach ($ErrRecord in $ErrorRecord) {
+ ## Capture Error Record
+ If ($GetErrorRecord) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord -Property $Property
+ $LogErrorRecordMsg = $ErrRecord | Select-Object -Property $SelectedProperties
+ }
+
+ ## Error Invocation Information
+ If ($GetErrorInvocation) {
+ If ($ErrRecord.InvocationInfo) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord.InvocationInfo -Property $Property
+ $LogErrorInvocationMsg = $ErrRecord.InvocationInfo | Select-Object -Property $SelectedProperties
+ }
+ }
+
+ ## Capture Error Exception
+ If ($GetErrorException) {
+ If ($ErrRecord.Exception) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord.Exception -Property $Property
+ $LogErrorExceptionMsg = $ErrRecord.Exception | Select-Object -Property $SelectedProperties
+ }
+ }
+
+ ## Display properties in the correct order
+ If ($Property -eq '*') {
+ # If all properties were chosen for display, then arrange them in the order the error object displays them by default.
+ If ($LogErrorRecordMsg) { [array]$LogErrorMessageTmp += $LogErrorRecordMsg }
+ If ($LogErrorInvocationMsg) { [array]$LogErrorMessageTmp += $LogErrorInvocationMsg }
+ If ($LogErrorExceptionMsg) { [array]$LogErrorMessageTmp += $LogErrorExceptionMsg }
+ }
+ Else {
+ # Display selected properties in our custom order
+ If ($LogErrorExceptionMsg) { [array]$LogErrorMessageTmp += $LogErrorExceptionMsg }
+ If ($LogErrorRecordMsg) { [array]$LogErrorMessageTmp += $LogErrorRecordMsg }
+ If ($LogErrorInvocationMsg) { [array]$LogErrorMessageTmp += $LogErrorInvocationMsg }
+ }
+
+ If ($LogErrorMessageTmp) {
+ $LogErrorMessage = 'Error Record:'
+ $LogErrorMessage += "`n-------------"
+ $LogErrorMsg = $LogErrorMessageTmp | Format-List | Out-String
+ $LogErrorMessage += $LogErrorMsg
+ }
+
+ ## Capture Error Inner Exception(s)
+ If ($GetErrorInnerException) {
+ If ($ErrRecord.Exception -and $ErrRecord.Exception.InnerException) {
+ $LogInnerMessage = 'Error Inner Exception(s):'
+ $LogInnerMessage += "`n-------------------------"
+
+ $ErrorInnerException = $ErrRecord.Exception.InnerException
+ $Count = 0
+
+ While ($ErrorInnerException) {
+ [string]$InnerExceptionSeperator = '~' * 40
+
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrorInnerException -Property $Property
+ $LogErrorInnerExceptionMsg = $ErrorInnerException | Select-Object -Property $SelectedProperties | Format-List | Out-String
+
+ If ($Count -gt 0) { $LogInnerMessage += $InnerExceptionSeperator }
+ $LogInnerMessage += $LogErrorInnerExceptionMsg
+
+ $Count++
+ $ErrorInnerException = $ErrorInnerException.InnerException
+ }
+ }
+ }
+
+ If ($LogErrorMessage) { $Output = $LogErrorMessage }
+ If ($LogInnerMessage) { $Output += $LogInnerMessage }
+
+ Write-Output -InputObject $Output
+
+ If (Test-Path -LiteralPath 'variable:Output') { Clear-Variable -Name 'Output' }
+ If (Test-Path -LiteralPath 'variable:LogErrorMessage') { Clear-Variable -Name 'LogErrorMessage' }
+ If (Test-Path -LiteralPath 'variable:LogInnerMessage') { Clear-Variable -Name 'LogInnerMessage' }
+ If (Test-Path -LiteralPath 'variable:LogErrorMessageTmp') { Clear-Variable -Name 'LogErrorMessageTmp' }
+ }
+ }
+ End {
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationPrompt
+Function Show-InstallationPrompt {
+<#
+.SYNOPSIS
+ Displays a custom installation prompt with the toolkit branding and optional buttons.
+.DESCRIPTION
+ Any combination of Left, Middle or Right buttons can be displayed. The return value of the button clicked by the user is the button text specified.
+.PARAMETER Title
+ Title of the prompt. Default: the application installation name.
+.PARAMETER Message
+ Message text to be included in the prompt
+.PARAMETER MessageAlignment
+ Alignment of the message text. Options: Left, Center, Right. Default: Center.
+.PARAMETER ButtonLeftText
+ Show a button on the left of the prompt with the specified text
+.PARAMETER ButtonRightText
+ Show a button on the right of the prompt with the specified text
+.PARAMETER ButtonMiddleText
+ Show a button in the middle of the prompt with the specified text
+.PARAMETER Icon
+ Show a system icon in the prompt. Options: Application, Asterisk, Error, Exclamation, Hand, Information, None, Question, Shield, Warning, WinLogo. Default: None.
+.PARAMETER NoWait
+ Specifies whether to show the prompt asynchronously (i.e. allow the script to continue without waiting for a response). Default: $false.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds. The user will have no option but to respond to the prompt - resistance is futile!
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $false.
+.PARAMETER Timeout
+ Specifies the time period in seconds after which the prompt should timeout. Default: UI timeout value set in the config XML file.
+.PARAMETER ExitOnTimeout
+ Specifies whether to exit the script if the UI times out. Default: $true.
+.EXAMPLE
+ Show-InstallationPrompt -Message 'Do you want to proceed with the installation?' -ButtonRightText 'Yes' -ButtonLeftText 'No'
+.EXAMPLE
+ Show-InstallationPrompt -Title 'Funny Prompt' -Message 'How are you feeling today?' -ButtonRightText 'Good' -ButtonLeftText 'Bad' -ButtonMiddleText 'Indifferent'
+.EXAMPLE
+ Show-InstallationPrompt -Message 'You can customize text to appear at the end of an install, or remove it completely for unattended installations.' -Icon Information -NoWait
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Title = $installTitle,
+ [Parameter(Mandatory=$false)]
+ [string]$Message = '',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Left','Center','Right')]
+ [string]$MessageAlignment = 'Center',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonRightText = '',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonLeftText = '',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonMiddleText = '',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Application','Asterisk','Error','Exclamation','Hand','Information','None','Question','Shield','Warning','WinLogo')]
+ [string]$Icon = 'None',
+ [Parameter(Mandatory=$false)]
+ [switch]$NoWait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PersistPrompt = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$Timeout = $configInstallationUITimeout,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ExitOnTimeout = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in non-interactive mode
+ If ($deployModeSilent) {
+ Write-Log -Message "Bypassing Installation Prompt [Mode: $deployMode]... $Message" -Source ${CmdletName}
+ Return
+ }
+
+ ## Get parameters for calling function asynchronously
+ [hashtable]$installPromptParameters = $psBoundParameters
+
+ ## Check if the countdown was specified
+ If ($timeout -gt $configInstallationUITimeout) {
+ [string]$CountdownTimeoutErr = "The installation UI dialog timeout cannot be longer than the timeout specified in the XML configuration file."
+ Write-Log -Message $CountdownTimeoutErr -Severity 3 -Source ${CmdletName}
+ Throw $CountdownTimeoutErr
+ }
+
+ [Windows.Forms.Application]::EnableVisualStyles()
+ $formInstallationPrompt = New-Object -TypeName 'System.Windows.Forms.Form'
+ $pictureBanner = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $pictureIcon = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $labelText = New-Object -TypeName 'System.Windows.Forms.Label'
+ $buttonRight = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonMiddle = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonLeft = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonAbort = New-Object -TypeName 'System.Windows.Forms.Button'
+ $InitialFormInstallationPromptWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ ## Remove all event handlers from the controls
+ Try {
+ $labelText.remove_Click($handler_labelText_Click)
+ $buttonLeft.remove_Click($buttonLeft_OnClick)
+ $buttonRight.remove_Click($buttonRight_OnClick)
+ $buttonMiddle.remove_Click($buttonMiddle_OnClick)
+ $buttonAbort.remove_Click($buttonAbort_OnClick)
+ $timer.remove_Tick($timer_Tick)
+ $timer.Dispose()
+ $timer = $null
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $timerPersist.Dispose()
+ $timerPersist = $null
+ $formInstallationPrompt.remove_Load($Form_StateCorrection_Load)
+ $formInstallationPrompt.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formInstallationPrompt.WindowState = 'Normal'
+ $formInstallationPrompt.AutoSize = $true
+ $formInstallationPrompt.TopMost = $true
+ $formInstallationPrompt.BringToFront()
+ # Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formInstallationPromptStartPosition' -Value $formInstallationPrompt.Location -Scope 'Script'
+ }
+
+ ## Form
+ $formInstallationPrompt.Controls.Add($pictureBanner)
+
+ ##----------------------------------------------
+ ## Create padding object
+ $paddingNone = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $paddingNone.Top = 0
+ $paddingNone.Bottom = 0
+ $paddingNone.Left = 0
+ $paddingNone.Right = 0
+
+ ## Generic Button properties
+ $buttonWidth = 110
+ $buttonHeight = 23
+ $buttonPadding = 50
+ $buttonSize = New-Object -TypeName 'System.Drawing.Size'
+ $buttonSize.Width = $buttonWidth
+ $buttonSize.Height = $buttonHeight
+ $buttonPadding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $buttonPadding.Top = 0
+ $buttonPadding.Bottom = 5
+ $buttonPadding.Left = 50
+ $buttonPadding.Right = 0
+
+ ## Picture Banner
+ $pictureBanner.DataBindings.DefaultDataSourceUpdateMode = 0
+ $pictureBanner.ImageLocation = $appDeployLogoBanner
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $pictureBanner.Location = $System_Drawing_Point
+ $pictureBanner.Name = 'pictureBanner'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 50
+ $System_Drawing_Size.Width = 450
+ $pictureBanner.Size = $System_Drawing_Size
+ $pictureBanner.SizeMode = 'CenterImage'
+ $pictureBanner.Margin = $paddingNone
+ $pictureBanner.TabIndex = 0
+ $pictureBanner.TabStop = $false
+
+ ## Picture Icon
+ $pictureIcon.DataBindings.DefaultDataSourceUpdateMode = 0
+ If ($icon -ne 'None') { $pictureIcon.Image = ([Drawing.SystemIcons]::$Icon).ToBitmap() }
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 15
+ $System_Drawing_Point.Y = 105
+ $pictureIcon.Location = $System_Drawing_Point
+ $pictureIcon.Name = 'pictureIcon'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 32
+ $System_Drawing_Size.Width = 32
+ $pictureIcon.Size = $System_Drawing_Size
+ $pictureIcon.AutoSize = $true
+ $pictureIcon.Margin = $paddingNone
+ $pictureIcon.TabIndex = 0
+ $pictureIcon.TabStop = $false
+
+ ## Label Text
+ $labelText.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelText.Name = 'labelText'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 148
+ $System_Drawing_Size.Width = 385
+ $labelText.Size = $System_Drawing_Size
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 25
+ $System_Drawing_Point.Y = 50
+ $labelText.Location = $System_Drawing_Point
+ $labelText.Margin = '0,0,0,0'
+ $labelText.Padding = '40,0,20,0'
+ $labelText.TabIndex = 1
+ $labelText.Text = $message
+ $labelText.TextAlign = "Middle$($MessageAlignment)"
+ $labelText.Anchor = 'Top'
+ $labelText.add_Click($handler_labelText_Click)
+
+ ## Button Left
+ $buttonLeft.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonLeft.Location = '15,200'
+ $buttonLeft.Name = 'buttonLeft'
+ $buttonLeft.Size = $buttonSize
+ $buttonLeft.TabIndex = 5
+ $buttonLeft.Text = $buttonLeftText
+ $buttonLeft.DialogResult = 'No'
+ $buttonLeft.AutoSize = $false
+ $buttonLeft.UseVisualStyleBackColor = $true
+ $buttonLeft.add_Click($buttonLeft_OnClick)
+
+ ## Button Middle
+ $buttonMiddle.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonMiddle.Location = '170,200'
+ $buttonMiddle.Name = 'buttonMiddle'
+ $buttonMiddle.Size = $buttonSize
+ $buttonMiddle.TabIndex = 6
+ $buttonMiddle.Text = $buttonMiddleText
+ $buttonMiddle.DialogResult = 'Ignore'
+ $buttonMiddle.AutoSize = $true
+ $buttonMiddle.UseVisualStyleBackColor = $true
+ $buttonMiddle.add_Click($buttonMiddle_OnClick)
+
+ ## Button Right
+ $buttonRight.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonRight.Location = '325,200'
+ $buttonRight.Name = 'buttonRight'
+ $buttonRight.Size = $buttonSize
+ $buttonRight.TabIndex = 7
+ $buttonRight.Text = $ButtonRightText
+ $buttonRight.DialogResult = 'Yes'
+ $buttonRight.AutoSize = $true
+ $buttonRight.UseVisualStyleBackColor = $true
+ $buttonRight.add_Click($buttonRight_OnClick)
+
+ ## Button Abort (Hidden)
+ $buttonAbort.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonAbort.Name = 'buttonAbort'
+ $buttonAbort.Size = '1,1'
+ $buttonAbort.DialogResult = 'Abort'
+ $buttonAbort.TabStop = $false
+ $buttonAbort.UseVisualStyleBackColor = $true
+ $buttonAbort.add_Click($buttonAbort_OnClick)
+
+ ## Form Installation Prompt
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 270
+ $System_Drawing_Size.Width = 450
+ $formInstallationPrompt.Size = $System_Drawing_Size
+ $formInstallationPrompt.Padding = '0,0,0,10'
+ $formInstallationPrompt.Margin = $paddingNone
+ $formInstallationPrompt.DataBindings.DefaultDataSourceUpdateMode = 0
+ $formInstallationPrompt.Name = 'WelcomeForm'
+ $formInstallationPrompt.Text = $title
+ $formInstallationPrompt.StartPosition = 'CenterScreen'
+ $formInstallationPrompt.FormBorderStyle = 'FixedDialog'
+ $formInstallationPrompt.MaximizeBox = $false
+ $formInstallationPrompt.MinimizeBox = $false
+ $formInstallationPrompt.TopMost = $true
+ $formInstallationPrompt.TopLevel = $true
+ $formInstallationPrompt.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formInstallationPrompt.Controls.Add($pictureBanner)
+ $formInstallationPrompt.Controls.Add($pictureIcon)
+ $formInstallationPrompt.Controls.Add($labelText)
+ $formInstallationPrompt.Controls.Add($buttonAbort)
+ If ($buttonLeftText) { $formInstallationPrompt.Controls.Add($buttonLeft) }
+ If ($buttonMiddleText) { $formInstallationPrompt.Controls.Add($buttonMiddle) }
+ If ($buttonRightText) { $formInstallationPrompt.Controls.Add($buttonRight) }
+
+ ## Timer
+ $timer = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timer.Interval = ($timeout * 1000)
+ $timer.Add_Tick({
+ Write-Log -Message 'Installation action not taken within a reasonable amount of time.' -Source ${CmdletName}
+ $buttonAbort.PerformClick()
+ })
+
+ ## Save the initial state of the form
+ $InitialFormInstallationPromptWindowState = $formInstallationPrompt.WindowState
+ ## Init the OnLoad event to correct the initial state of the form
+ $formInstallationPrompt.add_Load($Form_StateCorrection_Load)
+ ## Clean up the control events
+ $formInstallationPrompt.add_FormClosed($Form_Cleanup_FormClosed)
+
+ ## Start the timer
+ $timer.Start()
+
+ ## Persistence Timer
+ [scriptblock]$RefreshInstallationPrompt = {
+ $formInstallationPrompt.BringToFront()
+ $formInstallationPrompt.Location = "$($formInstallationPromptStartPosition.X),$($formInstallationPromptStartPosition.Y)"
+ $formInstallationPrompt.Refresh()
+ }
+ If ($persistPrompt) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = { & $RefreshInstallationPrompt }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ ## Close the Installation Progress Dialog if running
+ Close-InstallationProgress
+
+ [string]$installPromptLoggedParameters = ($installPromptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' '
+ Write-Log -Message "Displaying custom installation prompt with the non-default parameters: [$installPromptLoggedParameters]." -Source ${CmdletName}
+
+ ## If the NoWait parameter is specified, launch a new PowerShell session to show the prompt asynchronously
+ If ($NoWait) {
+ # Remove the NoWait parameter so that the script is run synchronously in the new PowerShell session
+ $installPromptParameters.Remove('NoWait')
+ # Format the parameters as a string
+ [string]$installPromptParameters = ($installPromptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' '
+ Start-Process -FilePath "$PSHOME\powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$scriptPath`" -ReferredInstallTitle `"$Title`" -ReferredInstallName `"$installName`" -ReferredLogName `"$logName`" -ShowInstallationPrompt $installPromptParameters -AsyncToolkitLaunch" -WindowStyle 'Hidden' -ErrorAction 'SilentlyContinue'
+ }
+ ## Otherwise, show the prompt synchronously. If user cancels, then keep showing it until user responds using one of the buttons.
+ Else {
+ $showDialog = $true
+ While ($showDialog) {
+ # Minimize all other windows
+ If ($minimizeWindows) { $null = $shellApp.MinimizeAll() }
+ # Show the Form
+ $result = $formInstallationPrompt.ShowDialog()
+ If (($result -eq 'Yes') -or ($result -eq 'No') -or ($result -eq 'Ignore') -or ($result -eq 'Abort')) {
+ $showDialog = $false
+ }
+ }
+ $formInstallationPrompt.Dispose()
+
+ Switch ($result) {
+ 'Yes' { Write-Output -InputObject $buttonRightText }
+ 'No' { Write-Output -InputObject $buttonLeftText }
+ 'Ignore' { Write-Output -InputObject $buttonMiddleText }
+ 'Abort' {
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+ If ($ExitOnTimeout) {
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ Else {
+ Write-Log -Message 'UI timed out but `$ExitOnTimeout set to `$false. Continue...' -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-DialogBox
+Function Show-DialogBox {
+<#
+.SYNOPSIS
+ Display a custom dialog box with optional title, buttons, icon and timeout.
+ Show-InstallationPrompt is recommended over this function as it provides more customization and uses consistent branding with the other UI components.
+.DESCRIPTION
+ Display a custom dialog box with optional title, buttons, icon and timeout. The default button is "OK", the default Icon is "None", and the default Timeout is none.
+.PARAMETER Text
+ Text in the message dialog box
+.PARAMETER Title
+ Title of the message dialog box
+.PARAMETER Buttons
+ Buttons to be included on the dialog box. Options: OK, OKCancel, AbortRetryIgnore, YesNoCancel, YesNo, RetryCancel, CancelTryAgainContinue. Default: OK.
+.PARAMETER DefaultButton
+ The Default button that is selected. Options: First, Second, Third. Default: First.
+.PARAMETER Icon
+ Icon to display on the dialog box. Options: None, Stop, Question, Exclamation, Information. Default: None.
+.PARAMETER Timeout
+ Timeout period in seconds before automatically closing the dialog box with the return message "Timeout". Default: UI timeout value set in the config XML file.
+.PARAMETER TopMost
+ Specifies whether the message box is a system modal message box and appears in a topmost window. Default: $true.
+.EXAMPLE
+ Show-DialogBox -Title 'Installed Complete' -Text 'Installation has completed. Please click OK and restart your computer.' -Icon 'Information'
+.EXAMPLE
+ Show-DialogBox -Title 'Installation Notice' -Text 'Installation will take approximately 30 minutes. Do you wish to proceed?' -Buttons 'OKCancel' -DefaultButton 'Second' -Icon 'Exclamation' -Timeout 600 -Topmost $false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,HelpMessage='Enter a message for the dialog box')]
+ [ValidateNotNullorEmpty()]
+ [string]$Text,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Title = $installTitle,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('OK','OKCancel','AbortRetryIgnore','YesNoCancel','YesNo','RetryCancel','CancelTryAgainContinue')]
+ [string]$Buttons = 'OK',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('First','Second','Third')]
+ [string]$DefaultButton = 'First',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Exclamation','Information','None','Stop','Question')]
+ [string]$Icon = 'None',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Timeout = $configInstallationUITimeout,
+ [Parameter(Mandatory=$false)]
+ [boolean]$TopMost = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ # Bypass if in non-interactive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Dialog Box [Mode: $deployMode]: $Text..." -Source ${CmdletName}
+ Return
+ }
+
+ Write-Log -Message "Display Dialog Box with message: $Text..." -Source ${CmdletName}
+
+ [hashtable]$dialogButtons = @{
+ 'OK' = 0
+ 'OKCancel' = 1
+ 'AbortRetryIgnore' = 2
+ 'YesNoCancel' = 3
+ 'YesNo' = 4
+ 'RetryCancel' = 5
+ 'CancelTryAgainContinue' = 6
+ }
+
+ [hashtable]$dialogIcons = @{
+ 'None' = 0
+ 'Stop' = 16
+ 'Question' = 32
+ 'Exclamation' = 48
+ 'Information' = 64
+ }
+
+ [hashtable]$dialogDefaultButton = @{
+ 'First' = 0
+ 'Second' = 256
+ 'Third' = 512
+ }
+
+ Switch ($TopMost) {
+ $true { $dialogTopMost = 4096 }
+ $false { $dialogTopMost = 0 }
+ }
+
+ $response = $Shell.Popup($Text, $Timeout, $Title, ($dialogButtons[$Buttons] + $dialogIcons[$Icon] + $dialogDefaultButton[$DefaultButton] + $dialogTopMost))
+
+ Switch ($response) {
+ 1 {
+ Write-Log -Message 'Dialog Box Response: OK' -Source ${CmdletName}
+ Write-Output -InputObject 'OK'
+ }
+ 2 {
+ Write-Log -Message 'Dialog Box Response: Cancel' -Source ${CmdletName}
+ Write-Output -InputObject 'Cancel'
+ }
+ 3 {
+ Write-Log -Message 'Dialog Box Response: Abort' -Source ${CmdletName}
+ Write-Output -InputObject 'Abort'
+ }
+ 4 {
+ Write-Log -Message 'Dialog Box Response: Retry' -Source ${CmdletName}
+ Write-Output -InputObject 'Retry'
+ }
+ 5 {
+ Write-Log -Message 'Dialog Box Response: Ignore' -Source ${CmdletName}
+ Write-Output -InputObject 'Ignore'
+ }
+ 6 {
+ Write-Log -Message 'Dialog Box Response: Yes' -Source ${CmdletName}
+ Write-Output -InputObject 'Yes'
+ }
+ 7 {
+ Write-Log -Message 'Dialog Box Response: No' -Source ${CmdletName}
+ Write-Output -InputObject 'No'
+ }
+ 10 {
+ Write-Log -Message 'Dialog Box Response: Try Again' -Source ${CmdletName}
+ Write-Output -InputObject 'Try Again'
+ }
+ 11 {
+ Write-Log -Message 'Dialog Box Response: Continue' -Source ${CmdletName}
+ Write-Output -InputObject 'Continue'
+ }
+ -1 {
+ Write-Log -Message 'Dialog Box Timed Out...' -Source ${CmdletName}
+ Write-Output -InputObject 'Timeout'
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-HardwarePlatform
+Function Get-HardwarePlatform {
+<#
+.SYNOPSIS
+ Retrieves information about the hardware platform (physical or virtual)
+.DESCRIPTION
+ Retrieves information about the hardware platform (physical or virtual)
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-HardwarePlatform
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Retrieve hardware platform information.' -Source ${CmdletName}
+ $hwBios = Get-WmiObject -Class 'Win32_BIOS' -ErrorAction 'Stop' | Select-Object -Property 'Version', 'SerialNumber'
+ $hwMakeModel = Get-WMIObject -Class 'Win32_ComputerSystem' -ErrorAction 'Stop' | Select-Object -Property 'Model', 'Manufacturer'
+
+ If ($hwBIOS.Version -match 'VRTUAL') { $hwType = 'Virtual:Hyper-V' }
+ ElseIf ($hwBIOS.Version -match 'A M I') { $hwType = 'Virtual:Virtual PC' }
+ ElseIf ($hwBIOS.Version -like '*Xen*') { $hwType = 'Virtual:Xen' }
+ ElseIf ($hwBIOS.SerialNumber -like '*VMware*') { $hwType = 'Virtual:VMWare' }
+ ElseIf (($hwMakeModel.Manufacturer -like '*Microsoft*') -and ($hwMakeModel.Model -notlike '*Surface*')) { $hwType = 'Virtual:Hyper-V' }
+ ElseIf ($hwMakeModel.Manufacturer -like '*VMWare*') { $hwType = 'Virtual:VMWare' }
+ ElseIf ($hwMakeModel.Model -like '*Virtual*') { $hwType = 'Virtual' }
+ Else { $hwType = 'Physical' }
+
+ Write-Output -InputObject $hwType
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve hardware platform information. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve hardware platform information: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-FreeDiskSpace
+Function Get-FreeDiskSpace {
+<#
+.SYNOPSIS
+ Retrieves the free disk space in MB on a particular drive (defaults to system drive)
+.DESCRIPTION
+ Retrieves the free disk space in MB on a particular drive (defaults to system drive)
+.PARAMETER Drive
+ Drive to check free disk space on
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-FreeDiskSpace -Drive 'C:'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Drive = $envSystemDrive,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Retrieve free disk space for drive [$Drive]." -Source ${CmdletName}
+ $disk = Get-WmiObject -Class 'Win32_LogicalDisk' -Filter "DeviceID='$Drive'" -ErrorAction 'Stop'
+ [double]$freeDiskSpace = [math]::Round($disk.FreeSpace / 1MB)
+
+ Write-Log -Message "Free disk space for drive [$Drive]: [$freeDiskSpace MB]." -Source ${CmdletName}
+ Write-Output -InputObject $freeDiskSpace
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve free disk space for drive [$Drive]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve free disk space for drive [$Drive]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-InstalledApplication
+Function Get-InstalledApplication {
+<#
+.SYNOPSIS
+ Retrieves information about installed applications.
+.DESCRIPTION
+ Retrieves information about installed applications by querying the registry. You can specify an application name, a product code, or both.
+ Returns information about application publisher, name & version, product code, uninstall string, install source, location, date, and application architecture.
+.PARAMETER Name
+ The name of the application to retrieve information for. Performs a contains match on the application display name by default.
+.PARAMETER Exact
+ Specifies that the named application must be matched using the exact name.
+.PARAMETER WildCard
+ Specifies that the named application must be matched using a wildcard search.
+.PARAMETER RegEx
+ Specifies that the named application must be matched using a regular expression search.
+.PARAMETER ProductCode
+ The product code of the application to retrieve information for.
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.EXAMPLE
+ Get-InstalledApplication -Name 'Adobe Flash'
+.EXAMPLE
+ Get-InstalledApplication -ProductCode '{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Exact = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WildCard = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$RegEx = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$ProductCode,
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($name) {
+ Write-Log -Message "Get information for installed Application Name(s) [$($name -join ', ')]..." -Source ${CmdletName}
+ }
+ If ($productCode) {
+ Write-Log -Message "Get information for installed Product Code [$ProductCode]..." -Source ${CmdletName}
+ }
+
+ ## Enumerate the installed applications from the registry for applications that have the "DisplayName" property
+ [psobject[]]$regKeyApplication = @()
+ ForEach ($regKey in $regKeyApplications) {
+ If (Test-Path -LiteralPath $regKey -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorUninstallKeyPath') {
+ [psobject[]]$UninstallKeyApps = Get-ChildItem -LiteralPath $regKey -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorUninstallKeyPath'
+ ForEach ($UninstallKeyApp in $UninstallKeyApps) {
+ Try {
+ [psobject]$regKeyApplicationProps = Get-ItemProperty -LiteralPath $UninstallKeyApp.PSPath -ErrorAction 'Stop'
+ If ($regKeyApplicationProps.DisplayName) { [psobject[]]$regKeyApplication += $regKeyApplicationProps }
+ }
+ Catch{
+ Write-Log -Message "Unable to enumerate properties from registry key path [$($UninstallKeyApp.PSPath)]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ }
+ If ($ErrorUninstallKeyPath) {
+ Write-Log -Message "The following error(s) took place while enumerating installed applications from the registry. `n$(Resolve-Error -ErrorRecord $ErrorUninstallKeyPath)" -Severity 2 -Source ${CmdletName}
+ }
+
+ ## Create a custom object with the desired properties for the installed applications and sanitize property details
+ [psobject[]]$installedApplication = @()
+ ForEach ($regKeyApp in $regKeyApplication) {
+ Try {
+ [string]$appDisplayName = ''
+ [string]$appDisplayVersion = ''
+ [string]$appPublisher = ''
+
+ ## Bypass any updates or hotfixes
+ If (-not $IncludeUpdatesAndHotfixes) {
+ If ($regKeyApp.DisplayName -match '(?i)kb\d+') { Continue }
+ If ($regKeyApp.DisplayName -match 'Cumulative Update') { Continue }
+ If ($regKeyApp.DisplayName -match 'Security Update') { Continue }
+ If ($regKeyApp.DisplayName -match 'Hotfix') { Continue }
+ }
+
+ ## Remove any control characters which may interfere with logging and creating file path names from these variables
+ $appDisplayName = $regKeyApp.DisplayName -replace '[^\u001F-\u007F]',''
+ $appDisplayVersion = $regKeyApp.DisplayVersion -replace '[^\u001F-\u007F]',''
+ $appPublisher = $regKeyApp.Publisher -replace '[^\u001F-\u007F]',''
+
+ ## Determine if application is a 64-bit application
+ [boolean]$Is64BitApp = If (($is64Bit) -and ($regKeyApp.PSPath -notmatch '^Microsoft\.PowerShell\.Core\\Registry::HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node')) { $true } Else { $false }
+
+ If ($ProductCode) {
+ ## Verify if there is a match with the product code passed to the script
+ If ($regKeyApp.PSChildName -match [regex]::Escape($productCode)) {
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] matching product code [$productCode]." -Source ${CmdletName}
+ $installedApplication += New-Object -TypeName 'PSObject' -Property @{
+ UninstallSubkey = $regKeyApp.PSChildName
+ ProductCode = If ($regKeyApp.PSChildName -match $MSIProductCodeRegExPattern) { $regKeyApp.PSChildName } Else { [string]::Empty }
+ DisplayName = $appDisplayName
+ DisplayVersion = $appDisplayVersion
+ UninstallString = $regKeyApp.UninstallString
+ InstallSource = $regKeyApp.InstallSource
+ InstallLocation = $regKeyApp.InstallLocation
+ InstallDate = $regKeyApp.InstallDate
+ Publisher = $appPublisher
+ Is64BitApplication = $Is64BitApp
+ }
+ }
+ }
+
+ If ($name) {
+ ## Verify if there is a match with the application name(s) passed to the script
+ ForEach ($application in $Name) {
+ $applicationMatched = $false
+ If ($exact) {
+ # Check for an exact application name match
+ If ($regKeyApp.DisplayName -eq $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using exact name matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($WildCard) {
+ # Check for wildcard application name match
+ If ($regKeyApp.DisplayName -like $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using wildcard matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($RegEx) {
+ # Check for a regex application name match
+ If ($regKeyApp.DisplayName -match $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using regex matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ # Check for a contains application name match
+ ElseIf ($regKeyApp.DisplayName -match [regex]::Escape($application)) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using contains matching for search term [$application]." -Source ${CmdletName}
+ }
+
+ If ($applicationMatched) {
+ $installedApplication += New-Object -TypeName 'PSObject' -Property @{
+ UninstallSubkey = $regKeyApp.PSChildName
+ ProductCode = If ($regKeyApp.PSChildName -match $MSIProductCodeRegExPattern) { $regKeyApp.PSChildName } Else { [string]::Empty }
+ DisplayName = $appDisplayName
+ DisplayVersion = $appDisplayVersion
+ UninstallString = $regKeyApp.UninstallString
+ InstallSource = $regKeyApp.InstallSource
+ InstallLocation = $regKeyApp.InstallLocation
+ InstallDate = $regKeyApp.InstallDate
+ Publisher = $appPublisher
+ Is64BitApplication = $Is64BitApp
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to resolve application details from registry for [$appDisplayName]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Continue
+ }
+ }
+
+ Write-Output -InputObject $installedApplication
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-MSI
+Function Execute-MSI {
+<#
+.SYNOPSIS
+ Executes msiexec.exe to perform the following actions for MSI & MSP files and MSI product codes: install, uninstall, patch, repair, active setup.
+.DESCRIPTION
+ Executes msiexec.exe to perform the following actions for MSI & MSP files and MSI product codes: install, uninstall, patch, repair, active setup.
+ If the -Action parameter is set to "Install" and the MSI is already installed, the function will exit.
+ Sets default switches to be passed to msiexec based on the preferences in the XML configuration file.
+ Automatically generates a log file name and creates a verbose log file for all msiexec operations.
+ Expects the MSI or MSP file to be located in the "Files" sub directory of the App Deploy Toolkit. Expects transform files to be in the same directory as the MSI file.
+.PARAMETER Action
+ The action to perform. Options: Install, Uninstall, Patch, Repair, ActiveSetup.
+.PARAMETER Path
+ The path to the MSI/MSP file or the product code of the installed MSI.
+.PARAMETER Transform
+ The name of the transform file(s) to be applied to the MSI. The transform file is expected to be in the same directory as the MSI file.
+.PARAMETER Patch
+ The name of the patch (msp) file(s) to be applied to the MSI for use with the "Install" action. The patch file is expected to be in the same directory as the MSI file.
+.PARAMETER Parameters
+ Overrides the default parameters specified in the XML configuration file. Install default is: "REBOOT=ReallySuppress /QB!". Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER AddParameters
+ Adds to the default parameters specified in the XML configuration file. Install default is: "REBOOT=ReallySuppress /QB!". Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER SecureParameters
+ Hides all parameters passed to the MSI or MSP file from the toolkit Log file.
+.PARAMETER LoggingOptions
+ Overrides the default logging options specified in the XML configuration file. Default options are: "/L*v".
+.PARAMETER LogName
+ Overrides the default log file name. The default log file name is generated from the MSI file name. If LogName does not end in .log, it will be automatically appended.
+ For uninstallations, by default the product code is resolved to the DisplayName and version of the application.
+.PARAMETER WorkingDirectory
+ Overrides the working directory. The working directory is set to the location of the MSI file.
+.PARAMETER SkipMSIAlreadyInstalledCheck
+ Skips the check to determine if the MSI is already installed on the system. Default is: $false.
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by msiexec that is not recognized by the App Deploy Toolkit. Default is: $false.
+.EXAMPLE
+ Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi'
+ Installs an MSI
+.EXAMPLE
+ Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi' -Transform 'Adobe_FlashPlayer_11.2.202.233_x64_EN_01.mst' -Parameters '/QN'
+ Installs an MSI, applying a transform and overriding the default MSI toolkit parameters
+.EXAMPLE
+ [psobject]$ExecuteMSIResult = Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi' -PassThru
+ Installs an MSI and stores the result of the execution into a variable by using the -PassThru option
+.EXAMPLE
+ Execute-MSI -Action 'Uninstall' -Path '{26923b43-4d38-484f-9b9e-de460746276c}'
+ Uninstalls an MSI using a product code
+.EXAMPLE
+ Execute-MSI -Action 'Patch' -Path 'Adobe_Reader_11.0.3_EN.msp'
+ Installs an MSP
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Install','Uninstall','Patch','Repair','ActiveSetup')]
+ [string]$Action = 'Install',
+ [Parameter(Mandatory=$true,HelpMessage='Please enter either the path to the MSI/MSP file or the ProductCode')]
+ [ValidateScript({($_ -match $MSIProductCodeRegExPattern) -or ('.msi','.msp' -contains [IO.Path]::GetExtension($_))})]
+ [Alias('FilePath')]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Transform,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$AddParameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Patch,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$LoggingOptions,
+ [Parameter(Mandatory=$false)]
+ [Alias('LogName')]
+ [string]$private:LogName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$SkipMSIAlreadyInstalledCheck = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Initialize variable indicating whether $Path variable is a Product Code or not
+ [boolean]$PathIsProductCode = $false
+
+ ## If the path matches a product code
+ If ($Path -match $MSIProductCodeRegExPattern) {
+ # Set variable indicating that $Path variable is a Product Code
+ [boolean]$PathIsProductCode = $true
+
+ # Resolve the product code to a publisher, application name, and version
+ Write-Log -Message 'Resolve product code to a publisher, application name, and version.' -Source ${CmdletName}
+
+ If ($IncludeUpdatesAndHotfixes) {
+ [psobject]$productCodeNameVersion = Get-InstalledApplication -ProductCode $path -IncludeUpdatesAndHotfixes | Select-Object -Property 'Publisher', 'DisplayName', 'DisplayVersion' -First 1 -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ [psobject]$productCodeNameVersion = Get-InstalledApplication -ProductCode $path | Select-Object -Property 'Publisher', 'DisplayName', 'DisplayVersion' -First 1 -ErrorAction 'SilentlyContinue'
+ }
+
+ # Build the log file name
+ If (-not $logName) {
+ If ($productCodeNameVersion) {
+ If ($productCodeNameVersion.Publisher) {
+ $logName = ($productCodeNameVersion.Publisher + '_' + $productCodeNameVersion.DisplayName + '_' + $productCodeNameVersion.DisplayVersion) -replace "[$invalidFileNameChars]",'' -replace ' ',''
+ }
+ Else {
+ $logName = ($productCodeNameVersion.DisplayName + '_' + $productCodeNameVersion.DisplayVersion) -replace "[$invalidFileNameChars]",'' -replace ' ',''
+ }
+ }
+ Else {
+ # Out of other options, make the Product Code the name of the log file
+ $logName = $Path
+ }
+ }
+ }
+ Else {
+ # Get the log file name without file extension
+ If (-not $logName) { $logName = ([IO.FileInfo]$path).BaseName } ElseIf ('.log','.txt' -contains [IO.Path]::GetExtension($logName)) { $logName = [IO.Path]::GetFileNameWithoutExtension($logName) }
+ }
+
+ If ($configToolkitCompressLogs) {
+ ## Build the log file path
+ [string]$logPath = Join-Path -Path $logTempFolder -ChildPath $logName
+ }
+ Else {
+ ## Create the Log directory if it doesn't already exist
+ If (-not (Test-Path -LiteralPath $configMSILogDir -PathType 'Container' -ErrorAction 'SilentlyContinue')) {
+ $null = New-Item -Path $configMSILogDir -ItemType 'Directory' -ErrorAction 'SilentlyContinue'
+ }
+ ## Build the log file path
+ [string]$logPath = Join-Path -Path $configMSILogDir -ChildPath $logName
+ }
+
+ ## Set the installation Parameters
+ If ($deployModeSilent) {
+ $msiInstallDefaultParams = $configMSISilentParams
+ $msiUninstallDefaultParams = $configMSISilentParams
+ }
+ Else {
+ $msiInstallDefaultParams = $configMSIInstallParams
+ $msiUninstallDefaultParams = $configMSIUninstallParams
+ }
+
+ ## Build the MSI Parameters
+ Switch ($action) {
+ 'Install' { $option = '/i'; [string]$msiLogFile = "$logPath" + '_Install'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'Uninstall' { $option = '/x'; [string]$msiLogFile = "$logPath" + '_Uninstall'; $msiDefaultParams = $msiUninstallDefaultParams }
+ 'Patch' { $option = '/update'; [string]$msiLogFile = "$logPath" + '_Patch'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'Repair' { $option = '/f'; [string]$msiLogFile = "$logPath" + '_Repair'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'ActiveSetup' { $option = '/fups'; [string]$msiLogFile = "$logPath" + '_ActiveSetup' }
+ }
+
+ ## Append ".log" to the MSI logfile path and enclose in quotes
+ If ([IO.Path]::GetExtension($msiLogFile) -ne '.log') {
+ [string]$msiLogFile = $msiLogFile + '.log'
+ [string]$msiLogFile = "`"$msiLogFile`""
+ }
+
+ ## If the MSI is in the Files directory, set the full path to the MSI
+ If (Test-Path -LiteralPath (Join-Path -Path $dirFiles -ChildPath $path -ErrorAction 'SilentlyContinue') -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ [string]$msiFile = Join-Path -Path $dirFiles -ChildPath $path
+ }
+ ElseIf (Test-Path -LiteralPath $Path -ErrorAction 'SilentlyContinue') {
+ [string]$msiFile = (Get-Item -LiteralPath $Path).FullName
+ }
+ ElseIf ($PathIsProductCode) {
+ [string]$msiFile = $Path
+ }
+ Else {
+ Write-Log -Message "Failed to find MSI file [$path]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to find MSI file [$path]."
+ }
+ Continue
+ }
+
+ ## Set the working directory of the MSI
+ If ((-not $PathIsProductCode) -and (-not $workingDirectory)) { [string]$workingDirectory = Split-Path -Path $msiFile -Parent }
+
+ ## Enumerate all transforms specified, qualify the full path if possible and enclose in quotes
+ If ($transform) {
+ [string[]]$transforms = $transform -split ','
+ 0..($transforms.Length - 1) | ForEach-Object {
+ If (Test-Path -LiteralPath (Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $transforms[$_]) -PathType 'Leaf') {
+ $transforms[$_] = Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $transforms[$_].Replace('.\','')
+ }
+ Else {
+ $transforms[$_] = $transforms[$_]
+ }
+ }
+ [string]$mstFile = "`"$($transforms -join ';')`""
+ }
+
+ ## Enumerate all patches specified, qualify the full path if possible and enclose in quotes
+ If ($patch) {
+ [string[]]$patches = $patch -split ','
+ 0..($patches.Length - 1) | ForEach-Object {
+ If (Test-Path -LiteralPath (Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $patches[$_]) -PathType 'Leaf') {
+ $patches[$_] = Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $patches[$_].Replace('.\','')
+ }
+ Else {
+ $patches[$_] = $patches[$_]
+ }
+ }
+ [string]$mspFile = "`"$($patches -join ';')`""
+ }
+
+ ## Get the ProductCode of the MSI
+ If ($PathIsProductCode) {
+ [string]$MSIProductCode = $path
+ }
+ ElseIf ([IO.Path]::GetExtension($msiFile) -eq '.msi') {
+ Try {
+ [hashtable]$GetMsiTablePropertySplat = @{ Path = $msiFile; Table = 'Property'; ContinueOnError = $false }
+ If ($transforms) { $GetMsiTablePropertySplat.Add( 'TransformPath', $transforms ) }
+ [string]$MSIProductCode = Get-MsiTableProperty @GetMsiTablePropertySplat | Select-Object -ExpandProperty 'ProductCode' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to get the ProductCode from the MSI file. Continue with requested action [$Action]..." -Source ${CmdletName}
+ }
+ }
+
+ ## Enclose the MSI file in quotes to avoid issues with spaces when running msiexec
+ [string]$msiFile = "`"$msiFile`""
+
+ ## Start building the MsiExec command line starting with the base action and file
+ [string]$argsMSI = "$option $msiFile"
+ # Add MST
+ If ($transform) { $argsMSI = "$argsMSI TRANSFORMS=$mstFile TRANSFORMSSECURE=1" }
+ # Add MSP
+ If ($patch) { $argsMSI = "$argsMSI PATCH=$mspFile" }
+ # Replace default parameters if specified.
+ If ($Parameters) { $argsMSI = "$argsMSI $Parameters" } Else { $argsMSI = "$argsMSI $msiDefaultParams" }
+ # Append parameters to default parameters if specified.
+ If ($AddParameters) { $argsMSI = "$argsMSI $AddParameters" }
+ # Add custom Logging Options if specified, otherwise, add default Logging Options from Config file
+ If ($LoggingOptions) { $argsMSI = "$argsMSI $LoggingOptions $msiLogFile" } Else { $argsMSI = "$argsMSI $configMSILoggingOptions $msiLogFile" }
+
+ ## Check if the MSI is already installed. If no valid ProductCode to check, then continue with requested MSI action.
+ If ($MSIProductCode) {
+ If ($SkipMSIAlreadyInstalledCheck) {
+ [boolean]$IsMsiInstalled = $false
+ }
+ Else {
+ If ($IncludeUpdatesAndHotfixes) {
+ [psobject]$MsiInstalled = Get-InstalledApplication -ProductCode $MSIProductCode -IncludeUpdatesAndHotfixes
+ }
+ Else {
+ [psobject]$MsiInstalled = Get-InstalledApplication -ProductCode $MSIProductCode
+ }
+ If ($MsiInstalled) { [boolean]$IsMsiInstalled = $true }
+ }
+ }
+ Else {
+ If ($Action -eq 'Install') { [boolean]$IsMsiInstalled = $false } Else { [boolean]$IsMsiInstalled = $true }
+ }
+
+ If (($IsMsiInstalled) -and ($Action -eq 'Install')) {
+ Write-Log -Message "The MSI is already installed on this system. Skipping action [$Action]..." -Source ${CmdletName}
+ }
+ ElseIf (((-not $IsMsiInstalled) -and ($Action -eq 'Install')) -or ($IsMsiInstalled)) {
+ Write-Log -Message "Executing MSI action [$Action]..." -Source ${CmdletName}
+ # Build the hashtable with the options that will be passed to Execute-Process using splatting
+ [hashtable]$ExecuteProcessSplat = @{ Path = $exeMsiexec
+ Parameters = $argsMSI
+ WindowStyle = 'Normal' }
+ If ($WorkingDirectory) { $ExecuteProcessSplat.Add( 'WorkingDirectory', $WorkingDirectory) }
+ If ($ContinueOnError) { $ExecuteProcessSplat.Add( 'ContinueOnError', $ContinueOnError) }
+ If ($SecureParameters) { $ExecuteProcessSplat.Add( 'SecureParameters', $SecureParameters) }
+ If ($PassThru) { $ExecuteProcessSplat.Add( 'PassThru', $PassThru) }
+ # Call the Execute-Process function
+ If ($PassThru) {
+ [psobject]$ExecuteResults = Execute-Process @ExecuteProcessSplat
+ }
+ Else {
+ Execute-Process @ExecuteProcessSplat
+ }
+ # Refresh environment variables for Windows Explorer process as Windows does not consistently update environment variables created by MSIs
+ Update-Desktop
+ }
+ Else {
+ Write-Log -Message "The MSI is not installed on this system. Skipping action [$Action]..." -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $ExecuteResults }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-MSIApplications
+Function Remove-MSIApplications {
+<#
+.SYNOPSIS
+ Removes all MSI applications matching the specified application name.
+.DESCRIPTION
+ Removes all MSI applications matching the specified application name.
+ Enumerates the registry for installed applications matching the specified application name and uninstalls that application using the product code, provided the uninstall string matches "msiexec".
+.PARAMETER Name
+ The name of the application to uninstall. Performs a contains match on the application display name by default.
+.PARAMETER Exact
+ Specifies that the named application must be matched using the exact name.
+.PARAMETER WildCard
+ Specifies that the named application must be matched using a wildcard search.
+.PARAMETER Parameters
+ Overrides the default parameters specified in the XML configuration file. Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER AddParameters
+ Adds to the default parameters specified in the XML configuration file. Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER FilterApplication
+ Two-dimensional array that contains one or more (property, value, match-type) sets that should be used to filter the list of results returned by Get-InstalledApplication to only those that should be uninstalled.
+ Properties that can be filtered upon: ProductCode, DisplayName, DisplayVersion, UninstallString, InstallSource, InstallLocation, InstallDate, Publisher, Is64BitApplication
+.PARAMETER ExcludeFromUninstall
+ Two-dimensional array that contains one or more (property, value, match-type) sets that should be excluded from uninstall if found.
+ Properties that can be excluded: ProductCode, DisplayName, DisplayVersion, UninstallString, InstallSource, InstallLocation, InstallDate, Publisher, Is64BitApplication
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.PARAMETER LoggingOptions
+ Overrides the default logging options specified in the XML configuration file. Default options are: "/L*v".
+.PARAMETER LogName
+ Overrides the default log file name. The default log file name is generated from the MSI file name. If LogName does not end in .log, it will be automatically appended.
+ For uninstallations, by default the product code is resolved to the DisplayName and version of the application.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by msiexec that is not recognized by the App Deploy Toolkit. Default is: $true.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Adobe Flash'
+ Removes all versions of software that match the name "Adobe Flash"
+.EXAMPLE
+ Remove-MSIApplications -Name 'Adobe'
+ Removes all versions of software that match the name "Adobe"
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -FilterApplication ('Is64BitApplication', $false, 'Exact'),('Publisher', 'Oracle Corporation', 'Exact')
+ Removes all versions of software that match the name "Java 8 Update" where the software is 32-bits and the publisher is "Oracle Corporation".
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -FilterApplication (,('Publisher', 'Oracle Corporation', 'Exact')) -ExcludeFromUninstall (,('DisplayName', 'Java 8 Update 45', 'Contains'))
+ Removes all versions of software that match the name "Java 8 Update" and also have "Oracle Corporation" as the Publisher; however, it does not uninstall "Java 8 Update 45" of the software.
+ NOTE: if only specifying a single row in the two-dimensional arrays, the array must have the extra parentheses and leading comma as in this example.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -ExcludeFromUninstall (,('DisplayName', 'Java 8 Update 45', 'Contains'))
+ Removes all versions of software that match the name "Java 8 Update"; however, it does not uninstall "Java 8 Update 45" of the software.
+ NOTE: if only specifying a single row in the two-dimensional array, the array must have the extra parentheses and leading comma as in this example.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -ExcludeFromUninstall
+ ('Is64BitApplication', $true, 'Exact'),
+ ('DisplayName', 'Java 8 Update 45', 'Exact'),
+ ('DisplayName', 'Java 8 Update 4*', 'WildCard'),
+ ('DisplayName', 'Java \d Update \d{3}', 'RegEx'),
+ ('DisplayName', 'Java 8 Update', 'Contains')
+ Removes all versions of software that match the name "Java 8 Update"; however, it does not uninstall 64-bit versions of the software, Update 45 of the software, or any Update that starts with 4.
+.NOTES
+ More reading on how to create arrays if having trouble with -FilterApplication or -ExcludeFromUninstall parameter: http://blogs.msdn.com/b/powershell/archive/2007/01/23/array-literals-in-powershell.aspx
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Exact = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WildCard = $false,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$AddParameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [array]$FilterApplication = @(@()),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [array]$ExcludeFromUninstall = @(@()),
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$LoggingOptions,
+ [Parameter(Mandatory=$false)]
+ [Alias('LogName')]
+ [string]$private:LogName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Build the hashtable with the options that will be passed to Get-InstalledApplication using splatting
+ [hashtable]$GetInstalledApplicationSplat = @{ Name = $name }
+ If ($Exact) { $GetInstalledApplicationSplat.Add( 'Exact', $Exact) }
+ ElseIf ($WildCard) { $GetInstalledApplicationSplat.Add( 'WildCard', $WildCard) }
+ If ($IncludeUpdatesAndHotfixes) { $GetInstalledApplicationSplat.Add( 'IncludeUpdatesAndHotfixes', $IncludeUpdatesAndHotfixes) }
+
+ [psobject[]]$installedApplications = Get-InstalledApplication @GetInstalledApplicationSplat
+
+ Write-Log -Message "Found [$($installedApplications.Count)] application(s) that matched the specified criteria [$Name]." -Source ${CmdletName}
+
+ ## Filter the results from Get-InstalledApplication
+ [Collections.ArrayList]$removeMSIApplications = New-Object -TypeName 'System.Collections.ArrayList'
+ If (($null -ne $installedApplications) -and ($installedApplications.Count)) {
+ ForEach ($installedApplication in $installedApplications) {
+ If ($installedApplication.UninstallString -notmatch 'msiexec') {
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName)] because uninstall string [$($installedApplication.UninstallString)] does not match `"msiexec`"." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ If ([string]::IsNullOrEmpty($installedApplication.ProductCode)) {
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName)] because unable to discover MSI ProductCode from application's registry Uninstall subkey [$($installedApplication.UninstallSubkey)]." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+
+ # Filter the results from Get-InstalledApplication to only those that should be uninstalled
+ If (($null -ne $FilterApplication) -and ($FilterApplication.Count)) {
+ Write-Log -Message "Filter the results to only those that should be uninstalled as specified in parameter [-FilterApplication]." -Source ${CmdletName}
+ [boolean]$addAppToRemoveList = $false
+ ForEach ($Filter in $FilterApplication) {
+ If ($Filter[2] -eq 'RegEx') {
+ If ($installedApplication.($Filter[0]) -match $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of regex match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'Contains') {
+ If ($installedApplication.($Filter[0]) -match [regex]::Escape($Filter[1])) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of contains match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'WildCard') {
+ If ($installedApplication.($Filter[0]) -like $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of wildcard match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'Exact') {
+ If ($installedApplication.($Filter[0]) -eq $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of exact match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Else {
+ [boolean]$addAppToRemoveList = $true
+ }
+
+ # Filter the results from Get-InstalledApplication to remove those that should never be uninstalled
+ If (($null -ne $ExcludeFromUninstall) -and ($ExcludeFromUninstall.Count)) {
+ ForEach ($Exclude in $ExcludeFromUninstall) {
+ If ($Exclude[2] -eq 'RegEx') {
+ If ($installedApplication.($Exclude[0]) -match $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of regex match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'Contains') {
+ If ($installedApplication.($Exclude[0]) -match [regex]::Escape($Exclude[1])) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of contains match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'WildCard') {
+ If ($installedApplication.($Exclude[0]) -like $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of wildcard match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'Exact') {
+ If ($installedApplication.($Exclude[0]) -eq $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of exact match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+
+ If ($addAppToRemoveList) {
+ Write-Log -Message "Adding application to list for removal: [$($installedApplication.DisplayName) $($installedApplication.Version)]." -Source ${CmdletName}
+ $removeMSIApplications.Add($installedApplication)
+ }
+ }
+ }
+
+ ## Build the hashtable with the options that will be passed to Execute-MSI using splatting
+ [hashtable]$ExecuteMSISplat = @{ Action = 'Uninstall'; Path = '' }
+ If ($ContinueOnError) { $ExecuteMSISplat.Add( 'ContinueOnError', $ContinueOnError) }
+ If ($Parameters) { $ExecuteMSISplat.Add( 'Parameters', $Parameters) }
+ ElseIf ($AddParameters) { $ExecuteMSISplat.Add( 'AddParameters', $AddParameters) }
+ If ($LoggingOptions) { $ExecuteMSISplat.Add( 'LoggingOptions', $LoggingOptions) }
+ If ($LogName) { $ExecuteMSISplat.Add( 'LogName', $LogName) }
+ If ($PassThru) { $ExecuteMSISplat.Add( 'PassThru', $PassThru) }
+ If ($IncludeUpdatesAndHotfixes) { $ExecuteMSISplat.Add( 'IncludeUpdatesAndHotfixes', $IncludeUpdatesAndHotfixes) }
+
+ If (($null -ne $removeMSIApplications) -and ($removeMSIApplications.Count)) {
+ ForEach ($removeMSIApplication in $removeMSIApplications) {
+ Write-Log -Message "Remove application [$($removeMSIApplication.DisplayName) $($removeMSIApplication.Version)]." -Source ${CmdletName}
+ $ExecuteMSISplat.Path = $removeMSIApplication.ProductCode
+ If ($PassThru) {
+ [psobject[]]$ExecuteResults += Execute-MSI @ExecuteMSISplat
+ }
+ Else {
+ Execute-MSI @ExecuteMSISplat
+ }
+ }
+ }
+ Else {
+ Write-Log -Message 'No applications found for removal. Continue...' -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $ExecuteResults }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-Process
+Function Execute-Process {
+<#
+.SYNOPSIS
+ Execute a process with optional arguments, working directory, window style.
+.DESCRIPTION
+ Executes a process, e.g. a file included in the Files directory of the App Deploy Toolkit, or a file on the local machine.
+ Provides various options for handling the return codes (see Parameters).
+.PARAMETER Path
+ Path to the file to be executed. If the file is located directly in the "Files" directory of the App Deploy Toolkit, only the file name needs to be specified.
+ Otherwise, the full path of the file must be specified. If the files is in a subdirectory of "Files", use the "$dirFiles" variable as shown in the example.
+.PARAMETER Parameters
+ Arguments to be passed to the executable
+.PARAMETER SecureParameters
+ Hides all parameters passed to the executable from the Toolkit log file
+.PARAMETER WindowStyle
+ Style of the window of the process executed. Options: Normal, Hidden, Maximized, Minimized. Default: Normal.
+ Note: Not all processes honor the "Hidden" flag. If it it not working, then check the command line options for the process being executed to see it has a silent option.
+.PARAMETER CreateNoWindow
+ Specifies whether the process should be started with a new window to contain it. Default is false.
+.PARAMETER WorkingDirectory
+ The working directory used for executing the process. Defaults to the directory of the file being executed.
+.PARAMETER NoWait
+ Immediately continue after executing the process.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER WaitForMsiExec
+ Sometimes an EXE bootstrapper will launch an MSI install. In such cases, this variable will ensure that
+ this function waits for the msiexec engine to become available before starting the install.
+.PARAMETER MsiExecWaitTime
+ Specify the length of time in seconds to wait for the msiexec engine to become available. Default: 600 seconds (10 minutes).
+.PARAMETER IgnoreExitCodes
+ List the exit codes to ignore.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by the process that is not recognized by the App Deploy Toolkit. Default: $false.
+.EXAMPLE
+ Execute-Process -Path 'uninstall_flash_player_64bit.exe' -Parameters '/uninstall' -WindowStyle 'Hidden'
+ If the file is in the "Files" directory of the App Deploy Toolkit, only the file name needs to be specified.
+.EXAMPLE
+ Execute-Process -Path "$dirFiles\Bin\setup.exe" -Parameters '/S' -WindowStyle 'Hidden'
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters '/S' -IgnoreExitCodes '1,2'
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters "-s -f2`"$configToolkitLogDir\$installName.log`""
+ Launch InstallShield "setup.exe" from the ".\Files" sub-directory and force log files to the logging folder.
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters "/s /v`"ALLUSERS=1 /qn /L* \`"$configToolkitLogDir\$installName.log`"`""
+ Launch InstallShield "setup.exe" with embedded MSI and force log files to the logging folder.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [Alias('FilePath')]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Normal','Hidden','Maximized','Minimized')]
+ [Diagnostics.ProcessWindowStyle]$WindowStyle = 'Normal',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$CreateNoWindow = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [switch]$NoWait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WaitForMsiExec = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [timespan]$MsiExecWaitTime = $(New-TimeSpan -Seconds $configMSIMutexWaitTime),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IgnoreExitCodes,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $private:returnCode = $null
+
+ ## Validate and find the fully qualified path for the $Path variable.
+ If (([IO.Path]::IsPathRooted($Path)) -and ([IO.Path]::HasExtension($Path))) {
+ Write-Log -Message "[$Path] is a valid fully qualified path, continue." -Source ${CmdletName}
+ If (-not (Test-Path -LiteralPath $Path -PathType 'Leaf' -ErrorAction 'Stop')) {
+ Throw "File [$Path] not found."
+ }
+ }
+ Else {
+ # The first directory to search will be the 'Files' subdirectory of the script directory
+ [string]$PathFolders = $dirFiles
+ # Add the current location of the console (Windows always searches this location first)
+ [string]$PathFolders = $PathFolders + ';' + (Get-Location -PSProvider 'FileSystem').Path
+ # Add the new path locations to the PATH environment variable
+ $env:PATH = $PathFolders + ';' + $env:PATH
+
+ # Get the fully qualified path for the file. Get-Command searches PATH environment variable to find this value.
+ [string]$FullyQualifiedPath = Get-Command -Name $Path -CommandType 'Application' -TotalCount 1 -Syntax -ErrorAction 'Stop'
+
+ # Revert the PATH environment variable to it's original value
+ $env:PATH = $env:PATH -replace [regex]::Escape($PathFolders + ';'), ''
+
+ If ($FullyQualifiedPath) {
+ Write-Log -Message "[$Path] successfully resolved to fully qualified path [$FullyQualifiedPath]." -Source ${CmdletName}
+ $Path = $FullyQualifiedPath
+ }
+ Else {
+ Throw "[$Path] contains an invalid path or file name."
+ }
+ }
+
+ ## Set the Working directory (if not specified)
+ If (-not $WorkingDirectory) { $WorkingDirectory = Split-Path -Path $Path -Parent -ErrorAction 'Stop' }
+
+ ## If MSI install, check to see if the MSI installer service is available or if another MSI install is already underway.
+ ## Please note that a race condition is possible after this check where another process waiting for the MSI installer
+ ## to become available grabs the MSI Installer mutex before we do. Not too concerned about this possible race condition.
+ If (($Path -match 'msiexec') -or ($WaitForMsiExec)) {
+ [boolean]$MsiExecAvailable = Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds $MsiExecWaitTime.TotalMilliseconds
+ Start-Sleep -Seconds 1
+ If (-not $MsiExecAvailable) {
+ # Default MSI exit code for install already in progress
+ [int32]$returnCode = 1618
+ Throw 'Please complete in progress MSI installation before proceeding with this install.'
+ }
+ }
+
+ Try {
+ ## Disable Zone checking to prevent warnings when running executables
+ $env:SEE_MASK_NOZONECHECKS = 1
+
+ ## Using this variable allows capture of exceptions from .NET methods. Private scope only changes value for current function.
+ $private:previousErrorActionPreference = $ErrorActionPreference
+ $ErrorActionPreference = 'Stop'
+
+ ## Define process
+ $processStartInfo = New-Object -TypeName 'System.Diagnostics.ProcessStartInfo' -ErrorAction 'Stop'
+ $processStartInfo.FileName = $Path
+ $processStartInfo.WorkingDirectory = $WorkingDirectory
+ $processStartInfo.UseShellExecute = $false
+ $processStartInfo.ErrorDialog = $false
+ $processStartInfo.RedirectStandardOutput = $true
+ $processStartInfo.RedirectStandardError = $true
+ $processStartInfo.CreateNoWindow = $CreateNoWindow
+ If ($Parameters) { $processStartInfo.Arguments = $Parameters }
+ If ($windowStyle) { $processStartInfo.WindowStyle = $WindowStyle }
+ $process = New-Object -TypeName 'System.Diagnostics.Process' -ErrorAction 'Stop'
+ $process.StartInfo = $processStartInfo
+
+ ## Add event handler to capture process's standard output redirection
+ [scriptblock]$processEventHandler = { If (-not [string]::IsNullOrEmpty($EventArgs.Data)) { $Event.MessageData.AppendLine($EventArgs.Data) } }
+ $stdOutBuilder = New-Object -TypeName 'System.Text.StringBuilder' -ArgumentList ''
+ $stdOutEvent = Register-ObjectEvent -InputObject $process -Action $processEventHandler -EventName 'OutputDataReceived' -MessageData $stdOutBuilder -ErrorAction 'Stop'
+
+ ## Start Process
+ Write-Log -Message "Working Directory is [$WorkingDirectory]." -Source ${CmdletName}
+ If ($Parameters) {
+ If ($Parameters -match '-Command \&') {
+ Write-Log -Message "Executing [$Path [PowerShell ScriptBlock]]..." -Source ${CmdletName}
+ }
+ Else {
+ If ($SecureParameters) {
+ Write-Log -Message "Executing [$Path (Parameters Hidden)]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Executing [$Path $Parameters]..." -Source ${CmdletName}
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Executing [$Path]..." -Source ${CmdletName}
+ }
+ [boolean]$processStarted = $process.Start()
+
+ If ($NoWait) {
+ Write-Log -Message 'NoWait parameter specified. Continuing without waiting for exit code...' -Source ${CmdletName}
+ }
+ Else {
+ $process.BeginOutputReadLine()
+ $stdErr = $($process.StandardError.ReadToEnd()).ToString() -replace $null,''
+
+ ## Instructs the Process component to wait indefinitely for the associated process to exit.
+ $process.WaitForExit()
+
+ ## HasExited indicates that the associated process has terminated, either normally or abnormally. Wait until HasExited returns $true.
+ While (-not ($process.HasExited)) { $process.Refresh(); Start-Sleep -Seconds 1 }
+
+ ## Get the exit code for the process
+ Try {
+ [int32]$returnCode = $process.ExitCode
+ }
+ Catch [System.Management.Automation.PSInvalidCastException] {
+ # Catch exit codes that are out of int32 range
+ [int32]$returnCode = 60013
+ }
+
+ ## Unregister standard output event to retrieve process output
+ If ($stdOutEvent) { Unregister-Event -SourceIdentifier $stdOutEvent.Name -ErrorAction 'Stop'; $stdOutEvent = $null }
+ $stdOut = $stdOutBuilder.ToString() -replace $null,''
+
+ If ($stdErr.Length -gt 0) {
+ Write-Log -Message "Standard error output from the process: $stdErr" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ Finally {
+ ## Make sure the standard output event is unregistered
+ If ($stdOutEvent) { Unregister-Event -SourceIdentifier $stdOutEvent.Name -ErrorAction 'Stop'}
+
+ ## Free resources associated with the process, this does not cause process to exit
+ If ($process) { $process.Close() }
+
+ ## Re-enable Zone checking
+ Remove-Item -LiteralPath 'env:SEE_MASK_NOZONECHECKS' -ErrorAction 'SilentlyContinue'
+
+ If ($private:previousErrorActionPreference) { $ErrorActionPreference = $private:previousErrorActionPreference }
+ }
+
+ If (-not $NoWait) {
+ ## Check to see whether we should ignore exit codes
+ $ignoreExitCodeMatch = $false
+ If ($ignoreExitCodes) {
+ # Split the processes on a comma
+ [int32[]]$ignoreExitCodesArray = $ignoreExitCodes -split ','
+ ForEach ($ignoreCode in $ignoreExitCodesArray) {
+ If ($returnCode -eq $ignoreCode) { $ignoreExitCodeMatch = $true }
+ }
+ }
+ # Or always ignore exit codes
+ If ($ContinueOnError) { $ignoreExitCodeMatch = $true }
+
+ ## If the passthru switch is specified, return the exit code and any output from process
+ If ($PassThru) {
+ Write-Log -Message "Execution completed with exit code [$returnCode]." -Source ${CmdletName}
+ [psobject]$ExecutionResults = New-Object -TypeName 'PSObject' -Property @{ ExitCode = $returnCode; StdOut = $stdOut; StdErr = $stdErr }
+ Write-Output -InputObject $ExecutionResults
+ }
+ ElseIf ($ignoreExitCodeMatch) {
+ Write-Log -Message "Execution complete and the exit code [$returncode] is being ignored." -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq 3010) -or ($returnCode -eq 1641)) {
+ Write-Log -Message "Execution completed successfully with exit code [$returnCode]. A reboot is required." -Severity 2 -Source ${CmdletName}
+ Set-Variable -Name 'msiRebootDetected' -Value $true -Scope 'Script'
+ }
+ ElseIf (($returnCode -eq 1605) -and ($Path -match 'msiexec')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the product is not currently installed." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq -2145124329) -and ($Path -match 'wusa')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the Windows Update is not applicable to this system." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq 17025) -and ($Path -match 'fullfile')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the Office Update is not applicable to this system." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf ($returnCode -eq 0) {
+ Write-Log -Message "Execution completed successfully with exit code [$returnCode]." -Source ${CmdletName}
+ }
+ Else {
+ [string]$MsiExitCodeMessage = ''
+ If ($Path -match 'msiexec') {
+ [string]$MsiExitCodeMessage = Get-MsiExitCodeMessage -MsiExitCode $returnCode
+ }
+
+ If ($MsiExitCodeMessage) {
+ Write-Log -Message "Execution failed with exit code [$returnCode]: $MsiExitCodeMessage" -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Execution failed with exit code [$returnCode]." -Severity 3 -Source ${CmdletName}
+ }
+ Exit-Script -ExitCode $returnCode
+ }
+ }
+ }
+ Catch {
+ If ([string]::IsNullOrEmpty([string]$returnCode)) {
+ [int32]$returnCode = 60002
+ Write-Log -Message "Function failed, setting exit code to [$returnCode]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Execution completed with exit code [$returnCode]. Function failed. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ If ($PassThru) {
+ [psobject]$ExecutionResults = New-Object -TypeName 'PSObject' -Property @{ ExitCode = $returnCode; StdOut = If ($stdOut) { $stdOut } Else { '' }; StdErr = If ($stdErr) { $stdErr } Else { '' } }
+ Write-Output -InputObject $ExecutionResults
+ }
+ Else {
+ Exit-Script -ExitCode $returnCode
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-MsiExitCodeMessage
+Function Get-MsiExitCodeMessage {
+<#
+.SYNOPSIS
+ Get message for MSI error code
+.DESCRIPTION
+ Get message for MSI error code by reading it from msimsg.dll
+.PARAMETER MsiErrorCode
+ MSI error code
+.EXAMPLE
+ Get-MsiExitCodeMessage -MsiErrorCode 1618
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://msdn.microsoft.com/en-us/library/aa368542(v=vs.85).aspx
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [int32]$MsiExitCode
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get message for exit code [$MsiExitCode]." -Source ${CmdletName}
+ [string]$MsiExitCodeMsg = [PSADT.Msi]::GetMessageFromMsiExitCode($MsiExitCode)
+ Write-Output -InputObject $MsiExitCodeMsg
+ }
+ Catch {
+ Write-Log -Message "Failed to get message for exit code [$MsiExitCode]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-IsMutexAvailable
+Function Test-IsMutexAvailable {
+<#
+.SYNOPSIS
+ Wait, up to a timeout value, to check if current thread is able to acquire an exclusive lock on a system mutex.
+.DESCRIPTION
+ A mutex can be used to serialize applications and prevent multiple instances from being opened at the same time.
+ Wait, up to a timeout (default is 1 millisecond), for the mutex to become available for an exclusive lock.
+.PARAMETER MutexName
+ The name of the system mutex.
+.PARAMETER MutexWaitTime
+ The number of milliseconds the current thread should wait to acquire an exclusive lock of a named mutex. Default is: 1 millisecond.
+ A wait time of -1 milliseconds means to wait indefinitely. A wait time of zero does not acquire an exclusive lock but instead tests the state of the wait handle and returns immediately.
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds 500
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds (New-TimeSpan -Minutes 5).TotalMilliseconds
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds (New-TimeSpan -Seconds 60).TotalMilliseconds
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://msdn.microsoft.com/en-us/library/aa372909(VS.85).asp
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateLength(1,260)]
+ [string]$MutexName,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({($_ -ge -1) -and ($_ -le [int32]::MaxValue)})]
+ [int32]$MutexWaitTimeInMilliseconds = 1
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Initialize Variables
+ [timespan]$MutexWaitTime = [timespan]::FromMilliseconds($MutexWaitTimeInMilliseconds)
+ If ($MutexWaitTime.TotalMinutes -ge 1) {
+ [string]$WaitLogMsg = "$($MutexWaitTime.TotalMinutes) minute(s)"
+ }
+ ElseIf ($MutexWaitTime.TotalSeconds -ge 1) {
+ [string]$WaitLogMsg = "$($MutexWaitTime.TotalSeconds) second(s)"
+ }
+ Else {
+ [string]$WaitLogMsg = "$($MutexWaitTime.Milliseconds) millisecond(s)"
+ }
+ [boolean]$IsUnhandledException = $false
+ [boolean]$IsMutexFree = $false
+ [Threading.Mutex]$OpenExistingMutex = $null
+ }
+ Process {
+ Write-Log -Message "Check to see if mutex [$MutexName] is available. Wait up to [$WaitLogMsg] for the mutex to become available." -Source ${CmdletName}
+ Try {
+ ## Using this variable allows capture of exceptions from .NET methods. Private scope only changes value for current function.
+ $private:previousErrorActionPreference = $ErrorActionPreference
+ $ErrorActionPreference = 'Stop'
+
+ ## Open the specified named mutex, if it already exists, without acquiring an exclusive lock on it. If the system mutex does not exist, this method throws an exception instead of creating the system object.
+ [Threading.Mutex]$OpenExistingMutex = [Threading.Mutex]::OpenExisting($MutexName)
+ ## Attempt to acquire an exclusive lock on the mutex. Use a Timespan to specify a timeout value after which no further attempt is made to acquire a lock on the mutex.
+ $IsMutexFree = $OpenExistingMutex.WaitOne($MutexWaitTime, $false)
+ }
+ Catch [Threading.WaitHandleCannotBeOpenedException] {
+ ## The named mutex does not exist
+ $IsMutexFree = $true
+ }
+ Catch [ObjectDisposedException] {
+ ## Mutex was disposed between opening it and attempting to wait on it
+ $IsMutexFree = $true
+ }
+ Catch [UnauthorizedAccessException] {
+ ## The named mutex exists, but the user does not have the security access required to use it
+ $IsMutexFree = $false
+ }
+ Catch [Threading.AbandonedMutexException] {
+ ## The wait completed because a thread exited without releasing a mutex. This exception is thrown when one thread acquires a mutex object that another thread has abandoned by exiting without releasing it.
+ $IsMutexFree = $true
+ }
+ Catch {
+ $IsUnhandledException = $true
+ ## Return $true, to signify that mutex is available, because function was unable to successfully complete a check due to an unhandled exception. Default is to err on the side of the mutex being available on a hard failure.
+ Write-Log -Message "Unable to check if mutex [$MutexName] is available due to an unhandled exception. Will default to return value of [$true]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ $IsMutexFree = $true
+ }
+ Finally {
+ If ($IsMutexFree) {
+ If (-not $IsUnhandledException) {
+ Write-Log -Message "Mutex [$MutexName] is available for an exclusive lock." -Source ${CmdletName}
+ }
+ }
+ Else {
+ If ($MutexName -eq 'Global\_MSIExecute') {
+ ## Get the command line for the MSI installation in progress
+ Try {
+ [string]$msiInProgressCmdLine = Get-WmiObject -Class 'Win32_Process' -Filter "name = 'msiexec.exe'" -ErrorAction 'Stop' | Where-Object { $_.CommandLine } | Select-Object -ExpandProperty 'CommandLine' | Where-Object { $_ -match '\.msi' } | ForEach-Object { $_.Trim() }
+ }
+ Catch { }
+ Write-Log -Message "Mutex [$MutexName] is not available for an exclusive lock because the following MSI installation is in progress [$msiInProgressCmdLine]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Mutex [$MutexName] is not available because another thread already has an exclusive lock on it." -Source ${CmdletName}
+ }
+ }
+
+ If (($null -ne $OpenExistingMutex) -and ($IsMutexFree)) {
+ ## Release exclusive lock on the mutex
+ $null = $OpenExistingMutex.ReleaseMutex()
+ $OpenExistingMutex.Close()
+ }
+ If ($private:previousErrorActionPreference) { $ErrorActionPreference = $private:previousErrorActionPreference }
+ }
+ }
+ End {
+ Write-Output -InputObject $IsMutexFree
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-Folder
+Function New-Folder {
+<#
+.SYNOPSIS
+ Create a new folder.
+.DESCRIPTION
+ Create a new folder if it does not exist.
+.PARAMETER Path
+ Path to the new folder to create.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ New-Folder -Path "$envWinDir\System32"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If (-not (Test-Path -LiteralPath $Path -PathType 'Container')) {
+ Write-Log -Message "Create folder [$Path]." -Source ${CmdletName}
+ $null = New-Item -Path $Path -ItemType 'Directory' -ErrorAction 'Stop'
+ }
+ Else {
+ Write-Log -Message "Folder [$Path] already exists." -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create folder [$Path]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create folder [$Path]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-Folder
+Function Remove-Folder {
+<#
+.SYNOPSIS
+ Remove folder and files if they exist.
+.DESCRIPTION
+ Remove folder and all files recursively in a given path.
+.PARAMETER Path
+ Path to the folder to remove.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-Folder -Path "$envWinDir\Downloaded Program Files"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If (Test-Path -LiteralPath $Path -PathType 'Container') {
+ Try {
+ Remove-Item -LiteralPath $Path -Force -Recurse -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorRemoveFolder'
+ If ($ErrorRemoveFolder) {
+ Write-Log -Message "The following error(s) took place while deleting folder(s) and file(s) recursively from path [$path]. `n$(Resolve-Error -ErrorRecord $ErrorRemoveFolder)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to delete folder(s) and file(s) recursively from path [$path]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete folder(s) and file(s) recursively from path [$path]: $($_.Exception.Message)"
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Folder [$Path] does not exists..." -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Copy-File
+Function Copy-File {
+<#
+.SYNOPSIS
+ Copy a file or group of files to a destination path.
+.DESCRIPTION
+ Copy a file or group of files to a destination path.
+.PARAMETER Path
+ Path of the file to copy.
+.PARAMETER Destination
+ Destination Path of the file to copy.
+.PARAMETER Recurse
+ Copy files in subdirectories.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. This will continue the deployment script, but will not continue copying files if an error is encountered. Default is: $true.
+.PARAMETER ContinueFileCopyOnError
+ Continue copying files if an error is encountered. This will continue the deployment script and will warn about files that failed to be copied. Default is: $false.
+.EXAMPLE
+ Copy-File -Path "$dirSupportFiles\MyApp.ini" -Destination "$envWindir\MyApp.ini"
+.EXAMPLE
+ Copy-File -Path "$dirSupportFiles\*.*" -Destination "$envTemp\tempfiles"
+ Copy all of the files in a folder to a destination folder.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Path,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Destination,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueFileCopyOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $null = $fileCopyError
+ If ((-not ([IO.Path]::HasExtension($Destination))) -and (-not (Test-Path -LiteralPath $Destination -PathType 'Container'))) {
+ Write-Log -Message "Destination folder does not exist, creating destination folder [$destination]." -Source ${CmdletName}
+ $null = New-Item -Path $Destination -Type 'Directory' -Force -ErrorAction 'Stop'
+ }
+
+ $null = $FileCopyError
+ If ($Recurse) {
+ Write-Log -Message "Copy file(s) recursively in path [$path] to destination [$destination]." -Source ${CmdletName}
+ If (-not $ContinueFileCopyOnError) {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -Recurse -ErrorAction 'Stop'
+ }
+ Else {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -Recurse -ErrorAction 'SilentlyContinue' -ErrorVariable FileCopyError
+ }
+ }
+ Else {
+ Write-Log -Message "Copy file in path [$path] to destination [$destination]." -Source ${CmdletName}
+ If (-not $ContinueFileCopyOnError) {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -ErrorAction 'Stop'
+ }
+ Else {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -ErrorAction 'SilentlyContinue' -ErrorVariable FileCopyError
+ }
+ }
+
+ If ($fileCopyError) {
+ Write-Log -Message "The following warnings were detected while copying file(s) in path [$path] to destination [$destination]. `n$FileCopyError" -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "File copy completed successfully." -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to copy file(s) in path [$path] to destination [$destination]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to copy file(s) in path [$path] to destination [$destination]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-File
+Function Remove-File {
+<#
+.SYNOPSIS
+ Removes one or more items from a given path on the filesystem.
+.DESCRIPTION
+ Removes one or more items from a given path on the filesystem.
+.PARAMETER Path
+ Specifies the path on the filesystem to be resolved. The value of Path will accept wildcards. Will accept an array of values.
+.PARAMETER LiteralPath
+ Specifies the path on the filesystem to be resolved. The value of LiteralPath is used exactly as it is typed; no characters are interpreted as wildcards. Will accept an array of values.
+.PARAMETER Recurse
+ Deletes the files in the specified location(s) and in all child items of the location(s).
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-File -Path 'C:\Windows\Downloaded Program Files\Temp.inf'
+.EXAMPLE
+ Remove-File -LiteralPath 'C:\Windows\Downloaded Program Files' -Recurse
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='Path')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Path,
+ [Parameter(Mandatory=$true,ParameterSetName='LiteralPath')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$LiteralPath,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Build hashtable of parameters/value pairs to be passed to Remove-Item cmdlet
+ [hashtable]$RemoveFileSplat = @{ 'Recurse' = $Recurse
+ 'Force' = $true
+ 'ErrorVariable' = '+ErrorRemoveItem'
+ }
+ If ($ContinueOnError) {
+ $RemoveFileSplat.Add('ErrorAction', 'SilentlyContinue')
+ }
+ Else {
+ $RemoveFileSplat.Add('ErrorAction', 'Stop')
+ }
+
+ ## Resolve the specified path, if the path does not exist, display a warning instead of an error
+ If ($PSCmdlet.ParameterSetName -eq 'Path') { [string[]]$SpecifiedPath = $Path } Else { [string[]]$SpecifiedPath = $LiteralPath }
+ ForEach ($Item in $SpecifiedPath) {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'Path') {
+ [string[]]$ResolvedPath += Resolve-Path -Path $Item -ErrorAction 'Stop' | Where-Object { $_.Path } | Select-Object -ExpandProperty 'Path' -ErrorAction 'Stop'
+ }
+ Else {
+ [string[]]$ResolvedPath += Resolve-Path -LiteralPath $Item -ErrorAction 'Stop' | Where-Object { $_.Path } | Select-Object -ExpandProperty 'Path' -ErrorAction 'Stop'
+ }
+ }
+ Catch [System.Management.Automation.ItemNotFoundException] {
+ Write-Log -Message "Unable to resolve file(s) for deletion in path [$Item] because path does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to resolve file(s) for deletion in path [$Item]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to resolve file(s) for deletion in path [$Item]: $($_.Exception.Message)"
+ }
+ }
+ }
+
+ ## Delete specified path if it was successfully resolved
+ If ($ResolvedPath) {
+ ForEach ($Item in $ResolvedPath) {
+ Try {
+ If (($Recurse) -and (Test-Path -LiteralPath $Item -PathType 'Container')) {
+ Write-Log -Message "Delete file(s) recursively in path [$Item]..." -Source ${CmdletName}
+ }
+ ElseIf ((-not $Recurse) -and (Test-Path -LiteralPath $Item -PathType 'Container')) {
+ Write-Log -Message "Skipping folder [$Item] because the Recurse switch was not specified"
+ Continue
+ }
+ Else {
+ Write-Log -Message "Delete file in path [$Item]..." -Source ${CmdletName}
+ }
+ $null = Remove-Item @RemoveFileSplat -LiteralPath $Item
+ }
+ Catch {
+ Write-Log -Message "Failed to delete file(s) in path [$Item]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete file(s) in path [$Item]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+
+ If ($ErrorRemoveItem) {
+ Write-Log -Message "The following error(s) took place while removing file(s) in path [$SpecifiedPath]. `n$(Resolve-Error -ErrorRecord $ErrorRemoveItem)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Convert-RegistryPath
+Function Convert-RegistryPath {
+<#
+.SYNOPSIS
+ Converts the specified registry key path to a format that is compatible with built-in PowerShell cmdlets.
+.DESCRIPTION
+ Converts the specified registry key path to a format that is compatible with built-in PowerShell cmdlets.
+ Converts registry key hives to their full paths. Example: HKLM is converted to "Registry::HKEY_LOCAL_MACHINE".
+.PARAMETER Key
+ Path to the registry key to convert (can be a registry hive or fully qualified path)
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.EXAMPLE
+ Convert-RegistryPath -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.EXAMPLE
+ Convert-RegistryPath -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Convert the registry key hive to the full path, only match if at the beginning of the line
+ If ($Key -match '^HKLM:\\|^HKCU:\\|^HKCR:\\|^HKU:\\|^HKCC:\\|^HKPD:\\') {
+ # Converts registry paths that start with, e.g.: HKLM:\
+ $key = $key -replace '^HKLM:\\', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR:\\', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU:\\', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU:\\', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC:\\', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD:\\', 'HKEY_PERFORMANCE_DATA\'
+ }
+ ElseIf ($Key -match '^HKLM:|^HKCU:|^HKCR:|^HKU:|^HKCC:|^HKPD:') {
+ # Converts registry paths that start with, e.g.: HKLM:
+ $key = $key -replace '^HKLM:', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR:', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU:', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU:', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC:', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD:', 'HKEY_PERFORMANCE_DATA\'
+ }
+ ElseIf ($Key -match '^HKLM\\|^HKCU\\|^HKCR\\|^HKU\\|^HKCC\\|^HKPD\\') {
+ # Converts registry paths that start with, e.g.: HKLM\
+ $key = $key -replace '^HKLM\\', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR\\', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU\\', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU\\', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC\\', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD\\', 'HKEY_PERFORMANCE_DATA\'
+ }
+
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($key -match '^HKEY_CURRENT_USER\\') { $key = $key -replace '^HKEY_CURRENT_USER\\', "HKEY_USERS\$SID\" }
+ }
+
+ ## Append the PowerShell drive to the registry key path
+ If ($key -notmatch '^Registry::') {[string]$key = "Registry::$key" }
+
+ If($Key -match '^Registry::HKEY_LOCAL_MACHINE|^Registry::HKEY_CLASSES_ROOT|^Registry::HKEY_CURRENT_USER|^Registry::HKEY_USERS|^Registry::HKEY_CURRENT_CONFIG|^Registry::HKEY_PERFORMANCE_DATA') {
+ ## Check for expected key string format
+ Write-Log -Message "Return fully qualified registry key path [$key]." -Source ${CmdletName}
+ Write-Output -InputObject $key
+ }
+ Else{
+ # If key string is not properly formatted, throw an error
+ Throw "Unable to detect target registry hive in string [$key]."
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-RegistryValue
+Function Test-RegistryValue {
+<#
+.SYNOPSIS
+ Test if a registry value exists.
+.DESCRIPTION
+ Checks a registry key path to see if it has a value with a given name. Can correctly handle cases where a value simply has an empty or null value.
+.PARAMETER Key
+ Path of the registry key.
+.PARAMETER Value
+ Specify the registry key value to check the existence of.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.EXAMPLE
+ Test-RegistryValue -Key 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -Value 'PendingFileRenameOperations'
+.NOTES
+ To test if registry key exists, use Test-Path function like so:
+ Test-Path -Path $Key -PathType 'Container'
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ Param (
+ [Parameter(Mandatory=$true,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]$Key,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullOrEmpty()]$Value,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ Try {
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$Key = Convert-RegistryPath -Key $Key -SID $SID
+ }
+ Else {
+ [string]$Key = Convert-RegistryPath -Key $Key
+ }
+ }
+ Catch {
+ Throw
+ }
+ [boolean]$IsRegistryValueExists = $false
+ Try {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ [string[]]$PathProperties = Get-Item -LiteralPath $Key -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Property' -ErrorAction 'Stop'
+ If ($PathProperties -contains $Value) { $IsRegistryValueExists = $true }
+ }
+ }
+ Catch { }
+
+ If ($IsRegistryValueExists) {
+ Write-Log -Message "Registry key value [$Key] [$Value] does exist." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Registry key value [$Key] [$Value] does not exist." -Source ${CmdletName}
+ }
+ Write-Output -InputObject $IsRegistryValueExists
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-RegistryKey
+Function Get-RegistryKey {
+<#
+.SYNOPSIS
+ Retrieves value names and value data for a specified registry key or optionally, a specific value.
+.DESCRIPTION
+ Retrieves value names and value data for a specified registry key or optionally, a specific value.
+ If the registry key does not exist or contain any values, the function will return $null by default. To test for existence of a registry key path, use built-in Test-Path cmdlet.
+.PARAMETER Key
+ Path of the registry key.
+.PARAMETER Value
+ Value to retrieve (optional).
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ReturnEmptyKeyIfExists
+ Return the registry key if it exists but it has no property/value pairs underneath it. Default is: $false.
+.PARAMETER DoNotExpandEnvironmentNames
+ Return unexpanded REG_EXPAND_SZ values. Default is: $false.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\iexplore.exe'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKLM:Software\Wow6432Node\Microsoft\Microsoft SQL Server Compact Edition\v3.5' -Value 'Version'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment' -Value 'Path' -DoNotExpandEnvironmentNames
+ Returns %ProgramFiles%\Java instead of C:\Program Files\Java
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Example' -Value '(Default)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$ReturnEmptyKeyIfExists = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$DoNotExpandEnvironmentNames = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$key = Convert-RegistryPath -Key $key -SID $SID
+ }
+ Else {
+ [string]$key = Convert-RegistryPath -Key $key
+ }
+
+ ## Check if the registry key exists
+ If (-not (Test-Path -LiteralPath $key -ErrorAction 'Stop')) {
+ Write-Log -Message "Registry key [$key] does not exist. Return `$null." -Severity 2 -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ Else {
+ If ($PSBoundParameters.ContainsKey('Value')) {
+ Write-Log -Message "Get registry key [$key] value [$value]." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Get registry key [$key] and all property values." -Source ${CmdletName}
+ }
+
+ ## Get all property values for registry key
+ $regKeyValue = Get-ItemProperty -LiteralPath $key -ErrorAction 'Stop'
+ [int32]$regKeyValuePropertyCount = $regKeyValue | Measure-Object | Select-Object -ExpandProperty 'Count'
+
+ ## Select requested property
+ If ($PSBoundParameters.ContainsKey('Value')) {
+ # Check if registry value exists
+ [boolean]$IsRegistryValueExists = $false
+ If ($regKeyValuePropertyCount -gt 0) {
+ Try {
+ [string[]]$PathProperties = Get-Item -LiteralPath $Key -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Property' -ErrorAction 'Stop'
+ If ($PathProperties -contains $Value) { $IsRegistryValueExists = $true }
+ }
+ Catch { }
+ }
+
+ # Get the Value (do not make a strongly typed variable because it depends entirely on what kind of value is being read)
+ If ($IsRegistryValueExists) {
+ If ($DoNotExpandEnvironmentNames) { #Only useful on 'ExpandString' values
+ If ($Value -like '(Default)') {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($null,$null,[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ }
+ Else {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($Value,$null,[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ }
+ }
+ ElseIf ($Value -like '(Default)') {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($null)
+ }
+ Else {
+ $regKeyValue = $regKeyValue | Select-Object -ExpandProperty $Value -ErrorAction 'SilentlyContinue'
+ }
+ }
+ Else {
+ Write-Log -Message "Registry key value [$Key] [$Value] does not exist. Return `$null." -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ }
+ ## Select all properties or return empty key object
+ Else {
+ If ($regKeyValuePropertyCount -eq 0) {
+ If ($ReturnEmptyKeyIfExists) {
+ Write-Log -Message "No property values found for registry key. Return empty registry key object [$key]." -Source ${CmdletName}
+ $regKeyValue = Get-Item -LiteralPath $key -Force -ErrorAction 'Stop'
+ }
+ Else {
+ Write-Log -Message "No property values found for registry key. Return `$null." -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ }
+ }
+ }
+ Write-Output -InputObject ($regKeyValue)
+ }
+ Catch {
+ If (-not $Value) {
+ Write-Log -Message "Failed to read registry key [$key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read registry key [$key]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to read registry key [$key] value [$value]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read registry key [$key] value [$value]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-RegistryKey
+Function Set-RegistryKey {
+<#
+.SYNOPSIS
+ Creates a registry key name, value, and value data; it sets the same if it already exists.
+.DESCRIPTION
+ Creates a registry key name, value, and value data; it sets the same if it already exists.
+.PARAMETER Key
+ The registry key path.
+.PARAMETER Name
+ The value name.
+.PARAMETER Value
+ The value data.
+.PARAMETER Type
+ The type of registry value to create or set. Options: 'Binary','DWord','ExpandString','MultiString','None','QWord','String','Unknown'. Default: String.
+ Dword should be specified as a decimal.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-RegistryKey -Key $blockedAppPath -Name 'Debugger' -Value $blockedAppDebuggerValue
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE' -Name 'Application' -Type 'Dword' -Value '1'
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce' -Name 'Debugger' -Value $blockedAppDebuggerValue -Type String
+.EXAMPLE
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Example' -Name 'Data' -Value (0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x02,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x02,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x00,0x01,0x01,0x01,0x02,0x02,0x02) -Type 'Binary'
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Example' -Value '(Default)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ $Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Binary','DWord','ExpandString','MultiString','None','QWord','String','Unknown')]
+ [Microsoft.Win32.RegistryValueKind]$Type = 'String',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ [string]$RegistryValueWriteAction = 'set'
+
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$key = Convert-RegistryPath -Key $key -SID $SID
+ }
+ Else {
+ [string]$key = Convert-RegistryPath -Key $key
+ }
+
+ ## Create registry key if it doesn't exist
+ If (-not (Test-Path -LiteralPath $key -ErrorAction 'Stop')) {
+ Try {
+ Write-Log -Message "Create registry key [$key]." -Source ${CmdletName}
+ # No forward slash found in Key. Use New-Item cmdlet to create registry key
+ If ((($Key -split '/').Count - 1) -eq 0)
+ {
+ $null = New-Item -Path $key -ItemType 'Registry' -Force -ErrorAction 'Stop'
+ }
+ # Forward slash was found in Key. Use REG.exe ADD to create registry key
+ Else
+ {
+ [string]$CreateRegkeyResult = & reg.exe Add "$($Key.Substring($Key.IndexOf('::') + 2))"
+ If ($global:LastExitCode -ne 0)
+ {
+ Throw "Failed to create registry key [$Key]"
+ }
+ }
+ }
+ Catch {
+ Throw
+ }
+ }
+
+ If ($Name) {
+ ## Set registry value if it doesn't exist
+ If (-not (Get-ItemProperty -LiteralPath $key -Name $Name -ErrorAction 'SilentlyContinue')) {
+ Write-Log -Message "Set registry key value: [$key] [$name = $value]." -Source ${CmdletName}
+ $null = New-ItemProperty -LiteralPath $key -Name $name -Value $value -PropertyType $Type -ErrorAction 'Stop'
+ }
+ ## Update registry value if it does exist
+ Else {
+ [string]$RegistryValueWriteAction = 'update'
+ If ($Name -eq '(Default)') {
+ ## Set Default registry key value with the following workaround, because Set-ItemProperty contains a bug and cannot set Default registry key value
+ $null = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').OpenSubKey('','ReadWriteSubTree').SetValue($null,$value)
+ }
+ Else {
+ Write-Log -Message "Update registry key value: [$key] [$name = $value]." -Source ${CmdletName}
+ $null = Set-ItemProperty -LiteralPath $key -Name $name -Value $value -ErrorAction 'Stop'
+ }
+ }
+ }
+ }
+ Catch {
+ If ($Name) {
+ Write-Log -Message "Failed to $RegistryValueWriteAction value [$value] for registry key [$key] [$name]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $RegistryValueWriteAction value [$value] for registry key [$key] [$name]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to set registry key [$key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set registry key [$key]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-RegistryKey
+Function Remove-RegistryKey {
+<#
+.SYNOPSIS
+ Deletes the specified registry key or value.
+.DESCRIPTION
+ Deletes the specified registry key or value.
+.PARAMETER Key
+ Path of the registry key to delete.
+.PARAMETER Name
+ Name of the registry value to delete.
+.PARAMETER Recurse
+ Delete registry key recursively.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-RegistryKey -Key 'HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\RunOnce'
+.EXAMPLE
+ Remove-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Run' -Name 'RunAppInstall'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$Key = Convert-RegistryPath -Key $Key -SID $SID
+ }
+ Else {
+ [string]$Key = Convert-RegistryPath -Key $Key
+ }
+
+ If (-not ($Name)) {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ If ($Recurse) {
+ Write-Log -Message "Delete registry key recursively [$Key]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Key -Force -Recurse -ErrorAction 'Stop'
+ }
+ Else {
+ If ($null -eq (Get-ChildItem -LiteralPath $Key -ErrorAction 'Stop')){
+ ## Check if there are subkeys of $Key, if so, executing Remove-Item will hang. Avoiding this with Get-ChildItem.
+ Write-Log -Message "Delete registry key [$Key]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Key -Force -ErrorAction 'Stop'
+ }
+ Else {
+ Throw "Unable to delete child key(s) of [$Key] without [-Recurse] switch."
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Unable to delete registry key [$Key] because it does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Else {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ Write-Log -Message "Delete registry value [$Key] [$Name]." -Source ${CmdletName}
+
+ If ($Name -eq '(Default)') {
+ ## Remove (Default) registry key value with the following workaround because Remove-ItemProperty cannot remove the (Default) registry key value
+ $null = (Get-Item -LiteralPath $Key -ErrorAction 'Stop').OpenSubKey('','ReadWriteSubTree').DeleteValue('')
+ }
+ Else {
+ $null = Remove-ItemProperty -LiteralPath $Key -Name $Name -Force -ErrorAction 'Stop'
+ }
+ }
+ Else {
+ Write-Log -Message "Unable to delete registry value [$Key] [$Name] because registry key does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ Catch [System.Management.Automation.PSArgumentException] {
+ Write-Log -Message "Unable to delete registry value [$Key] [$Name] because it does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ Catch {
+ If (-not ($Name)) {
+ Write-Log -Message "Failed to delete registry key [$Key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete registry key [$Key]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to delete registry value [$Key] [$Name]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete registry value [$Key] [$Name]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-HKCURegistrySettingsForAllUsers
+Function Invoke-HKCURegistrySettingsForAllUsers {
+<#
+.SYNOPSIS
+ Set current user registry settings for all current users and any new users in the future.
+.DESCRIPTION
+ Set HKCU registry settings for all current and future users by loading their NTUSER.dat registry hive file, and making the modifications.
+ This function will modify HKCU settings for all users even when executed under the SYSTEM account.
+ To ensure new users in the future get the registry edits, the Default User registry hive used to provision the registry for new users is modified.
+ This function can be used as an alternative to using ActiveSetup for registry settings.
+ The advantage of using this function over ActiveSetup is that a user does not have to log off and log back on before the changes take effect.
+.PARAMETER RegistrySettings
+ Script block which contains HKCU registry settings which should be modified for all users on the system. Must specify the -SID parameter for all HKCU settings.
+.PARAMETER UserProfiles
+ Specify the user profiles to modify HKCU registry settings for. Default is all user profiles except for system profiles.
+.EXAMPLE
+ [scriptblock]$HKCURegistrySettings = {
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'qmenable' -Value 0 -Type DWord -SID $UserProfile.SID
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'updatereliabilitydata' -Value 1 -Type DWord -SID $UserProfile.SID
+ }
+ Invoke-HKCURegistrySettingsForAllUsers -RegistrySettings $HKCURegistrySettings
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [scriptblock]$RegistrySettings,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [psobject[]]$UserProfiles = (Get-UserProfiles)
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ForEach ($UserProfile in $UserProfiles) {
+ Try {
+ # Set the path to the user's registry hive when it is loaded
+ [string]$UserRegistryPath = "Registry::HKEY_USERS\$($UserProfile.SID)"
+
+ # Set the path to the user's registry hive file
+ [string]$UserRegistryHiveFile = Join-Path -Path $UserProfile.ProfilePath -ChildPath 'NTUSER.DAT'
+
+ # Load the User profile registry hive if it is not already loaded because the User is logged in
+ [boolean]$ManuallyLoadedRegHive = $false
+ If (-not (Test-Path -LiteralPath $UserRegistryPath)) {
+ # Load the User registry hive if the registry hive file exists
+ If (Test-Path -LiteralPath $UserRegistryHiveFile -PathType 'Leaf') {
+ Write-Log -Message "Load the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe load "`"HKEY_USERS\$($UserProfile.SID)`"" "`"$UserRegistryHiveFile`""
+
+ If ($global:LastExitCode -ne 0) {
+ Throw "Failed to load the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. Failure message [$HiveLoadResult]. Continue..."
+ }
+
+ [boolean]$ManuallyLoadedRegHive = $true
+ }
+ Else {
+ Throw "Failed to find the registry hive file [$UserRegistryHiveFile] for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. Continue..."
+ }
+ }
+ Else {
+ Write-Log -Message "The User [$($UserProfile.NTAccount)] registry hive is already loaded in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ }
+
+ ## Execute ScriptBlock which contains code to manipulate HKCU registry.
+ # Make sure read/write calls to the HKCU registry hive specify the -SID parameter or settings will not be changed for all users.
+ # Example: Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'qmenable' -Value 0 -Type DWord -SID $UserProfile.SID
+ Write-Log -Message 'Execute ScriptBlock to modify HKCU registry settings for all users.' -Source ${CmdletName}
+ & $RegistrySettings
+ }
+ Catch {
+ Write-Log -Message "Failed to modify the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)] `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Finally {
+ If ($ManuallyLoadedRegHive) {
+ Try {
+ Write-Log -Message "Unload the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe unload "`"HKEY_USERS\$($UserProfile.SID)`""
+
+ If ($global:LastExitCode -ne 0) {
+ Write-Log -Message "REG.exe failed to unload the registry hive and exited with exit code [$($global:LastExitCode)]. Performing manual garbage collection to ensure successful unloading of registry hive." -Severity 2 -Source ${CmdletName}
+ [GC]::Collect()
+ [GC]::WaitForPendingFinalizers()
+ Start-Sleep -Seconds 5
+
+ Write-Log -Message "Unload the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe unload "`"HKEY_USERS\$($UserProfile.SID)`""
+ If ($global:LastExitCode -ne 0) { Throw "REG.exe failed with exit code [$($global:LastExitCode)] and result [$HiveLoadResult]." }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to unload the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function ConvertTo-NTAccountOrSID
+Function ConvertTo-NTAccountOrSID {
+<#
+.SYNOPSIS
+ Convert between NT Account names and their security identifiers (SIDs).
+.DESCRIPTION
+ Specify either the NT Account name or the SID and get the other. Can also convert well known sid types.
+.PARAMETER AccountName
+ The Windows NT Account name specified in \ format.
+ Use fully qualified account names (e.g., \) instead of isolated names (e.g, ) because they are unambiguous and provide better performance.
+.PARAMETER SID
+ The Windows NT Account SID.
+.PARAMETER WellKnownSIDName
+ Specify the Well Known SID name translate to the actual SID (e.g., LocalServiceSid).
+ To get all well known SIDs available on system: [enum]::GetNames([Security.Principal.WellKnownSidType])
+.PARAMETER WellKnownToNTAccount
+ Convert the Well Known SID to an NTAccount name
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -AccountName 'CONTOSO\User1'
+ Converts a Windows NT Account name to the corresponding SID
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -SID 'S-1-5-21-1220945662-2111687655-725345543-14012660'
+ Converts a Windows NT Account SID to the corresponding NT Account Name
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -WellKnownSIDName 'NetworkServiceSid'
+ Converts a Well Known SID name to a SID
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ The conversion can return an empty result if the user account does not exist anymore or if translation fails.
+ http://blogs.technet.com/b/askds/archive/2011/07/28/troubleshooting-sid-translation-failures-from-the-obvious-to-the-not-so-obvious.aspx
+.LINK
+ http://psappdeploytoolkit.com
+ List of Well Known SIDs: http://msdn.microsoft.com/en-us/library/system.security.principal.wellknownsidtype(v=vs.110).aspx
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='NTAccountToSID',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$AccountName,
+ [Parameter(Mandatory=$true,ParameterSetName='SIDToNTAccount',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$true,ParameterSetName='WellKnownName',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$WellKnownSIDName,
+ [Parameter(Mandatory=$false,ParameterSetName='WellKnownName')]
+ [ValidateNotNullOrEmpty()]
+ [switch]$WellKnownToNTAccount
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Switch ($PSCmdlet.ParameterSetName) {
+ 'SIDToNTAccount' {
+ [string]$msg = "the SID [$SID] to an NT Account name"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ $NTAccountSID = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList $SID
+ $NTAccount = $NTAccountSID.Translate([Security.Principal.NTAccount])
+ Write-Output -InputObject $NTAccount
+ }
+ 'NTAccountToSID' {
+ [string]$msg = "the NT Account [$AccountName] to a SID"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ $NTAccount = New-Object -TypeName 'System.Security.Principal.NTAccount' -ArgumentList $AccountName
+ $NTAccountSID = $NTAccount.Translate([Security.Principal.SecurityIdentifier])
+ Write-Output -InputObject $NTAccountSID
+ }
+ 'WellKnownName' {
+ If ($WellKnownToNTAccount) {
+ [string]$ConversionType = 'NTAccount'
+ }
+ Else {
+ [string]$ConversionType = 'SID'
+ }
+ [string]$msg = "the Well Known SID Name [$WellKnownSIDName] to a $ConversionType"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ # Get the SID for the root domain
+ Try {
+ $MachineRootDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'Stop').Domain.ToLower()
+ $ADDomainObj = New-Object -TypeName 'System.DirectoryServices.DirectoryEntry' -ArgumentList "LDAP://$MachineRootDomain"
+ $DomainSidInBinary = $ADDomainObj.ObjectSid
+ $DomainSid = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ($DomainSidInBinary[0], 0)
+ }
+ Catch {
+ Write-Log -Message 'Unable to get Domain SID from Active Directory. Setting Domain SID to $null.' -Severity 2 -Source ${CmdletName}
+ $DomainSid = $null
+ }
+
+ # Get the SID for the well known SID name
+ $WellKnownSidType = [Security.Principal.WellKnownSidType]::$WellKnownSIDName
+ $NTAccountSID = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ($WellKnownSidType, $DomainSid)
+
+ If ($WellKnownToNTAccount) {
+ $NTAccount = $NTAccountSID.Translate([Security.Principal.NTAccount])
+ Write-Output -InputObject $NTAccount
+ }
+ Else {
+ Write-Output -InputObject $NTAccountSID
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to convert $msg. It may not be a valid account anymore or there is some other problem. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-UserProfiles
+Function Get-UserProfiles {
+<#
+.SYNOPSIS
+ Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine and also the Default User (which does not log on).
+.DESCRIPTION
+ Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine and also the Default User (which does not log on).
+ Please note that the NTAccount property may be empty for some user profiles but the SID and ProfilePath properties will always be populated.
+.PARAMETER ExcludeNTAccount
+ Specify NT account names in Domain\Username format to exclude from the list of user profiles.
+.PARAMETER ExcludeSystemProfiles
+ Exclude system profiles: SYSTEM, LOCAL SERVICE, NETWORK SERVICE. Default is: $true.
+.PARAMETER ExcludeDefaultUser
+ Exclude the Default User. Default is: $false.
+.EXAMPLE
+ Get-UserProfiles
+ Returns the following properties for each user profile on the system: NTAccount, SID, ProfilePath
+.EXAMPLE
+ Get-UserProfiles -ExcludeNTAccount 'CONTOSO\Robot','CONTOSO\ntadmin'
+.EXAMPLE
+ [string[]]$ProfilePaths = Get-UserProfiles | Select-Object -ExpandProperty 'ProfilePath'
+ Returns the user profile path for each user on the system. This information can then be used to make modifications under the user profile on the filesystem.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string[]]$ExcludeNTAccount,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ExcludeSystemProfiles = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$ExcludeDefaultUser = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Get the User Profile Path, User Account SID, and the User Account Name for all users that log onto the machine.' -Source ${CmdletName}
+
+ ## Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine
+ [string]$UserProfileListRegKey = 'Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList'
+ [psobject[]]$UserProfiles = Get-ChildItem -LiteralPath $UserProfileListRegKey -ErrorAction 'Stop' |
+ ForEach-Object {
+ Get-ItemProperty -LiteralPath $_.PSPath -ErrorAction 'Stop' | Where-Object { ($_.ProfileImagePath) } |
+ Select-Object @{ Label = 'NTAccount'; Expression = { $(ConvertTo-NTAccountOrSID -SID $_.PSChildName).Value } }, @{ Label = 'SID'; Expression = { $_.PSChildName } }, @{ Label = 'ProfilePath'; Expression = { $_.ProfileImagePath } }
+ }
+ If ($ExcludeSystemProfiles) {
+ [string[]]$SystemProfiles = 'S-1-5-18', 'S-1-5-19', 'S-1-5-20'
+ [psobject[]]$UserProfiles = $UserProfiles | Where-Object { $SystemProfiles -notcontains $_.SID }
+ }
+ If ($ExcludeNTAccount) {
+ [psobject[]]$UserProfiles = $UserProfiles | Where-Object { $ExcludeNTAccount -notcontains $_.NTAccount }
+ }
+
+ ## Find the path to the Default User profile
+ If (-not $ExcludeDefaultUser) {
+ [string]$UserProfilesDirectory = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'ProfilesDirectory' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'ProfilesDirectory'
+
+ # On Windows Vista or higher
+ If (([version]$envOSVersion).Major -gt 5) {
+ # Path to Default User Profile directory on Windows Vista or higher: By default, C:\Users\Default
+ [string]$DefaultUserProfileDirectory = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'Default' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Default'
+ }
+ # On Windows XP or lower
+ Else {
+ # Default User Profile Name: By default, 'Default User'
+ [string]$DefaultUserProfileName = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'DefaultUserProfile' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'DefaultUserProfile'
+
+ # Path to Default User Profile directory: By default, C:\Documents and Settings\Default User
+ [string]$DefaultUserProfileDirectory = Join-Path -Path $UserProfilesDirectory -ChildPath $DefaultUserProfileName
+ }
+
+ ## Create a custom object for the Default User profile.
+ # Since the Default User is not an actual User account, it does not have a username or a SID.
+ # We will make up a SID and add it to the custom object so that we have a location to load the default registry hive into later on.
+ [psobject]$DefaultUserProfile = New-Object -TypeName 'PSObject' -Property @{
+ NTAccount = 'Default User'
+ SID = 'S-1-5-21-Default-User'
+ ProfilePath = $DefaultUserProfileDirectory
+ }
+
+ ## Add the Default User custom object to the User Profile list.
+ $UserProfiles += $DefaultUserProfile
+ }
+
+ Write-Output -InputObject $UserProfiles
+ }
+ Catch {
+ Write-Log -Message "Failed to create a custom object representing all user profiles on the machine. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-FileVersion
+Function Get-FileVersion {
+<#
+.SYNOPSIS
+ Gets the version of the specified file
+.DESCRIPTION
+ Gets the version of the specified file
+.PARAMETER File
+ Path of the file
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-FileVersion -File "$envProgramFilesX86\Adobe\Reader 11.0\Reader\AcroRd32.exe"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$File,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get file version info for file [$file]." -Source ${CmdletName}
+
+ If (Test-Path -LiteralPath $File -PathType 'Leaf') {
+ $fileVersion = (Get-Command -Name $file -ErrorAction 'Stop').FileVersionInfo.FileVersion
+ If ($fileVersion) {
+ ## Remove product information to leave only the file version
+ $fileVersion = ($fileVersion -split ' ' | Select-Object -First 1)
+
+ Write-Log -Message "File version is [$fileVersion]." -Source ${CmdletName}
+ Write-Output -InputObject $fileVersion
+ }
+ Else {
+ Write-Log -Message 'No file version information found.' -Source ${CmdletName}
+ }
+ }
+ Else {
+ Throw "File path [$file] does not exist."
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get file version info. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get file version info: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-Shortcut
+Function New-Shortcut {
+<#
+.SYNOPSIS
+ Creates a new .lnk or .url type shortcut
+.DESCRIPTION
+ Creates a new shortcut .lnk or .url file, with configurable options
+.PARAMETER Path
+ Path to save the shortcut
+.PARAMETER TargetPath
+ Target path or URL that the shortcut launches
+.PARAMETER Arguments
+ Arguments to be passed to the target path
+.PARAMETER IconLocation
+ Location of the icon used for the shortcut
+.PARAMETER IconIndex
+ Executables, DLLs, ICO files with multiple icons need the icon index to be specified
+.PARAMETER Description
+ Description of the shortcut
+.PARAMETER WorkingDirectory
+ Working Directory to be used for the target path
+.PARAMETER WindowStyle
+ Windows style of the application. Options: Normal, Maximized, Minimized. Default is: Normal.
+.PARAMETER RunAsAdmin
+ Set shortcut to run program as administrator. This option will prompt user to elevate when executing shortcut.
+.PARAMETER Hotkey
+ Create a Hotkey to launch the shortcut, e.g. "CTRL+SHIFT+F"
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ New-Shortcut -Path "$envProgramData\Microsoft\Windows\Start Menu\My Shortcut.lnk" -TargetPath "$envWinDir\system32\notepad.exe" -IconLocation "$envWinDir\system32\notepad.exe" -Description 'Notepad' -WorkingDirectory "$envHomeDrive\$envHomePath"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$TargetPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Arguments,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IconLocation,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IconIndex,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Description,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Normal','Maximized','Minimized')]
+ [string]$WindowStyle,
+ [Parameter(Mandatory=$false)]
+ [switch]$RunAsAdmin,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Hotkey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ If (-not $Shell) { [__comobject]$Shell = New-Object -ComObject 'WScript.Shell' -ErrorAction 'Stop' }
+ }
+ Process {
+ Try {
+ Try {
+ [IO.FileInfo]$Path = [IO.FileInfo]$Path
+ [string]$PathDirectory = $Path.DirectoryName
+
+ If (-not (Test-Path -LiteralPath $PathDirectory -PathType 'Container' -ErrorAction 'Stop')) {
+ Write-Log -Message "Create shortcut directory [$PathDirectory]." -Source ${CmdletName}
+ $null = New-Item -Path $PathDirectory -ItemType 'Directory' -Force -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create shortcut directory [$PathDirectory]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Throw
+ }
+
+ Write-Log -Message "Create shortcut [$($path.FullName)]." -Source ${CmdletName}
+ If (($path.FullName).ToLower().EndsWith('.url')) {
+ [string[]]$URLFile = '[InternetShortcut]'
+ $URLFile += "URL=$targetPath"
+ If ($iconIndex) { $URLFile += "IconIndex=$iconIndex" }
+ If ($IconLocation) { $URLFile += "IconFile=$iconLocation" }
+ $URLFile | Out-File -FilePath $path.FullName -Force -Encoding 'default' -ErrorAction 'Stop'
+ }
+ ElseIf (($path.FullName).ToLower().EndsWith('.lnk')) {
+ If (($iconLocation -and $iconIndex) -and (-not ($iconLocation.Contains(',')))) {
+ $iconLocation = $iconLocation + ",$iconIndex"
+ }
+ Switch ($windowStyle) {
+ 'Normal' { $windowStyleInt = 1 }
+ 'Maximized' { $windowStyleInt = 3 }
+ 'Minimized' { $windowStyleInt = 7 }
+ Default { $windowStyleInt = 1 }
+ }
+ $shortcut = $shell.CreateShortcut($path.FullName)
+ $shortcut.TargetPath = $targetPath
+ $shortcut.Arguments = $arguments
+ $shortcut.Description = $description
+ $shortcut.WorkingDirectory = $workingDirectory
+ $shortcut.WindowStyle = $windowStyleInt
+ If ($hotkey) {$shortcut.Hotkey = $hotkey}
+ If ($iconLocation) { $shortcut.IconLocation = $iconLocation }
+ $shortcut.Save()
+
+ ## Set shortcut to run program as administrator
+ If ($RunAsAdmin) {
+ Write-Log -Message 'Set shortcut to run program as administrator.' -Source ${CmdletName}
+ $TempFileName = [IO.Path]::GetRandomFileName()
+ $TempFile = [IO.FileInfo][IO.Path]::Combine($Path.Directory, $TempFileName)
+ $Writer = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($TempFile, ([IO.FileMode]::Create)) -ErrorAction 'Stop'
+ $Reader = $Path.OpenRead()
+ While ($Reader.Position -lt $Reader.Length) {
+ $Byte = $Reader.ReadByte()
+ If ($Reader.Position -eq 22) { $Byte = 34 }
+ $Writer.WriteByte($Byte)
+ }
+ $Reader.Close()
+ $Writer.Close()
+ $Path.Delete()
+ $null = Rename-Item -Path $TempFile -NewName $Path.Name -Force -ErrorAction 'Stop'
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create shortcut [$($path.FullName)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create shortcut [$($path.FullName)]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-ProcessAsUser
+Function Execute-ProcessAsUser {
+<#
+.SYNOPSIS
+ Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.
+.DESCRIPTION
+ Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.
+.PARAMETER UserName
+ Logged in Username under which to run the process from. Default is: The active console user. If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user.
+.PARAMETER Path
+ Path to the file being executed.
+.PARAMETER Parameters
+ Arguments to be passed to the file being executed.
+.PARAMETER SecureParameters
+ Hides all parameters passed to the executable from the Toolkit log file.
+.PARAMETER RunLevel
+ Specifies the level of user rights that Task Scheduler uses to run the task. The acceptable values for this parameter are:
+ - HighestAvailable: Tasks run by using the highest available privileges (Admin privileges for Administrators). Default Value.
+ - LeastPrivilege: Tasks run by using the least-privileged user account (LUA) privileges.
+.PARAMETER Wait
+ Wait for the process, launched by the scheduled task, to complete execution before accepting more input. Default is $false.
+.PARAMETER PassThru
+ Returns the exit code from this function or the process launched by the scheduled task.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is $true.
+.EXAMPLE
+ Execute-ProcessAsUser -UserName 'CONTOSO\User' -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & `"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait
+ Execute process under a user account by specifying a username under which to execute it.
+.EXAMPLE
+ Execute-ProcessAsUser -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & `"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait
+ Execute process under a user account by using the default active logged in user that was detected when the toolkit was launched.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$UserName = $RunAsActiveUser.NTAccount,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters = '',
+ [Parameter(Mandatory=$false)]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('HighestAvailable','LeastPrivilege')]
+ [string]$RunLevel = 'HighestAvailable',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$Wait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Initialize exit code variable
+ [int32]$executeProcessAsUserExitCode = 0
+
+ ## Confirm that the username field is not empty
+ If (-not $UserName) {
+ [int32]$executeProcessAsUserExitCode = 60009
+ Write-Log -Message "The function [${CmdletName}] has a -UserName parameter that has an empty default value because no logged in users were detected when the toolkit was launched." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The function [${CmdletName}] has a -UserName parameter that has an empty default value because no logged in users were detected when the toolkit was launched."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Confirm if the toolkit is running with administrator privileges
+ If (($RunLevel -eq 'HighestAvailable') -and (-not $IsAdmin)) {
+ [int32]$executeProcessAsUserExitCode = 60003
+ Write-Log -Message "The function [${CmdletName}] requires the toolkit to be running with Administrator privileges if the [-RunLevel] parameter is set to 'HighestAvailable'." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The function [${CmdletName}] requires the toolkit to be running with Administrator privileges if the [-RunLevel] parameter is set to 'HighestAvailable'."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Build the scheduled task XML name
+ [string]$schTaskName = "$appDeployToolkitName-ExecuteAsUser"
+
+ ## Create the temporary App Deploy Toolkit files folder if it doesn't already exist
+ If (-not (Test-Path -LiteralPath $dirAppDeployTemp -PathType 'Container')) {
+ New-Item -Path $dirAppDeployTemp -ItemType 'Directory' -Force -ErrorAction 'Stop'
+ }
+
+ ## If PowerShell.exe is being launched, then create a VBScript to launch PowerShell so that we can suppress the console window that flashes otherwise
+ If (($Path -eq 'PowerShell.exe') -or ((Split-Path -Path $Path -Leaf) -eq 'PowerShell.exe')) {
+ # Permit inclusion of double quotes in parameters
+ If ($($Parameters.Substring($Parameters.Length - 1)) -eq '"') {
+ [string]$executeProcessAsUserParametersVBS = 'chr(34) & ' + "`"$($Path)`"" + ' & chr(34) & ' + '" ' + ($Parameters -replace '"', "`" & chr(34) & `"" -replace ' & chr\(34\) & "$', '') + ' & chr(34)' }
+ Else {
+ [string]$executeProcessAsUserParametersVBS = 'chr(34) & ' + "`"$($Path)`"" + ' & chr(34) & ' + '" ' + ($Parameters -replace '"', "`" & chr(34) & `"" -replace ' & chr\(34\) & "$','') + '"' }
+ [string[]]$executeProcessAsUserScript = "strCommand = $executeProcessAsUserParametersVBS"
+ $executeProcessAsUserScript += 'set oWShell = CreateObject("WScript.Shell")'
+ $executeProcessAsUserScript += 'intReturn = oWShell.Run(strCommand, 0, true)'
+ $executeProcessAsUserScript += 'WScript.Quit intReturn'
+ $executeProcessAsUserScript | Out-File -FilePath "$dirAppDeployTemp\$($schTaskName).vbs" -Force -Encoding 'default' -ErrorAction 'SilentlyContinue'
+ $Path = 'wscript.exe'
+ $Parameters = "`"$dirAppDeployTemp\$($schTaskName).vbs`""
+ }
+
+ ## Specify the scheduled task configuration in XML format
+ [string]$xmlSchTask = @"
+
+
+
+
+
+ StopExisting
+ false
+ false
+ true
+ false
+ false
+
+ false
+ false
+
+ true
+ true
+ false
+ false
+ false
+ PT72H
+ 7
+
+
+
+ $Path
+ $Parameters
+
+
+
+
+ $UserName
+ InteractiveToken
+ $RunLevel
+
+
+
+"@
+ ## Export the XML to file
+ Try {
+ # Specify the filename to export the XML to
+ [string]$xmlSchTaskFilePath = "$dirAppDeployTemp\$schTaskName.xml"
+ [string]$xmlSchTask | Out-File -FilePath $xmlSchTaskFilePath -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ [int32]$executeProcessAsUserExitCode = 60007
+ Write-Log -Message "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]: $($_.Exception.Message)"
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Create Scheduled Task to run the process with a logged-on user account
+ If ($Parameters) {
+ If ($SecureParameters) {
+ Write-Log -Message "Create scheduled task to run the process [$Path] (Parameters Hidden) as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Create scheduled task to run the process [$Path $Parameters] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message "Create scheduled task to run the process [$Path] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/create /f /tn $schTaskName /xml `"$xmlSchTaskFilePath`"" -WindowStyle 'Hidden' -CreateNoWindow -PassThru
+ If ($schTaskResult.ExitCode -ne 0) {
+ [int32]$executeProcessAsUserExitCode = $schTaskResult.ExitCode
+ Write-Log -Message "Failed to create the scheduled task by importing the scheduled task XML file [$xmlSchTaskFilePath]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create the scheduled task by importing the scheduled task XML file [$xmlSchTaskFilePath]."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Trigger the Scheduled Task
+ If ($Parameters) {
+ If ($SecureParameters) {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path] (Parameters Hidden) as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path $Parameters] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/run /i /tn $schTaskName" -WindowStyle 'Hidden' -CreateNoWindow -Passthru
+ If ($schTaskResult.ExitCode -ne 0) {
+ [int32]$executeProcessAsUserExitCode = $schTaskResult.ExitCode
+ Write-Log -Message "Failed to trigger scheduled task [$schTaskName]." -Severity 3 -Source ${CmdletName}
+ # Delete Scheduled Task
+ Write-Log -Message 'Delete the scheduled task which did not trigger.' -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/delete /tn $schTaskName /f" -WindowStyle 'Hidden' -CreateNoWindow -ContinueOnError $true
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger scheduled task [$schTaskName]."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Wait for the process launched by the scheduled task to complete execution
+ If ($Wait) {
+ Write-Log -Message "Waiting for the process launched by the scheduled task [$schTaskName] to complete execution (this may take some time)..." -Source ${CmdletName}
+ Start-Sleep -Seconds 1
+ #If on Windows Vista or higer, Windows Task Scheduler 2.0 is supported. 'Schedule.Service' ComObject output is UI language independent
+ If (([version]$envOSVersion).Major -gt 5) {
+ Try {
+ [__comobject]$ScheduleService = New-Object -ComObject 'Schedule.Service' -ErrorAction Stop
+ $ScheduleService.Connect()
+ $RootFolder = $ScheduleService.GetFolder('\')
+ $Task = $RootFolder.GetTask("$schTaskName")
+ # Task State(Status) 4 = 'Running'
+ While ($Task.State -eq 4) {
+ Start-Sleep -Seconds 5
+ }
+ # Get the exit code from the process launched by the scheduled task
+ [int32]$executeProcessAsUserExitCode = $Task.LastTaskResult
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve information from Task Scheduler. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Finally {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($ScheduleService) } Catch { }
+ }
+ }
+ #Windows Task Scheduler 1.0
+ Else {
+ While ((($exeSchTasksResult = & $exeSchTasks /query /TN $schTaskName /V /FO CSV) | ConvertFrom-CSV | Select-Object -ExpandProperty 'Status' | Select-Object -First 1) -eq 'Running') {
+ Start-Sleep -Seconds 5
+ }
+ # Get the exit code from the process launched by the scheduled task
+ [int32]$executeProcessAsUserExitCode = ($exeSchTasksResult = & $exeSchTasks /query /TN $schTaskName /V /FO CSV) | ConvertFrom-CSV | Select-Object -ExpandProperty 'Last Result' | Select-Object -First 1
+ }
+ Write-Log -Message "Exit code from process launched by scheduled task [$executeProcessAsUserExitCode]." -Source ${CmdletName}
+ }
+ Else {
+ Start-Sleep -Seconds 1
+ }
+
+ ## Delete scheduled task
+ Try {
+ Write-Log -Message "Delete scheduled task [$schTaskName]." -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/delete /tn $schTaskName /f" -WindowStyle 'Hidden' -CreateNoWindow -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to delete scheduled task [$schTaskName]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $executeProcessAsUserExitCode }
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Update-Desktop
+Function Update-Desktop {
+<#
+.SYNOPSIS
+ Refresh the Windows Explorer Shell, which causes the desktop icons and the environment variables to be reloaded.
+.DESCRIPTION
+ Refresh the Windows Explorer Shell, which causes the desktop icons and the environment variables to be reloaded.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-Desktop
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Refresh the Desktop and the Windows Explorer environment process block.' -Source ${CmdletName}
+ [PSADT.Explorer]::RefreshDesktopAndEnvironmentVariables()
+ }
+ Catch {
+ Write-Log -Message "Failed to refresh the Desktop and the Windows Explorer environment process block. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to refresh the Desktop and the Windows Explorer environment process block: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Refresh-Desktop' -Value 'Update-Desktop' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Update-SessionEnvironmentVariables
+Function Update-SessionEnvironmentVariables {
+<#
+.SYNOPSIS
+ Updates the environment variables for the current PowerShell session with any environment variable changes that may have occurred during script execution.
+.DESCRIPTION
+ Environment variable changes that take place during script execution are not visible to the current PowerShell session.
+ Use this function to refresh the current PowerShell session with all environment variable settings.
+.PARAMETER LoadLoggedOnUserEnvironmentVariables
+ If script is running in SYSTEM context, this option allows loading environment variables from the active console user. If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-SessionEnvironmentVariables
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$LoadLoggedOnUserEnvironmentVariables = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ [scriptblock]$GetEnvironmentVar = {
+ Param (
+ $Key,
+ $Scope
+ )
+ [Environment]::GetEnvironmentVariable($Key, $Scope)
+ }
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Refresh the environment variables for this PowerShell session.' -Source ${CmdletName}
+
+ If ($LoadLoggedOnUserEnvironmentVariables -and $RunAsActiveUser) {
+ [string]$CurrentUserEnvironmentSID = $RunAsActiveUser.SID
+ }
+ Else {
+ [string]$CurrentUserEnvironmentSID = [Security.Principal.WindowsIdentity]::GetCurrent().User.Value
+ }
+ [string]$MachineEnvironmentVars = 'Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
+ [string]$UserEnvironmentVars = "Registry::HKEY_USERS\$CurrentUserEnvironmentSID\Environment"
+
+ ## Update all session environment variables. Ordering is important here: $UserEnvironmentVars comes second so that we can override $MachineEnvironmentVars.
+ $MachineEnvironmentVars, $UserEnvironmentVars | Get-Item | Where-Object { $_ } | ForEach-Object { $envRegPath = $_.PSPath; $_ | Select-Object -ExpandProperty 'Property' | ForEach-Object { Set-Item -LiteralPath "env:$($_)" -Value (Get-ItemProperty -LiteralPath $envRegPath -Name $_).$_ } }
+
+ ## Set PATH environment variable separately because it is a combination of the user and machine environment variables
+ [string[]]$PathFolders = 'Machine', 'User' | ForEach-Object { (& $GetEnvironmentVar -Key 'PATH' -Scope $_) } | Where-Object { $_ } | ForEach-Object { $_.Trim(';') } | ForEach-Object { $_.Split(';') } | ForEach-Object { $_.Trim() } | ForEach-Object { $_.Trim('"') } | Select-Object -Unique
+ $env:PATH = $PathFolders -join ';'
+ }
+ Catch {
+ Write-Log -Message "Failed to refresh the environment variables for this PowerShell session. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to refresh the environment variables for this PowerShell session: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Refresh-SessionEnvironmentVariables' -Value 'Update-SessionEnvironmentVariables' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Get-ScheduledTask
+Function Get-ScheduledTask {
+<#
+.SYNOPSIS
+ Retrieve all details for scheduled tasks on the local computer.
+.DESCRIPTION
+ Retrieve all details for scheduled tasks on the local computer using schtasks.exe. All property names have spaces and colons removed.
+.PARAMETER TaskName
+ Specify the name of the scheduled task to retrieve details for. Uses regex match to find scheduled task.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $true.
+.EXAMPLE
+ Get-ScheduledTask
+ To display a list of all scheduled task properties.
+.EXAMPLE
+ Get-ScheduledTask | Out-GridView
+ To display a grid view of all scheduled task properties.
+.EXAMPLE
+ Get-ScheduledTask | Select-Object -Property TaskName
+ To display a list of all scheduled task names.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$TaskName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ If (-not $exeSchTasks) { [string]$exeSchTasks = "$env:WINDIR\system32\schtasks.exe" }
+ [psobject[]]$ScheduledTasks = @()
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Retrieve Scheduled Tasks...' -Source ${CmdletName}
+ [string[]]$exeSchtasksResults = & $exeSchTasks /Query /V /FO CSV
+ If ($global:LastExitCode -ne 0) { Throw "Failed to retrieve scheduled tasks using [$exeSchTasks]." }
+ [psobject[]]$SchtasksResults = $exeSchtasksResults | ConvertFrom-CSV -Header 'HostName', 'TaskName', 'Next Run Time', 'Status', 'Logon Mode', 'Last Run Time', 'Last Result', 'Author', 'Task To Run', 'Start In', 'Comment', 'Scheduled Task State', 'Idle Time', 'Power Management', 'Run As User', 'Delete Task If Not Rescheduled', 'Stop Task If Runs X Hours and X Mins', 'Schedule', 'Schedule Type', 'Start Time', 'Start Date', 'End Date', 'Days', 'Months', 'Repeat: Every', 'Repeat: Until: Time', 'Repeat: Until: Duration', 'Repeat: Stop If Still Running' -ErrorAction 'Stop'
+
+ If ($SchtasksResults) {
+ ForEach ($SchtasksResult in $SchtasksResults) {
+ If ($SchtasksResult.TaskName -match $TaskName) {
+ $SchtasksResult | Get-Member -MemberType 'Properties' |
+ ForEach -Begin {
+ [hashtable]$Task = @{}
+ } -Process {
+ ## Remove spaces and colons in property names. Do not set property value if line being processed is a column header (this will only work on English language machines).
+ ($Task.($($_.Name).Replace(' ','').Replace(':',''))) = If ($_.Name -ne $SchtasksResult.($_.Name)) { $SchtasksResult.($_.Name) }
+ } -End {
+ ## Only add task to the custom object if all property values are not empty
+ If (($Task.Values | Select-Object -Unique | Measure-Object).Count) {
+ $ScheduledTasks += New-Object -TypeName 'PSObject' -Property $Task
+ }
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve scheduled tasks. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve scheduled tasks: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-Output -InputObject $ScheduledTasks
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Block-AppExecution
+Function Block-AppExecution {
+<#
+.SYNOPSIS
+ Block the execution of an application(s)
+.DESCRIPTION
+ This function is called when you pass the -BlockExecution parameter to the Stop-RunningApplications function. It does the following:
+ 1. Makes a copy of this script in a temporary directory on the local machine.
+ 2. Checks for an existing scheduled task from previous failed installation attempt where apps were blocked and if found, calls the Unblock-AppExecution function to restore the original IFEO registry keys.
+ This is to prevent the function from overriding the backup of the original IFEO options.
+ 3. Creates a scheduled task to restore the IFEO registry key values in case the script is terminated uncleanly by calling the local temporary copy of this script with the parameter -CleanupBlockedApps.
+ 4. Modifies the "Image File Execution Options" registry key for the specified process(s) to call this script with the parameter -ShowBlockedAppDialog.
+ 5. When the script is called with those parameters, it will display a custom message to the user to indicate that execution of the application has been blocked while the installation is in progress.
+ The text of this message can be customized in the XML configuration file.
+.PARAMETER ProcessName
+ Name of the process or processes separated by commas
+.EXAMPLE
+ Block-AppExecution -ProcessName ('winword','excel')
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ It is used when the -BlockExecution parameter is specified with the Show-InstallationWelcome function to block applications.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ ## Specify process names separated by commas
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$ProcessName
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Remove illegal characters from the scheduled task arguments string
+ [char[]]$invalidScheduledTaskChars = '$', '!', '''', '"', '(', ')', ';', '\', '`', '*', '?', '{', '}', '[', ']', '<', '>', '|', '&', '%', '#', '~', '@', ' '
+ [string]$SchInstallName = $installName
+ ForEach ($invalidChar in $invalidScheduledTaskChars) { [string]$SchInstallName = $SchInstallName -replace [regex]::Escape($invalidChar),'' }
+ [string]$schTaskUnblockAppsCommand += "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$dirAppDeployTemp\$scriptFileName`" -CleanupBlockedApps -ReferredInstallName `"$SchInstallName`" -ReferredInstallTitle `"$installTitle`" -ReferredLogName `"$logName`" -AsyncToolkitLaunch"
+ ## Specify the scheduled task configuration in XML format
+ [string]$xmlUnblockAppsSchTask = @"
+
+
+
+
+
+ true
+
+
+
+
+ S-1-5-18
+
+
+
+ IgnoreNew
+ false
+ false
+ true
+ false
+ false
+
+ false
+ false
+
+ true
+ true
+ false
+ false
+ false
+ PT1H
+ 7
+
+
+
+ powershell.exe
+ $schTaskUnblockAppsCommand
+
+
+
+"@
+ }
+ Process {
+ ## Bypass if in NonInteractive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Function [${CmdletName}] [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+
+ [string]$schTaskBlockedAppsName = $installName + '_BlockedApps'
+
+ ## Delete this file if it exists as it can cause failures (it is a bug from an older version of the toolkit)
+ If (Test-Path -LiteralPath "$configToolkitTempPath\PSAppDeployToolkit" -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ $null = Remove-Item -LiteralPath "$configToolkitTempPath\PSAppDeployToolkit" -Force -ErrorAction 'SilentlyContinue'
+ }
+ ## Create Temporary directory (if required) and copy Toolkit so it can be called by scheduled task later if required
+ If (-not (Test-Path -LiteralPath $dirAppDeployTemp -PathType 'Container' -ErrorAction 'SilentlyContinue')) {
+ $null = New-Item -Path $dirAppDeployTemp -ItemType 'Directory' -ErrorAction 'SilentlyContinue'
+ }
+
+ Copy-Item -Path "$scriptRoot\*.*" -Destination $dirAppDeployTemp -Exclude 'thumbs.db' -Force -Recurse -ErrorAction 'SilentlyContinue'
+
+ ## Build the debugger block value script
+ [string]$debuggerBlockMessageCmd = "`"powershell.exe -ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `" & chr(34) & `"$dirAppDeployTemp\$scriptFileName`" & chr(34) & `" -ShowBlockedAppDialog -AsyncToolkitLaunch -ReferredInstallTitle `" & chr(34) & `"$installTitle`" & chr(34)"
+ [string[]]$debuggerBlockScript = "strCommand = $debuggerBlockMessageCmd"
+ $debuggerBlockScript += 'set oWShell = CreateObject("WScript.Shell")'
+ $debuggerBlockScript += 'oWShell.Run strCommand, 0, false'
+ $debuggerBlockScript | Out-File -FilePath "$dirAppDeployTemp\AppDeployToolkit_BlockAppExecutionMessage.vbs" -Force -Encoding 'default' -ErrorAction 'SilentlyContinue'
+ [string]$debuggerBlockValue = "wscript.exe `"$dirAppDeployTemp\AppDeployToolkit_BlockAppExecutionMessage.vbs`""
+
+ ## Create a scheduled task to run on startup to call this script and clean up blocked applications in case the installation is interrupted, e.g. user shuts down during installation"
+ Write-Log -Message 'Create scheduled task to cleanup blocked applications in case installation is interrupted.' -Source ${CmdletName}
+ If (Get-ScheduledTask -ContinueOnError $true | Select-Object -Property 'TaskName' | Where-Object { $_.TaskName -eq "\$schTaskBlockedAppsName" }) {
+ Write-Log -Message "Scheduled task [$schTaskBlockedAppsName] already exists." -Source ${CmdletName}
+ }
+ Else {
+ ## Export the scheduled task XML to file
+ Try {
+ # Specify the filename to export the XML to
+ [string]$xmlSchTaskFilePath = "$dirAppDeployTemp\SchTaskUnBlockApps.xml"
+ [string]$xmlUnblockAppsSchTask | Out-File -FilePath $xmlSchTaskFilePath -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Return
+ }
+
+ ## Import the Scheduled Task XML file to create the Scheduled Task
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/create /f /tn $schTaskBlockedAppsName /xml `"$xmlSchTaskFilePath`"" -WindowStyle 'Hidden' -CreateNoWindow -PassThru
+ If ($schTaskResult.ExitCode -ne 0) {
+ Write-Log -Message "Failed to create the scheduled task [$schTaskBlockedAppsName] by importing the scheduled task XML file [$xmlSchTaskFilePath]." -Severity 3 -Source ${CmdletName}
+ Return
+ }
+ }
+
+ [string[]]$blockProcessName = $processName
+ ## Append .exe to match registry keys
+ [string[]]$blockProcessName = $blockProcessName | ForEach-Object { $_ + '.exe' } -ErrorAction 'SilentlyContinue'
+
+ ## Enumerate each process and set the debugger value to block application execution
+ ForEach ($blockProcess in $blockProcessName) {
+ Write-Log -Message "Set the Image File Execution Option registry key to block execution of [$blockProcess]." -Source ${CmdletName}
+ Set-RegistryKey -Key (Join-Path -Path $regKeyAppExecution -ChildPath $blockProcess) -Name 'Debugger' -Value $debuggerBlockValue -ContinueOnError $true
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Unblock-AppExecution
+Function Unblock-AppExecution {
+<#
+.SYNOPSIS
+ Unblocks the execution of applications performed by the Block-AppExecution function
+.DESCRIPTION
+ This function is called by the Exit-Script function or when the script itself is called with the parameters -CleanupBlockedApps
+.EXAMPLE
+ Unblock-AppExecution
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ It is used when the -BlockExecution parameter is specified with the Show-InstallationWelcome function to undo the actions performed by Block-AppExecution.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in NonInteractive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Function [${CmdletName}] [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+
+ ## Remove Debugger values to unblock processes
+ [psobject[]]$unblockProcesses = $null
+ [psobject[]]$unblockProcesses += (Get-ChildItem -LiteralPath $regKeyAppExecution -Recurse -ErrorAction 'SilentlyContinue' | ForEach-Object { Get-ItemProperty -LiteralPath $_.PSPath -ErrorAction 'SilentlyContinue'})
+ ForEach ($unblockProcess in ($unblockProcesses | Where-Object { $_.Debugger -like '*AppDeployToolkit_BlockAppExecutionMessage*' })) {
+ Write-Log -Message "Remove the Image File Execution Options registry key to unblock execution of [$($unblockProcess.PSChildName)]." -Source ${CmdletName}
+ $unblockProcess | Remove-ItemProperty -Name 'Debugger' -ErrorAction 'SilentlyContinue'
+ }
+
+ ## If block execution variable is $true, set it to $false
+ If ($BlockExecution) {
+ # Make this variable globally available so we can check whether we need to call Unblock-AppExecution
+ Set-Variable -Name 'BlockExecution' -Value $false -Scope 'Script'
+ }
+
+ ## Remove the scheduled task if it exists
+ [string]$schTaskBlockedAppsName = $installName + '_BlockedApps'
+ Try {
+ If (Get-ScheduledTask -ContinueOnError $true | Select-Object -Property 'TaskName' | Where-Object { $_.TaskName -eq "\$schTaskBlockedAppsName" }) {
+ Write-Log -Message "Delete Scheduled Task [$schTaskBlockedAppsName]." -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/Delete /TN $schTaskBlockedAppsName /F"
+ }
+ }
+ Catch {
+ Write-Log -Message "Error retrieving/deleting Scheduled Task.`n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-DeferHistory
+Function Get-DeferHistory {
+<#
+.SYNOPSIS
+ Get the history of deferrals from the registry for the current application, if it exists.
+.DESCRIPTION
+ Get the history of deferrals from the registry for the current application, if it exists.
+.EXAMPLE
+ Get-DeferHistory
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message 'Get deferral history...' -Source ${CmdletName}
+ Get-RegistryKey -Key $regKeyDeferHistory -ContinueOnError $true
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-DeferHistory
+Function Set-DeferHistory {
+<#
+.SYNOPSIS
+ Set the history of deferrals in the registry for the current application.
+.DESCRIPTION
+ Set the history of deferrals in the registry for the current application.
+.EXAMPLE
+ Set-DeferHistory
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [string]$deferTimesRemaining,
+ [Parameter(Mandatory=$false)]
+ [string]$deferDeadline
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($deferTimesRemaining -and ($deferTimesRemaining -ge 0)) {
+ Write-Log -Message "Set deferral history: [DeferTimesRemaining = $deferTimesRemaining]." -Source ${CmdletName}
+ Set-RegistryKey -Key $regKeyDeferHistory -Name 'DeferTimesRemaining' -Value $deferTimesRemaining -ContinueOnError $true
+ }
+ If ($deferDeadline) {
+ Write-Log -Message "Set deferral history: [DeferDeadline = $deferDeadline]." -Source ${CmdletName}
+ Set-RegistryKey -Key $regKeyDeferHistory -Name 'DeferDeadline' -Value $deferDeadline -ContinueOnError $true
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-UniversalDate
+Function Get-UniversalDate {
+<#
+.SYNOPSIS
+ Returns the date/time for the local culture in a universal sortable date time pattern.
+.DESCRIPTION
+ Converts the current datetime or a datetime string for the current culture into a universal sortable date time pattern, e.g. 2013-08-22 11:51:52Z
+.PARAMETER DateTime
+ Specify the DateTime in the current culture.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $false.
+.EXAMPLE
+ Get-UniversalDate
+ Returns the current date in a universal sortable date time pattern.
+.EXAMPLE
+ Get-UniversalDate -DateTime '25/08/2013'
+ Returns the date for the current culture in a universal sortable date time pattern.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ # Get the current date
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$DateTime = ((Get-Date -Format ($culture).DateTimeFormat.FullDateTimePattern).ToString()),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If a universal sortable date time pattern was provided, remove the Z, otherwise it could get converted to a different time zone.
+ If ($DateTime -match 'Z$') { $DateTime = $DateTime -replace 'Z$', '' }
+ [datetime]$DateTime = [datetime]::Parse($DateTime, $culture)
+
+ ## Convert the date to a universal sortable date time pattern based on the current culture
+ Write-Log -Message "Convert the date [$DateTime] to a universal sortable date time pattern based on the current culture [$($culture.Name)]." -Source ${CmdletName}
+ [string]$universalDateTime = (Get-Date -Date $DateTime -Format ($culture).DateTimeFormat.UniversalSortableDateTimePattern -ErrorAction 'Stop').ToString()
+ Write-Output -InputObject $universalDateTime
+ }
+ Catch {
+ Write-Log -Message "The specified date/time [$DateTime] is not in a format recognized by the current culture [$($culture.Name)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The specified date/time [$DateTime] is not in a format recognized by the current culture: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-RunningProcesses
+Function Get-RunningProcesses {
+<#
+.SYNOPSIS
+ Gets the processes that are running from a custom list of process objects and also adds a property called ProcessDescription.
+.DESCRIPTION
+ Gets the processes that are running from a custom list of process objects and also adds a property called ProcessDescription.
+.PARAMETER ProcessObjects
+ Custom object containing the process objects to search for.
+.EXAMPLE
+ Get-RunningProcesses
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [psobject[]]$ProcessObjects,
+ [Parameter(Mandatory=$false,Position=1)]
+ [switch]$DisableLogging
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($processObjects) {
+ [string]$runningAppsCheck = ($processObjects | ForEach-Object { $_.ProcessName }) -join ','
+ If (-not($DisableLogging)) {
+ Write-Log -Message "Check for running application(s) [$runningAppsCheck]..." -Source ${CmdletName}
+ }
+ ## Create an array of process names to search for
+ [string[]]$processNames = $processObjects | ForEach-Object { $_.ProcessName }
+
+ ## Get all running processes and escape special characters. Match against the process names to search for to find running processes.
+ [Diagnostics.Process[]]$runningProcesses = Get-Process | Where-Object { $processNames -contains $_.ProcessName }
+
+ If ($runningProcesses) {
+ [string]$runningProcessList = ($runningProcesses | ForEach-Object { $_.ProcessName } | Select-Object -Unique) -join ','
+ If (-not($DisableLogging)) {
+ Write-Log -Message "The following processes are running: [$runningProcessList]." -Source ${CmdletName}
+ Write-Log -Message 'Resolve process descriptions...' -Source ${CmdletName}
+ }
+ ## Resolve the running process names to descriptions
+ ForEach ($runningProcess in $runningProcesses) {
+ ForEach ($processObject in $processObjects) {
+ If ($runningProcess.ProcessName -eq $processObject.ProcessName) {
+ If ($processObject.ProcessDescription) {
+ # The description of the process provided as a Parameter to the function, e.g. -ProcessName "winword=Microsoft Office Word".
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $processObject.ProcessDescription -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ ElseIf ($runningProcess.Description) {
+ # If the process already has a description field specified, then use it
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $runningProcess.Description -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ # Fall back on the process name if no description is provided by the process or as a parameter to the function
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $runningProcess.ProcessName -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+ }
+ }
+ Else {
+ If (-not($DisableLogging)) {
+ Write-Log -Message 'Application(s) are not running.' -Source ${CmdletName}
+ }
+ }
+ Write-Output -InputObject $runningProcesses
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationWelcome
+Function Show-InstallationWelcome {
+<#
+.SYNOPSIS
+ Show a welcome dialog prompting the user with information about the installation and actions to be performed before the installation can begin.
+.DESCRIPTION
+ The following prompts can be included in the welcome dialog:
+ a) Close the specified running applications, or optionally close the applications without showing a prompt (using the -Silent switch).
+ b) Defer the installation a certain number of times, for a certain number of days or until a deadline is reached.
+ c) Countdown until applications are automatically closed.
+ d) Prevent users from launching the specified applications while the installation is in progress.
+ Notes:
+ The process descriptions are retrieved from WMI, with a fall back on the process name if no description is available. Alternatively, you can specify the description yourself with a '=' symbol - see examples.
+ The dialog box will timeout after the timeout specified in the XML configuration file (default 1 hour and 55 minutes) to prevent SCCM installations from timing out and returning a failure code to SCCM. When the dialog times out, the script will exit and return a 1618 code (SCCM fast retry code).
+.PARAMETER CloseApps
+ Name of the process to stop (do not include the .exe). Specify multiple processes separated by a comma. Specify custom descriptions like this: "winword=Microsoft Office Word,excel=Microsoft Office Excel"
+.PARAMETER Silent
+ Stop processes without prompting the user.
+.PARAMETER CloseAppsCountdown
+ Option to provide a countdown in seconds until the specified applications are automatically closed. This only takes effect if deferral is not allowed or has expired.
+.PARAMETER ForceCloseAppsCountdown
+ Option to provide a countdown in seconds until the specified applications are automatically closed regardless of whether deferral is allowed.
+.PARAMETER PromptToSave
+ Specify whether to prompt to save working documents when the user chooses to close applications by selecting the "Close Programs" button. Option does not work in SYSTEM context unless toolkit launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds. The user will have no option but to respond to the prompt. This only takes effect if deferral is not allowed or has expired.
+.PARAMETER BlockExecution
+ Option to prevent the user from launching the process/application during the installation.
+.PARAMETER AllowDefer
+ Enables an optional defer button to allow the user to defer the installation.
+.PARAMETER AllowDeferCloseApps
+ Enables an optional defer button to allow the user to defer the installation only if there are running applications that need to be closed.
+.PARAMETER DeferTimes
+ Specify the number of times the installation can be deferred.
+.PARAMETER DeferDays
+ Specify the number of days since first run that the installation can be deferred. This is converted to a deadline.
+.PARAMETER DeferDeadline
+ Specify the deadline date until which the installation can be deferred.
+ Specify the date in the local culture if the script is intended for that same culture.
+ If the script is intended to run on EN-US machines, specify the date in the format: "08/25/2013" or "08-25-2013" or "08-25-2013 18:00:00"
+ If the script is intended for multiple cultures, specify the date in the universal sortable date/time format: "2013-08-22 11:51:52Z"
+ The deadline date will be displayed to the user in the format of their culture.
+.PARAMETER CheckDiskSpace
+ Specify whether to check if there is enough disk space for the installation to proceed.
+ If this parameter is specified without the RequiredDiskSpace parameter, the required disk space is calculated automatically based on the size of the script source and associated files.
+.PARAMETER RequiredDiskSpace
+ Specify required disk space in MB, used in combination with CheckDiskSpace.
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $true.
+.PARAMETER TopMost
+ Specifies whether the windows is the topmost window. Default: $true.
+.PARAMETER ForceCountdown
+ Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled.
+.PARAMETER CustomText
+ Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'iexplore,winword,excel'
+ Prompt the user to close Internet Explorer, Word and Excel.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -Silent
+ Close Word and Excel without prompting the user.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -BlockExecution
+ Close Word and Excel and prevent the user from launching the applications while the installation is in progress.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword=Microsoft Office Word,excel=Microsoft Office Excel' -CloseAppsCountdown 600
+ Prompt the user to close Word and Excel, with customized descriptions for the applications and automatically close the applications after 10 minutes.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,msaccess,excel' -PersistPrompt
+ Prompt the user to close Word, MSAccess and Excel.
+ By using the PersistPrompt switch, the dialog will return to the center of the screen every 10 seconds so the user cannot ignore it by dragging it aside.
+.EXAMPLE
+ Show-InstallationWelcome -AllowDefer -DeferDeadline '25/08/2013'
+ Allow the user to defer the installation until the deadline is reached.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -BlockExecution -AllowDefer -DeferTimes 10 -DeferDeadline '25/08/2013' -CloseAppsCountdown 600
+ Close Word and Excel and prevent the user from launching the applications while the installation is in progress.
+ Allow the user to defer the installation a maximum of 10 times or until the deadline is reached, whichever happens first.
+ When deferral expires, prompt the user to close the applications and automatically close them after 10 minutes.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParametersetName='None')]
+
+ Param (
+ ## Specify process names separated by commas. Optionally specify a process description with an equals symbol, e.g. "winword=Microsoft Office Word"
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$CloseApps,
+ ## Specify whether to prompt user or force close the applications
+ [Parameter(Mandatory=$false)]
+ [switch]$Silent = $false,
+ ## Specify a countdown to display before automatically closing applications where deferral is not allowed or has expired
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CloseAppsCountdown = 0,
+ ## Specify a countdown to display before automatically closing applications whether or not deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCloseAppsCountdown = 0,
+ ## Specify whether to prompt to save working documents when the user chooses to close applications by selecting the "Close Programs" button
+ [Parameter(Mandatory=$false)]
+ [switch]$PromptToSave = $false,
+ ## Specify whether to make the prompt persist in the center of the screen every 10 seconds.
+ [Parameter(Mandatory=$false)]
+ [switch]$PersistPrompt = $false,
+ ## Specify whether to block execution of the processes during installation
+ [Parameter(Mandatory=$false)]
+ [switch]$BlockExecution = $false,
+ ## Specify whether to enable the optional defer button on the dialog box
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDefer = $false,
+ ## Specify whether to enable the optional defer button on the dialog box only if an app needs to be closed
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDeferCloseApps = $false,
+ ## Specify the number of times the deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$DeferTimes = 0,
+ ## Specify the number of days since first run that the deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$DeferDays = 0,
+ ## Specify the deadline (in format dd/mm/yyyy) for which deferral will expire as an option
+ [Parameter(Mandatory=$false)]
+ [string]$DeferDeadline = '',
+ ## Specify whether to check if there is enough disk space for the installation to proceed. If this parameter is specified without the RequiredDiskSpace parameter, the required disk space is calculated automatically based on the size of the script source and associated files.
+ [Parameter(ParameterSetName = "CheckDiskSpaceParameterSet",Mandatory=$true)]
+ [ValidateScript({$_.IsPresent -eq ($true -or $false)})]
+ [switch]$CheckDiskSpace,
+ ## Specify required disk space in MB, used in combination with $CheckDiskSpace.
+ [Parameter(ParameterSetName = "CheckDiskSpaceParameterSet",Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$RequiredDiskSpace = 0,
+ ## Specify whether to minimize other windows when displaying prompt
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $true,
+ ## Specifies whether the window is the topmost window
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true,
+ ## Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCountdown = 0,
+ ## Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+ [Parameter(Mandatory=$false)]
+ [switch]$CustomText = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If running in NonInteractive mode, force the processes to close silently
+ If ($deployModeNonInteractive) { $Silent = $true }
+
+ ## If using Zero-Config MSI Deployment, append any executables found in the MSI to the CloseApps list
+ If ($useDefaultMsi) { $CloseApps = "$CloseApps,$defaultMsiExecutablesList" }
+
+ ## Check disk space requirements if specified
+ If ($CheckDiskSpace) {
+ Write-Log -Message 'Evaluate disk space requirements.' -Source ${CmdletName}
+ [double]$freeDiskSpace = Get-FreeDiskSpace
+ If ($RequiredDiskSpace -eq 0) {
+ Try {
+ # Determine the size of the Files folder
+ $fso = New-Object -ComObject 'Scripting.FileSystemObject' -ErrorAction 'Stop'
+ $RequiredDiskSpace = [math]::Round((($fso.GetFolder($scriptParentPath).Size) / 1MB))
+ }
+ Catch {
+ Write-Log -Message "Failed to calculate disk space requirement from source files. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ If ($freeDiskSpace -lt $RequiredDiskSpace) {
+ Write-Log -Message "Failed to meet minimum disk space requirement. Space Required [$RequiredDiskSpace MB], Space Available [$freeDiskSpace MB]." -Severity 3 -Source ${CmdletName}
+ If (-not $Silent) {
+ Show-InstallationPrompt -Message ($configDiskSpaceMessage -f $installTitle, $RequiredDiskSpace, ($freeDiskSpace)) -ButtonRightText 'OK' -Icon 'Error'
+ }
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ Else {
+ Write-Log -Message 'Successfully passed minimum disk space requirement check.' -Source ${CmdletName}
+ }
+ }
+
+ If ($CloseApps) {
+ ## Create a Process object with custom descriptions where they are provided (split on an '=' sign)
+ [psobject[]]$processObjects = @()
+ # Split multiple processes on a comma, then split on equal sign, then create custom object with process name and description
+ ForEach ($process in ($CloseApps -split ',' | Where-Object { $_ })) {
+ If ($process.Contains('=')) {
+ [string[]]$ProcessSplit = $process -split '='
+ $processObjects += New-Object -TypeName 'PSObject' -Property @{
+ ProcessName = $ProcessSplit[0]
+ ProcessDescription = $ProcessSplit[1]
+ }
+ }
+ Else {
+ [string]$ProcessInfo = $process
+ $processObjects += New-Object -TypeName 'PSObject' -Property @{
+ ProcessName = $process
+ ProcessDescription = ''
+ }
+ }
+ }
+ }
+
+ ## Check Deferral history and calculate remaining deferrals
+ If (($allowDefer) -or ($AllowDeferCloseApps)) {
+ # Set $allowDefer to true if $AllowDeferCloseApps is true
+ $allowDefer = $true
+
+ # Get the deferral history from the registry
+ $deferHistory = Get-DeferHistory
+ $deferHistoryTimes = $deferHistory | Select-Object -ExpandProperty 'DeferTimesRemaining' -ErrorAction 'SilentlyContinue'
+ $deferHistoryDeadline = $deferHistory | Select-Object -ExpandProperty 'DeferDeadline' -ErrorAction 'SilentlyContinue'
+
+ # Reset Switches
+ $checkDeferDays = $false
+ $checkDeferDeadline = $false
+ If ($DeferDays -ne 0) { $checkDeferDays = $true }
+ If ($DeferDeadline) { $checkDeferDeadline = $true }
+ If ($DeferTimes -ne 0) {
+ If ($deferHistoryTimes -ge 0) {
+ Write-Log -Message "Defer history shows [$($deferHistory.DeferTimesRemaining)] deferrals remaining." -Source ${CmdletName}
+ $DeferTimes = $deferHistory.DeferTimesRemaining - 1
+ }
+ Else {
+ $DeferTimes = $DeferTimes - 1
+ }
+ Write-Log -Message "User has [$deferTimes] deferrals remaining." -Source ${CmdletName}
+ If ($DeferTimes -lt 0) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ Else {
+ If (Test-Path -LiteralPath 'variable:deferTimes') { Remove-Variable -Name 'deferTimes' }
+ $DeferTimes = $null
+ }
+ If ($checkDeferDays -and $allowDefer) {
+ If ($deferHistoryDeadline) {
+ Write-Log -Message "Defer history shows a deadline date of [$deferHistoryDeadline]." -Source ${CmdletName}
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime $deferHistoryDeadline
+ }
+ Else {
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime (Get-Date -Date ((Get-Date).AddDays($deferDays)) -Format ($culture).DateTimeFormat.FullDateTimePattern)
+ }
+ Write-Log -Message "User has until [$deferDeadlineUniversal] before deferral expires." -Source ${CmdletName}
+ If ((Get-UniversalDate) -gt $deferDeadlineUniversal) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ If ($checkDeferDeadline -and $allowDefer) {
+ # Validate Date
+ Try {
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime $deferDeadline -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Date is not in the correct format for the current culture. Type the date in the current locale format, such as 20/08/2014 (Europe) or 08/20/2014 (United States). If the script is intended for multiple cultures, specify the date in the universal sortable date/time format, e.g. '2013-08-22 11:51:52Z'. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Throw "Date is not in the correct format for the current culture. Type the date in the current locale format, such as 20/08/2014 (Europe) or 08/20/2014 (United States). If the script is intended for multiple cultures, specify the date in the universal sortable date/time format, e.g. '2013-08-22 11:51:52Z': $($_.Exception.Message)"
+ }
+ Write-Log -Message "User has until [$deferDeadlineUniversal] remaining." -Source ${CmdletName}
+ If ((Get-UniversalDate) -gt $deferDeadlineUniversal) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ }
+ If (($deferTimes -lt 0) -and (-not ($deferDeadlineUniversal))) { $AllowDefer = $false }
+
+ ## Prompt the user to close running applications and optionally defer if enabled
+ If (-not ($deployModeSilent) -and (-not ($silent))) {
+ If ($forceCloseAppsCountdown -gt 0) {
+ # Keep the same variable for countdown to simplify the code:
+ $closeAppsCountdown = $forceCloseAppsCountdown
+ # Change this variable to a boolean now to switch the countdown on even with deferral
+ [boolean]$forceCloseAppsCountdown = $true
+ }
+ ElseIf ($forceCountdown -gt 0){
+ # Keep the same variable for countdown to simplify the code:
+ $closeAppsCountdown = $forceCountdown
+ # Change this variable to a boolean now to switch the countdown on
+ [boolean]$forceCountdown = $true
+ }
+ Set-Variable -Name 'closeAppsCountdownGlobal' -Value $closeAppsCountdown -Scope 'Script'
+
+ While ((Get-RunningProcesses -ProcessObjects $processObjects -OutVariable 'runningProcesses') -or (($promptResult -ne 'Defer') -and ($promptResult -ne 'Close'))) {
+ [string]$runningProcessDescriptions = ($runningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ # Check if we need to prompt the user to defer, to defer and close apps, or not to prompt them at all
+ If ($allowDefer) {
+ # If there is deferral and closing apps is allowed but there are no apps to be closed, break the while loop
+ If ($AllowDeferCloseApps -and (-not $runningProcessDescriptions)) {
+ Break
+ }
+ # Otherwise, as long as the user has not selected to close the apps or the processes are still running and the user has not selected to continue, prompt user to close running processes with deferral
+ ElseIf (($promptResult -ne 'Close') -or (($runningProcessDescriptions) -and ($promptResult -ne 'Continue'))) {
+ [string]$promptResult = Show-WelcomePrompt -ProcessDescriptions $runningProcessDescriptions -CloseAppsCountdown $closeAppsCountdownGlobal -ForceCloseAppsCountdown $forceCloseAppsCountdown -ForceCountdown $forceCountdown -PersistPrompt $PersistPrompt -AllowDefer -DeferTimes $deferTimes -DeferDeadline $deferDeadlineUniversal -MinimizeWindows $MinimizeWindows -CustomText:$CustomText -TopMost $TopMost
+ }
+ }
+ # If there is no deferral and processes are running, prompt the user to close running processes with no deferral option
+ ElseIf (($runningProcessDescriptions) -or ($forceCountdown)) {
+ [string]$promptResult = Show-WelcomePrompt -ProcessDescriptions $runningProcessDescriptions -CloseAppsCountdown $closeAppsCountdownGlobal -ForceCloseAppsCountdown $forceCloseAppsCountdown -ForceCountdown $forceCountdown -PersistPrompt $PersistPrompt -MinimizeWindows $minimizeWindows -CustomText:$CustomText -TopMost $TopMost
+ }
+ # If there is no deferral and no processes running, break the while loop
+ Else {
+ Break
+ }
+
+ # If the user has clicked OK, wait a few seconds for the process to terminate before evaluating the running processes again
+ If ($promptResult -eq 'Continue') {
+ Write-Log -Message 'User selected to continue...' -Source ${CmdletName}
+ Start-Sleep -Seconds 2
+
+ # Break the while loop if there are no processes to close and the user has clicked OK to continue
+ If (-not $runningProcesses) { Break }
+ }
+ # Force the applications to close
+ ElseIf ($promptResult -eq 'Close') {
+ Write-Log -Message 'User selected to force the application(s) to close...' -Source ${CmdletName}
+ If (($PromptToSave) -and ($SessionZero -and (-not $IsProcessUserInteractive))) {
+ Write-Log -Message 'Specified [-PromptToSave] option will not be available because current process is running in session zero and is not interactive.' -Severity 2 -Source ${CmdletName}
+ }
+
+ ForEach ($runningProcess in $runningProcesses) {
+ [psobject[]]$AllOpenWindowsForRunningProcess = Get-WindowTitle -GetAllWindowTitles -DisableFunctionLogging | Where-Object { $_.ParentProcess -eq $runningProcess.Name }
+ # If the PromptToSave parameter was specified and the process has a window open, then prompt the user to save work if there is work to be saved when closing window
+ If (($PromptToSave) -and (-not ($SessionZero -and (-not $IsProcessUserInteractive))) -and ($AllOpenWindowsForRunningProcess) -and ($runningProcess.MainWindowHandle -ne [IntPtr]::Zero)) {
+ [timespan]$PromptToSaveTimeout = New-TimeSpan -Seconds $configInstallationPromptToSave
+ [Diagnostics.StopWatch]$PromptToSaveStopWatch = [Diagnostics.StopWatch]::StartNew()
+ $PromptToSaveStopWatch.Reset()
+ ForEach ($OpenWindow in $AllOpenWindowsForRunningProcess) {
+ Try {
+ Write-Log -Message "Stop process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)] and prompt to save if there is work to be saved (timeout in [$configInstallationPromptToSave] seconds)..." -Source ${CmdletName}
+ [boolean]$IsBringWindowToFrontSuccess = [PSADT.UiAutomation]::BringWindowToFront($OpenWindow.WindowHandle)
+ [boolean]$IsCloseWindowCallSuccess = $runningProcess.CloseMainWindow()
+ If (-not $IsCloseWindowCallSuccess) {
+ Write-Log -Message "Failed to call the CloseMainWindow() method on process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)] because the main window may be disabled due to a modal dialog being shown." -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ $PromptToSaveStopWatch.Start()
+ Do {
+ [boolean]$IsWindowOpen = [boolean](Get-WindowTitle -GetAllWindowTitles -DisableFunctionLogging | Where-Object { $_.WindowHandle -eq $OpenWindow.WindowHandle })
+ If (-not $IsWindowOpen) { Break }
+ Start-Sleep -Seconds 3
+ } While (($IsWindowOpen) -and ($PromptToSaveStopWatch.Elapsed -lt $PromptToSaveTimeout))
+ $PromptToSaveStopWatch.Reset()
+ If ($IsWindowOpen) {
+ Write-Log -Message "Exceeded the [$configInstallationPromptToSave] seconds timeout value for the user to save work associated with process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Window [$($OpenWindow.WindowTitle)] for process [$($runningProcess.Name)] was successfully closed." -Source ${CmdletName}
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to close window [$($OpenWindow.WindowTitle)] for process [$($runningProcess.Name)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Continue
+ }
+ Finally {
+ $runningProcess.Refresh()
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Stop process $($runningProcess.Name)..." -Source ${CmdletName}
+ Stop-Process -Id $runningProcess.Id -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ Start-Sleep -Seconds 2
+ }
+ # Stop the script (if not actioned before the timeout value)
+ ElseIf ($promptResult -eq 'Timeout') {
+ Write-Log -Message 'Installation not actioned before the timeout value.' -Source ${CmdletName}
+ $BlockExecution = $false
+
+ If (($deferTimes) -or ($deferDeadlineUniversal)) {
+ Set-DeferHistory -DeferTimesRemaining $DeferTimes -DeferDeadline $deferDeadlineUniversal
+ }
+ ## Dispose the welcome prompt timer here because if we dispose it within the Show-WelcomePrompt function we risk resetting the timer and missing the specified timeout period
+ If ($script:welcomeTimer) {
+ Try {
+ $script:welcomeTimer.Dispose()
+ $script:welcomeTimer = $null
+ }
+ Catch { }
+ }
+
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ # Stop the script (user chose to defer)
+ ElseIf ($promptResult -eq 'Defer') {
+ Write-Log -Message 'Installation deferred by the user.' -Source ${CmdletName}
+ $BlockExecution = $false
+
+ Set-DeferHistory -DeferTimesRemaining $DeferTimes -DeferDeadline $deferDeadlineUniversal
+
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+
+ Exit-Script -ExitCode $configInstallationDeferExitCode
+ }
+ }
+ }
+
+ ## Force the processes to close silently, without prompting the user
+ If (($Silent -or $deployModeSilent) -and $CloseApps) {
+ [array]$runningProcesses = $null
+ [array]$runningProcesses = Get-RunningProcesses $processObjects
+ If ($runningProcesses) {
+ [string]$runningProcessDescriptions = ($runningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ Write-Log -Message "Force close application(s) [$($runningProcessDescriptions)] without prompting user." -Source ${CmdletName}
+ $runningProcesses | Stop-Process -Force -ErrorAction 'SilentlyContinue'
+ Start-Sleep -Seconds 2
+ }
+ }
+
+ ## Force nsd.exe to stop if Notes is one of the required applications to close
+ If (($processObjects | Select-Object -ExpandProperty 'ProcessName') -contains 'notes') {
+ ## Get the path where Notes is installed
+ [string]$notesPath = Get-Item -LiteralPath $regKeyLotusNotes -ErrorAction 'SilentlyContinue' | Get-ItemProperty | Select-Object -ExpandProperty 'Path'
+
+ ## Ensure we aren't running as a Local System Account and Notes install directory was found
+ If ((-not $IsLocalSystemAccount) -and ($notesPath)) {
+ # Get a list of all the executables in the Notes folder
+ [string[]]$notesPathExes = Get-ChildItem -LiteralPath $notesPath -Filter '*.exe' -Recurse | Select-Object -ExpandProperty 'BaseName' | Sort-Object
+ ## Check for running Notes executables and run NSD if any are found
+ $notesPathExes | ForEach-Object {
+ If ((Get-Process | Select-Object -ExpandProperty 'Name') -contains $_) {
+ [string]$notesNSDExecutable = Join-Path -Path $notesPath -ChildPath 'NSD.exe'
+ Try {
+ If (Test-Path -LiteralPath $notesNSDExecutable -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "Execute [$notesNSDExecutable] with the -kill argument..." -Source ${CmdletName}
+ [Diagnostics.Process]$notesNSDProcess = Start-Process -FilePath $notesNSDExecutable -ArgumentList '-kill' -WindowStyle 'Hidden' -PassThru -ErrorAction 'SilentlyContinue'
+
+ If (-not ($notesNSDProcess.WaitForExit(10000))) {
+ Write-Log -Message "[$notesNSDExecutable] did not end in a timely manner. Force terminate process." -Source ${CmdletName}
+ Stop-Process -Name 'NSD' -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to launch [$notesNSDExecutable]. `n$(Resolve-Error)" -Source ${CmdletName}
+ }
+
+ Write-Log -Message "[$notesNSDExecutable] returned exit code [$($notesNSDProcess.ExitCode)]." -Source ${CmdletName}
+
+ # Force NSD process to stop in case the previous command was not successful
+ Stop-Process -Name 'NSD' -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+
+ # Strip all Notes processes from the process list except notes.exe, because the other notes processes (e.g. notes2.exe) may be invoked by the Notes installation, so we don't want to block their execution.
+ If ($notesPathExes) {
+ [array]$processesIgnoringNotesExceptions = Compare-Object -ReferenceObject ($processObjects | Select-Object -ExpandProperty 'ProcessName' | Sort-Object) -DifferenceObject $notesPathExes -IncludeEqual | Where-Object { ($_.SideIndicator -eq '<=') -or ($_.InputObject -eq 'notes') } | Select-Object -ExpandProperty 'InputObject'
+ [array]$processObjects = $processObjects | Where-Object { $processesIgnoringNotesExceptions -contains $_.ProcessName }
+ }
+ }
+
+ ## If block execution switch is true, call the function to block execution of these processes
+ If ($BlockExecution) {
+ # Make this variable globally available so we can check whether we need to call Unblock-AppExecution
+ Set-Variable -Name 'BlockExecution' -Value $BlockExecution -Scope 'Script'
+ Write-Log -Message '[-BlockExecution] parameter specified.' -Source ${CmdletName}
+ Block-AppExecution -ProcessName ($processObjects | Select-Object -ExpandProperty 'ProcessName')
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-WelcomePrompt
+Function Show-WelcomePrompt {
+<#
+.SYNOPSIS
+ Called by Show-InstallationWelcome to prompt the user to optionally do the following:
+ 1) Close the specified running applications.
+ 2) Provide an option to defer the installation.
+ 3) Show a countdown before applications are automatically closed.
+.DESCRIPTION
+ The user is presented with a Windows Forms dialog box to close the applications themselves and continue or to have the script close the applications for them.
+ If the -AllowDefer option is set to true, an optional "Defer" button will be shown to the user. If they select this option, the script will exit and return a 1618 code (SCCM fast retry code).
+ The dialog box will timeout after the timeout specified in the XML configuration file (default 1 hour and 55 minutes) to prevent SCCM installations from timing out and returning a failure code to SCCM. When the dialog times out, the script will exit and return a 1618 code (SCCM fast retry code).
+.PARAMETER ProcessDescriptions
+ The descriptive names of the applications that are running and need to be closed.
+.PARAMETER CloseAppsCountdown
+ Specify the countdown time in seconds before running applications are automatically closed when deferral is not allowed or expired.
+.PARAMETER ForceCloseAppsCountdown
+ Specify whether to show the countdown regardless of whether deferral is allowed.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds.
+.PARAMETER AllowDefer
+ Specify whether to provide an option to defer the installation.
+.PARAMETER DeferTimes
+ Specify the number of times the user is allowed to defer.
+.PARAMETER DeferDeadline
+ Specify the deadline date before the user is allowed to defer.
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $true.
+.PARAMETER TopMost
+ Specifies whether the windows is the topmost window. Default: $true.
+.PARAMETER ForceCountdown
+ Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled.
+.PARAMETER CustomText
+ Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+.EXAMPLE
+ Show-WelcomePrompt -ProcessDescriptions 'Lotus Notes, Microsoft Word' -CloseAppsCountdown 600 -AllowDefer -DeferTimes 10
+.NOTES
+ This is an internal script function and should typically not be called directly. It is used by the Show-InstallationWelcome prompt to display a custom prompt.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [string]$ProcessDescriptions,
+ [Parameter(Mandatory=$false)]
+ [int32]$CloseAppsCountdown,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ForceCloseAppsCountdown,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$PersistPrompt = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDefer = $false,
+ [Parameter(Mandatory=$false)]
+ [string]$DeferTimes,
+ [Parameter(Mandatory=$false)]
+ [string]$DeferDeadline,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCountdown = 0,
+ [Parameter(Mandatory=$false)]
+ [switch]$CustomText = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Reset switches
+ [boolean]$showCloseApps = $false
+ [boolean]$showDefer = $false
+ [boolean]$persistWindow = $false
+
+ ## Reset times
+ [datetime]$startTime = Get-Date
+ [datetime]$countdownTime = $startTime
+
+ ## Check if the countdown was specified
+ If ($CloseAppsCountdown) {
+ If ($CloseAppsCountdown -gt $configInstallationUITimeout) {
+ Throw 'The close applications countdown time cannot be longer than the timeout specified in the XML configuration for installation UI dialogs to timeout.'
+ }
+ }
+
+ ## Initial form layout: Close Applications / Allow Deferral
+ If ($processDescriptions) {
+ Write-Log -Message "Prompt user to close application(s) [$processDescriptions]..." -Source ${CmdletName}
+ $showCloseApps = $true
+ }
+ If (($allowDefer) -and (($deferTimes -ge 0) -or ($deferDeadline))) {
+ Write-Log -Message 'User has the option to defer.' -Source ${CmdletName}
+ $showDefer = $true
+ If ($deferDeadline) {
+ # Remove the Z from universal sortable date time format, otherwise it could be converted to a different time zone
+ $deferDeadline = $deferDeadline -replace 'Z',''
+ # Convert the deadline date to a string
+ [string]$deferDeadline = (Get-Date -Date $deferDeadline).ToString()
+ }
+ }
+
+ ## If deferral is being shown and 'close apps countdown' or 'persist prompt' was specified, enable those features.
+ If (-not $showDefer) {
+ If ($closeAppsCountdown -gt 0) {
+ Write-Log -Message "Close applications countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+ }
+ If ($showDefer) {
+ If ($persistPrompt) { $persistWindow = $true }
+ }
+ ## If 'force close apps countdown' was specified, enable that feature.
+ If ($forceCloseAppsCountdown -eq $true) {
+ Write-Log -Message "Close applications countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+ ## If 'force countdown' was specified, enable that feature.
+ If ($forceCountdown -eq $true) {
+ Write-Log -Message "Countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+
+ [string[]]$processDescriptions = $processDescriptions -split ','
+ [Windows.Forms.Application]::EnableVisualStyles()
+
+ $formWelcome = New-Object -TypeName 'System.Windows.Forms.Form'
+ $pictureBanner = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $labelAppName = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelCountdown = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelDefer = New-Object -TypeName 'System.Windows.Forms.Label'
+ $listBoxCloseApps = New-Object -TypeName 'System.Windows.Forms.ListBox'
+ $buttonContinue = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonDefer = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonCloseApps = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonAbort = New-Object -TypeName 'System.Windows.Forms.Button'
+ $formWelcomeWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+ $flowLayoutPanel = New-Object -TypeName 'System.Windows.Forms.FlowLayoutPanel'
+ $panelButtons = New-Object -TypeName 'System.Windows.Forms.Panel'
+ $toolTip = New-Object -TypeName 'System.Windows.Forms.ToolTip'
+
+ ## Remove all event handlers from the controls
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ Try {
+ $labelAppName.remove_Click($handler_labelAppName_Click)
+ $labelDefer.remove_Click($handler_labelDefer_Click)
+ $buttonCloseApps.remove_Click($buttonCloseApps_OnClick)
+ $buttonContinue.remove_Click($buttonContinue_OnClick)
+ $buttonDefer.remove_Click($buttonDefer_OnClick)
+ $buttonAbort.remove_Click($buttonAbort_OnClick)
+ $script:welcomeTimer.remove_Tick($timer_Tick)
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $timerRunningProcesses.remove_Tick($timerRunningProcesses_Tick)
+ $formWelcome.remove_Load($Form_StateCorrection_Load)
+ $formWelcome.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formWelcome.WindowState = 'Normal'
+ $formWelcome.AutoSize = $true
+ $formWelcome.TopMost = $TopMost
+ $formWelcome.BringToFront()
+ # Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formWelcomeStartPosition' -Value $formWelcome.Location -Scope 'Script'
+
+ ## Initialize the countdown timer
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($CloseAppsCountdown)
+ $script:welcomeTimer.Start()
+
+ ## Set up the form
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ [string]$labelCountdownSeconds = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($forceCountdown -eq $true) {
+ If ($deploymentType -ieq 'Install') { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $($configDeploymentTypeInstall.ToLower())) + "`n$labelCountdownSeconds" }
+ Else { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $($configDeploymentTypeUninstall.ToLower())) + "`n$labelCountdownSeconds" }
+ }
+ Else { $labelCountdown.Text = "$configClosePromptCountdownMessage`n$labelCountdownSeconds" }
+ }
+
+ ## Add the timer if it doesn't already exist - this avoids the timer being reset if the continue button is clicked
+ If (-not ($script:welcomeTimer)) {
+ $script:welcomeTimer = New-Object -TypeName 'System.Windows.Forms.Timer'
+ }
+
+ If ($showCountdown) {
+ [scriptblock]$timer_Tick = {
+ ## Get the time information
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($CloseAppsCountdown)
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ Set-Variable -Name 'closeAppsCountdownGlobal' -Value $remainingTime.TotalSeconds -Scope 'Script'
+
+ ## If the countdown is complete, close the application(s) or continue
+ If ($countdownTime -lt $currentTime) {
+ If ($forceCountdown -eq $true) {
+ Write-Log -Message 'Countdown timer has elapsed. Force continue.' -Source ${CmdletName}
+ $buttonContinue.PerformClick()
+ }
+ Else {
+ Write-Log -Message 'Close application(s) countdown timer has elapsed. Force closing application(s).' -Source ${CmdletName}
+ $buttonCloseApps.PerformClick()
+ }
+ }
+ Else {
+ # Update the form
+ [string]$labelCountdownSeconds = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($forceCountdown -eq $true) {
+ If ($deploymentType -ieq 'Install') { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $configDeploymentTypeInstall) + "`n$labelCountdownSeconds" }
+ Else { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $configDeploymentTypeUninstall) + "`n$labelCountdownSeconds" }
+ }
+ Else { $labelCountdown.Text = "$configClosePromptCountdownMessage`n$labelCountdownSeconds" }
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+ }
+ Else {
+ $script:welcomeTimer.Interval = ($configInstallationUITimeout * 1000)
+ [scriptblock]$timer_Tick = { $buttonAbort.PerformClick() }
+ }
+
+ $script:welcomeTimer.add_Tick($timer_Tick)
+
+ ## Persistence Timer
+ If ($persistWindow) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = { Update-InstallationWelcome }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ ## Process Re-Enumeration Timer
+ If ($configInstallationWelcomePromptDynamicRunningProcessEvaluation) {
+ $timerRunningProcesses = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerRunningProcesses.Interval = ($configInstallationWelcomePromptDynamicRunningProcessEvaluationInterval * 1000)
+ [scriptblock]$timerRunningProcesses_Tick = { Get-RunningProcessesDynamically }
+ $timerRunningProcesses.add_Tick($timerRunningProcesses_Tick)
+ $timerRunningProcesses.Start()
+ }
+
+ ## Form
+ $formWelcome.Controls.Add($pictureBanner)
+ $formWelcome.Controls.Add($buttonAbort)
+
+ ##----------------------------------------------
+ ## Create padding object
+ $paddingNone = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $paddingNone.Top = 0
+ $paddingNone.Bottom = 0
+ $paddingNone.Left = 0
+ $paddingNone.Right = 0
+
+ ## Generic Button properties
+ $buttonWidth = 110
+ $buttonHeight = 23
+ $buttonPadding = 50
+ $buttonSize = New-Object -TypeName 'System.Drawing.Size'
+ $buttonSize.Width = $buttonWidth
+ $buttonSize.Height = $buttonHeight
+ $buttonPadding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $buttonPadding.Top = 0
+ $buttonPadding.Bottom = 5
+ $buttonPadding.Left = 50
+ $buttonPadding.Right = 0
+
+ ## Picture Banner
+ $pictureBanner.DataBindings.DefaultDataSourceUpdateMode = 0
+ $pictureBanner.ImageLocation = $appDeployLogoBanner
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $pictureBanner.Location = $System_Drawing_Point
+ $pictureBanner.Name = 'pictureBanner'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 50
+ $System_Drawing_Size.Width = 450
+ $pictureBanner.Size = $System_Drawing_Size
+ $pictureBanner.SizeMode = 'CenterImage'
+ $pictureBanner.Margin = $paddingNone
+ $pictureBanner.TabIndex = 0
+ $pictureBanner.TabStop = $false
+
+ ## Label App Name
+ $labelAppName.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelAppName.Name = 'labelAppName'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ If (-not $showCloseApps) {
+ $System_Drawing_Size.Height = 40
+ }
+ Else {
+ $System_Drawing_Size.Height = 65
+ }
+ $System_Drawing_Size.Width = 450
+ $labelAppName.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelAppName.MaximumSize = $System_Drawing_Size
+ $labelAppName.Margin = '0,15,0,15'
+ $labelAppName.Padding = '20,0,20,0'
+ $labelAppName.TabIndex = 1
+
+ ## Initial form layout: Close Applications / Allow Deferral
+ If ($showCloseApps) {
+ $labelAppNameText = $configClosePromptMessage
+ }
+ ElseIf (($showDefer) -or ($forceCountdown)) {
+ $labelAppNameText = "$configDeferPromptWelcomeMessage `n$installTitle"
+ }
+ If ($CustomText) {
+ $labelAppNameText = "$labelAppNameText `n`n$configWelcomePromptCustomMessage"
+ }
+ $labelAppName.Text = $labelAppNameText
+ $labelAppName.TextAlign = 'TopCenter'
+ $labelAppName.Anchor = 'Top'
+ $labelAppName.AutoSize = $true
+ $labelAppName.add_Click($handler_labelAppName_Click)
+
+ ## Listbox Close Applications
+ $listBoxCloseApps.DataBindings.DefaultDataSourceUpdateMode = 0
+ $listBoxCloseApps.FormattingEnabled = $true
+ $listBoxCloseApps.HorizontalScrollbar = $true
+ $listBoxCloseApps.Name = 'listBoxCloseApps'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 100
+ $System_Drawing_Size.Width = 300
+ $listBoxCloseApps.Size = $System_Drawing_Size
+ $listBoxCloseApps.Margin = '75,0,0,0'
+ $listBoxCloseApps.TabIndex = 3
+ $ProcessDescriptions | ForEach-Object { $null = $listboxCloseApps.Items.Add($_) }
+
+ ## Label Defer
+ $labelDefer.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelDefer.Name = 'labelDefer'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 90
+ $System_Drawing_Size.Width = 450
+ $labelDefer.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelDefer.MaximumSize = $System_Drawing_Size
+ $labelDefer.Margin = $paddingNone
+ $labelDefer.Padding = '40,0,20,0'
+ $labelDefer.TabIndex = 4
+ $deferralText = "$configDeferPromptExpiryMessage`n"
+
+ If ($deferTimes -ge 0) {
+ $deferralText = "$deferralText `n$configDeferPromptRemainingDeferrals $([int32]$deferTimes + 1)"
+ }
+ If ($deferDeadline) {
+ $deferralText = "$deferralText `n$configDeferPromptDeadline $deferDeadline"
+ }
+ If (($deferTimes -lt 0) -and (-not $DeferDeadline)) {
+ $deferralText = "$deferralText `n$configDeferPromptNoDeadline"
+ }
+ $deferralText = "$deferralText `n`n$configDeferPromptWarningMessage"
+ $labelDefer.Text = $deferralText
+ $labelDefer.TextAlign = 'MiddleCenter'
+ $labelDefer.AutoSize = $true
+ $labelDefer.add_Click($handler_labelDefer_Click)
+
+ ## Label Countdown
+ $labelCountdown.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelCountdown.Name = 'labelCountdown'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 40
+ $System_Drawing_Size.Width = 450
+ $labelCountdown.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelCountdown.MaximumSize = $System_Drawing_Size
+ $labelCountdown.Margin = $paddingNone
+ $labelCountdown.Padding = '40,0,20,0'
+ $labelCountdown.TabIndex = 4
+ $labelCountdown.Font = 'Microsoft Sans Serif, 9pt, style=Bold'
+ $labelCountdown.Text = '00:00:00'
+ $labelCountdown.TextAlign = 'MiddleCenter'
+ $labelCountdown.AutoSize = $true
+ $labelCountdown.add_Click($handler_labelDefer_Click)
+
+ ## Panel Flow Layout
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 50
+ $flowLayoutPanel.Location = $System_Drawing_Point
+ $flowLayoutPanel.AutoSize = $true
+ $flowLayoutPanel.Anchor = 'Top'
+ $flowLayoutPanel.FlowDirection = 'TopDown'
+ $flowLayoutPanel.WrapContents = $true
+ $flowLayoutPanel.Controls.Add($labelAppName)
+ If ($showCloseApps) { $flowLayoutPanel.Controls.Add($listBoxCloseApps) }
+ If ($showDefer) {
+ $flowLayoutPanel.Controls.Add($labelDefer)
+ }
+ If ($showCountdown) {
+ $flowLayoutPanel.Controls.Add($labelCountdown)
+ }
+
+ ## Button Close For Me
+ $buttonCloseApps.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonCloseApps.Location = '15,0'
+ $buttonCloseApps.Name = 'buttonCloseApps'
+ $buttonCloseApps.Size = $buttonSize
+ $buttonCloseApps.TabIndex = 5
+ $buttonCloseApps.Text = $configClosePromptButtonClose
+ $buttonCloseApps.DialogResult = 'Yes'
+ $buttonCloseApps.AutoSize = $true
+ $buttonCloseApps.UseVisualStyleBackColor = $true
+ $buttonCloseApps.add_Click($buttonCloseApps_OnClick)
+
+ ## Button Defer
+ $buttonDefer.DataBindings.DefaultDataSourceUpdateMode = 0
+ If (-not $showCloseApps) {
+ $buttonDefer.Location = '15,0'
+ }
+ Else {
+ $buttonDefer.Location = '170,0'
+ }
+ $buttonDefer.Name = 'buttonDefer'
+ $buttonDefer.Size = $buttonSize
+ $buttonDefer.TabIndex = 6
+ $buttonDefer.Text = $configClosePromptButtonDefer
+ $buttonDefer.DialogResult = 'No'
+ $buttonDefer.AutoSize = $true
+ $buttonDefer.UseVisualStyleBackColor = $true
+ $buttonDefer.add_Click($buttonDefer_OnClick)
+
+ ## Button Continue
+ $buttonContinue.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonContinue.Location = '325,0'
+ $buttonContinue.Name = 'buttonContinue'
+ $buttonContinue.Size = $buttonSize
+ $buttonContinue.TabIndex = 7
+ $buttonContinue.Text = $configClosePromptButtonContinue
+ $buttonContinue.DialogResult = 'OK'
+ $buttonContinue.AutoSize = $true
+ $buttonContinue.UseVisualStyleBackColor = $true
+ $buttonContinue.add_Click($buttonContinue_OnClick)
+ If ($showCloseApps) {
+ # Add tooltip to Continue button
+ $toolTip.BackColor = [Drawing.Color]::LightGoldenrodYellow
+ $toolTip.IsBalloon = $false
+ $toolTip.InitialDelay = 100
+ $toolTip.ReshowDelay = 100
+ $toolTip.SetToolTip($buttonContinue, $configClosePromptButtonContinueTooltip)
+ }
+
+ ## Button Abort (Hidden)
+ $buttonAbort.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonAbort.Name = 'buttonAbort'
+ $buttonAbort.Size = '1,1'
+ $buttonAbort.TabStop = $false
+ $buttonAbort.DialogResult = 'Abort'
+ $buttonAbort.TabIndex = 5
+ $buttonAbort.UseVisualStyleBackColor = $true
+ $buttonAbort.add_Click($buttonAbort_OnClick)
+
+ ## Form Welcome
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 0
+ $System_Drawing_Size.Width = 0
+ $formWelcome.Size = $System_Drawing_Size
+ $formWelcome.Padding = $paddingNone
+ $formWelcome.Margin = $paddingNone
+ $formWelcome.DataBindings.DefaultDataSourceUpdateMode = 0
+ $formWelcome.Name = 'WelcomeForm'
+ $formWelcome.Text = $installTitle
+ $formWelcome.StartPosition = 'CenterScreen'
+ $formWelcome.FormBorderStyle = 'FixedDialog'
+ $formWelcome.MaximizeBox = $false
+ $formWelcome.MinimizeBox = $false
+ $formWelcome.TopMost = $TopMost
+ $formWelcome.TopLevel = $true
+ $formWelcome.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formWelcome.AutoSize = $true
+ $formWelcome.Controls.Add($pictureBanner)
+ $formWelcome.Controls.Add($flowLayoutPanel)
+
+ ## Panel Button
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ # Calculate the position of the panel relative to the size of the form
+ $System_Drawing_Point.Y = (($formWelcome.Size | Select-Object -ExpandProperty 'Height') - 10)
+ $panelButtons.Location = $System_Drawing_Point
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 40
+ $System_Drawing_Size.Width = 450
+ $panelButtons.Size = $System_Drawing_Size
+ $panelButtons.AutoSize = $true
+ $panelButtons.Anchor = 'Top'
+ $padding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $padding.Top = 0
+ $padding.Bottom = 0
+ $padding.Left = 0
+ $padding.Right = 0
+ $panelButtons.Margin = $padding
+ If ($showCloseApps) { $panelButtons.Controls.Add($buttonCloseApps) }
+ If ($showDefer) { $panelButtons.Controls.Add($buttonDefer) }
+ $panelButtons.Controls.Add($buttonContinue)
+
+ ## Add the Buttons Panel to the form
+ $formWelcome.Controls.Add($panelButtons)
+
+ ## Save the initial state of the form
+ $formWelcomeWindowState = $formWelcome.WindowState
+ # Init the OnLoad event to correct the initial state of the form
+ $formWelcome.add_Load($Form_StateCorrection_Load)
+ # Clean up the control events
+ $formWelcome.add_FormClosed($Form_Cleanup_FormClosed)
+
+ Function Update-InstallationWelcome {
+ $formWelcome.BringToFront()
+ $formWelcome.Location = "$($formWelcomeStartPosition.X),$($formWelcomeStartPosition.Y)"
+ $formWelcome.Refresh()
+ }
+
+ # Function invoked by a timer to periodically check running processes dynamically whilst showing the welcome prompt
+ Function Get-RunningProcessesDynamically {
+ $dynamicRunningProcesses = $null
+ Get-RunningProcesses -ProcessObjects $processObjects -DisableLogging -OutVariable 'dynamicRunningProcesses'
+ [string]$dynamicRunningProcessDescriptions = ($dynamicRunningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ If ($dynamicRunningProcessDescriptions -ne $script:runningProcessDescriptions) {
+ # Update the runningProcessDescriptions variable for the next time this function runs
+ Set-Variable -Name 'runningProcessDescriptions' -Value $dynamicRunningProcessDescriptions -Force -Scope 'Script'
+ If ($dynamicrunningProcesses) {
+ Write-Log -Message "The running processes have changed. Updating the apps to close: [$script:runningProcessDescriptions]..." -Source ${CmdletName}
+ }
+ # Update the list box with the processes to close
+ $listboxCloseApps.Items.Clear()
+ $script:runningProcessDescriptions -split "," | ForEach-Object { $null = $listboxCloseApps.Items.Add($_) }
+ }
+ # If CloseApps processes were running when the prompt was shown, and they are subsequently detected to be closed while the form is showing, then close the form. The deferral and CloseApps conditions will be re-evaluated.
+ If ($ProcessDescriptions) {
+ If (-not ($dynamicRunningProcesses)) {
+ Write-Log -Message 'Previously detected running processes are no longer running.' -Source ${CmdletName}
+ $formWelcome.Dispose()
+ }
+ }
+ # If CloseApps processes were not running when the prompt was shown, and they are subsequently detected to be running while the form is showing, then close the form for relaunch. The deferral and CloseApps conditions will be re-evaluated.
+ ElseIf (-not $ProcessDescriptions) {
+ If ($dynamicRunningProcesses) {
+ Write-Log -Message 'New running processes detected. Updating the form to prompt to close the running applications.' -Source ${CmdletName}
+ $formWelcome.Dispose()
+ }
+ }
+ }
+
+ ## Minimize all other windows
+ If ($minimizeWindows) { $null = $shellApp.MinimizeAll() }
+
+ ## Show the form
+ $result = $formWelcome.ShowDialog()
+ $formWelcome.Dispose()
+
+ Switch ($result) {
+ OK { $result = 'Continue' }
+ No { $result = 'Defer' }
+ Yes { $result = 'Close' }
+ Abort { $result = 'Timeout' }
+ }
+
+ Write-Output -InputObject $result
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationRestartPrompt
+Function Show-InstallationRestartPrompt {
+<#
+.SYNOPSIS
+ Displays a restart prompt with a countdown to a forced restart.
+.DESCRIPTION
+ Displays a restart prompt with a countdown to a forced restart.
+.PARAMETER CountdownSeconds
+ Specifies the number of seconds to countdown before the system restart.
+.PARAMETER CountdownNoHideSeconds
+ Specifies the number of seconds to display the restart prompt without allowing the window to be hidden.
+.PARAMETER NoCountdown
+ Specifies not to show a countdown, just the Restart Now and Restart Later buttons.
+ The UI will restore/reposition itself persistently based on the interval value specified in the config file.
+.EXAMPLE
+ Show-InstallationRestartPrompt -Countdownseconds 600 -CountdownNoHideSeconds 60
+.EXAMPLE
+ Show-InstallationRestartPrompt -NoCountdown
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CountdownSeconds = 60,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CountdownNoHideSeconds = 30,
+ [Parameter(Mandatory=$false)]
+ [switch]$NoCountdown = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in non-interactive mode
+ If ($deployModeSilent) {
+ Write-Log -Message "Bypass Installation Restart Prompt [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+ ## Get the parameters passed to the function for invoking the function asynchronously
+ [hashtable]$installRestartPromptParameters = $psBoundParameters
+
+ ## Check if we are already displaying a restart prompt
+ If (Get-Process | Where-Object { $_.MainWindowTitle -match $configRestartPromptTitle }) {
+ Write-Log -Message "${CmdletName} was invoked, but an existing restart prompt was detected. Cancelling restart prompt." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ [datetime]$startTime = Get-Date
+ [datetime]$countdownTime = $startTime
+
+ [Windows.Forms.Application]::EnableVisualStyles()
+ $formRestart = New-Object -TypeName 'System.Windows.Forms.Form'
+ $labelCountdown = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelTimeRemaining = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelMessage = New-Object -TypeName 'System.Windows.Forms.Label'
+ $buttonRestartLater = New-Object -TypeName 'System.Windows.Forms.Button'
+ $picturebox = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $buttonRestartNow = New-Object -TypeName 'System.Windows.Forms.Button'
+ $timerCountdown = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $InitialFormWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ [scriptblock]$RestartComputer = {
+ Write-Log -Message 'Force restart the computer...' -Source ${CmdletName}
+ Restart-Computer -Force
+ }
+
+ [scriptblock]$FormEvent_Load = {
+ ## Initialize the countdown timer
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($countdownSeconds)
+ $timerCountdown.Start()
+ ## Set up the form
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ $labelCountdown.Text = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($remainingTime.TotalSeconds -le $countdownNoHideSeconds) { $buttonRestartLater.Enabled = $false }
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formRestart.WindowState = $InitialFormWindowState
+ $formRestart.AutoSize = $true
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ ## Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formInstallationRestartPromptStartPosition' -Value $formRestart.Location -Scope 'Script'
+ }
+
+ ## Persistence Timer
+ If ($NoCountdown) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationRestartPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = {
+ # Show the Restart Popup
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ $formRestart.Location = "$($formInstallationRestartPromptStartPosition.X),$($formInstallationRestartPromptStartPosition.Y)"
+ $formRestart.Refresh()
+ [Windows.Forms.Application]::DoEvents()
+ }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ [scriptblock]$buttonRestartLater_Click = {
+ ## Minimize the form
+ $formRestart.WindowState = 'Minimized'
+ If ($NoCountdown) {
+ ## Reset the persistence timer
+ $timerPersist.Stop()
+ $timerPersist.Start()
+ }
+ }
+
+ ## Restart the computer
+ [scriptblock]$buttonRestartNow_Click = { & $RestartComputer }
+
+ ## Hide the form if minimized
+ [scriptblock]$formRestart_Resize = { If ($formRestart.WindowState -eq 'Minimized') { $formRestart.WindowState = 'Minimized' } }
+
+ [scriptblock]$timerCountdown_Tick = {
+ ## Get the time information
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($countdownSeconds)
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ ## If the countdown is complete, restart the machine
+ If ($countdownTime -lt $currentTime) {
+ $buttonRestartNow.PerformClick()
+ }
+ Else {
+ ## Update the form
+ $labelCountdown.Text = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($remainingTime.TotalSeconds -le $countdownNoHideSeconds) {
+ $buttonRestartLater.Enabled = $false
+ # If the form is hidden when we hit the "No Hide", bring it back up
+ If ($formRestart.WindowState -eq 'Minimized') {
+ # Show Popup
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ $formRestart.Location = "$($formInstallationRestartPromptStartPosition.X),$($formInstallationRestartPromptStartPosition.Y)"
+ $formRestart.Refresh()
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+
+ ## Remove all event handlers from the controls
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ Try {
+ $buttonRestartLater.remove_Click($buttonRestartLater_Click)
+ $buttonRestartNow.remove_Click($buttonRestartNow_Click)
+ $formRestart.remove_Load($FormEvent_Load)
+ $formRestart.remove_Resize($formRestart_Resize)
+ $timerCountdown.remove_Tick($timerCountdown_Tick)
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $formRestart.remove_Load($Form_StateCorrection_Load)
+ $formRestart.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ ## Form
+ If (-not $NoCountdown) {
+ $formRestart.Controls.Add($labelCountdown)
+ $formRestart.Controls.Add($labelTimeRemaining)
+ }
+ $formRestart.Controls.Add($labelMessage)
+ $formRestart.Controls.Add($buttonRestartLater)
+ $formRestart.Controls.Add($picturebox)
+ $formRestart.Controls.Add($buttonRestartNow)
+ $formRestart.ClientSize = '450,260'
+ $formRestart.ControlBox = $false
+ $formRestart.FormBorderStyle = 'FixedDialog'
+ $formRestart.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formRestart.MaximizeBox = $false
+ $formRestart.MinimizeBox = $false
+ $formRestart.Name = 'formRestart'
+ $formRestart.StartPosition = 'CenterScreen'
+ $formRestart.Text = "$($configRestartPromptTitle): $installTitle"
+ $formRestart.add_Load($FormEvent_Load)
+ $formRestart.add_Resize($formRestart_Resize)
+
+ ## Banner
+ $picturebox.Anchor = 'Top'
+ $picturebox.Image = [Drawing.Image]::Fromfile($AppDeployLogoBanner)
+ $picturebox.Location = '0,0'
+ $picturebox.Name = 'picturebox'
+ $picturebox.Size = '450,50'
+ $picturebox.SizeMode = 'CenterImage'
+ $picturebox.TabIndex = 1
+ $picturebox.TabStop = $false
+
+ ## Label Message
+ $labelMessage.Location = '20,58'
+ $labelMessage.Name = 'labelMessage'
+ $labelMessage.Size = '400,79'
+ $labelMessage.TabIndex = 3
+ $labelMessage.Text = "$configRestartPromptMessage $configRestartPromptMessageTime `n`n$configRestartPromptMessageRestart"
+ If ($NoCountdown) { $labelMessage.Text = $configRestartPromptMessage }
+ $labelMessage.TextAlign = 'MiddleCenter'
+
+ ## Label Time Remaining
+ $labelTimeRemaining.Location = '20,138'
+ $labelTimeRemaining.Name = 'labelTimeRemaining'
+ $labelTimeRemaining.Size = '400,23'
+ $labelTimeRemaining.TabIndex = 4
+ $labelTimeRemaining.Text = $configRestartPromptTimeRemaining
+ $labelTimeRemaining.TextAlign = 'MiddleCenter'
+
+ ## Label Countdown
+ $labelCountdown.Font = 'Microsoft Sans Serif, 18pt, style=Bold'
+ $labelCountdown.Location = '20,165'
+ $labelCountdown.Name = 'labelCountdown'
+ $labelCountdown.Size = '400,30'
+ $labelCountdown.TabIndex = 5
+ $labelCountdown.Text = '00:00:00'
+ $labelCountdown.TextAlign = 'MiddleCenter'
+
+ ## Label Restart Later
+ $buttonRestartLater.Anchor = 'Bottom,Left'
+ $buttonRestartLater.Location = '20,216'
+ $buttonRestartLater.Name = 'buttonRestartLater'
+ $buttonRestartLater.Size = '159,23'
+ $buttonRestartLater.TabIndex = 0
+ $buttonRestartLater.Text = $configRestartPromptButtonRestartLater
+ $buttonRestartLater.UseVisualStyleBackColor = $true
+ $buttonRestartLater.add_Click($buttonRestartLater_Click)
+
+ ## Label Restart Now
+ $buttonRestartNow.Anchor = 'Bottom,Right'
+ $buttonRestartNow.Location = '265,216'
+ $buttonRestartNow.Name = 'buttonRestartNow'
+ $buttonRestartNow.Size = '159,23'
+ $buttonRestartNow.TabIndex = 2
+ $buttonRestartNow.Text = $configRestartPromptButtonRestartNow
+ $buttonRestartNow.UseVisualStyleBackColor = $true
+ $buttonRestartNow.add_Click($buttonRestartNow_Click)
+
+ ## Timer Countdown
+ If (-not $NoCountdown) { $timerCountdown.add_Tick($timerCountdown_Tick) }
+
+ ##----------------------------------------------
+
+ ## Save the initial state of the form
+ $InitialFormWindowState = $formRestart.WindowState
+ # Init the OnLoad event to correct the initial state of the form
+ $formRestart.add_Load($Form_StateCorrection_Load)
+ # Clean up the control events
+ $formRestart.add_FormClosed($Form_Cleanup_FormClosed)
+ $formRestartClosing = [Windows.Forms.FormClosingEventHandler]{ If ($_.CloseReason -eq 'UserClosing') { $_.Cancel = $true } }
+ $formRestart.add_FormClosing($formRestartClosing)
+
+ ## If the script has been dot-source invoked by the deploy app script, display the restart prompt asynchronously
+ If ($deployAppScriptFriendlyName) {
+ If ($NoCountdown) {
+ Write-Log -Message "Invoking ${CmdletName} asynchronously with no countdown..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Invoking ${CmdletName} asynchronously with a [$countDownSeconds] second countdown..." -Source ${CmdletName}
+ }
+ [string]$installRestartPromptParameters = ($installRestartPromptParameters.GetEnumerator() | ForEach-Object {
+ If ($_.Value.GetType().Name -eq 'SwitchParameter') {
+ "-$($_.Key)"
+ }
+ ElseIf ($_.Value.GetType().Name -eq 'Boolean') {
+ "-$($_.Key) `$" + "$($_.Value)".ToLower()
+ }
+ ElseIf ($_.Value.GetType().Name -eq 'Int32') {
+ "-$($_.Key) $($_.Value)"
+ }
+ Else {
+ "-$($_.Key) `"$($_.Value)`""
+ }
+ }) -join ' '
+ Start-Process -FilePath "$PSHOME\powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$scriptPath`" -ReferredInstallTitle `"$installTitle`" -ReferredInstallName `"$installName`" -ReferredLogName `"$logName`" -ShowInstallationRestartPrompt $installRestartPromptParameters -AsyncToolkitLaunch" -WindowStyle 'Hidden' -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ If ($NoCountdown) {
+ Write-Log -Message 'Display restart prompt with no countdown.' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Display restart prompt with a [$countDownSeconds] second countdown." -Source ${CmdletName}
+ }
+
+ # Show the Form
+ Write-Output -InputObject $formRestart.ShowDialog()
+ $formRestart.Dispose()
+
+ # Activate the Window
+ [Diagnostics.Process]$powershellProcess = Get-Process | Where-Object { $_.MainWindowTitle -match $installTitle }
+ [Microsoft.VisualBasic.Interaction]::AppActivate($powershellProcess.ID)
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-BalloonTip
+Function Show-BalloonTip {
+<#
+.SYNOPSIS
+ Displays a balloon tip notification in the system tray.
+.DESCRIPTION
+ Displays a balloon tip notification in the system tray.
+.PARAMETER BalloonTipText
+ Text of the balloon tip.
+.PARAMETER BalloonTipTitle
+ Title of the balloon tip.
+.PARAMETER BalloonTipIcon
+ Icon to be used. Options: 'Error', 'Info', 'None', 'Warning'. Default is: Info.
+.PARAMETER BalloonTipTime
+ Time in milliseconds to display the balloon tip. Default: 500.
+.EXAMPLE
+ Show-BalloonTip -BalloonTipText 'Installation Started' -BalloonTipTitle 'Application Name'
+.EXAMPLE
+ Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText 'Installation Started' -BalloonTipTitle 'Application Name' -BalloonTipTime 1000
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullOrEmpty()]
+ [string]$BalloonTipText,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$BalloonTipTitle = $installTitle,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateSet('Error','Info','None','Warning')]
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = 'Info',
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [int32]$BalloonTipTime = 10000
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Skip balloon if in silent mode
+ If (($deployModeSilent) -or (-not $configShowBalloonNotifications) -or (Test-PowerPoint)) { Return }
+
+ ## Dispose of previous balloon
+ If ($script:notifyIcon) { Try { $script:notifyIcon.Dispose() } Catch {} }
+
+ ## Get the calling function so we know when to display the exiting balloon tip notification in an asynchronous script
+ Try { [string]$callingFunction = (Get-Variable -Name MyInvocation -Scope 1).Value.Mycommand.Name } Catch { }
+
+ If ($callingFunction -eq 'Exit-Script') {
+ Write-Log -Message "Display balloon tip notification asynchronously with message [$BalloonTipText]." -Source ${CmdletName}
+ ## Create a script block to display the balloon notification in a new PowerShell process so that we can wait to cleanly dispose of the balloon tip without having to make the deployment script wait
+ [scriptblock]$notifyIconScriptBlock = {
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullOrEmpty()]
+ [string]$BalloonTipText,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$BalloonTipTitle,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateSet('Error','Info','None','Warning')]
+ $BalloonTipIcon, # Don't strongly type variable as System.Drawing; assembly not loaded yet in asynchronous scriptblock so will throw error
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [int32]$BalloonTipTime,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [string]$AppDeployLogoIcon
+ )
+
+ ## Load assembly containing class System.Windows.Forms and System.Drawing
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'System.Drawing' -ErrorAction 'Stop'
+
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = $BalloonTipIcon
+ $script:notifyIcon = New-Object -TypeName 'System.Windows.Forms.NotifyIcon' -Property @{
+ BalloonTipIcon = $BalloonTipIcon
+ BalloonTipText = $BalloonTipText
+ BalloonTipTitle = $BalloonTipTitle
+ Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ Text = -join $BalloonTipText[0..62]
+ Visible = $true
+ }
+
+ ## Display the balloon tip notification asynchronously
+ $script:NotifyIcon.ShowBalloonTip($BalloonTipTime)
+
+ ## Keep the asynchronous PowerShell process running so that we can dispose of the balloon tip icon
+ Start-Sleep -Milliseconds ($BalloonTipTime)
+ $script:notifyIcon.Dispose()
+ }
+
+ ## Invoke a separate PowerShell process passing the script block as a command and associated parameters to display the balloon tip notification asynchronously
+ Try {
+ Execute-Process -Path "$PSHOME\powershell.exe" -Parameters "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -Command & {$notifyIconScriptBlock} '$BalloonTipText' '$BalloonTipTitle' '$BalloonTipIcon' '$BalloonTipTime' '$AppDeployLogoIcon'" -NoWait -WindowStyle 'Hidden' -CreateNoWindow
+ }
+ Catch { }
+ }
+ ## Otherwise create the balloontip icon synchronously
+ Else {
+ Write-Log -Message "Display balloon tip notification with message [$BalloonTipText]." -Source ${CmdletName}
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = $BalloonTipIcon
+ $script:notifyIcon = New-Object -TypeName 'System.Windows.Forms.NotifyIcon' -Property @{
+ BalloonTipIcon = $BalloonTipIcon
+ BalloonTipText = $BalloonTipText
+ BalloonTipTitle = $BalloonTipTitle
+ Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ Text = -join $BalloonTipText[0..62]
+ Visible = $true
+ }
+
+ ## Display the balloon tip notification
+ $script:NotifyIcon.ShowBalloonTip($BalloonTipTime)
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationProgress
+Function Show-InstallationProgress {
+<#
+.SYNOPSIS
+ Displays a progress dialog in a separate thread with an updateable custom message.
+.DESCRIPTION
+ Create a WPF window in a separate thread to display a marquee style progress ellipse with a custom message that can be updated.
+ The status message supports line breaks.
+ The first time this function is called in a script, it will display a balloon tip notification to indicate that the installation has started (provided balloon tips are enabled in the configuration).
+.PARAMETER StatusMessage
+ The status message to be displayed. The default status message is taken from the XML configuration file.
+.PARAMETER WindowLocation
+ The location of the progress window. Default: just below top, centered.
+.PARAMETER TopMost
+ Specifies whether the progress window should be topmost. Default: $true.
+.EXAMPLE
+ Show-InstallationProgress
+ Uses the default status message from the XML configuration file.
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage 'Installation in Progress...'
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage "Installation in Progress...`nThe installation may take 20 minutes to complete."
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage 'Installation in Progress...' -WindowLocation 'BottomRight' -TopMost $false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$StatusMessage = $configProgressMessageInstall,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Default','BottomRight')]
+ [string]$WindowLocation = 'Default',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($deployModeSilent) { Return }
+
+ ## If the default progress message hasn't been overridden and the deployment type is uninstall, use the default uninstallation message
+ If (($StatusMessage -eq $configProgressMessageInstall) -and ($deploymentType -eq 'Uninstall')) {
+ $StatusMessage = $configProgressMessageUninstall
+ }
+
+ If ($envHost.Name -match 'PowerGUI') {
+ Write-Log -Message "$($envHost.Name) is not a supported host for WPF multi-threading. Progress dialog with message [$statusMessage] will not be displayed." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ ## Check if the progress thread is running before invoking methods on it
+ If ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -ne 'Running') {
+ # Notify user that the software installation has started
+ $balloonText = "$deploymentTypeName $configBalloonTextStart"
+ Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText $balloonText
+ # Create a synchronized hashtable to share objects between runspaces
+ $script:ProgressSyncHash = [hashtable]::Synchronized(@{ })
+ # Create a new runspace for the progress bar
+ $script:ProgressRunspace = [runspacefactory]::CreateRunspace()
+ $script:ProgressRunspace.ApartmentState = 'STA'
+ $script:ProgressRunspace.ThreadOptions = 'ReuseThread'
+ $script:ProgressRunspace.Open()
+ # Add the sync hash to the runspace
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('progressSyncHash', $script:ProgressSyncHash)
+ # Add other variables from the parent thread required in the progress runspace
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('installTitle', $installTitle)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('windowLocation', $windowLocation)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('topMost', $topMost.ToString())
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('appDeployLogoBanner', $appDeployLogoBanner)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('progressStatusMessage', $statusMessage)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('AppDeployLogoIcon', $AppDeployLogoIcon)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('dpiScale', $dpiScale)
+
+ # Add the script block to be executed in the progress runspace
+ $progressCmd = [PowerShell]::Create().AddScript({
+ [Xml.XmlDocument]$xamlProgress = @'
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+'@
+
+ ## Set the configurable values using variables added to the runspace from the parent thread
+ # Calculate the position on the screen where the progress dialog should be placed
+ $screen = [Windows.Forms.Screen]::PrimaryScreen
+ $screenWorkingArea = $screen.WorkingArea
+ [int32]$screenWidth = $screenWorkingArea | Select-Object -ExpandProperty 'Width'
+ [int32]$screenHeight = $screenWorkingArea | Select-Object -ExpandProperty 'Height'
+ # Set the start position of the Window based on the screen size
+ If ($windowLocation -eq 'BottomRight') {
+ $xamlProgress.Window.Left = [string](($screenWidth / ($dpiscale / 100)) - ($xamlProgress.Window.Width))
+ $xamlProgress.Window.Top = [string](($screenHeight / ($dpiscale / 100)) - ($xamlProgress.Window.Height))
+ }
+ # Show the default location (Top center)
+ Else {
+ # Center the progress window by calculating the center of the workable screen based on the width of the screen relative to the DPI scale minus half the width of the progress bar
+ $xamlProgress.Window.Left = [string](($screenWidth / (2 * ($dpiscale / 100) )) - (($xamlProgress.Window.Width / 2)))
+ $xamlProgress.Window.Top = [string]($screenHeight / 9.5)
+ }
+ $xamlProgress.Window.TopMost = $topMost
+ $xamlProgress.Window.Icon = $AppDeployLogoIcon
+ $xamlProgress.Window.Grid.Image.Source = $appDeployLogoBanner
+ $xamlProgress.Window.Grid.TextBlock.Text = $ProgressStatusMessage
+ $xamlProgress.Window.Title = $installTitle
+ # Parse the XAML
+ $progressReader = New-Object -TypeName 'System.Xml.XmlNodeReader' -ArgumentList $xamlProgress
+ $script:ProgressSyncHash.Window = [Windows.Markup.XamlReader]::Load($progressReader)
+ $script:ProgressSyncHash.ProgressText = $script:ProgressSyncHash.Window.FindName('ProgressText')
+ # Add an action to the Window.Closing event handler to disable the close button
+ $script:ProgressSyncHash.Window.Add_Closing({ $_.Cancel = $true })
+ # Allow the window to be dragged by clicking on it anywhere
+ $script:ProgressSyncHash.Window.Add_MouseLeftButtonDown({ $script:ProgressSyncHash.Window.DragMove() })
+ # Add a tooltip
+ $script:ProgressSyncHash.Window.ToolTip = $installTitle
+ $null = $script:ProgressSyncHash.Window.ShowDialog()
+ $script:ProgressSyncHash.Error = $Error
+ })
+
+ $progressCmd.Runspace = $script:ProgressRunspace
+ Write-Log -Message "Spin up progress dialog in a separate thread with message: [$statusMessage]." -Source ${CmdletName}
+ # Invoke the progress runspace
+ $progressData = $progressCmd.BeginInvoke()
+ # Allow the thread to be spun up safely before invoking actions against it.
+ Start-Sleep -Seconds 1
+ If ($script:ProgressSyncHash.Error) {
+ Write-Log -Message "Failure while displaying progress dialog. `n$(Resolve-Error -ErrorRecord $script:ProgressSyncHash.Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ ## Check if the progress thread is running before invoking methods on it
+ ElseIf ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -eq 'Running') {
+ # Update the progress text
+ Try {
+ $script:ProgressSyncHash.Window.Dispatcher.Invoke([Windows.Threading.DispatcherPriority]'Send', [Windows.Input.InputEventHandler]{ $script:ProgressSyncHash.ProgressText.Text = $statusMessage }, $null, $null)
+ Write-Log -Message "Updated progress message: [$statusMessage]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Unable to update the progress message. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Close-InstallationProgress
+Function Close-InstallationProgress {
+<#
+.SYNOPSIS
+ Closes the dialog created by Show-InstallationProgress.
+.DESCRIPTION
+ Closes the dialog created by Show-InstallationProgress.
+ This function is called by the Exit-Script function to close a running instance of the progress dialog if found.
+.EXAMPLE
+ Close-InstallationProgress
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -eq 'Running') {
+ ## Close the progress thread
+ Write-Log -Message 'Close the installation progress dialog.' -Source ${CmdletName}
+ $script:ProgressSyncHash.Window.Dispatcher.InvokeShutdown()
+ $script:ProgressSyncHash.Clear()
+ $script:ProgressRunspace.Close()
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-PinnedApplication
+Function Set-PinnedApplication {
+<#
+.SYNOPSIS
+ Pins or unpins a shortcut to the start menu or task bar.
+.DESCRIPTION
+ Pins or unpins a shortcut to the start menu or task bar.
+ This should typically be run in the user context, as pinned items are stored in the user profile.
+.PARAMETER Action
+ Action to be performed. Options: 'PintoStartMenu','UnpinfromStartMenu','PintoTaskbar','UnpinfromTaskbar'.
+.PARAMETER FilePath
+ Path to the shortcut file to be pinned or unpinned.
+.EXAMPLE
+ Set-PinnedApplication -Action 'PintoStartMenu' -FilePath "$envProgramFilesX86\IBM\Lotus\Notes\notes.exe"
+.EXAMPLE
+ Set-PinnedApplication -Action 'UnpinfromTaskbar' -FilePath "$envProgramFilesX86\IBM\Lotus\Notes\notes.exe"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('PintoStartMenu','UnpinfromStartMenu','PintoTaskbar','UnpinfromTaskbar')]
+ [string]$Action,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ #region Function Get-PinVerb
+ Function Get-PinVerb {
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [int32]$VerbId
+ )
+
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-Log -Message "Get localized pin verb for verb id [$VerbID]." -Source ${CmdletName}
+ [string]$PinVerb = [PSADT.FileVerb]::GetPinVerb($VerbId)
+ Write-Log -Message "Verb ID [$VerbID] has a localized pin verb of [$PinVerb]." -Source ${CmdletName}
+ Write-Output -InputObject $PinVerb
+ }
+ #endregion
+
+ #region Function Invoke-Verb
+ Function Invoke-Verb {
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Verb
+ )
+
+ Try {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ $verb = $verb.Replace('&','')
+ $path = Split-Path -Path $FilePath -Parent -ErrorAction 'Stop'
+ $folder = $shellApp.Namespace($path)
+ $item = $folder.ParseName((Split-Path -Path $FilePath -Leaf -ErrorAction 'Stop'))
+ $itemVerb = $item.Verbs() | Where-Object { $_.Name.Replace('&','') -eq $verb } -ErrorAction 'Stop'
+
+ If ($null -eq $itemVerb) {
+ Write-Log -Message "Performing action [$verb] is not programmatically supported for this file [$FilePath]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Perform action [$verb] on [$FilePath]." -Source ${CmdletName}
+ $itemVerb.DoIt()
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to perform action [$verb] on [$FilePath]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ #endregion
+
+ If (([version]$envOSVersion).Major -ge 10) {
+ Write-Log -Message "Detected Windows 10 or higher, using Windows 10 verb codes." -Source ${CmdletName}
+ [hashtable]$Verbs = @{
+ 'PintoStartMenu' = 51201
+ 'UnpinfromStartMenu' = 51394
+ 'PintoTaskbar' = 5386
+ 'UnpinfromTaskbar' = 5387
+ }
+ }
+ Else {
+ [hashtable]$Verbs = @{
+ 'PintoStartMenu' = 5381
+ 'UnpinfromStartMenu' = 5382
+ 'PintoTaskbar' = 5386
+ 'UnpinfromTaskbar' = 5387
+ }
+ }
+
+ }
+ Process {
+ Try {
+ Write-Log -Message "Execute action [$Action] for file [$FilePath]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf' -ErrorAction 'Stop')) {
+ Throw "Path [$filePath] does not exist."
+ }
+
+ If (-not ($Verbs.$Action)) {
+ Throw "Action [$Action] not supported. Supported actions are [$($Verbs.Keys -join ', ')]."
+ }
+
+ [string]$PinVerbAction = Get-PinVerb -VerbId $Verbs.$Action
+ If (-not ($PinVerbAction)) {
+ Throw "Failed to get a localized pin verb for action [$Action]. Action is not supported on this operating system."
+ }
+
+ Invoke-Verb -FilePath $FilePath -Verb $PinVerbAction
+ }
+ Catch {
+ Write-Log -Message "Failed to execute action [$Action]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-IniValue
+Function Get-IniValue {
+<#
+.SYNOPSIS
+ Parses an INI file and returns the value of the specified section and key.
+.DESCRIPTION
+ Parses an INI file and returns the value of the specified section and key.
+.PARAMETER FilePath
+ Path to the INI file.
+.PARAMETER Section
+ Section within the INI file.
+.PARAMETER Key
+ Key within the section of the INI file.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-IniValue -FilePath "$envProgramFilesX86\IBM\Notes\notes.ini" -Section 'Notes' -Key 'KeyFileName'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Section,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Read INI Key: [Section = $Section] [Key = $Key]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ $IniValue = [PSADT.IniFile]::GetIniValue($Section, $Key, $FilePath)
+ Write-Log -Message "INI Key Value: [Section = $Section] [Key = $Key] [Value = $IniValue]." -Source ${CmdletName}
+
+ Write-Output -InputObject $IniValue
+ }
+ Catch {
+ Write-Log -Message "Failed to read INI file key value. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read INI file key value: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-IniValue
+Function Set-IniValue {
+<#
+.SYNOPSIS
+ Opens an INI file and sets the value of the specified section and key.
+.DESCRIPTION
+ Opens an INI file and sets the value of the specified section and key.
+.PARAMETER FilePath
+ Path to the INI file.
+.PARAMETER Section
+ Section within the INI file.
+.PARAMETER Key
+ Key within the section of the INI file.
+.PARAMETER Value
+ Value for the key within the section of the INI file. To remove a value, set this variable to $null.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-IniValue -FilePath "$envProgramFilesX86\IBM\Notes\notes.ini" -Section 'Notes' -Key 'KeyFileName' -Value 'MyFile.ID'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Section,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ # Don't strongly type this variable as [string] b/c PowerShell replaces [string]$Value = $null with an empty string
+ [Parameter(Mandatory=$true)]
+ [AllowNull()]
+ $Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Write INI Key Value: [Section = $Section] [Key = $Key] [Value = $Value]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ [PSADT.IniFile]::SetIniValue($Section, $Key, ([Text.StringBuilder]$Value), $FilePath)
+ }
+ Catch {
+ Write-Log -Message "Failed to write INI file key value. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to write INI file key value: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-PEFileArchitecture
+Function Get-PEFileArchitecture {
+<#
+.SYNOPSIS
+ Determine if a PE file is a 32-bit or a 64-bit file.
+.DESCRIPTION
+ Determine if a PE file is a 32-bit or a 64-bit file by examining the file's image file header.
+ PE file extensions: .exe, .dll, .ocx, .drv, .sys, .scr, .efi, .cpl, .fon
+.PARAMETER FilePath
+ Path to the PE file to examine.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.PARAMETER PassThru
+ Get the file object, attach a property indicating the file binary type, and write to pipeline
+.EXAMPLE
+ Get-PEFileArchitecture -FilePath "$env:windir\notepad.exe"
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [IO.FileInfo[]]$FilePath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ [string[]]$PEFileExtensions = '.exe', '.dll', '.ocx', '.drv', '.sys', '.scr', '.efi', '.cpl', '.fon'
+ [int32]$MACHINE_OFFSET = 4
+ [int32]$PE_POINTER_OFFSET = 60
+ }
+ Process {
+ ForEach ($Path in $filePath) {
+ Try {
+ If ($PEFileExtensions -notcontains $Path.Extension) {
+ Throw "Invalid file type. Please specify one of the following PE file types: $($PEFileExtensions -join ', ')"
+ }
+
+ [byte[]]$data = New-Object -TypeName 'System.Byte[]' -ArgumentList 4096
+ $stream = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($Path.FullName, 'Open', 'Read')
+ $null = $stream.Read($data, 0, 4096)
+ $stream.Flush()
+ $stream.Close()
+
+ [int32]$PE_HEADER_ADDR = [BitConverter]::ToInt32($data, $PE_POINTER_OFFSET)
+ [uint16]$PE_IMAGE_FILE_HEADER = [BitConverter]::ToUInt16($data, $PE_HEADER_ADDR + $MACHINE_OFFSET)
+ Switch ($PE_IMAGE_FILE_HEADER) {
+ 0 { $PEArchitecture = 'Native' } # The contents of this file are assumed to be applicable to any machine type
+ 0x014c { $PEArchitecture = '32BIT' } # File for Windows 32-bit systems
+ 0x0200 { $PEArchitecture = 'Itanium-x64' } # File for Intel Itanium x64 processor family
+ 0x8664 { $PEArchitecture = '64BIT' } # File for Windows 64-bit systems
+ Default { $PEArchitecture = 'Unknown' }
+ }
+ Write-Log -Message "File [$($Path.FullName)] has a detected file architecture of [$PEArchitecture]." -Source ${CmdletName}
+
+ If ($PassThru) {
+ # Get the file object, attach a property indicating the type, and write to pipeline
+ Get-Item -LiteralPath $Path.FullName -Force | Add-Member -MemberType 'NoteProperty' -Name 'BinaryType' -Value $PEArchitecture -Force -PassThru | Write-Output
+ }
+ Else {
+ Write-Output -InputObject $PEArchitecture
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get the PE file architecture. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the PE file architecture: $($_.Exception.Message)"
+ }
+ Continue
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-RegisterOrUnregisterDLL
+Function Invoke-RegisterOrUnregisterDLL {
+<#
+.SYNOPSIS
+ Register or unregister a DLL file.
+.DESCRIPTION
+ Register or unregister a DLL file using regsvr32.exe. Function can be invoked using alias: 'Register-DLL' or 'Unregister-DLL'.
+.PARAMETER FilePath
+ Path to the DLL file.
+.PARAMETER DLLAction
+ Specify whether to register or unregister the DLL. Optional if function is invoked using 'Register-DLL' or 'Unregister-DLL' alias.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Register-DLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll"
+ Register DLL file using the "Register-DLL" alias for this function
+.EXAMPLE
+ UnRegister-DLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll"
+ Unregister DLL file using the "Unregister-DLL" alias for this function
+.EXAMPLE
+ Invoke-RegisterOrUnregisterDLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll" -DLLAction 'Register'
+ Register DLL file using the actual name of this function
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Register','Unregister')]
+ [string]$DLLAction,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Get name used to invoke this function in case the 'Register-DLL' or 'Unregister-DLL' alias was used and set the correct DLL action
+ [string]${InvokedCmdletName} = $MyInvocation.InvocationName
+ # Set the correct register/unregister action based on the alias used to invoke this function
+ If (${InvokedCmdletName} -ne ${CmdletName}) {
+ Switch (${InvokedCmdletName}) {
+ 'Register-DLL' { [string]$DLLAction = 'Register' }
+ 'Unregister-DLL' { [string]$DLLAction = 'Unregister' }
+ }
+ }
+ # Set the correct DLL register/unregister action parameters
+ If (-not $DLLAction) { Throw 'Parameter validation failed. Please specify the [-DLLAction] parameter to determine whether to register or unregister the DLL.' }
+ [string]$DLLAction = ((Get-Culture).TextInfo).ToTitleCase($DLLAction.ToLower())
+ Switch ($DLLAction) {
+ 'Register' { [string]$DLLActionParameters = "/s `"$FilePath`"" }
+ 'Unregister' { [string]$DLLActionParameters = "/s /u `"$FilePath`"" }
+ }
+ }
+ Process {
+ Try {
+ Write-Log -Message "$DLLAction DLL file [$filePath]." -Source ${CmdletName}
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ [string]$DLLFileBitness = Get-PEFileArchitecture -FilePath $filePath -ContinueOnError $false -ErrorAction 'Stop'
+ If (($DLLFileBitness -ne '64BIT') -and ($DLLFileBitness -ne '32BIT')) {
+ Throw "File [$filePath] has a detected file architecture of [$DLLFileBitness]. Only 32-bit or 64-bit DLL files can be $($DLLAction.ToLower() + 'ed')."
+ }
+
+ If ($Is64Bit) {
+ If ($DLLFileBitness -eq '64BIT') {
+ If ($Is64BitProcess) {
+ [string]$RegSvr32Path = "$envWinDir\system32\regsvr32.exe"
+ }
+ Else {
+ [string]$RegSvr32Path = "$envWinDir\sysnative\regsvr32.exe"
+ }
+ }
+ ElseIf ($DLLFileBitness -eq '32BIT') {
+ [string]$RegSvr32Path = "$envWinDir\SysWOW64\regsvr32.exe"
+ }
+ }
+ Else {
+ If ($DLLFileBitness -eq '64BIT') {
+ Throw "File [$filePath] cannot be $($DLLAction.ToLower()) because it is a 64-bit file on a 32-bit operating system."
+ }
+ ElseIf ($DLLFileBitness -eq '32BIT') {
+ [string]$RegSvr32Path = "$envWinDir\system32\regsvr32.exe"
+ }
+ }
+
+ [psobject]$ExecuteResult = Execute-Process -Path $RegSvr32Path -Parameters $DLLActionParameters -WindowStyle 'Hidden' -PassThru
+
+ If ($ExecuteResult.ExitCode -ne 0) {
+ If ($ExecuteResult.ExitCode -eq 60002) {
+ Throw "Execute-Process function failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ Else {
+ Throw "regsvr32.exe failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to $($DLLAction.ToLower()) DLL file. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $($DLLAction.ToLower()) DLL file: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Register-DLL' -Value 'Invoke-RegisterOrUnregisterDLL' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+Set-Alias -Name 'Unregister-DLL' -Value 'Invoke-RegisterOrUnregisterDLL' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Invoke-ObjectMethod
+Function Invoke-ObjectMethod {
+<#
+.SYNOPSIS
+ Invoke method on any object.
+.DESCRIPTION
+ Invoke method on any object with or without using named parameters.
+.PARAMETER InputObject
+ Specifies an object which has methods that can be invoked.
+.PARAMETER MethodName
+ Specifies the name of a method to invoke.
+.PARAMETER ArgumentList
+ Argument to pass to the method being executed. Allows execution of method without specifying named parameters.
+.PARAMETER Parameter
+ Argument to pass to the method being executed. Allows execution of method by using named parameters.
+.EXAMPLE
+ $ShellApp = New-Object -ComObject 'Shell.Application'
+ $null = Invoke-ObjectMethod -InputObject $ShellApp -MethodName 'MinimizeAll'
+ Minimizes all windows.
+.EXAMPLE
+ $ShellApp = New-Object -ComObject 'Shell.Application'
+ $null = Invoke-ObjectMethod -InputObject $ShellApp -MethodName 'Explore' -Parameter @{'vDir'='C:\Windows'}
+ Opens the C:\Windows folder in a Windows Explorer window.
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='Positional')]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNull()]
+ [object]$InputObject,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$MethodName,
+ [Parameter(Mandatory=$false,Position=2,ParameterSetName='Positional')]
+ [object[]]$ArgumentList,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='Named')]
+ [ValidateNotNull()]
+ [hashtable]$Parameter
+ )
+
+ Begin { }
+ Process {
+ If ($PSCmdlet.ParameterSetName -eq 'Named') {
+ ## Invoke method by using parameter names
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($MethodName, [Reflection.BindingFlags]::InvokeMethod, $null, $InputObject, ([object[]]($Parameter.Values)), $null, $null, ([string[]]($Parameter.Keys)))
+ }
+ Else {
+ ## Invoke method without using parameter names
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($MethodName, [Reflection.BindingFlags]::InvokeMethod, $null, $InputObject, $ArgumentList, $null, $null, $null)
+ }
+ }
+ End { }
+}
+#endregion
+
+
+#region Function Get-ObjectProperty
+Function Get-ObjectProperty {
+<#
+.SYNOPSIS
+ Get a property from any object.
+.DESCRIPTION
+ Get a property from any object.
+.PARAMETER InputObject
+ Specifies an object which has properties that can be retrieved.
+.PARAMETER PropertyName
+ Specifies the name of a property to retrieve.
+.PARAMETER ArgumentList
+ Argument to pass to the property being retrieved.
+.EXAMPLE
+ Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @(1)
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNull()]
+ [object]$InputObject,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyName,
+ [Parameter(Mandatory=$false,Position=2)]
+ [object[]]$ArgumentList
+ )
+
+ Begin { }
+ Process {
+ ## Retrieve property
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($PropertyName, [Reflection.BindingFlags]::GetProperty, $null, $InputObject, $ArgumentList, $null, $null, $null)
+ }
+ End { }
+}
+#endregion
+
+
+#region Function Get-MsiTableProperty
+Function Get-MsiTableProperty {
+<#
+.SYNOPSIS
+ Get all of the properties from a Windows Installer database table or the Summary Information stream and return as a custom object.
+.DESCRIPTION
+ Use the Windows Installer object to read all of the properties from a Windows Installer database table or the Summary Information stream.
+.PARAMETER Path
+ The fully qualified path to an database file. Supports .msi and .msp files.
+.PARAMETER TransformPath
+ The fully qualified path to a list of MST file(s) which should be applied to the MSI file.
+.PARAMETER Table
+ The name of the the MSI table from which all of the properties must be retrieved. Default is: 'Property'.
+.PARAMETER TablePropertyNameColumnNum
+ Specify the table column number which contains the name of the properties. Default is: 1 for MSIs and 2 for MSPs.
+.PARAMETER TablePropertyValueColumnNum
+ Specify the table column number which contains the value of the properties. Default is: 2 for MSIs and 3 for MSPs.
+.PARAMETER GetSummaryInformation
+ Retrieves the Summary Information for the Windows Installer database.
+ Summary Information property descriptions: https://msdn.microsoft.com/en-us/library/aa372049(v=vs.85).aspx
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -TransformPath 'C:\Package\AppDeploy.mst'
+ Retrieve all of the properties from the default 'Property' table.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -TransformPath 'C:\Package\AppDeploy.mst' -Table 'Property' | Select-Object -ExpandProperty ProductCode
+ Retrieve all of the properties from the 'Property' table and then pipe to Select-Object to select the ProductCode property.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -GetSummaryInformation
+ Retrieves the Summary Information for the Windows Installer database.
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='TableInfo')]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string[]]$TransformPath,
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullOrEmpty()]
+ [string]$Table = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 'Property' } Else { 'MsiPatchMetadata' }),
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullorEmpty()]
+ [int32]$TablePropertyNameColumnNum = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 1 } Else { 2 }),
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullorEmpty()]
+ [int32]$TablePropertyValueColumnNum = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 2 } Else { 3 }),
+ [Parameter(Mandatory=$true,ParameterSetName='SummaryInfo')]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetSummaryInformation = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'TableInfo') {
+ Write-Log -Message "Read data from Windows Installer database file [$Path] in table [$Table]." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Read the Summary Information from the Windows Installer database file [$Path]." -Source ${CmdletName}
+ }
+
+ ## Create a Windows Installer object
+ [__comobject]$Installer = New-Object -ComObject 'WindowsInstaller.Installer' -ErrorAction 'Stop'
+ ## Determine if the database file is a patch (.msp) or not
+ If ([IO.Path]::GetExtension($Path) -eq '.msp') { [boolean]$IsMspFile = $true }
+ ## Define properties for how the MSI database is opened
+ [int32]$msiOpenDatabaseModeReadOnly = 0
+ [int32]$msiSuppressApplyTransformErrors = 63
+ [int32]$msiOpenDatabaseMode = $msiOpenDatabaseModeReadOnly
+ [int32]$msiOpenDatabaseModePatchFile = 32
+ If ($IsMspFile) { [int32]$msiOpenDatabaseMode = $msiOpenDatabaseModePatchFile }
+ ## Open database in read only mode
+ [__comobject]$Database = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($Path, $msiOpenDatabaseMode)
+ ## Apply a list of transform(s) to the database
+ If (($TransformPath) -and (-not $IsMspFile)) {
+ ForEach ($Transform in $TransformPath) {
+ $null = Invoke-ObjectMethod -InputObject $Database -MethodName 'ApplyTransform' -ArgumentList @($Transform, $msiSuppressApplyTransformErrors)
+ }
+ }
+
+ ## Get either the requested windows database table information or summary information
+ If ($PSCmdlet.ParameterSetName -eq 'TableInfo') {
+ ## Open the requested table view from the database
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $Database -MethodName 'OpenView' -ArgumentList @("SELECT * FROM $Table")
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+
+ ## Create an empty object to store properties in
+ [psobject]$TableProperties = New-Object -TypeName 'PSObject'
+
+ ## Retrieve the first row from the requested table. If the first row was successfully retrieved, then save data and loop through the entire table.
+ # https://msdn.microsoft.com/en-us/library/windows/desktop/aa371136(v=vs.85).aspx
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+ While ($Record) {
+ # Read string data from record and add property/value pair to custom object
+ $TableProperties | Add-Member -MemberType 'NoteProperty' -Name (Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @($TablePropertyNameColumnNum)) -Value (Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @($TablePropertyValueColumnNum)) -Force
+ # Retrieve the next row in the table
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+ }
+ Write-Output -InputObject $TableProperties
+ }
+ Else {
+ ## Get the SummaryInformation from the windows installer database
+ [__comobject]$SummaryInformation = Get-ObjectProperty -InputObject $Database -PropertyName 'SummaryInformation'
+ [hashtable]$SummaryInfoProperty = @{}
+ ## Summary property descriptions: https://msdn.microsoft.com/en-us/library/aa372049(v=vs.85).aspx
+ $SummaryInfoProperty.Add('CodePage', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(1)))
+ $SummaryInfoProperty.Add('Title', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(2)))
+ $SummaryInfoProperty.Add('Subject', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(3)))
+ $SummaryInfoProperty.Add('Author', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(4)))
+ $SummaryInfoProperty.Add('Keywords', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(5)))
+ $SummaryInfoProperty.Add('Comments', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(6)))
+ $SummaryInfoProperty.Add('Template', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(7)))
+ $SummaryInfoProperty.Add('LastSavedBy', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(8)))
+ $SummaryInfoProperty.Add('RevisionNumber', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(9)))
+ $SummaryInfoProperty.Add('LastPrinted', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(11)))
+ $SummaryInfoProperty.Add('CreateTimeDate', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(12)))
+ $SummaryInfoProperty.Add('LastSaveTimeDate', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(13)))
+ $SummaryInfoProperty.Add('PageCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(14)))
+ $SummaryInfoProperty.Add('WordCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(15)))
+ $SummaryInfoProperty.Add('CharacterCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(16)))
+ $SummaryInfoProperty.Add('CreatingApplication', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(18)))
+ $SummaryInfoProperty.Add('Security', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(19)))
+ [psobject]$SummaryInfoProperties = New-Object -TypeName 'PSObject' -Property $SummaryInfoProperty
+ Write-Output -InputObject $SummaryInfoProperties
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get the MSI table [$Table]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the MSI table [$Table]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try {
+ If ($View) {
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View) } Catch { }
+ }
+ ElseIf($SummaryInformation) {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SummaryInformation) } Catch { }
+ }
+ }
+ Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($DataBase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-MsiProperty
+Function Set-MsiProperty {
+<#
+.SYNOPSIS
+ Set a property in the MSI property table.
+.DESCRIPTION
+ Set a property in the MSI property table.
+.PARAMETER DataBase
+ Specify a ComObject representing an MSI database opened in view/modify/update mode.
+.PARAMETER PropertyName
+ The name of the property to be set/modified.
+.PARAMETER PropertyValue
+ The value of the property to be set/modified.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-MsiProperty -DataBase $TempMsiPathDatabase -PropertyName 'ALLUSERS' -PropertyValue '1'
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [__comobject]$DataBase,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyName,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyValue,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]." -Source ${CmdletName}
+
+ ## Open the requested table view from the database
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("SELECT * FROM Property WHERE Property='$PropertyName'")
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+
+ ## Retrieve the requested property from the requested table.
+ # https://msdn.microsoft.com/en-us/library/windows/desktop/aa371136(v=vs.85).aspx
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+
+ ## Close the previous view on the MSI database
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View)
+
+ ## Set the MSI property
+ If ($Record) {
+ # If the property already exists, then create the view for updating the property
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("UPDATE Property SET Value='$PropertyValue' WHERE Property='$PropertyName'")
+ }
+ Else {
+ # If property does not exist, then create view for inserting the property
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("INSERT INTO Property (Property, Value) VALUES ('$PropertyName','$PropertyValue')")
+ }
+ # Execute the view to set the MSI property
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+ }
+ Catch {
+ Write-Log -Message "Failed to set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try {
+ If ($View) {
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View)
+ }
+ }
+ Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-MsiTransform
+Function New-MsiTransform {
+<#
+.SYNOPSIS
+ Create a transform file for an MSI database.
+.DESCRIPTION
+ Create a transform file for an MSI database and create/modify properties in the Properties table.
+.PARAMETER MsiPath
+ Specify the path to an MSI file.
+.PARAMETER ApplyTransformPath
+ Specify the path to a transform which should be applied to the MSI database before any new properties are created or modified.
+.PARAMETER NewTransformPath
+ Specify the path where the new transform file with the desired properties will be created. If a transform file of the same name already exists, it will be deleted before a new one is created.
+ Default is: a) If -ApplyTransformPath was specified but not -NewTransformPath, then .new.mst
+ b) If only -MsiPath was specified, then .mst
+.PARAMETER TransformProperties
+ Hashtable which contains calls to Set-MsiProperty for configuring the desired properties which should be included in new transform file.
+ Example hashtable: [hashtable]$TransformProperties = @{ 'ALLUSERS' = '1' }
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ [hashtable]$TransformProperties = {
+ 'ALLUSERS' = '1'
+ 'AgreeToLicense' = 'Yes'
+ 'REBOOT' = 'ReallySuppress'
+ 'RebootYesNo' = 'No'
+ 'ROOTDRIVE' = 'C:'
+ }
+ New-MsiTransform -MsiPath 'C:\Temp\PSADTInstall.msi' -TransformProperties $TransformProperties
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$MsiPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$ApplyTransformPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$NewTransformPath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [hashtable]$TransformProperties,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Define properties for how the MSI database is opened
+ [int32]$msiOpenDatabaseModeReadOnly = 0
+ [int32]$msiOpenDatabaseModeTransact = 1
+ [int32]$msiViewModifyUpdate = 2
+ [int32]$msiViewModifyReplace = 4
+ [int32]$msiViewModifyDelete = 6
+ [int32]$msiTransformErrorNone = 0
+ [int32]$msiTransformValidationNone = 0
+ [int32]$msiSuppressApplyTransformErrors = 63
+ }
+ Process {
+ Try {
+ Write-Log -Message "Create a transform file for MSI [$MsiPath]." -Source ${CmdletName}
+
+ ## Discover the parent folder that the MSI file resides in
+ [string]$MsiParentFolder = Split-Path -Path $MsiPath -Parent -ErrorAction 'Stop'
+
+ ## Create a temporary file name for storing a second copy of the MSI database
+ [string]$TempMsiPath = Join-Path -Path $MsiParentFolder -ChildPath ([IO.Path]::GetFileName(([IO.Path]::GetTempFileName()))) -ErrorAction 'Stop'
+
+ ## Create a second copy of the MSI database
+ Write-Log -Message "Copy MSI database in path [$MsiPath] to destination [$TempMsiPath]." -Source ${CmdletName}
+ $null = Copy-Item -LiteralPath $MsiPath -Destination $TempMsiPath -Force -ErrorAction 'Stop'
+
+ ## Create a Windows Installer object
+ [__comobject]$Installer = New-Object -ComObject 'WindowsInstaller.Installer' -ErrorAction 'Stop'
+
+ ## Open both copies of the MSI database
+ # Open the original MSI database in read only mode
+ Write-Log -Message "Open the MSI database [$MsiPath] in read only mode." -Source ${CmdletName}
+ [__comobject]$MsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($MsiPath, $msiOpenDatabaseModeReadOnly)
+ # Open the temporary copy of the MSI database in view/modify/update mode
+ Write-Log -Message "Open the MSI database [$TempMsiPath] in view/modify/update mode." -Source ${CmdletName}
+ [__comobject]$TempMsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($TempMsiPath, $msiViewModifyUpdate)
+
+ ## If a MSI transform file was specified, then apply it to the temporary copy of the MSI database
+ If ($ApplyTransformPath) {
+ Write-Log -Message "Apply transform file [$ApplyTransformPath] to MSI database [$TempMsiPath]." -Source ${CmdletName}
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'ApplyTransform' -ArgumentList @($ApplyTransformPath, $msiSuppressApplyTransformErrors)
+ }
+
+ ## Determine the path for the new transform file that will be generated
+ If (-not $NewTransformPath) {
+ If ($ApplyTransformPath) {
+ [string]$NewTransformFileName = [IO.Path]::GetFileNameWithoutExtension($ApplyTransformPath) + '.new' + [IO.Path]::GetExtension($ApplyTransformPath)
+ }
+ Else {
+ [string]$NewTransformFileName = [IO.Path]::GetFileNameWithoutExtension($MsiPath) + '.mst'
+ }
+ [string]$NewTransformPath = Join-Path -Path $MsiParentFolder -ChildPath $NewTransformFileName -ErrorAction 'Stop'
+ }
+
+ ## Set the MSI properties in the temporary copy of the MSI database
+ $TransformProperties.GetEnumerator() | ForEach-Object { Set-MsiProperty -DataBase $TempMsiPathDatabase -PropertyName $_.Key -PropertyValue $_.Value }
+
+ ## Commit the new properties to the temporary copy of the MSI database
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'Commit'
+
+ ## Reopen the temporary copy of the MSI database in read only mode
+ # Release the database object for the temporary copy of the MSI database
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($TempMsiPathDatabase)
+ # Open the temporary copy of the MSI database in read only mode
+ Write-Log -Message "Re-open the MSI database [$TempMsiPath] in read only mode." -Source ${CmdletName}
+ [__comobject]$TempMsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($TempMsiPath, $msiOpenDatabaseModeReadOnly)
+
+ ## Delete the new transform file path if it already exists
+ If (Test-Path -LiteralPath $NewTransformPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "A transform file of the same name already exists. Deleting transform file [$NewTransformPath]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $NewTransformPath -Force -ErrorAction 'Stop'
+ }
+
+ ## Generate the new transform file by taking the difference between the temporary copy of the MSI database and the original MSI database
+ Write-Log -Message "Generate new transform file [$NewTransformPath]." -Source ${CmdletName}
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'GenerateTransform' -ArgumentList @($MsiPathDatabase, $NewTransformPath)
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'CreateTransformSummaryInfo' -ArgumentList @($MsiPathDatabase, $NewTransformPath, $msiTransformErrorNone, $msiTransformValidationNone)
+
+ If (Test-Path -LiteralPath $NewTransformPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "Successfully created new transform file in path [$NewTransformPath]." -Source ${CmdletName}
+ }
+ Else {
+ Throw "Failed to generate transform file in path [$NewTransformPath]."
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create new transform file in path [$NewTransformPath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create new transform file in path [$NewTransformPath]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($TempMsiPathDatabase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($MsiPathDatabase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ Try {
+ ## Delete the temporary copy of the MSI database
+ If (Test-Path -LiteralPath $TempMsiPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ $null = Remove-Item -LiteralPath $TempMsiPath -Force -ErrorAction 'Stop'
+ }
+ }
+ Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-MSUpdates
+Function Test-MSUpdates {
+<#
+.SYNOPSIS
+ Test whether a Microsoft Windows update is installed.
+.DESCRIPTION
+ Test whether a Microsoft Windows update is installed.
+.PARAMETER KBNumber
+ KBNumber of the update.
+.PARAMETER ContinueOnError
+ Suppress writing log message to console on failure to write message to log file. Default is: $true.
+.EXAMPLE
+ Test-MSUpdates -KBNumber 'KB2549864'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,HelpMessage='Enter the KB Number for the Microsoft Update')]
+ [ValidateNotNullorEmpty()]
+ [string]$KBNumber,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Check if Microsoft Update [$kbNumber] is installed." -Source ${CmdletName}
+
+ ## Default is not found
+ [boolean]$kbFound = $false
+
+ ## Check for update using built in PS cmdlet which uses WMI in the background to gather details
+ Get-Hotfix -Id $kbNumber -ErrorAction 'SilentlyContinue' | ForEach-Object { $kbFound = $true }
+
+ If (-not $kbFound) {
+ Write-Log -Message 'Unable to detect Windows update history via Get-Hotfix cmdlet. Trying via COM object.' -Source ${CmdletName}
+
+ ## Check for update using ComObject method (to catch Office updates)
+ [__comobject]$UpdateSession = New-Object -ComObject "Microsoft.Update.Session"
+ [__comobject]$UpdateSearcher = $UpdateSession.CreateUpdateSearcher()
+ # Indicates whether the search results include updates that are superseded by other updates in the search results
+ $UpdateSearcher.IncludePotentiallySupersededUpdates = $false
+ # Indicates whether the UpdateSearcher goes online to search for updates.
+ $UpdateSearcher.Online = $false
+ [int32]$UpdateHistoryCount = $UpdateSearcher.GetTotalHistoryCount()
+ If ($UpdateHistoryCount -gt 0) {
+ [psobject]$UpdateHistory = $UpdateSearcher.QueryHistory(0, $UpdateHistoryCount) |
+ Select-Object -Property 'Title','Date',
+ @{Name = 'Operation'; Expression = { Switch ($_.Operation) { 1 {'Installation'}; 2 {'Uninstallation'}; 3 {'Other'} } } },
+ @{Name = 'Status'; Expression = { Switch ($_.ResultCode) { 0 {'Not Started'}; 1 {'In Progress'}; 2 {'Successful'}; 3 {'Incomplete'}; 4 {'Failed'}; 5 {'Aborted'} } } },
+ 'Description' |
+ Sort-Object -Property 'Date' -Descending
+ ForEach ($Update in $UpdateHistory) {
+ If (($Update.Operation -ne 'Other') -and ($Update.Title -match "\($KBNumber\)")) {
+ $LatestUpdateHistory = $Update
+ Break
+ }
+ }
+ If (($LatestUpdateHistory.Operation -eq 'Installation') -and ($LatestUpdateHistory.Status -eq 'Successful')) {
+ Write-Log -Message "Discovered the following Microsoft Update: `n$($LatestUpdateHistory | Format-List | Out-String)" -Source ${CmdletName}
+ $kbFound = $true
+ }
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($UpdateSession)
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($UpdateSearcher)
+ }
+ Else {
+ Write-Log -Message 'Unable to detect Windows update history via COM object.' -Source ${CmdletName}
+ }
+ }
+
+ ## Return Result
+ If (-not $kbFound) {
+ Write-Log -Message "Microsoft Update [$kbNumber] is not installed." -Source ${CmdletName}
+ Write-Output -InputObject $false
+ }
+ Else {
+ Write-Log -Message "Microsoft Update [$kbNumber] is installed." -Source ${CmdletName}
+ Write-Output -InputObject $true
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed discovering Microsoft Update [$kbNumber]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed discovering Microsoft Update [$kbNumber]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Install-MSUpdates
+Function Install-MSUpdates {
+<#
+.SYNOPSIS
+ Install all Microsoft Updates in a given directory.
+.DESCRIPTION
+ Install all Microsoft Updates of type ".exe", ".msu", or ".msp" in a given directory (recursively search directory).
+.PARAMETER Directory
+ Directory containing the updates.
+.EXAMPLE
+ Install-MSUpdates -Directory "$dirFiles\MSUpdates"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Directory
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message "Recursively install all Microsoft Updates in directory [$Directory]." -Source ${CmdletName}
+
+ ## KB Number pattern match
+ $kbPattern = '(?i)kb\d{6,8}'
+
+ ## Get all hotfixes and install if required
+ [IO.FileInfo[]]$files = Get-ChildItem -LiteralPath $Directory -Recurse -Include ('*.exe','*.msu','*.msp')
+ ForEach ($file in $files) {
+ If ($file.Name -match 'redist') {
+ [version]$redistVersion = [Diagnostics.FileVersionInfo]::GetVersionInfo($file.FullName).ProductVersion
+ [string]$redistDescription = [Diagnostics.FileVersionInfo]::GetVersionInfo($file.FullName).FileDescription
+
+ Write-Log -Message "Install [$redistDescription $redistVersion]..." -Source ${CmdletName}
+ # Handle older redistributables (ie, VC++ 2005)
+ If ($redistDescription -match 'Win32 Cabinet Self-Extractor') {
+ Execute-Process -Path $file.FullName -Parameters '/q' -WindowStyle 'Hidden' -ContinueOnError $true
+ }
+ Else {
+ Execute-Process -Path $file.FullName -Parameters '/quiet /norestart' -WindowStyle 'Hidden' -ContinueOnError $true
+ }
+ }
+ Else {
+ # Get the KB number of the file
+ [string]$kbNumber = [regex]::Match($file.Name, $kbPattern).ToString()
+ If (-not $kbNumber) { Continue }
+
+ # Check to see whether the KB is already installed
+ If (-not (Test-MSUpdates -KBNumber $kbNumber)) {
+ Write-Log -Message "KB Number [$KBNumber] was not detected and will be installed." -Source ${CmdletName}
+ Switch ($file.Extension) {
+ # Installation type for executables (i.e., Microsoft Office Updates)
+ '.exe' { Execute-Process -Path $file.FullName -Parameters '/quiet /norestart' -WindowStyle 'Hidden' -ContinueOnError $true }
+ # Installation type for Windows updates using Windows Update Standalone Installer
+ '.msu' { Execute-Process -Path 'wusa.exe' -Parameters "`"$($file.FullName)`" /quiet /norestart" -WindowStyle 'Hidden' -ContinueOnError $true }
+ # Installation type for Windows Installer Patch
+ '.msp' { Execute-MSI -Action 'Patch' -Path $file.FullName -ContinueOnError $true }
+ }
+ }
+ Else {
+ Write-Log -Message "KB Number [$kbNumber] is already installed. Continue..." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-WindowTitle
+Function Get-WindowTitle {
+<#
+.SYNOPSIS
+ Search for an open window title and return details about the window.
+.DESCRIPTION
+ Search for a window title. If window title searched for returns more than one result, then details for each window will be displayed.
+ Returns the following properties for each window: WindowTitle, WindowHandle, ParentProcess, ParentProcessMainWindowHandle, ParentProcessId.
+ Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER WindowTitle
+ The title of the application window to search for using regex matching.
+.PARAMETER GetAllWindowTitles
+ Get titles for all open windows on the system.
+.PARAMETER DisableFunctionLogging
+ Disables logging messages to the script log file.
+.EXAMPLE
+ Get-WindowTitle -WindowTitle 'Microsoft Word'
+ Gets details for each window that has the words "Microsoft Word" in the title.
+.EXAMPLE
+ Get-WindowTitle -GetAllWindowTitles
+ Gets details for all windows with a title.
+.EXAMPLE
+ Get-WindowTitle -GetAllWindowTitles | Where-Object { $_.ParentProcess -eq 'WINWORD' }
+ Get details for all windows belonging to Microsoft Word process with name "WINWORD".
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='SearchWinTitle')]
+ [AllowEmptyString()]
+ [string]$WindowTitle,
+ [Parameter(Mandatory=$true,ParameterSetName='GetAllWinTitles')]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetAllWindowTitles = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$DisableFunctionLogging = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'SearchWinTitle') {
+ If (-not $DisableFunctionLogging) { Write-Log -Message "Find open window title(s) [$WindowTitle] using regex matching." -Source ${CmdletName} }
+ }
+ ElseIf ($PSCmdlet.ParameterSetName -eq 'GetAllWinTitles') {
+ If (-not $DisableFunctionLogging) { Write-Log -Message 'Find all open window title(s).' -Source ${CmdletName} }
+ }
+
+ ## Get all window handles for visible windows
+ [IntPtr[]]$VisibleWindowHandles = [PSADT.UiAutomation]::EnumWindows() | Where-Object { [PSADT.UiAutomation]::IsWindowVisible($_) }
+
+ ## Discover details about each visible window that was discovered
+ ForEach ($VisibleWindowHandle in $VisibleWindowHandles) {
+ If (-not $VisibleWindowHandle) { Continue }
+ ## Get the window title
+ [string]$VisibleWindowTitle = [PSADT.UiAutomation]::GetWindowText($VisibleWindowHandle)
+ If ($VisibleWindowTitle) {
+ ## Get the process that spawned the window
+ [Diagnostics.Process]$Process = Get-Process -ErrorAction 'Stop' | Where-Object { $_.Id -eq [PSADT.UiAutomation]::GetWindowThreadProcessId($VisibleWindowHandle) }
+ If ($Process) {
+ ## Build custom object with details about the window and the process
+ [psobject]$VisibleWindow = New-Object -TypeName 'PSObject' -Property @{
+ WindowTitle = $VisibleWindowTitle
+ WindowHandle = $VisibleWindowHandle
+ ParentProcess= $Process.Name
+ ParentProcessMainWindowHandle = $Process.MainWindowHandle
+ ParentProcessId = $Process.Id
+ }
+
+ ## Only save/return the window and process details which match the search criteria
+ If ($PSCmdlet.ParameterSetName -eq 'SearchWinTitle') {
+ $MatchResult = $VisibleWindow.WindowTitle -match $WindowTitle
+ If ($MatchResult) {
+ [psobject[]]$VisibleWindows += $VisibleWindow
+ }
+ }
+ ElseIf ($PSCmdlet.ParameterSetName -eq 'GetAllWinTitles') {
+ [psobject[]]$VisibleWindows += $VisibleWindow
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ If (-not $DisableFunctionLogging) { Write-Log -Message "Failed to get requested window title(s). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName} }
+ }
+ }
+ End {
+ Write-Output -InputObject $VisibleWindows
+
+ If ($DisableFunctionLogging) { . $RevertScriptLogging }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Send-Keys
+Function Send-Keys {
+<#
+.SYNOPSIS
+ Send a sequence of keys to one or more application windows.
+.DESCRIPTION
+ Send a sequence of keys to one or more application window. If window title searched for returns more than one window, then all of them will receive the sent keys.
+ Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER WindowTitle
+ The title of the application window to search for using regex matching.
+.PARAMETER GetAllWindowTitles
+ Get titles for all open windows on the system.
+.PARAMETER WindowHandle
+ Send keys to a specific window where the Window Handle is already known.
+.PARAMETER Keys
+ The sequence of keys to send. Info on Key input at: http://msdn.microsoft.com/en-us/library/System.Windows.Forms.SendKeys(v=vs.100).aspx
+.PARAMETER WaitSeconds
+ An optional number of seconds to wait after the sending of the keys.
+.EXAMPLE
+ Send-Keys -WindowTitle 'foobar - Notepad' -Key 'Hello world'
+ Send the sequence of keys "Hello world" to the application titled "foobar - Notepad".
+.EXAMPLE
+ Send-Keys -WindowTitle 'foobar - Notepad' -Key 'Hello world' -WaitSeconds 5
+ Send the sequence of keys "Hello world" to the application titled "foobar - Notepad" and wait 5 seconds.
+.EXAMPLE
+ Send-Keys -WindowHandle ([IntPtr]17368294) -Key 'Hello world'
+ Send the sequence of keys "Hello world" to the application with a Window Handle of '17368294'.
+.NOTES
+.LINK
+ http://msdn.microsoft.com/en-us/library/System.Windows.Forms.SendKeys(v=vs.100).aspx
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false,Position=0)]
+ [AllowEmptyString()]
+ [ValidateNotNull()]
+ [string]$WindowTitle,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetAllWindowTitles = $false,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNullorEmpty()]
+ [IntPtr]$WindowHandle,
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [string]$Keys,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [int32]$WaitSeconds
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Load assembly containing class System.Windows.Forms.SendKeys
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+
+ [scriptblock]$SendKeys = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [IntPtr]$WindowHandle
+ )
+ Try {
+ ## Bring the window to the foreground
+ [boolean]$IsBringWindowToFrontSuccess = [PSADT.UiAutomation]::BringWindowToFront($WindowHandle)
+ If (-not $IsBringWindowToFrontSuccess) { Throw 'Failed to bring window to foreground.'}
+
+ ## Send the Key sequence
+ If ($Keys) {
+ [boolean]$IsWindowModal = If ([PSADT.UiAutomation]::IsWindowEnabled($WindowHandle)) { $false } Else { $true }
+ If ($IsWindowModal) { Throw 'Unable to send keys to window because it may be disabled due to a modal dialog being shown.' }
+ [Windows.Forms.SendKeys]::SendWait($Keys)
+ Write-Log -Message "Sent key(s) [$Keys] to window title [$($Window.WindowTitle)] with window handle [$WindowHandle]." -Source ${CmdletName}
+
+ If ($WaitSeconds) {
+ Write-Log -Message "Sleeping for [$WaitSeconds] seconds." -Source ${CmdletName}
+ Start-Sleep -Seconds $WaitSeconds
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to send keys to window title [$($Window.WindowTitle)] with window handle [$WindowHandle]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ Process {
+ Try {
+ If ($WindowHandle) {
+ [psobject]$Window = Get-WindowTitle -GetAllWindowTitles | Where-Object { $_.WindowHandle -eq $WindowHandle }
+ If (-not $Window) {
+ Write-Log -Message "No windows with Window Handle [$WindowHandle] were discovered." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+ & $SendKeys -WindowHandle $Window.WindowHandle
+ }
+ Else {
+ [hashtable]$GetWindowTitleSplat = @{}
+ If ($GetAllWindowTitles) { $GetWindowTitleSplat.Add( 'GetAllWindowTitles', $GetAllWindowTitles) }
+ Else { $GetWindowTitleSplat.Add( 'WindowTitle', $WindowTitle) }
+ [psobject[]]$AllWindows = Get-WindowTitle @GetWindowTitleSplat
+ If (-not $AllWindows) {
+ Write-Log -Message 'No windows with the specified details were discovered.' -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ ForEach ($Window in $AllWindows) {
+ & $SendKeys -WindowHandle $Window.WindowHandle
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to send keys to specified window. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-Battery
+Function Test-Battery {
+<#
+.SYNOPSIS
+ Tests whether the local machine is running on AC power or not.
+.DESCRIPTION
+ Tests whether the local machine is running on AC power and returns true/false. For detailed information, use -PassThru option.
+.PARAMETER PassThru
+ Outputs a hashtable containing the following properties:
+ IsLaptop, IsUsingACPower, ACPowerLineStatus, BatteryChargeStatus, BatteryLifePercent, BatteryLifeRemaining, BatteryFullLifetime
+.EXAMPLE
+ Test-Battery
+.EXAMPLE
+ (Test-Battery -PassThru).IsLaptop
+ Determines if the current system is a laptop or not.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## PowerStatus class found in this assembly is more reliable than WMI in cases where the battery is failing.
+ Add-Type -Assembly 'System.Windows.Forms' -ErrorAction 'SilentlyContinue'
+
+ ## Initialize a hashtable to store information about system type and power status
+ [hashtable]$SystemTypePowerStatus = @{ }
+ }
+ Process {
+ Write-Log -Message 'Check if system is using AC power or if it is running on battery...' -Source ${CmdletName}
+
+ [Windows.Forms.PowerStatus]$PowerStatus = [Windows.Forms.SystemInformation]::PowerStatus
+
+ ## Get the system power status. Indicates whether the system is using AC power or if the status is unknown. Possible values:
+ # Offline : The system is not using AC power.
+ # Online : The system is using AC power.
+ # Unknown : The power status of the system is unknown.
+ [string]$PowerLineStatus = $PowerStatus.PowerLineStatus
+ $SystemTypePowerStatus.Add('ACPowerLineStatus', $PowerStatus.PowerLineStatus)
+
+ ## Get the current battery charge status. Possible values: High, Low, Critical, Charging, NoSystemBattery, Unknown.
+ [string]$BatteryChargeStatus = $PowerStatus.BatteryChargeStatus
+ $SystemTypePowerStatus.Add('BatteryChargeStatus', $PowerStatus.BatteryChargeStatus)
+
+ ## Get the approximate amount, from 0.00 to 1.0, of full battery charge remaining.
+ # This property can report 1.0 when the battery is damaged and Windows can't detect a battery.
+ # Therefore, this property is only indicative of battery charge remaining if 'BatteryChargeStatus' property is not reporting 'NoSystemBattery' or 'Unknown'.
+ [single]$BatteryLifePercent = $PowerStatus.BatteryLifePercent
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ [single]$BatteryLifePercent = 0.0
+ }
+ $SystemTypePowerStatus.Add('BatteryLifePercent', $PowerStatus.BatteryLifePercent)
+
+ ## The reported approximate number of seconds of battery life remaining. It will report –1 if the remaining life is unknown because the system is on AC power.
+ [int32]$BatteryLifeRemaining = $PowerStatus.BatteryLifeRemaining
+ $SystemTypePowerStatus.Add('BatteryLifeRemaining', $PowerStatus.BatteryLifeRemaining)
+
+ ## Get the manufacturer reported full charge lifetime of the primary battery power source in seconds.
+ # The reported number of seconds of battery life available when the battery is fully charged, or -1 if it is unknown.
+ # This will only be reported if the battery supports reporting this information. You will most likely get -1, indicating unknown.
+ [int32]$BatteryFullLifetime = $PowerStatus.BatteryFullLifetime
+ $SystemTypePowerStatus.Add('BatteryFullLifetime', $PowerStatus.BatteryFullLifetime)
+
+ ## Determine if the system is using AC power
+ [boolean]$OnACPower = $false
+ If ($PowerLineStatus -eq 'Online') {
+ Write-Log -Message 'System is using AC power.' -Source ${CmdletName}
+ $OnACPower = $true
+ }
+ ElseIf ($PowerLineStatus -eq 'Offline') {
+ Write-Log -Message 'System is using battery power.' -Source ${CmdletName}
+ }
+ ElseIf ($PowerLineStatus -eq 'Unknown') {
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ Write-Log -Message "System power status is [$PowerLineStatus] and battery charge status is [$BatteryChargeStatus]. This is most likely due to a damaged battery so we will report system is using AC power." -Source ${CmdletName}
+ $OnACPower = $true
+ }
+ Else {
+ Write-Log -Message "System power status is [$PowerLineStatus] and battery charge status is [$BatteryChargeStatus]. Therefore, we will report system is using battery power." -Source ${CmdletName}
+ }
+ }
+ $SystemTypePowerStatus.Add('IsUsingACPower', $OnACPower)
+
+ ## Determine if the system is a laptop
+ [boolean]$IsLaptop = $false
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ $IsLaptop = $false
+ }
+ Else {
+ $IsLaptop = $true
+ }
+ # Chassis Types
+ [int32[]]$ChassisTypes = Get-WmiObject -Class 'Win32_SystemEnclosure' | Where-Object { $_.ChassisTypes } | Select-Object -ExpandProperty 'ChassisTypes'
+ Write-Log -Message "The following system chassis types were detected [$($ChassisTypes -join ',')]." -Source ${CmdletName}
+ ForEach ($ChassisType in $ChassisTypes) {
+ Switch ($ChassisType) {
+ { $_ -eq 9 -or $_ -eq 10 -or $_ -eq 14 } { $IsLaptop = $true } # 9=Laptop, 10=Notebook, 14=Sub Notebook
+ { $_ -eq 3 } { $IsLaptop = $false } # 3=Desktop
+ }
+ }
+ # Add IsLaptop property to hashtable
+ $SystemTypePowerStatus.Add('IsLaptop', $IsLaptop)
+
+ If ($PassThru) {
+ Write-Output -InputObject $SystemTypePowerStatus
+ }
+ Else {
+ Write-Output -InputObject $OnACPower
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-NetworkConnection
+Function Test-NetworkConnection {
+<#
+.SYNOPSIS
+ Tests for an active local network connection, excluding wireless and virtual network adapters.
+.DESCRIPTION
+ Tests for an active local network connection, excluding wireless and virtual network adapters, by querying the Win32_NetworkAdapter WMI class.
+.EXAMPLE
+ Test-NetworkConnection
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message 'Check if system is using a wired network connection...' -Source ${CmdletName}
+
+ [psobject[]]$networkConnected = Get-WmiObject -Class 'Win32_NetworkAdapter' | Where-Object { ($_.NetConnectionStatus -eq 2) -and ($_.NetConnectionID -match 'Local') -and ($_.NetConnectionID -notmatch 'Wireless') -and ($_.Name -notmatch 'Virtual') } -ErrorAction 'SilentlyContinue'
+ [boolean]$onNetwork = $false
+ If ($networkConnected) {
+ Write-Log -Message 'Wired network connection found.' -Source ${CmdletName}
+ [boolean]$onNetwork = $true
+ }
+ Else {
+ Write-Log -Message 'Wired network connection not found.' -Source ${CmdletName}
+ }
+
+ Write-Output -InputObject $onNetwork
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-PowerPoint
+Function Test-PowerPoint {
+<#
+.SYNOPSIS
+ Tests whether PowerPoint is running in either fullscreen slideshow mode or presentation mode.
+.DESCRIPTION
+ Tests whether someone is presenting using PowerPoint in either fullscreen slideshow mode or presentation mode.
+.EXAMPLE
+ Test-PowerPoint
+.NOTES
+ This function can only execute detection logic if the process is in interactive mode.
+ There is a possiblity of a false positive if the PowerPoint filename starts with "PowerPoint Slide Show".
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Check if PowerPoint is in either fullscreen slideshow mode or presentation mode...' -Source ${CmdletName}
+ Try {
+ [Diagnostics.Process[]]$PowerPointProcess = Get-Process -ErrorAction 'Stop' | Where-Object { $_.ProcessName -eq 'POWERPNT' }
+ If ($PowerPointProcess) {
+ [boolean]$IsPowerPointRunning = $true
+ Write-Log -Message 'PowerPoint application is running.' -Source ${CmdletName}
+ }
+ Else {
+ [boolean]$IsPowerPointRunning = $false
+ Write-Log -Message 'PowerPoint application is not running.' -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Throw
+ }
+
+ [nullable[boolean]]$IsPowerPointFullScreen = $false
+ If ($IsPowerPointRunning) {
+ ## Detect if PowerPoint is in fullscreen mode or Presentation Mode, detection method only works if process is interactive
+ If ([Environment]::UserInteractive) {
+ # Check if "POWERPNT" process has a window with a title that begins with "PowerPoint Slide Show" or "Powerpoint-" for non-English language systems.
+ # There is a possiblity of a false positive if the PowerPoint filename starts with "PowerPoint Slide Show"
+ [psobject]$PowerPointWindow = Get-WindowTitle -GetAllWindowTitles | Where { $_.WindowTitle -match '^PowerPoint Slide Show' -or $_.WindowTitle -match '^PowerPoint-' } | Where-Object { $_.ParentProcess -eq 'POWERPNT'} | Select-Object -First 1
+ If ($PowerPointWindow) {
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ Write-Log -Message 'Detected that PowerPoint process [POWERPNT] has a window with a title that beings with [PowerPoint Slide Show] or [PowerPoint-].' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message 'Detected that PowerPoint process [POWERPNT] does not have a window with a title that beings with [PowerPoint Slide Show] or [PowerPoint-].' -Source ${CmdletName}
+ Try {
+ [int32[]]$PowerPointProcessIDs = $PowerPointProcess | Select-Object -ExpandProperty 'Id' -ErrorAction 'Stop'
+ Write-Log -Message "PowerPoint process [POWERPNT] has process id(s) [$($PowerPointProcessIDs -join ', ')]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Unable to retrieve process id(s) for [POWERPNT] process. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+
+ ## If previous detection method did not detect PowerPoint in fullscreen mode, then check if PowerPoint is in Presentation Mode (check only works on Windows Vista or higher)
+ If ((-not $IsPowerPointFullScreen) -and (([version]$envOSVersion).Major -gt 5)) {
+ # Note: below method does not detect PowerPoint presentation mode if the presentation is on a monitor that does not have current mouse input control
+ [string]$UserNotificationState = [PSADT.UiAutomation]::GetUserNotificationState()
+ Write-Log -Message "Detected user notification state [$UserNotificationState]." -Source ${CmdletName}
+ Switch ($UserNotificationState) {
+ 'PresentationMode' {
+ Write-Log -Message "Detected that system is in [Presentation Mode]." -Source ${CmdletName}
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ }
+ 'FullScreenOrPresentationModeOrLoginScreen' {
+ If (([string]$PowerPointProcessIDs) -and ($PowerPointProcessIDs -contains [PSADT.UIAutomation]::GetWindowThreadProcessID([PSADT.UIAutomation]::GetForeGroundWindow()))) {
+ Write-Log -Message "Detected that fullscreen foreground window matches PowerPoint process id." -Source ${CmdletName}
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ }
+ }
+ }
+ }
+ }
+ Else {
+ [nullable[boolean]]$IsPowerPointFullScreen = $null
+ Write-Log -Message 'Unable to run check to see if PowerPoint is in fullscreen mode or Presentation Mode because current process is not interactive. Configure script to run in interactive mode in your deployment tool. If using SCCM Application Model, then make sure "Allow users to view and interact with the program installation" is selected. If using SCCM Package Model, then make sure "Allow users to interact with this program" is selected.' -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsPowerPointFullScreen = $null
+ Write-Log -Message "Failed check to see if PowerPoint is running in fullscreen slideshow mode. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-Log -Message "PowerPoint is running in fullscreen mode [$IsPowerPointFullScreen]." -Source ${CmdletName}
+ Write-Output -InputObject $IsPowerPointFullScreen
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-SCCMTask
+Function Invoke-SCCMTask {
+<#
+.SYNOPSIS
+ Triggers SCCM to invoke the requested schedule task id.
+.DESCRIPTION
+ Triggers SCCM to invoke the requested schedule task id.
+.PARAMETER ScheduleId
+ Name of the schedule id to trigger.
+ Options: HardwareInventory, SoftwareInventory, HeartbeatDiscovery, SoftwareInventoryFileCollection, RequestMachinePolicy, EvaluateMachinePolicy,
+ LocationServicesCleanup, SoftwareMeteringReport, SourceUpdate, PolicyAgentCleanup, RequestMachinePolicy2, CertificateMaintenance, PeerDistributionPointStatus,
+ PeerDistributionPointProvisioning, ComplianceIntervalEnforcement, SoftwareUpdatesAgentAssignmentEvaluation, UploadStateMessage, StateMessageManager,
+ SoftwareUpdatesScan, AMTProvisionCycle, UpdateStorePolicy, StateSystemBulkSend, ApplicationManagerPolicyAction, PowerManagementStartSummarizer
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Invoke-SCCMTask 'SoftwareUpdatesScan'
+.EXAMPLE
+ Invoke-SCCMTask
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('HardwareInventory','SoftwareInventory','HeartbeatDiscovery','SoftwareInventoryFileCollection','RequestMachinePolicy','EvaluateMachinePolicy','LocationServicesCleanup','SoftwareMeteringReport','SourceUpdate','PolicyAgentCleanup','RequestMachinePolicy2','CertificateMaintenance','PeerDistributionPointStatus','PeerDistributionPointProvisioning','ComplianceIntervalEnforcement','SoftwareUpdatesAgentAssignmentEvaluation','UploadStateMessage','StateMessageManager','SoftwareUpdatesScan','AMTProvisionCycle','UpdateStorePolicy','StateSystemBulkSend','ApplicationManagerPolicyAction','PowerManagementStartSummarizer')]
+ [string]$ScheduleID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Invoke SCCM Schedule Task ID [$ScheduleId]..." -Source ${CmdletName}
+
+ ## Make sure SCCM client is installed and running
+ Write-Log -Message 'Check to see if SCCM Client service [ccmexec] is installed and running.' -Source ${CmdletName}
+ If (Test-ServiceExists -Name 'ccmexec') {
+ If ($(Get-Service -Name 'ccmexec' -ErrorAction 'SilentlyContinue').Status -ne 'Running') {
+ Throw "SCCM Client Service [ccmexec] exists but it is not in a 'Running' state."
+ }
+ } Else {
+ Throw 'SCCM Client Service [ccmexec] does not exist. The SCCM Client may not be installed.'
+ }
+
+ ## Determine the SCCM Client Version
+ Try {
+ [version]$SCCMClientVersion = Get-WmiObject -Namespace 'ROOT\CCM' -Class 'CCM_InstalledComponent' -ErrorAction 'Stop' | Where-Object { $_.Name -eq 'SmsClient' } | Select-Object -ExpandProperty 'Version' -ErrorAction 'Stop'
+ Write-Log -Message "Installed SCCM Client Version Number [$SCCMClientVersion]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to determine the SCCM client version number. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to determine the SCCM client version number.'
+ }
+
+ ## Create a hashtable of Schedule IDs compatible with SCCM Client 2007
+ [hashtable]$ScheduleIds = @{
+ HardwareInventory = '{00000000-0000-0000-0000-000000000001}'; # Hardware Inventory Collection Task
+ SoftwareInventory = '{00000000-0000-0000-0000-000000000002}'; # Software Inventory Collection Task
+ HeartbeatDiscovery = '{00000000-0000-0000-0000-000000000003}'; # Heartbeat Discovery Cycle
+ SoftwareInventoryFileCollection = '{00000000-0000-0000-0000-000000000010}'; # Software Inventory File Collection Task
+ RequestMachinePolicy = '{00000000-0000-0000-0000-000000000021}'; # Request Machine Policy Assignments
+ EvaluateMachinePolicy = '{00000000-0000-0000-0000-000000000022}'; # Evaluate Machine Policy Assignments
+ RefreshDefaultMp = '{00000000-0000-0000-0000-000000000023}'; # Refresh Default MP Task
+ RefreshLocationServices = '{00000000-0000-0000-0000-000000000024}'; # Refresh Location Services Task
+ LocationServicesCleanup = '{00000000-0000-0000-0000-000000000025}'; # Location Services Cleanup Task
+ SoftwareMeteringReport = '{00000000-0000-0000-0000-000000000031}'; # Software Metering Report Cycle
+ SourceUpdate = '{00000000-0000-0000-0000-000000000032}'; # Source Update Manage Update Cycle
+ PolicyAgentCleanup = '{00000000-0000-0000-0000-000000000040}'; # Policy Agent Cleanup Cycle
+ RequestMachinePolicy2 = '{00000000-0000-0000-0000-000000000042}'; # Request Machine Policy Assignments
+ CertificateMaintenance = '{00000000-0000-0000-0000-000000000051}'; # Certificate Maintenance Cycle
+ PeerDistributionPointStatus = '{00000000-0000-0000-0000-000000000061}'; # Peer Distribution Point Status Task
+ PeerDistributionPointProvisioning = '{00000000-0000-0000-0000-000000000062}'; # Peer Distribution Point Provisioning Status Task
+ ComplianceIntervalEnforcement = '{00000000-0000-0000-0000-000000000071}'; # Compliance Interval Enforcement
+ SoftwareUpdatesAgentAssignmentEvaluation = '{00000000-0000-0000-0000-000000000108}'; # Software Updates Agent Assignment Evaluation Cycle
+ UploadStateMessage = '{00000000-0000-0000-0000-000000000111}'; # Send Unsent State Messages
+ StateMessageManager = '{00000000-0000-0000-0000-000000000112}'; # State Message Manager Task
+ SoftwareUpdatesScan = '{00000000-0000-0000-0000-000000000113}'; # Force Update Scan
+ AMTProvisionCycle = '{00000000-0000-0000-0000-000000000120}'; # AMT Provision Cycle
+ }
+
+ ## If SCCM 2012 Client or higher, modify hashtabe containing Schedule IDs so that it only has the ones compatible with this version of the SCCM client
+ If ($SCCMClientVersion.Major -ge 5) {
+ $ScheduleIds.Remove('PeerDistributionPointStatus')
+ $ScheduleIds.Remove('PeerDistributionPointProvisioning')
+ $ScheduleIds.Remove('ComplianceIntervalEnforcement')
+ $ScheduleIds.Add('UpdateStorePolicy','{00000000-0000-0000-0000-000000000114}') # Update Store Policy
+ $ScheduleIds.Add('StateSystemBulkSend','{00000000-0000-0000-0000-000000000116}') # State System Policy Bulk Send Low
+ $ScheduleIds.Add('ApplicationManagerPolicyAction','{00000000-0000-0000-0000-000000000121}') # Application Manager Policy Action
+ $ScheduleIds.Add('PowerManagementStartSummarizer','{00000000-0000-0000-0000-000000000131}') # Power Management Start Summarizer
+ }
+
+ ## Determine if the requested Schedule ID is available on this version of the SCCM Client
+ If (-not ($ScheduleIds.ContainsKey($ScheduleId))) {
+ Throw "The requested ScheduleId [$ScheduleId] is not available with this version of the SCCM Client [$SCCMClientVersion]."
+ }
+
+ ## Trigger SCCM task
+ Write-Log -Message "Trigger SCCM Task ID [$ScheduleId]." -Source ${CmdletName}
+ [Management.ManagementClass]$SmsClient = [WMIClass]'ROOT\CCM:SMS_Client'
+ $null = $SmsClient.TriggerSchedule($ScheduleIds.$ScheduleID)
+ }
+ Catch {
+ Write-Log -Message "Failed to trigger SCCM Schedule Task ID [$($ScheduleIds.$ScheduleId)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger SCCM Schedule Task ID [$($ScheduleIds.$ScheduleId)]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Install-SCCMSoftwareUpdates
+Function Install-SCCMSoftwareUpdates {
+<#
+.SYNOPSIS
+ Scans for outstanding SCCM updates to be installed and installs the pending updates.
+.DESCRIPTION
+ Scans for outstanding SCCM updates to be installed and installs the pending updates.
+ Only compatible with SCCM 2012 Client or higher. This function can take several minutes to run.
+.PARAMETER SoftwareUpdatesScanWaitInSeconds
+ The amount of time to wait in seconds for the software updates scan to complete. Default is: 180 seconds.
+.PARAMETER WaitForPendingUpdatesTimeout
+ The amount of time to wait for missing and pending updates to install before exiting the function. Default is: 45 minutes.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Install-SCCMSoftwareUpdates
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$SoftwareUpdatesScanWaitInSeconds = 180,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [timespan]$WaitForPendingUpdatesTimeout = $(New-TimeSpan -Minutes 45),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Scan for and install pending SCCM software updates.' -Source ${CmdletName}
+
+ ## Make sure SCCM client is installed and running
+ Write-Log -Message 'Check to see if SCCM Client service [ccmexec] is installed and running.' -Source ${CmdletName}
+ If (Test-ServiceExists -Name 'ccmexec') {
+ If ($(Get-Service -Name 'ccmexec' -ErrorAction 'SilentlyContinue').Status -ne 'Running') {
+ Throw "SCCM Client Service [ccmexec] exists but it is not in a 'Running' state."
+ }
+ } Else {
+ Throw 'SCCM Client Service [ccmexec] does not exist. The SCCM Client may not be installed.'
+ }
+
+ ## Determine the SCCM Client Version
+ Try {
+ [version]$SCCMClientVersion = Get-WmiObject -Namespace 'ROOT\CCM' -Class 'CCM_InstalledComponent' -ErrorAction 'Stop' | Where-Object { $_.Name -eq 'SmsClient' } | Select-Object -ExpandProperty 'Version' -ErrorAction 'Stop'
+ Write-Log -Message "Installed SCCM Client Version Number [$SCCMClientVersion]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to determine the SCCM client version number. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to determine the SCCM client version number.'
+ }
+ # If SCCM 2007 Client or lower, exit function
+ If ($SCCMClientVersion.Major -le 4) {
+ Throw 'SCCM 2007 or lower, which is incompatible with this function, was detected on this system.'
+ }
+
+ $StartTime = Get-Date
+ ## Trigger SCCM client scan for Software Updates
+ Write-Log -Message 'Trigger SCCM client scan for Software Updates...' -Source ${CmdletName}
+ Invoke-SCCMTask -ScheduleId 'SoftwareUpdatesScan'
+
+ Write-Log -Message "The SCCM client scan for Software Updates has been triggered. The script is suspended for [$SoftwareUpdatesScanWaitInSeconds] seconds to let the update scan finish." -Source ${CmdletName}
+ Start-Sleep -Seconds $SoftwareUpdatesScanWaitInSeconds
+
+ ## Find the number of missing updates
+ Try {
+ [Management.ManagementObject[]]$CMMissingUpdates = @(Get-WmiObject -Namespace 'ROOT\CCM\ClientSDK' -Query "SELECT * FROM CCM_SoftwareUpdate WHERE ComplianceState = '0'" -ErrorAction 'Stop')
+ }
+ Catch {
+ Write-Log -Message "Failed to find the number of missing software updates. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to find the number of missing software updates.'
+ }
+
+ ## Install missing updates and wait for pending updates to finish installing
+ If ($CMMissingUpdates.Count) {
+ # Install missing updates
+ Write-Log -Message "Install missing updates. The number of missing updates is [$($CMMissingUpdates.Count)]." -Source ${CmdletName}
+ $CMInstallMissingUpdates = (Get-WmiObject -Namespace 'ROOT\CCM\ClientSDK' -Class 'CCM_SoftwareUpdatesManager' -List).InstallUpdates($CMMissingUpdates)
+
+ # Wait for pending updates to finish installing or the timeout value to expire
+ Do {
+ Start-Sleep -Seconds 60
+ [array]$CMInstallPendingUpdates = @(Get-WmiObject -Namespace "ROOT\CCM\ClientSDK" -Query "SELECT * FROM CCM_SoftwareUpdate WHERE EvaluationState = 6 or EvaluationState = 7")
+ Write-Log -Message "The number of updates pending installation is [$($CMInstallPendingUpdates.Count)]." -Source ${CmdletName}
+ } While (($CMInstallPendingUpdates.Count -ne 0) -and ((New-TimeSpan -Start $StartTime -End $(Get-Date)) -lt $WaitForPendingUpdatesTimeout))
+ }
+ Else {
+ Write-Log -Message 'There are no missing updates.' -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to trigger installation of missing software updates. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger installation of missing software updates: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Update-GroupPolicy
+Function Update-GroupPolicy {
+<#
+.SYNOPSIS
+ Performs a gpupdate command to refresh Group Policies on the local machine.
+.DESCRIPTION
+ Performs a gpupdate command to refresh Group Policies on the local machine.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-GroupPolicy
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ [string[]]$GPUpdateCmds = '/C echo N | gpupdate.exe /Target:Computer /Force', '/C echo N | gpupdate.exe /Target:User /Force'
+ [int32]$InstallCount = 0
+ ForEach ($GPUpdateCmd in $GPUpdateCmds) {
+ Try {
+ If ($InstallCount -eq 0) {
+ [string]$InstallMsg = 'Update Group Policies for the Machine'
+ Write-Log -Message "$($InstallMsg)..." -Source ${CmdletName}
+ }
+ Else {
+ [string]$InstallMsg = 'Update Group Policies for the User'
+ Write-Log -Message "$($InstallMsg)..." -Source ${CmdletName}
+ }
+ [psobject]$ExecuteResult = Execute-Process -Path "$envWindir\system32\cmd.exe" -Parameters $GPUpdateCmd -WindowStyle 'Hidden' -PassThru
+
+ If ($ExecuteResult.ExitCode -ne 0) {
+ If ($ExecuteResult.ExitCode -eq 60002) {
+ Throw "Execute-Process function failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ Else {
+ Throw "gpupdate.exe failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ }
+ $InstallCount++
+ }
+ Catch {
+ Write-Log -Message "Failed to $($InstallMsg). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $($InstallMsg): $($_.Exception.Message)"
+ }
+ Continue
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Enable-TerminalServerInstallMode
+Function Enable-TerminalServerInstallMode {
+<#
+.SYNOPSIS
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.DESCRIPTION
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Enable-TerminalServerInstall
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Change terminal server into user install mode...' -Source ${CmdletName}
+ $terminalServerResult = & change.exe User /Install
+
+ If ($global:LastExitCode -ne 1) { Throw $terminalServerResult }
+ }
+ Catch {
+ Write-Log -Message "Failed to change terminal server into user install mode. `n$(Resolve-Error) " -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to change terminal server into user install mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Disable-TerminalServerInstallMode
+Function Disable-TerminalServerInstallMode {
+<#
+.SYNOPSIS
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.DESCRIPTION
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Disable-TerminalServerInstall
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Change terminal server into user execute mode...' -Source ${CmdletName}
+ $terminalServerResult = & change.exe User /Execute
+
+ If ($global:LastExitCode -ne 1) { Throw $terminalServerResult }
+ }
+ Catch {
+ Write-Log -Message "Failed to change terminal server into user execute mode. `n$(Resolve-Error) " -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to change terminal server into user execute mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-ActiveSetup
+Function Set-ActiveSetup {
+<#
+.SYNOPSIS
+ Creates an Active Setup entry in the registry to execute a file for each user upon login.
+.DESCRIPTION
+ Active Setup allows handling of per-user changes registry/file changes upon login.
+ A registry key is created in the HKLM registry hive which gets replicated to the HKCU hive when a user logs in.
+ If the "Version" value of the Active Setup entry in HKLM is higher than the version value in HKCU, the file referenced in "StubPath" is executed.
+ This Function:
+ - Creates the registry entries in HKLM:SOFTWARE\Microsoft\Active Setup\Installed Components\$installName.
+ - Creates StubPath value depending on the file extension of the $StubExePath parameter.
+ - Handles Version value with YYYYMMDDHHMMSS granularity to permit re-installs on the same day and still trigger Active Setup after Version increase.
+ - Copies/overwrites the StubPath file to $StubExePath destination path if file exists in 'Files' subdirectory of script directory.
+ - Executes the StubPath file for the current user as long as not in Session 0 (no need to logout/login to trigger Active Setup).
+.PARAMETER StubExePath
+ Full destination path to the file that will be executed for each user that logs in.
+ If this file exists in the 'Files' subdirectory of the script directory, it will be copied to the destination path.
+.PARAMETER Arguments
+ Arguments to pass to the file being executed.
+.PARAMETER Description
+ Description for the Active Setup. Users will see "Setting up personalized settings for: $Description" at logon. Default is: $installName.
+.PARAMETER Key
+ Name of the registry key for the Active Setup entry. Default is: $installName.
+.PARAMETER Version
+ Optional. Specify version for Active setup entry. Active Setup is not triggered if Version value has more than 8 consecutive digits. Use commas to get around this limitation.
+.PARAMETER Locale
+ Optional. Arbitrary string used to specify the installation language of the file being executed. Not replicated to HKCU.
+.PARAMETER PurgeActiveSetupKey
+ Remove Active Setup entry from HKLM registry hive. Will also load each logon user's HKCU registry hive to remove Active Setup entry.
+.PARAMETER DisableActiveSetup
+ Disables the Active Setup entry so that the StubPath file will not be executed.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-ActiveSetup -StubExePath 'C:\Users\Public\Company\ProgramUserConfig.vbs' -Arguments '/Silent' -Description 'Program User Config' -Key 'ProgramUserConfig' -Locale 'en'
+.EXAMPLE
+ Set-ActiveSetup -StubExePath "$envWinDir\regedit.exe" -Arguments "/S `"%SystemDrive%\Program Files (x86)\PS App Deploy\PSAppDeployHKCUSettings.reg`"" -Description 'PS App Deploy Config' -Key 'PS_App_Deploy_Config' -ContinueOnError $true
+.EXAMPLE
+ Set-ActiveSetup -Key 'ProgramUserConfig' -PurgeActiveSetupKey
+ Deletes "ProgramUserConfig" active setup entry from all registry hives.
+.NOTES
+ Original code borrowed from: Denis St-Pierre (Ottawa, Canada), Todd MacNaught (Ottawa, Canada)
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$StubExePath,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Arguments,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Description = $installName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key = $installName,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Version = ((Get-Date -Format 'yyMM,ddHH,mmss').ToString()), # Ex: 1405,1515,0522
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Locale,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [switch]$DisableActiveSetup = $false,
+ [Parameter(Mandatory=$true,ParameterSetName='Purge')]
+ [switch]$PurgeActiveSetupKey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ [string]$ActiveSetupKey = "HKLM:SOFTWARE\Microsoft\Active Setup\Installed Components\$Key"
+ [string]$HKCUActiveSetupKey = "HKCU:Software\Microsoft\Active Setup\Installed Components\$Key"
+
+ ## Delete Active Setup registry entry from the HKLM hive and for all logon user registry hives on the system
+ If ($PurgeActiveSetupKey) {
+ Write-Log -Message "Remove Active Setup entry [$ActiveSetupKey]." -Source ${CmdletName}
+ Remove-RegistryKey -Key $ActiveSetupKey -Recurse
+
+ Write-Log -Message "Remove Active Setup entry [$HKCUActiveSetupKey] for all log on user registry hives on the system." -Source ${CmdletName}
+ [scriptblock]$RemoveHKCUActiveSetupKey = { Remove-RegistryKey -Key $HKCUActiveSetupKey -SID $UserProfile.SID -Recurse }
+ Invoke-HKCURegistrySettingsForAllUsers -RegistrySettings $RemoveHKCUActiveSetupKey -UserProfiles (Get-UserProfiles -ExcludeDefaultUser)
+ Return
+ }
+
+ ## Verify a file with a supported file extension was specified in $StubExePath
+ [string[]]$StubExePathFileExtensions = '.exe', '.vbs', '.cmd', '.ps1', '.js'
+ [string]$StubExeExt = [IO.Path]::GetExtension($StubExePath)
+ If ($StubExePathFileExtensions -notcontains $StubExeExt) {
+ Throw "Unsupported Active Setup StubPath file extension [$StubExeExt]."
+ }
+
+ ## Copy file to $StubExePath from the 'Files' subdirectory of the script directory (if it exists there)
+ [string]$StubExePath = [Environment]::ExpandEnvironmentVariables($StubExePath)
+ [string]$ActiveSetupFileName = [IO.Path]::GetFileName($StubExePath)
+ [string]$StubExeFile = Join-Path -Path $dirFiles -ChildPath $ActiveSetupFileName
+ If (Test-Path -LiteralPath $StubExeFile -PathType 'Leaf') {
+ # This will overwrite the StubPath file if $StubExePath already exists on target
+ Copy-File -Path $StubExeFile -Destination $StubExePath -ContinueOnError $false
+ }
+
+ ## Check if the $StubExePath file exists
+ If (-not (Test-Path -LiteralPath $StubExePath -PathType 'Leaf')) { Throw "Active Setup StubPath file [$ActiveSetupFileName] is missing." }
+
+ ## Define Active Setup StubPath according to file extension of $StubExePath
+ Switch ($StubExeExt) {
+ '.exe' {
+ [string]$CUStubExePath = $StubExePath
+ [string]$CUArguments = $Arguments
+ [string]$StubPath = "$CUStubExePath"
+ }
+ {'.vbs','.js' -contains $StubExeExt} {
+ [string]$CUStubExePath = "$envWinDir\system32\cscript.exe"
+ [string]$CUArguments = "//nologo `"$StubExePath`""
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ '.cmd' {
+ [string]$CUStubExePath = "$envWinDir\system32\CMD.exe"
+ [string]$CUArguments = "/C `"$StubExePath`""
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ '.ps1' {
+ [string]$CUStubExePath = "$PSHOME\powershell.exe"
+ [string]$CUArguments = "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -Command & { & `\`"$StubExePath`\`"}"
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ }
+ If ($Arguments) {
+ [string]$StubPath = "$StubPath $Arguments"
+ If ($StubExeExt -ne '.exe') { [string]$CUArguments = "$CUArguments $Arguments" }
+ }
+
+ ## Create the Active Setup entry in the registry
+ [scriptblock]$SetActiveSetupRegKeys = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$ActiveSetupRegKey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+ If ($SID) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name '(Default)' -Value $Description -SID $SID -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'StubPath' -Value $StubPath -Type 'String' -SID $SID -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Version' -Value $Version -SID $SID -ContinueOnError $false
+ If ($Locale) { Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Locale' -Value $Locale -SID $SID -ContinueOnError $false }
+ If ($DisableActiveSetup) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 0 -Type 'DWord' -SID $SID -ContinueOnError $false
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 1 -Type 'DWord' -SID $SID -ContinueOnError $false
+ }
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name '(Default)' -Value $Description -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'StubPath' -Value $StubPath -Type 'String' -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Version' -Value $Version -ContinueOnError $false
+ If ($Locale) { Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Locale' -Value $Locale -ContinueOnError $false }
+ If ($DisableActiveSetup) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 0 -Type 'DWord' -ContinueOnError $false
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 1 -Type 'DWord' -ContinueOnError $false
+ }
+ }
+
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $ActiveSetupKey
+
+ ## Execute the StubPath file for the current user as long as not in Session 0
+ If ($SessionZero) {
+ If ($RunAsActiveUser) {
+ Write-Log -Message "Session 0 detected: Execute Active Setup StubPath file for currently logged in user [$($RunAsActiveUser.NTAccount)]." -Source ${CmdletName}
+ If ($CUArguments) {
+ Execute-ProcessAsUser -Path $CUStubExePath -Parameters $CUArguments -Wait -ContinueOnError $true
+ }
+ Else {
+ Execute-ProcessAsUser -Path $CUStubExePath -Wait -ContinueOnError $true
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $HKCUActiveSetupKey -SID $RunAsActiveUser.SID
+ }
+ Else {
+ Write-Log -Message 'Session 0 detected: No logged in users detected. Active Setup StubPath file will execute when users first log into their account.' -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message 'Execute Active Setup StubPath file for the current user.' -Source ${CmdletName}
+ If ($CUArguments) {
+ $ExecuteResults = Execute-Process -FilePath $CUStubExePath -Parameters $CUArguments -PassThru
+ }
+ Else {
+ $ExecuteResults = Execute-Process -FilePath $CUStubExePath -PassThru
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $HKCUActiveSetupKey
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to set Active Setup registry entry. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set Active Setup registry entry: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-ServiceExists
+Function Test-ServiceExists {
+<#
+.SYNOPSIS
+ Check to see if a service exists.
+.DESCRIPTION
+ Check to see if a service exists (using WMI method because Get-Service will generate ErrorRecord if service doesn't exist).
+.PARAMETER Name
+ Specify the name of the service.
+ Note: Service name can be found by executing "Get-Service | Format-Table -AutoSize -Wrap" or by using the properties screen of a service in services.msc.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER PassThru
+ Return the WMI service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Test-ServiceExists -Name 'wuauserv'
+.EXAMPLE
+ Test-ServiceExists -Name 'testservice' -PassThru | Where-Object { $_ } | ForEach-Object { $_.Delete() }
+ Check if a service exists and then delete it by using the -PassThru parameter.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $ServiceObject = Get-WmiObject -ComputerName $ComputerName -Class 'Win32_Service' -Filter "Name='$Name'" -ErrorAction 'Stop'
+ # If nothing is returned from Win32_Service, check Win32_BaseService
+ If (-not ($ServiceObject) ) {
+ $ServiceObject = Get-WmiObject -ComputerName $ComputerName -Class 'Win32_BaseService' -Filter "Name='$Name'" -ErrorAction 'Stop'
+ }
+
+ If ($ServiceObject) {
+ Write-Log -Message "Service [$Name] exists." -Source ${CmdletName}
+ If ($PassThru) { Write-Output -InputObject $ServiceObject } Else { Write-Output -InputObject $true }
+ }
+ Else {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName}
+ If ($PassThru) { Write-Output -InputObject $ServiceObject } Else { Write-Output -InputObject $false }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed check to see if service [$Name] exists." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed check to see if service [$Name] exists: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Stop-ServiceAndDependencies
+Function Stop-ServiceAndDependencies {
+<#
+.SYNOPSIS
+ Stop Windows service and its dependencies.
+.DESCRIPTION
+ Stop Windows service and its dependencies.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER SkipServiceExistsTest
+ Choose to skip the test to check whether or not the service exists if it was already done outside of this function.
+.PARAMETER SkipDependentServices
+ Choose to skip checking for and stopping dependent services. Default is: $false.
+.PARAMETER PendingStatusWait
+ The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.
+.PARAMETER PassThru
+ Return the System.ServiceProcess.ServiceController service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Stop-ServiceAndDependencies -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipServiceExistsTest,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipDependentServices,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [timespan]$PendingStatusWait = (New-TimeSpan -Seconds 60),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Check to see if the service exists
+ If ((-not $SkipServiceExistsTest) -and (-not (Test-ServiceExists -ComputerName $ComputerName -Name $Name -ContinueOnError $false))) {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName} -Severity 2
+ Throw "Service [$Name] does not exist."
+ }
+
+ ## Get the service object
+ Write-Log -Message "Get the service object for service [$Name]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction 'Stop'
+ ## Wait up to 60 seconds if service is in a pending state
+ [string[]]$PendingStatus = 'ContinuePending', 'PausePending', 'StartPending', 'StopPending'
+ If ($PendingStatus -contains $Service.Status) {
+ Switch ($Service.Status) {
+ 'ContinuePending' { $DesiredStatus = 'Running' }
+ 'PausePending' { $DesiredStatus = 'Paused' }
+ 'StartPending' { $DesiredStatus = 'Running' }
+ 'StopPending' { $DesiredStatus = 'Stopped' }
+ }
+ Write-Log -Message "Waiting for up to [$($PendingStatusWait.TotalSeconds)] seconds to allow service pending status [$($Service.Status)] to reach desired status [$DesiredStatus]." -Source ${CmdletName}
+ $Service.WaitForStatus([ServiceProcess.ServiceControllerStatus]$DesiredStatus, $PendingStatusWait)
+ $Service.Refresh()
+ }
+ ## Discover if the service is currently running
+ Write-Log -Message "Service [$($Service.ServiceName)] with display name [$($Service.DisplayName)] has a status of [$($Service.Status)]." -Source ${CmdletName}
+ If ($Service.Status -ne 'Stopped') {
+ # Discover all dependent services that are running and stop them
+ If (-not $SkipDependentServices) {
+ Write-Log -Message "Discover all dependent service(s) for service [$Name] which are not 'Stopped'." -Source ${CmdletName}
+ [ServiceProcess.ServiceController[]]$DependentServices = Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -DependentServices -ErrorAction 'Stop' | Where-Object { $_.Status -ne 'Stopped' }
+ If ($DependentServices) {
+ ForEach ($DependentService in $DependentServices) {
+ Write-Log -Message "Stop dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]." -Source ${CmdletName}
+ Try {
+ Stop-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $DependentService.ServiceName -ErrorAction 'Stop') -Force -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]. Continue..." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Dependent service(s) were not discovered for service [$Name]." -Source ${CmdletName}
+ }
+ }
+ # Stop the parent service
+ Write-Log -Message "Stop parent service [$($Service.ServiceName)] with display name [$($Service.DisplayName)]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Stop-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -ErrorAction 'Stop') -Force -PassThru -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to stop the service [$Name]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to stop the service [$Name]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ # Return the service object if option selected
+ If ($PassThru -and $Service) { Write-Output -InputObject $Service }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Start-ServiceAndDependencies
+Function Start-ServiceAndDependencies {
+<#
+.SYNOPSIS
+ Start Windows service and its dependencies.
+.DESCRIPTION
+ Start Windows service and its dependencies.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER SkipServiceExistsTest
+ Choose to skip the test to check whether or not the service exists if it was already done outside of this function.
+.PARAMETER SkipDependentServices
+ Choose to skip checking for and starting dependent services. Default is: $false.
+.PARAMETER PendingStatusWait
+ The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.
+.PARAMETER PassThru
+ Return the System.ServiceProcess.ServiceController service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Start-ServiceAndDependencies -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipServiceExistsTest,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipDependentServices,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [timespan]$PendingStatusWait = (New-TimeSpan -Seconds 60),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Check to see if the service exists
+ If ((-not $SkipServiceExistsTest) -and (-not (Test-ServiceExists -ComputerName $ComputerName -Name $Name -ContinueOnError $false))) {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName} -Severity 2
+ Throw "Service [$Name] does not exist."
+ }
+
+ ## Get the service object
+ Write-Log -Message "Get the service object for service [$Name]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction 'Stop'
+ ## Wait up to 60 seconds if service is in a pending state
+ [string[]]$PendingStatus = 'ContinuePending', 'PausePending', 'StartPending', 'StopPending'
+ If ($PendingStatus -contains $Service.Status) {
+ Switch ($Service.Status) {
+ 'ContinuePending' { $DesiredStatus = 'Running' }
+ 'PausePending' { $DesiredStatus = 'Paused' }
+ 'StartPending' { $DesiredStatus = 'Running' }
+ 'StopPending' { $DesiredStatus = 'Stopped' }
+ }
+ Write-Log -Message "Waiting for up to [$($PendingStatusWait.TotalSeconds)] seconds to allow service pending status [$($Service.Status)] to reach desired status [$DesiredStatus]." -Source ${CmdletName}
+ $Service.WaitForStatus([ServiceProcess.ServiceControllerStatus]$DesiredStatus, $PendingStatusWait)
+ $Service.Refresh()
+ }
+ ## Discover if the service is currently stopped
+ Write-Log -Message "Service [$($Service.ServiceName)] with display name [$($Service.DisplayName)] has a status of [$($Service.Status)]." -Source ${CmdletName}
+ If ($Service.Status -ne 'Running') {
+ # Start the parent service
+ Write-Log -Message "Start parent service [$($Service.ServiceName)] with display name [$($Service.DisplayName)]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Start-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -ErrorAction 'Stop') -PassThru -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+
+ # Discover all dependent services that are stopped and start them
+ If (-not $SkipDependentServices) {
+ Write-Log -Message "Discover all dependent service(s) for service [$Name] which are not 'Running'." -Source ${CmdletName}
+ [ServiceProcess.ServiceController[]]$DependentServices = Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -DependentServices -ErrorAction 'Stop' | Where-Object { $_.Status -ne 'Running' }
+ If ($DependentServices) {
+ ForEach ($DependentService in $DependentServices) {
+ Write-Log -Message "Start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]." -Source ${CmdletName}
+ Try {
+ Start-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $DependentService.ServiceName -ErrorAction 'Stop') -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]. Continue..." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Dependent service(s) were not discovered for service [$Name]." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to start the service [$Name]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to start the service [$Name]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ # Return the service object if option selected
+ If ($PassThru -and $Service) { Write-Output -InputObject $Service }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-ServiceStartMode
+Function Get-ServiceStartMode
+{
+<#
+.SYNOPSIS
+ Get the service startup mode.
+.DESCRIPTION
+ Get the service startup mode.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-ServiceStartMode -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdLetBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get the service [$Name] startup mode." -Source ${CmdletName}
+ [string]$ServiceStartMode = (Get-WmiObject -ComputerName $ComputerName -Class 'Win32_Service' -Filter "Name='$Name'" -Property 'StartMode' -ErrorAction 'Stop').StartMode
+ ## If service start mode is set to 'Auto', change value to 'Automatic' to be consistent with 'Set-ServiceStartMode' function
+ If ($ServiceStartMode -eq 'Auto') { $ServiceStartMode = 'Automatic'}
+
+ ## If on Windows Vista or higher, check to see if service is set to Automatic (Delayed Start)
+ If (($ServiceStartMode -eq 'Automatic') -and (([version]$envOSVersion).Major -gt 5)) {
+ Try {
+ [string]$ServiceRegistryPath = "HKLM:SYSTEM\CurrentControlSet\Services\$Name"
+ [int32]$DelayedAutoStart = Get-ItemProperty -LiteralPath $ServiceRegistryPath -ErrorAction 'Stop' | Select-Object -ExpandProperty 'DelayedAutoStart' -ErrorAction 'Stop'
+ If ($DelayedAutoStart -eq 1) { $ServiceStartMode = 'Automatic (Delayed Start)' }
+ }
+ Catch { }
+ }
+
+ Write-Log -Message "Service [$Name] startup mode is set to [$ServiceStartMode]." -Source ${CmdletName}
+ Write-Output -InputObject $ServiceStartMode
+ }
+ Catch {
+ Write-Log -Message "Failed to get the service [$Name] startup mode. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the service [$Name] startup mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-ServiceStartMode
+Function Set-ServiceStartMode
+{
+<#
+.SYNOPSIS
+ Set the service startup mode.
+.DESCRIPTION
+ Set the service startup mode.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER StartMode
+ Specify startup mode for the service. Options: Automatic, Automatic (Delayed Start), Manual, Disabled, Boot, System.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-ServiceStartMode -Name 'wuauserv' -StartMode 'Automatic (Delayed Start)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdLetBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('Automatic','Automatic (Delayed Start)','Manual','Disabled','Boot','System')]
+ [string]$StartMode,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If on lower than Windows Vista and 'Automatic (Delayed Start)' selected, then change to 'Automatic' because 'Delayed Start' is not supported.
+ If (($StartMode -eq 'Automatic (Delayed Start)') -and (([version]$envOSVersion).Major -lt 6)) { $StartMode = 'Automatic' }
+
+ Write-Log -Message "Set service [$Name] startup mode to [$StartMode]." -Source ${CmdletName}
+
+ ## Set the name of the start up mode that will be passed to sc.exe
+ [string]$ScExeStartMode = $StartMode
+ If ($StartMode -eq 'Automatic') { $ScExeStartMode = 'Auto' }
+ If ($StartMode -eq 'Automatic (Delayed Start)') { $ScExeStartMode = 'Delayed-Auto' }
+ If ($StartMode -eq 'Manual') { $ScExeStartMode = 'Demand' }
+
+ ## Set the start up mode using sc.exe. Note: we found that the ChangeStartMode method in the Win32_Service WMI class set services to 'Automatic (Delayed Start)' even when you specified 'Automatic' on Win7, Win8, and Win10.
+ $ChangeStartMode = & sc.exe config $Name start= $ScExeStartMode
+
+ If ($global:LastExitCode -ne 0) {
+ Throw "sc.exe failed with exit code [$($global:LastExitCode)] and message [$ChangeStartMode]."
+ }
+
+ Write-Log -Message "Successfully set service [$Name] startup mode to [$StartMode]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to set service [$Name] startup mode to [$StartMode]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to set service [$Name] startup mode to [$StartMode]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-LoggedOnUser
+Function Get-LoggedOnUser {
+<#
+.SYNOPSIS
+ Get session details for all local and RDP logged on users.
+.DESCRIPTION
+ Get session details for all local and RDP logged on users using Win32 APIs. Get the following session details:
+ NTAccount, SID, UserName, DomainName, SessionId, SessionName, ConnectState, IsCurrentSession, IsConsoleSession, IsUserSession, IsActiveUserSession
+ IsRdpSession, IsLocalAdmin, LogonTime, IdleTime, DisconnectTime, ClientName, ClientProtocolType, ClientDirectory, ClientBuildNumber
+.EXAMPLE
+ Get-LoggedOnUser
+.NOTES
+ Description of ConnectState property:
+ Value Description
+ ----- -----------
+ Active A user is logged on to the session.
+ ConnectQuery The session is in the process of connecting to a client.
+ Connected A client is connected to the session.
+ Disconnected The session is active, but the client has disconnected from it.
+ Down The session is down due to an error.
+ Idle The session is waiting for a client to connect.
+ Initializing The session is initializing.
+ Listening The session is listening for connections.
+ Reset The session is being reset.
+ Shadowing This session is shadowing another session.
+
+ Description of IsActiveUserSession property:
+ If a console user exists, then that will be the active user session.
+ If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user that is either 'Active' or 'Connected' is the active user.
+
+ Description of IsRdpSession property:
+ Gets a value indicating whether the user is associated with an RDP client session.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Get session information for all logged on users.' -Source ${CmdletName}
+ Write-Output -InputObject ([PSADT.QueryUser]::GetUserSessionInfo("$env:ComputerName"))
+ }
+ Catch {
+ Write-Log -Message "Failed to get session information for all logged on users. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-PendingReboot
+Function Get-PendingReboot {
+<#
+.SYNOPSIS
+ Get the pending reboot status on a local computer.
+.DESCRIPTION
+ Check WMI and the registry to determine if the system has a pending reboot operation from any of the following:
+ a) Component Based Servicing (Vista, Windows 2008)
+ b) Windows Update / Auto Update (XP, Windows 2003 / 2008)
+ c) SCCM 2012 Clients (DetermineIfRebootPending WMI method)
+ d) App-V Pending Tasks (global based Appv 5.0 SP2)
+ e) Pending File Rename Operations (XP, Windows 2003 / 2008)
+.EXAMPLE
+ Get-PendingReboot
+
+ Returns custom object with following properties:
+ ComputerName, LastBootUpTime, IsSystemRebootPending, IsCBServicingRebootPending, IsWindowsUpdateRebootPending, IsSCCMClientRebootPending, IsFileRenameRebootPending, PendingFileRenameOperations, ErrorMsg
+
+ *Notes: ErrorMsg only contains something if an error occurred
+.EXAMPLE
+ (Get-PendingReboot).IsSystemRebootPending
+ Returns boolean value determining whether or not there is a pending reboot operation.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Initialize variables
+ [string]$private:ComputerName = ([Net.Dns]::GetHostEntry('')).HostName
+ $PendRebootErrorMsg = $null
+ }
+ Process {
+ Write-Log -Message "Get the pending reboot status on the local computer [$ComputerName]." -Source ${CmdletName}
+
+ ## Get the date/time that the system last booted up
+ Try {
+ [nullable[datetime]]$LastBootUpTime = (Get-Date -ErrorAction 'Stop') - ([timespan]::FromMilliseconds([math]::Abs([Environment]::TickCount)))
+ }
+ Catch {
+ [nullable[datetime]]$LastBootUpTime = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get LastBootUpTime: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get LastBootUpTime. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if a Windows Vista/Server 2008 and above machine has a pending reboot from a Component Based Servicing (CBS) operation
+ Try {
+ If (([version]$envOSVersion).Major -ge 5) {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending' -ErrorAction 'Stop') {
+ [nullable[boolean]]$IsCBServicingRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsCBServicingRebootPending = $false
+ }
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsCBServicingRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsCBServicingRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsCBServicingRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from a Windows Update
+ Try {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired' -ErrorAction 'Stop') {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $false
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsWindowsUpdateRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsWindowsUpdateRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from a pending file rename operation
+ [boolean]$IsFileRenameRebootPending = $false
+ $PendingFileRenameOperations = $null
+ If (Test-RegistryValue -Key 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -Value 'PendingFileRenameOperations') {
+ # If PendingFileRenameOperations value exists, set $IsFileRenameRebootPending variable to $true
+ [boolean]$IsFileRenameRebootPending = $true
+ # Get the value of PendingFileRenameOperations
+ Try {
+ [string[]]$PendingFileRenameOperations = Get-ItemProperty -LiteralPath 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'PendingFileRenameOperations' -ErrorAction 'Stop'
+ }
+ Catch {
+ [string[]]$PendRebootErrorMsg += "Failed to get PendingFileRenameOperations: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get PendingFileRenameOperations. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+
+ ## Determine SCCM 2012 Client reboot pending status
+ Try {
+ [boolean]$IsSccmClientNamespaceExists = $false
+ [psobject]$SCCMClientRebootStatus = Invoke-WmiMethod -ComputerName $ComputerName -NameSpace 'ROOT\CCM\ClientSDK' -Class 'CCM_ClientUtilities' -Name 'DetermineIfRebootPending' -ErrorAction 'Stop'
+ [boolean]$IsSccmClientNamespaceExists = $true
+ If ($SCCMClientRebootStatus.ReturnValue -ne 0) {
+ Throw "'DetermineIfRebootPending' method of 'ROOT\CCM\ClientSDK\CCM_ClientUtilities' class returned error code [$($SCCMClientRebootStatus.ReturnValue)]"
+ }
+ Else {
+ Write-Log -Message 'Successfully queried SCCM client for reboot status.' -Source ${CmdletName}
+ [nullable[boolean]]$IsSCCMClientRebootPending = $false
+ If ($SCCMClientRebootStatus.IsHardRebootPending -or $SCCMClientRebootStatus.RebootPending) {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $true
+ Write-Log -Message 'Pending SCCM reboot detected.' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message 'Pending SCCM reboot not detected.' -Source ${CmdletName}
+ }
+ }
+ }
+ Catch [System.Management.ManagementException] {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $null
+ [boolean]$IsSccmClientNamespaceExists = $false
+ Write-Log -Message "Failed to get IsSCCMClientRebootPending. Failed to detect the SCCM client WMI class." -Severity 3 -Source ${CmdletName}
+ }
+ Catch {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsSCCMClientRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsSCCMClientRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from an App-V global Pending Task. (User profile based tasks will complete on logoff/logon)
+ Try {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Software\Microsoft\AppV\Client\PendingTasks' -ErrorAction 'Stop') {
+
+ [nullable[boolean]]$IsAppVRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsAppVRebootPending = $false
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsAppVRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsAppVRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsAppVRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot for the system
+ [boolean]$IsSystemRebootPending = $false
+ If ($IsCBServicingRebootPending -or $IsWindowsUpdateRebootPending -or $IsSCCMClientRebootPending -or $IsFileRenameRebootPending) {
+ [boolean]$IsSystemRebootPending = $true
+ }
+
+ ## Create a custom object containing pending reboot information for the system
+ [psobject]$PendingRebootInfo = New-Object -TypeName 'PSObject' -Property @{
+ ComputerName = $ComputerName
+ LastBootUpTime = $LastBootUpTime
+ IsSystemRebootPending = $IsSystemRebootPending
+ IsCBServicingRebootPending = $IsCBServicingRebootPending
+ IsWindowsUpdateRebootPending = $IsWindowsUpdateRebootPending
+ IsSCCMClientRebootPending = $IsSCCMClientRebootPending
+ IsAppVRebootPending = $IsAppVRebootPending
+ IsFileRenameRebootPending = $IsFileRenameRebootPending
+ PendingFileRenameOperations = $PendingFileRenameOperations
+ ErrorMsg = $PendRebootErrorMsg
+ }
+ Write-Log -Message "Pending reboot status on the local computer [$ComputerName]: `n$($PendingRebootInfo | Format-List | Out-String)" -Source ${CmdletName}
+ }
+ End {
+ Write-Output -InputObject ($PendingRebootInfo | Select-Object -Property 'ComputerName','LastBootUpTime','IsSystemRebootPending','IsCBServicingRebootPending','IsWindowsUpdateRebootPending','IsSCCMClientRebootPending','IsAppVRebootPending','IsFileRenameRebootPending','PendingFileRenameOperations','ErrorMsg')
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#endregion
+##*=============================================
+##* END FUNCTION LISTINGS
+##*=============================================
+
+##*=============================================
+##* SCRIPT BODY
+##*=============================================
+#region ScriptBody
+
+## If the script was invoked by the Help Console, exit the script now
+If ($invokingScript) {
+ If ((Split-Path -Path $invokingScript -Leaf) -eq 'AppDeployToolkitHelp.ps1') { Return }
+}
+
+## Add the custom types required for the toolkit
+If (-not ([Management.Automation.PSTypeName]'PSADT.UiAutomation').Type) {
+ [string[]]$ReferencedAssemblies = 'System.Drawing', 'System.Windows.Forms', 'System.DirectoryServices'
+ Add-Type -Path $appDeployCustomTypesSourceCode -ReferencedAssemblies $ReferencedAssemblies -IgnoreWarnings -ErrorAction 'Stop'
+}
+
+## Define ScriptBlocks to disable/revert script logging
+[scriptblock]$DisableScriptLogging = { $OldDisableLoggingValue = $DisableLogging ; $DisableLogging = $true }
+[scriptblock]$RevertScriptLogging = { $DisableLogging = $OldDisableLoggingValue }
+
+## Define ScriptBlock for getting details for all logged on users
+[scriptblock]$GetLoggedOnUserDetails = {
+ [psobject[]]$LoggedOnUserSessions = Get-LoggedOnUser
+ [string[]]$usersLoggedOn = $LoggedOnUserSessions | ForEach-Object { $_.NTAccount }
+
+ If ($usersLoggedOn) {
+ # Get account and session details for the logged on user session that the current process is running under. Note that the account used to execute the current process may be different than the account that is logged into the session (i.e. you can use "RunAs" to launch with different credentials when logged into an account).
+ [psobject]$CurrentLoggedOnUserSession = $LoggedOnUserSessions | Where-Object { $_.IsCurrentSession }
+
+ # Get account and session details for the account running as the console user (user with control of the physical monitor, keyboard, and mouse)
+ [psobject]$CurrentConsoleUserSession = $LoggedOnUserSessions | Where-Object { $_.IsConsoleSession }
+
+ ## Determine the account that will be used to execute commands in the user session when toolkit is running under the SYSTEM account
+ # If a console user exists, then that will be the active user session.
+ # If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user that is either 'Active' or 'Connected' is the active user.
+ [psobject]$RunAsActiveUser = $LoggedOnUserSessions | Where-Object { $_.IsActiveUserSession }
+ }
+}
+
+## Define ScriptBlock to test for and attempt to make a service healthy by checking if it exists, is currently running, and has the specified start mode.
+[scriptblock]$TestServiceHealth = {
+ Param (
+ [string]$ServiceName,
+ [string]$ServiceStartMode = 'Automatic'
+ )
+ Try {
+ [boolean]$IsServiceHealthy = $true
+ If (Test-ServiceExists -Name $ServiceName -ContinueOnError $false) {
+ If ((Get-ServiceStartMode -Name $ServiceName -ContinueOnError $false) -ne $ServiceStartMode) {
+ Set-ServiceStartMode -Name $ServiceName -StartMode $ServiceStartMode -ContinueOnError $false
+ }
+ Start-ServiceAndDependencies -Name $ServiceName -SkipServiceExistsTest -ContinueOnError $false
+ }
+ Else {
+ [boolean]$IsServiceHealthy = $false
+ }
+ }
+ Catch {
+ [boolean]$IsServiceHealthy = $false
+ }
+ Write-Output -InputObject $IsServiceHealthy
+}
+
+## Disable logging until log file details are available
+. $DisableScriptLogging
+
+## If the default Deploy-Application.ps1 hasn't been modified, and the main script was not called by a referring script, check for MSI / MST and modify the install accordingly
+If ((-not $appName) -and (-not $ReferredInstallName)){
+ # Find the first MSI file in the Files folder and use that as our install
+ [string]$defaultMsiFile = Get-ChildItem -LiteralPath $dirFiles -ErrorAction 'SilentlyContinue' | Where-Object { (-not $_.PsIsContainer) -and ([IO.Path]::GetExtension($_.Name) -eq '.msi') } | Select-Object -ExpandProperty 'FullName' -First 1
+ If ($defaultMsiFile) {
+ Try {
+ [boolean]$useDefaultMsi = $true
+ Write-Log -Message "Discovered Zero-Config MSI installation file [$defaultMsiFile]." -Source $appDeployToolkitName
+ # Discover if there is a zero-config MST file
+ [string]$defaultMstFile = [IO.Path]::ChangeExtension($defaultMsiFile, 'mst')
+ If (Test-Path -LiteralPath $defaultMstFile -PathType 'Leaf') {
+ Write-Log -Message "Discovered Zero-Config MST installation file [$defaultMstFile]." -Source $appDeployToolkitName
+ }
+ Else {
+ [string]$defaultMstFile = ''
+ }
+ # Discover if there are zero-config MSP files. Name multiple MSP files in alphabetical order to control order in which they are installed.
+ [string[]]$defaultMspFiles = Get-ChildItem -LiteralPath $dirFiles -ErrorAction 'SilentlyContinue' | Where-Object { (-not $_.PsIsContainer) -and ([IO.Path]::GetExtension($_.Name) -eq '.msp') } | Select-Object -ExpandProperty 'FullName'
+ If ($defaultMspFiles) {
+ Write-Log -Message "Discovered Zero-Config MSP installation file(s) [$($defaultMspFiles -join ',')]." -Source $appDeployToolkitName
+ }
+
+ ## Read the MSI and get the installation details
+ [hashtable]$GetDefaultMsiTablePropertySplat = @{ Path = $defaultMsiFile; Table = 'Property'; ContinueOnError = $false; ErrorAction = 'Stop' }
+ If ($defaultMstFile) { $GetDefaultMsiTablePropertySplat.Add('TransformPath', $defaultMstFile) }
+ [psobject]$defaultMsiPropertyList = Get-MsiTableProperty @GetDefaultMsiTablePropertySplat
+ [string]$appVendor = $defaultMsiPropertyList.Manufacturer
+ [string]$appName = $defaultMsiPropertyList.ProductName
+ [string]$appVersion = $defaultMsiPropertyList.ProductVersion
+ $GetDefaultMsiTablePropertySplat.Set_Item('Table', 'File')
+ [psobject]$defaultMsiFileList = Get-MsiTableProperty @GetDefaultMsiTablePropertySplat
+ [string[]]$defaultMsiExecutables = Get-Member -InputObject $defaultMsiFileList -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Name' -ErrorAction 'Stop' | Where-Object { [IO.Path]::GetExtension($_) -eq '.exe' } | ForEach-Object { [IO.Path]::GetFileNameWithoutExtension($_) }
+ [string]$defaultMsiExecutablesList = $defaultMsiExecutables -join ','
+ Write-Log -Message "App Vendor [$appVendor]." -Source $appDeployToolkitName
+ Write-Log -Message "App Name [$appName]." -Source $appDeployToolkitName
+ Write-Log -Message "App Version [$appVersion]." -Source $appDeployToolkitName
+ Write-Log -Message "MSI Executable List [$defaultMsiExecutablesList]." -Source $appDeployToolkitName
+ }
+ Catch {
+ Write-Log -Message "Failed to process Zero-Config MSI Deployment. `n$(Resolve-Error)" -Source $appDeployToolkitName
+ $useDefaultMsi = $false ; $appVendor = '' ; $appName = '' ; $appVersion = ''
+ }
+ }
+}
+
+## Set up sample variables if Dot Sourcing the script, app details have not been specified, or InstallName not passed as parameter to the script
+If (-not $appName) {
+ [string]$appName = $appDeployMainScriptFriendlyName
+ If (-not $appVendor) { [string]$appVendor = 'PS' }
+ If (-not $appVersion) { [string]$appVersion = $appDeployMainScriptVersion }
+ If (-not $appLang) { [string]$appLang = $currentLanguage }
+ If (-not $appRevision) { [string]$appRevision = '01' }
+ If (-not $appArch) { [string]$appArch = '' }
+}
+If ($ReferredInstallTitle) { [string]$installTitle = $ReferredInstallTitle }
+If (-not $installTitle) {
+ [string]$installTitle = ("$appVendor $appName $appVersion").Trim()
+}
+
+## Sanitize the application details, as they can cause issues in the script
+[char[]]$invalidFileNameChars = [IO.Path]::GetInvalidFileNameChars()
+[string]$appVendor = $appVendor -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appName = $appName -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appVersion = $appVersion -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appArch = $appArch -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appLang = $appLang -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appRevision = $appRevision -replace "[$invalidFileNameChars]",'' -replace ' ',''
+
+## Build the Installation Name
+If ($ReferredInstallName) { [string]$installName = $ReferredInstallName }
+If (-not $installName) {
+ If ($appArch) {
+ [string]$installName = $appVendor + '_' + $appName + '_' + $appVersion + '_' + $appArch + '_' + $appLang + '_' + $appRevision
+ }
+ Else {
+ [string]$installName = $appVendor + '_' + $appName + '_' + $appVersion + '_' + $appLang + '_' + $appRevision
+ }
+}
+[string]$installName = $installName -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$installName = $installName.Trim('_') -replace '[_]+','_'
+
+## Set the Defer History registry path
+[string]$regKeyDeferHistory = "$configToolkitRegPath\$appDeployToolkitName\DeferHistory\$installName"
+
+## Variables: Log Files
+If ($ReferredLogName) { [string]$logName = $ReferredLogName }
+If (-not $logName) { [string]$logName = $installName + '_' + $appDeployToolkitName + '_' + $deploymentType + '.log' }
+# If option to compress logs is selected, then log will be created in temp log folder ($logTempFolder) and then copied to actual log folder ($configToolkitLogDir) after being zipped.
+[string]$logTempFolder = Join-Path -Path $envTemp -ChildPath "${installName}_$deploymentType"
+If ($configToolkitCompressLogs) {
+ # If the temp log folder already exists from a previous ZIP operation, then delete all files in it to avoid issues
+ If (Test-Path -LiteralPath $logTempFolder -PathType 'Container' -ErrorAction 'SilentlyContinue') {
+ $null = Remove-Item -LiteralPath $logTempFolder -Recurse -Force -ErrorAction 'SilentlyContinue'
+ }
+}
+
+## Revert script logging to original setting
+. $RevertScriptLogging
+
+## Initialize Logging
+$installPhase = 'Initialization'
+$scriptSeparator = '*' * 79
+Write-Log -Message ($scriptSeparator,$scriptSeparator) -Source $appDeployToolkitName
+Write-Log -Message "[$installName] setup started." -Source $appDeployToolkitName
+
+## Assemblies: Load
+Try {
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'PresentationFramework' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'Microsoft.VisualBasic' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'System.Drawing' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'PresentationCore' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'WindowsBase' -ErrorAction 'Stop'
+}
+Catch {
+ Write-Log -Message "Failed to load assembly. `n$(Resolve-Error)" -Severity 3 -Source $appDeployToolkitName
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Continue despite assembly load error since deployment mode is [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ Exit-Script -ExitCode 60004
+ }
+}
+
+## Check how the script was invoked
+If ($invokingScript) {
+ Write-Log -Message "Script [$scriptPath] dot-source invoked by [$invokingScript]" -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "Script [$scriptPath] invoked directly" -Source $appDeployToolkitName
+}
+
+## Dot Source script extensions
+If (Test-Path -LiteralPath "$scriptRoot\$appDeployToolkitDotSourceExtensions" -PathType 'Leaf') {
+ . "$scriptRoot\$appDeployToolkitDotSourceExtensions"
+}
+
+## Evaluate non-default parameters passed to the scripts
+If ($deployAppScriptParameters) { [string]$deployAppScriptParameters = ($deployAppScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+# Save main script parameters hashtable for async execution of the toolkit
+[hashtable]$appDeployMainScriptAsyncParameters = $appDeployMainScriptParameters
+If ($appDeployMainScriptParameters) { [string]$appDeployMainScriptParameters = ($appDeployMainScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+If ($appDeployExtScriptParameters) { [string]$appDeployExtScriptParameters = ($appDeployExtScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+
+## Check the XML config file version
+If ($configConfigVersion -lt $appDeployMainScriptMinimumConfigVersion) {
+ [string]$XMLConfigVersionErr = "The XML configuration file version [$configConfigVersion] is lower than the supported version required by the Toolkit [$appDeployMainScriptMinimumConfigVersion]. Please upgrade the configuration file."
+ Write-Log -Message $XMLConfigVersionErr -Severity 3 -Source $appDeployToolkitName
+ Throw $XMLConfigVersionErr
+}
+
+## Log system/script information
+If ($appScriptVersion) { Write-Log -Message "[$installName] script version is [$appScriptVersion]" -Source $appDeployToolkitName }
+If ($deployAppScriptFriendlyName) { Write-Log -Message "[$deployAppScriptFriendlyName] script version is [$deployAppScriptVersion]" -Source $appDeployToolkitName }
+If ($deployAppScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$deployAppScriptFriendlyName]: [$deployAppScriptParameters]" -Source $appDeployToolkitName }
+If ($appDeployMainScriptFriendlyName) { Write-Log -Message "[$appDeployMainScriptFriendlyName] script version is [$appDeployMainScriptVersion]" -Source $appDeployToolkitName }
+If ($appDeployMainScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$appDeployMainScriptFriendlyName]: [$appDeployMainScriptParameters]" -Source $appDeployToolkitName }
+If ($appDeployExtScriptFriendlyName) { Write-Log -Message "[$appDeployExtScriptFriendlyName] version is [$appDeployExtScriptVersion]" -Source $appDeployToolkitName }
+If ($appDeployExtScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$appDeployExtScriptFriendlyName]: [$appDeployExtScriptParameters]" -Source $appDeployToolkitName }
+Write-Log -Message "Computer Name is [$envComputerNameFQDN]" -Source $appDeployToolkitName
+Write-Log -Message "Current User is [$ProcessNTAccount]" -Source $appDeployToolkitName
+If ($envOSServicePack) {
+ Write-Log -Message "OS Version is [$envOSName $envOSServicePack $envOSArchitecture $envOSVersion]" -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "OS Version is [$envOSName $envOSArchitecture $envOSVersion]" -Source $appDeployToolkitName
+}
+Write-Log -Message "OS Type is [$envOSProductTypeName]" -Source $appDeployToolkitName
+Write-Log -Message "Current Culture is [$($culture.Name)], language is [$currentLanguage] and UI language is [$currentUILanguage]" -Source $appDeployToolkitName
+Write-Log -Message "Hardware Platform is [$(. $DisableScriptLogging; Get-HardwarePlatform; . $RevertScriptLogging)]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell Host is [$($envHost.Name)] with version [$($envHost.Version)]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell Version is [$envPSVersion $psArchitecture]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell CLR (.NET) version is [$envCLRVersion]" -Source $appDeployToolkitName
+Write-Log -Message $scriptSeparator -Source $appDeployToolkitName
+
+## Disable logging
+. $DisableScriptLogging
+
+## Dot source ScriptBlock to get a list of all users logged on to the system (both local and RDP users), and discover session details for account executing script
+. $GetLoggedOnUserDetails
+
+## Dot source ScriptBlock to load localized UI messages from config XML
+. $xmlLoadLocalizedUIMessages
+
+## Dot source ScriptBlock to get system DPI scale factor
+. $GetDisplayScaleFactor
+
+## Revert script logging to original setting
+. $RevertScriptLogging
+
+## Set the install phase to asynchronous if the script was not dot sourced, i.e. called with parameters
+If ($AsyncToolkitLaunch) {
+ $installPhase = 'Asynchronous'
+}
+
+## If the ShowInstallationPrompt Parameter is specified, only call that function.
+If ($showInstallationPrompt) {
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowInstallationPrompt]." -Source $appDeployToolkitName
+ $appDeployMainScriptAsyncParameters.Remove('ShowInstallationPrompt')
+ $appDeployMainScriptAsyncParameters.Remove('AsyncToolkitLaunch')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallName')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallTitle')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredLogName')
+ Show-InstallationPrompt @appDeployMainScriptAsyncParameters
+ Exit 0
+}
+
+## If the ShowInstallationRestartPrompt Parameter is specified, only call that function.
+If ($showInstallationRestartPrompt) {
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowInstallationRestartPrompt]." -Source $appDeployToolkitName
+ $appDeployMainScriptAsyncParameters.Remove('ShowInstallationRestartPrompt')
+ $appDeployMainScriptAsyncParameters.Remove('AsyncToolkitLaunch')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallName')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallTitle')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredLogName')
+ Show-InstallationRestartPrompt @appDeployMainScriptAsyncParameters
+ Exit 0
+}
+
+## If the CleanupBlockedApps Parameter is specified, only call that function.
+If ($cleanupBlockedApps) {
+ $deployModeSilent = $true
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-CleanupBlockedApps]." -Source $appDeployToolkitName
+ Unblock-AppExecution
+ Exit 0
+}
+
+## If the ShowBlockedAppDialog Parameter is specified, only call that function.
+If ($showBlockedAppDialog) {
+ Try {
+ . $DisableScriptLogging
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowBlockedAppDialog]." -Source $appDeployToolkitName
+ # Create a mutex and specify a name without acquiring a lock on the mutex
+ [boolean]$showBlockedAppDialogMutexLocked = $false
+ [string]$showBlockedAppDialogMutexName = 'Global\PSADT_ShowBlockedAppDialog_Message'
+ [Threading.Mutex]$showBlockedAppDialogMutex = New-Object -TypeName 'System.Threading.Mutex' -ArgumentList ($false, $showBlockedAppDialogMutexName)
+ # Attempt to acquire an exclusive lock on the mutex, attempt will fail after 1 millisecond if unable to acquire exclusive lock
+ If ((Test-IsMutexAvailable -MutexName $showBlockedAppDialogMutexName -MutexWaitTimeInMilliseconds 1) -and ($showBlockedAppDialogMutex.WaitOne(1))) {
+ [boolean]$showBlockedAppDialogMutexLocked = $true
+ Show-InstallationPrompt -Title $installTitle -Message $configBlockExecutionMessage -Icon 'Warning' -ButtonRightText 'OK'
+ Exit 0
+ }
+ Else {
+ # If attempt to acquire an exclusive lock on the mutex failed, then exit script as another blocked app dialog window is already open
+ Write-Log -Message "Unable to acquire an exclusive lock on mutex [$showBlockedAppDialogMutexName] because another blocked application dialog window is already open. Exiting script..." -Severity 2 -Source $appDeployToolkitName
+ Exit 0
+ }
+ }
+ Catch {
+ Write-Log -Message "There was an error in displaying the Installation Prompt. `n$(Resolve-Error)" -Severity 3 -Source $appDeployToolkitName
+ Exit 60005
+ }
+ Finally {
+ If ($showBlockedAppDialogMutexLocked) { $null = $showBlockedAppDialogMutex.ReleaseMutex() }
+ If ($showBlockedAppDialogMutex) { $showBlockedAppDialogMutex.Close() }
+ }
+}
+
+## Log details for all currently logged in users
+Write-Log -Message "Display session information for all logged on users: `n$($LoggedOnUserSessions | Format-List | Out-String)" -Source $appDeployToolkitName
+If ($usersLoggedOn) {
+ Write-Log -Message "The following users are logged on to the system: [$($usersLoggedOn -join ', ')]." -Source $appDeployToolkitName
+
+ # Check if the current process is running in the context of one of the logged in users
+ If ($CurrentLoggedOnUserSession) {
+ Write-Log -Message "Current process is running with user account [$ProcessNTAccount] under logged in user session for [$($CurrentLoggedOnUserSession.NTAccount)]." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message "Current process is running under a system account [$ProcessNTAccount]." -Source $appDeployToolkitName
+ }
+
+ # Display account and session details for the account running as the console user (user with control of the physical monitor, keyboard, and mouse)
+ If ($CurrentConsoleUserSession) {
+ Write-Log -Message "The following user is the console user [$($CurrentConsoleUserSession.NTAccount)] (user with control of physical monitor, keyboard, and mouse)." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message 'There is no console user logged in (user with control of physical monitor, keyboard, and mouse).' -Source $appDeployToolkitName
+ }
+
+ # Display the account that will be used to execute commands in the user session when toolkit is running under the SYSTEM account
+ If ($RunAsActiveUser) {
+ Write-Log -Message "The active logged on user is [$($RunAsActiveUser.NTAccount)]." -Source $appDeployToolkitName
+ }
+}
+Else {
+ Write-Log -Message 'No users are logged on to the system.' -Source $appDeployToolkitName
+}
+
+## Log which language's UI messages are loaded from the config XML file
+If ($HKUPrimaryLanguageShort) {
+ Write-Log -Message "The active logged on user [$($RunAsActiveUser.NTAccount)] has a primary UI language of [$HKUPrimaryLanguageShort]." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "The current system account [$ProcessNTAccount] has a primary UI language of [$currentLanguage]." -Source $appDeployToolkitName
+}
+If ($configInstallationUILanguageOverride) { Write-Log -Message "The config XML file was configured to override the detected primary UI language with the following UI language: [$configInstallationUILanguageOverride]." -Source $appDeployToolkitName }
+Write-Log -Message "The following UI messages were imported from the config XML file: [$xmlUIMessageLanguage]." -Source $appDeployToolkitName
+
+## Log system DPI scale factor of active logged on user
+If ($UserDisplayScaleFactor) {
+ Write-Log -Message "The active logged on user [$($RunAsActiveUser.NTAccount)] has a DPI scale factor of [$dpiScale] with DPI pixels [$dpiPixels]." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "The system has a DPI scale factor of [$dpiScale] with DPI pixels [$dpiPixels]." -Source $appDeployToolkitName
+}
+
+## Check if script is running from a SCCM Task Sequence
+Try {
+ [__comobject]$SMSTSEnvironment = New-Object -ComObject 'Microsoft.SMS.TSEnvironment' -ErrorAction 'Stop'
+ Write-Log -Message 'Successfully loaded COM Object [Microsoft.SMS.TSEnvironment]. Therefore, script is currently running from a SCCM Task Sequence.' -Source $appDeployToolkitName
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SMSTSEnvironment)
+ $runningTaskSequence = $true
+}
+Catch {
+ Write-Log -Message 'Unable to load COM Object [Microsoft.SMS.TSEnvironment]. Therefore, script is not currently running from a SCCM Task Sequence.' -Source $appDeployToolkitName
+ $runningTaskSequence = $false
+}
+
+
+## Check to see if the Task Scheduler service is in a healthy state by checking its services to see if they exist, are currently running, and have a start mode of 'Automatic'.
+## The task scheduler service and the services it is dependent on can/should only be started/stopped/modified when running in the SYSTEM context.
+[boolean]$IsTaskSchedulerHealthy = $true
+If ($IsLocalSystemAccount) {
+ # Check the health of the 'COM+ Event System' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'EventSystem'
+ # Check the health of the 'Remote Procedure Call (RPC)' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'RpcSs'
+ # Check the health of the 'Windows Event Log' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'EventLog'
+ # Check the health of the 'Task Scheduler' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'Schedule'
+
+ Write-Log -Message "The task scheduler service is in a healthy state: $IsTaskSchedulerHealthy." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "Skipping attempt to check for and make the task scheduler services healthy because the App Deployment Toolkit is not running under the [$LocalSystemNTAccount] account." -Source $appDeployToolkitName
+}
+
+## If script is running in session zero
+If ($SessionZero) {
+ ## If the script was launched with deployment mode set to NonInteractive, then continue
+ If ($deployMode -eq 'NonInteractive') {
+ Write-Log -Message "Session 0 detected but deployment mode was manually set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ ## If the process is not able to display a UI, enable NonInteractive mode
+ If (-not $IsProcessUserInteractive) {
+ $deployMode = 'NonInteractive'
+ Write-Log -Message "Session 0 detected, process not running in user interactive mode; deployment mode set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ If (-not $usersLoggedOn) {
+ $deployMode = 'NonInteractive'
+ Write-Log -Message "Session 0 detected, process running in user interactive mode, no users logged in; deployment mode set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message 'Session 0 detected, process running in user interactive mode, user(s) logged in.' -Source $appDeployToolkitName
+ }
+ }
+ }
+}
+Else {
+ Write-Log -Message 'Session 0 not detected.' -Source $appDeployToolkitName
+}
+
+## Set Deploy Mode switches
+If ($deployMode) {
+ Write-Log -Message "Installation is running in [$deployMode] mode." -Source $appDeployToolkitName
+}
+Switch ($deployMode) {
+ 'Silent' { $deployModeSilent = $true }
+ 'NonInteractive' { $deployModeNonInteractive = $true; $deployModeSilent = $true }
+ Default { $deployModeNonInteractive = $false; $deployModeSilent = $false }
+}
+
+## Check deployment type (install/uninstall)
+Switch ($deploymentType) {
+ 'Install' { $deploymentTypeName = $configDeploymentTypeInstall }
+ 'Uninstall' { $deploymentTypeName = $configDeploymentTypeUnInstall }
+ Default { $deploymentTypeName = $configDeploymentTypeInstall }
+}
+If ($deploymentTypeName) { Write-Log -Message "Deployment type is [$deploymentTypeName]." -Source $appDeployToolkitName }
+
+If ($useDefaultMsi) { Write-Log -Message "Discovered Zero-Config MSI installation file [$defaultMsiFile]." -Source $appDeployToolkitName }
+
+## Check current permissions and exit if not running with Administrator rights
+If ($configToolkitRequireAdmin) {
+ # Check if the current process is running with elevated administrator permissions
+ If ((-not $IsAdmin) -and (-not $ShowBlockedAppDialog)) {
+ [string]$AdminPermissionErr = "[$appDeployToolkitName] has an XML config file option [Toolkit_RequireAdmin] set to [True] so as to require Administrator rights for the toolkit to function. Please re-run the deployment script as an Administrator or change the option in the XML config file to not require Administrator rights."
+ Write-Log -Message $AdminPermissionErr -Severity 3 -Source $appDeployToolkitName
+ Show-DialogBox -Text $AdminPermissionErr -Icon 'Stop'
+ Throw $AdminPermissionErr
+ }
+}
+
+## If terminal server mode was specified, change the installation mode to support it
+If ($terminalServerMode) { Enable-TerminalServerInstallMode }
+
+#endregion
+##*=============================================
+##* END SCRIPT BODY
+##*=============================================
diff --git a/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/Thumbs.db b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/Thumbs.db
new file mode 100644
index 0000000..3c1f662
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/AppDeployToolkit/Thumbs.db differ
diff --git a/CFX Maestro/2.2/PS_Deployment/Deploy-Application.exe b/CFX Maestro/2.2/PS_Deployment/Deploy-Application.exe
new file mode 100644
index 0000000..4000f07
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/Deploy-Application.exe differ
diff --git a/CFX Maestro/2.2/PS_Deployment/Deploy-Application.exe.config b/CFX Maestro/2.2/PS_Deployment/Deploy-Application.exe.config
new file mode 100644
index 0000000..99844ed
--- /dev/null
+++ b/CFX Maestro/2.2/PS_Deployment/Deploy-Application.exe.config
@@ -0,0 +1,7 @@
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/CFX Maestro/2.2/PS_Deployment/Deploy-Application.ps1 b/CFX Maestro/2.2/PS_Deployment/Deploy-Application.ps1
new file mode 100644
index 0000000..3e7d543
--- /dev/null
+++ b/CFX Maestro/2.2/PS_Deployment/Deploy-Application.ps1
@@ -0,0 +1,226 @@
+<#
+.SYNOPSIS
+ This script performs the installation or uninstallation of an application(s).
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script is provided as a template to perform an install or uninstall of an application(s).
+ The script either performs an "Install" deployment type or an "Uninstall" deployment type.
+ The install deployment type is broken down into 3 main sections/phases: Pre-Install, Install, and Post-Install.
+ The script dot-sources the AppDeployToolkitMain.ps1 script which contains the logic and functions required to install or uninstall an application.
+.PARAMETER DeploymentType
+ The type of deployment to perform. Default is: Install.
+.PARAMETER DeployMode
+ Specifies whether the installation should be run in Interactive, Silent, or NonInteractive mode. Default is: Interactive. Options: Interactive = Shows dialogs, Silent = No dialogs, NonInteractive = Very silent, i.e. no blocking apps. NonInteractive mode is automatically set if it is detected that the process is not user interactive.
+.PARAMETER AllowRebootPassThru
+ Allows the 3010 return code (requires restart) to be passed back to the parent process (e.g. SCCM) if detected from an installation. If 3010 is passed back to SCCM, a reboot prompt will be triggered.
+.PARAMETER TerminalServerMode
+ Changes to "user install mode" and back to "user execute mode" for installing/uninstalling applications for Remote Destkop Session Hosts/Citrix servers.
+.PARAMETER DisableLogging
+ Disables logging to file for the script. Default is: $false.
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -DeployMode 'Silent'; Exit $LastExitCode }"
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -AllowRebootPassThru; Exit $LastExitCode }"
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -DeploymentType 'Uninstall'; Exit $LastExitCode }"
+.EXAMPLE
+ Deploy-Application.exe -DeploymentType "Install" -DeployMode "Silent"
+.NOTES
+ Toolkit Exit Code Ranges:
+ 60000 - 68999: Reserved for built-in exit codes in Deploy-Application.ps1, Deploy-Application.exe, and AppDeployToolkitMain.ps1
+ 69000 - 69999: Recommended for user customized exit codes in Deploy-Application.ps1
+ 70000 - 79999: Recommended for user customized exit codes in AppDeployToolkitExtensions.ps1
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Install','Uninstall')]
+ [string]$DeploymentType = 'Install',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Interactive','Silent','NonInteractive')]
+ [string]$DeployMode = 'Interactive',
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowRebootPassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$TerminalServerMode = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$DisableLogging = $false
+)
+
+Try {
+ ## Set the script execution policy for this process
+ Try { Set-ExecutionPolicy -ExecutionPolicy 'ByPass' -Scope 'Process' -Force -ErrorAction 'Stop' } Catch {}
+
+ ##*===============================================
+ ##* VARIABLE DECLARATION
+ ##*===============================================
+ ## Variables: Application
+ [string]$appVendor = 'Bio-Rad'
+ [string]$appName = 'CFX Maestro'
+ [string]$appVersion = '2.2'
+ [string]$appArch = 'x86_x64'
+ [string]$appLang = 'EN'
+ [string]$appRevision = '01'
+ [string]$appScriptVersion = '1.0.0'
+ [string]$appScriptDate = '10/06/2021'
+ [string]$appScriptAuthor = 'Shawn Curtis'
+ ##*===============================================
+ ## Variables: Install Titles (Only set here to override defaults set by the toolkit)
+ [string]$installName = ''
+ [string]$installTitle = ''
+
+ ##* Do not modify section below
+ #region DoNotModify
+
+ ## Variables: Exit Code
+ [int32]$mainExitCode = 0
+
+ ## Variables: Script
+ [string]$deployAppScriptFriendlyName = 'Deploy Application'
+ [version]$deployAppScriptVersion = [version]'3.7.0'
+ [string]$deployAppScriptDate = '02/13/2018'
+ [hashtable]$deployAppScriptParameters = $psBoundParameters
+
+ ## Variables: Environment
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $InvocationInfo = $HostInvocation } Else { $InvocationInfo = $MyInvocation }
+ [string]$scriptDirectory = Split-Path -Path $InvocationInfo.MyCommand.Definition -Parent
+
+ ## Dot source the required App Deploy Toolkit Functions
+ Try {
+ [string]$moduleAppDeployToolkitMain = "$scriptDirectory\AppDeployToolkit\AppDeployToolkitMain.ps1"
+ If (-not (Test-Path -LiteralPath $moduleAppDeployToolkitMain -PathType 'Leaf')) { Throw "Module does not exist at the specified location [$moduleAppDeployToolkitMain]." }
+ If ($DisableLogging) { . $moduleAppDeployToolkitMain -DisableLogging } Else { . $moduleAppDeployToolkitMain }
+ }
+ Catch {
+ If ($mainExitCode -eq 0){ [int32]$mainExitCode = 60008 }
+ Write-Error -Message "Module [$moduleAppDeployToolkitMain] failed to load: `n$($_.Exception.Message)`n `n$($_.InvocationInfo.PositionMessage)" -ErrorAction 'Continue'
+ ## Exit the script, returning the exit code to SCCM
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $script:ExitCode = $mainExitCode; Exit } Else { Exit $mainExitCode }
+ }
+
+ #endregion
+ ##* Do not modify section above
+ ##*===============================================
+ ##* END VARIABLE DECLARATION
+ ##*===============================================
+
+ If ($deploymentType -ine 'Uninstall') {
+ ##*===============================================
+ ##* PRE-INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Pre-Installation'
+
+ Write-Log "Closing related processses"
+ Show-InstallationWelcome -CloseApps 'BioRadC1000Server, BioRadCFXManager, BioRADMiniOpticonDiscovery'
+
+ ## Show Progress Message (with the default message)
+ Show-InstallationProgress
+
+ ##
+
+ ## Import the Trusted Certs required for installation. ##
+
+ Copy-File -Path "$dirSupportFiles\*.cer" -Destination 'C:\TEMP\'
+
+ # The following only works on W10, so I left it for futue reference #
+
+ #Import-Certificate "C:\TEMP\BioRad.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher\
+
+ #Import-Certificate "C:\TEMP\Jungo.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher\
+
+ certutil -addstore "TrustedPublisher" C:\TEMP\BioRad.cer
+
+ certutil -addstore "TrustedPublisher" C:\TEMP\Jungo.cer
+
+ ##*===============================================
+ ##* INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Installation'
+
+ ## Handle Zero-Config MSI Installations
+ If ($useDefaultMsi) {
+ [hashtable]$ExecuteDefaultMSISplat = @{ Action = 'Install'; Path = $defaultMsiFile }; If ($defaultMstFile) { $ExecuteDefaultMSISplat.Add('Transform', $defaultMstFile) }
+ Execute-MSI @ExecuteDefaultMSISplat; If ($defaultMspFiles) { $defaultMspFiles | ForEach-Object { Execute-MSI -Action 'Patch' -Path $_ } }
+ }
+
+ ##
+
+ Write-Log "Installing Bio-Rad CFX Maestro 2.2"
+ Execute-Process -Path "$dirFiles\CFX\CFXMaestroSetup.exe" -Parameters '/S /v/qn'
+
+ ##*===============================================
+ ##* POST-INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Post-Installation'
+
+ ##
+
+ ## Remove the Certificates that were copied locally for import.
+
+ Remove-Item 'C:\TEMP' -Recurse
+
+ }
+ ElseIf ($deploymentType -ieq 'Uninstall')
+ {
+ ##*===============================================
+ ##* PRE-UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Pre-Uninstallation'
+
+ ## Show Welcome Message, close Internet Explorer with a 60 second countdown before automatically closing
+ Show-InstallationWelcome -CloseApps 'BioRadC1000Server, BioRadCFXManager, BioRADMiniOpticonDiscovery' -CloseAppsCountdown 60
+
+ ## Show Progress Message (with the default message)
+ Show-InstallationProgress
+
+ ##
+
+
+ ##*===============================================
+ ##* UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Uninstallation'
+
+ ## Handle Zero-Config MSI Uninstallations
+ If ($useDefaultMsi) {
+ [hashtable]$ExecuteDefaultMSISplat = @{ Action = 'Uninstall'; Path = $defaultMsiFile }; If ($defaultMstFile) { $ExecuteDefaultMSISplat.Add('Transform', $defaultMstFile) }
+ Execute-MSI @ExecuteDefaultMSISplat
+ }
+
+ #
+
+ #Removing CFX Maestro
+ Write-Log "Removing CFX Maestro."
+ Remove-MSIApplications -Name 'Maestro' -FilterApplication (,('Publisher', 'Bio-Rad Laboratories, Inc.', 'Exact'))
+
+
+ ##*===============================================
+ ##* POST-UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Post-Uninstallation'
+
+ ##
+
+
+ }
+
+ ##*===============================================
+ ##* END SCRIPT BODY
+ ##*===============================================
+
+ ## Call the Exit-Script function to perform final cleanup operations
+ Exit-Script -ExitCode $mainExitCode
+}
+Catch {
+ [int32]$mainExitCode = 60001
+ [string]$mainErrorMessage = "$(Resolve-Error)"
+ Write-Log -Message $mainErrorMessage -Severity 3 -Source $deployAppScriptFriendlyName
+ Show-DialogBox -Text $mainErrorMessage -Icon 'Stop'
+ Exit-Script -ExitCode $mainExitCode
+}
\ No newline at end of file
diff --git a/CFX Maestro/2.2/PS_Deployment/SupportFiles/BioRad.cer b/CFX Maestro/2.2/PS_Deployment/SupportFiles/BioRad.cer
new file mode 100644
index 0000000..6ba4907
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/SupportFiles/BioRad.cer differ
diff --git a/CFX Maestro/2.2/PS_Deployment/SupportFiles/Jungo.cer b/CFX Maestro/2.2/PS_Deployment/SupportFiles/Jungo.cer
new file mode 100644
index 0000000..33740b2
Binary files /dev/null and b/CFX Maestro/2.2/PS_Deployment/SupportFiles/Jungo.cer differ
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitBanner.png b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitBanner.png
new file mode 100644
index 0000000..60c2ed1
Binary files /dev/null and b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitBanner.png differ
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitConfig.xml b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitConfig.xml
new file mode 100644
index 0000000..67fe1f1
Binary files /dev/null and b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitConfig.xml differ
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitExtensions.ps1 b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitExtensions.ps1
new file mode 100644
index 0000000..08fd4ed
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitExtensions.ps1
@@ -0,0 +1,57 @@
+<#
+.SYNOPSIS
+ This script is a template that allows you to extend the toolkit with your own custom functions.
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script is automatically dot-sourced by the AppDeployToolkitMain.ps1 script.
+.NOTES
+ Toolkit Exit Code Ranges:
+ 60000 - 68999: Reserved for built-in exit codes in Deploy-Application.ps1, Deploy-Application.exe, and AppDeployToolkitMain.ps1
+ 69000 - 69999: Recommended for user customized exit codes in Deploy-Application.ps1
+ 70000 - 79999: Recommended for user customized exit codes in AppDeployToolkitExtensions.ps1
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+)
+
+##*===============================================
+##* VARIABLE DECLARATION
+##*===============================================
+
+# Variables: Script
+[string]$appDeployToolkitExtName = 'PSAppDeployToolkitExt'
+[string]$appDeployExtScriptFriendlyName = 'App Deploy Toolkit Extensions'
+[version]$appDeployExtScriptVersion = [version]'1.5.0'
+[string]$appDeployExtScriptDate = '02/12/2017'
+[hashtable]$appDeployExtScriptParameters = $PSBoundParameters
+
+##*===============================================
+##* FUNCTION LISTINGS
+##*===============================================
+
+#
+
+##*===============================================
+##* END FUNCTION LISTINGS
+##*===============================================
+
+##*===============================================
+##* SCRIPT BODY
+##*===============================================
+
+If ($scriptParentPath) {
+ Write-Log -Message "Script [$($MyInvocation.MyCommand.Definition)] dot-source invoked by [$(((Get-Variable -Name MyInvocation).Value).ScriptName)]" -Source $appDeployToolkitExtName
+}
+Else {
+ Write-Log -Message "Script [$($MyInvocation.MyCommand.Definition)] invoked directly" -Source $appDeployToolkitExtName
+}
+
+##*===============================================
+##* END SCRIPT BODY
+##*===============================================
\ No newline at end of file
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitHelp.ps1 b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitHelp.ps1
new file mode 100644
index 0000000..83c6e4a
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitHelp.ps1
@@ -0,0 +1,132 @@
+<#
+.SYNOPSIS
+ Displays a graphical console to browse the help for the App Deployment Toolkit functions
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ Displays a graphical console to browse the help for the App Deployment Toolkit functions
+.EXAMPLE
+ AppDeployToolkitHelp.ps1
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+
+##*===============================================
+##* VARIABLE DECLARATION
+##*===============================================
+
+## Variables: Script
+[string]$appDeployToolkitHelpName = 'PSAppDeployToolkitHelp'
+[string]$appDeployHelpScriptFriendlyName = 'App Deploy Toolkit Help'
+[version]$appDeployHelpScriptVersion = [version]'3.6.5'
+[string]$appDeployHelpScriptDate = '02/12/2017'
+
+## Variables: Environment
+[string]$scriptDirectory = Split-Path -Path $MyInvocation.MyCommand.Definition -Parent
+# Dot source the App Deploy Toolkit Functions
+. "$scriptDirectory\AppDeployToolkitMain.ps1" -DisableLogging
+
+##*===============================================
+##* END VARIABLE DECLARATION
+##*===============================================
+
+##*===============================================
+##* FUNCTION LISTINGS
+##*===============================================
+
+Function Show-HelpConsole {
+ ## Import the Assemblies
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName System.Drawing -ErrorAction 'Stop'
+
+ ## Form Objects
+ $HelpForm = New-Object -TypeName 'System.Windows.Forms.Form'
+ $HelpListBox = New-Object -TypeName 'System.Windows.Forms.ListBox'
+ $HelpTextBox = New-Object -TypeName 'System.Windows.Forms.RichTextBox'
+ $InitialFormWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ ## Form Code
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 665
+ $System_Drawing_Size.Width = 957
+ $HelpForm.ClientSize = $System_Drawing_Size
+ $HelpForm.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpForm.Name = 'HelpForm'
+ $HelpForm.Text = 'PowerShell App Deployment Toolkit Help Console'
+ $HelpForm.WindowState = 'Normal'
+ $HelpForm.ShowInTaskbar = $true
+ $HelpForm.FormBorderStyle = 'Fixed3D'
+ $HelpForm.MaximizeBox = $false
+ $HelpForm.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $HelpListBox.Anchor = 7
+ $HelpListBox.BorderStyle = 1
+ $HelpListBox.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpListBox.Font = New-Object -TypeName 'System.Drawing.Font' -ArgumentList ('Microsoft Sans Serif', 9.75, 1, 3, 1)
+ $HelpListBox.FormattingEnabled = $true
+ $HelpListBox.ItemHeight = 16
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $HelpListBox.Location = $System_Drawing_Point
+ $HelpListBox.Name = 'HelpListBox'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 658
+ $System_Drawing_Size.Width = 271
+ $HelpListBox.Size = $System_Drawing_Size
+ $HelpListBox.Sorted = $true
+ $HelpListBox.TabIndex = 2
+ $HelpListBox.add_SelectedIndexChanged({ $HelpTextBox.Text = Get-Help -Name $HelpListBox.SelectedItem -Full | Out-String })
+ $helpFunctions = Get-Command -CommandType 'Function' | Where-Object { ($_.HelpUri -match 'psappdeploytoolkit') -and ($_.Definition -notmatch 'internal script function') } | Select-Object -ExpandProperty Name
+ ForEach ($helpFunction in $helpFunctions) {
+ $null = $HelpListBox.Items.Add($helpFunction)
+ }
+ $HelpForm.Controls.Add($HelpListBox)
+ $HelpTextBox.Anchor = 11
+ $HelpTextBox.BorderStyle = 1
+ $HelpTextBox.DataBindings.DefaultDataSourceUpdateMode = 0
+ $HelpTextBox.Font = New-Object -TypeName 'System.Drawing.Font' -ArgumentList ('Microsoft Sans Serif', 8.5, 0, 3, 1)
+ $HelpTextBox.ForeColor = [System.Drawing.Color]::FromArgb(255, 0, 0, 0)
+ $System_Drawing_Point = New-Object -TypeName System.Drawing.Point
+ $System_Drawing_Point.X = 277
+ $System_Drawing_Point.Y = 0
+ $HelpTextBox.Location = $System_Drawing_Point
+ $HelpTextBox.Name = 'HelpTextBox'
+ $HelpTextBox.ReadOnly = $True
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 658
+ $System_Drawing_Size.Width = 680
+ $HelpTextBox.Size = $System_Drawing_Size
+ $HelpTextBox.TabIndex = 1
+ $HelpTextBox.Text = ''
+ $HelpForm.Controls.Add($HelpTextBox)
+
+ ## Save the initial state of the form
+ $InitialFormWindowState = $HelpForm.WindowState
+ ## Init the OnLoad event to correct the initial state of the form
+ $HelpForm.add_Load($OnLoadForm_StateCorrection)
+ ## Show the Form
+ $null = $HelpForm.ShowDialog()
+}
+
+##*===============================================
+##* END FUNCTION LISTINGS
+##*===============================================
+
+##*===============================================
+##* SCRIPT BODY
+##*===============================================
+
+Write-Log -Message "Load [$appDeployHelpScriptFriendlyName] console..." -Source $appDeployToolkitHelpName
+
+## Show the help console
+Show-HelpConsole
+
+Write-Log -Message "[$appDeployHelpScriptFriendlyName] console closed." -Source $appDeployToolkitHelpName
+
+##*===============================================
+##* END SCRIPT BODY
+##*===============================================
\ No newline at end of file
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitLogo.ico b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitLogo.ico
new file mode 100644
index 0000000..411f4ab
Binary files /dev/null and b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitLogo.ico differ
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitMain.cs b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitMain.cs
new file mode 100644
index 0000000..b1653b0
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitMain.cs
@@ -0,0 +1,775 @@
+// Date Modified: 01-08-2016
+// Version Number: 3.6.8
+
+using System;
+using System.Text;
+using System.Collections;
+using System.ComponentModel;
+using System.DirectoryServices;
+using System.Security.Principal;
+using System.Collections.Generic;
+using System.Runtime.InteropServices;
+using System.Text.RegularExpressions;
+using FILETIME = System.Runtime.InteropServices.ComTypes.FILETIME;
+
+namespace PSADT
+{
+ public class Msi
+ {
+ enum LoadLibraryFlags : int
+ {
+ DONT_RESOLVE_DLL_REFERENCES = 0x00000001,
+ LOAD_IGNORE_CODE_AUTHZ_LEVEL = 0x00000010,
+ LOAD_LIBRARY_AS_DATAFILE = 0x00000002,
+ LOAD_LIBRARY_AS_DATAFILE_EXCLUSIVE = 0x00000040,
+ LOAD_LIBRARY_AS_IMAGE_RESOURCE = 0x00000020,
+ LOAD_WITH_ALTERED_SEARCH_PATH = 0x00000008
+ }
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern IntPtr LoadLibraryEx(string lpFileName, IntPtr hFile, LoadLibraryFlags dwFlags);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern int LoadString(IntPtr hInstance, int uID, StringBuilder lpBuffer, int nBufferMax);
+
+ // Get MSI exit code message from msimsg.dll resource dll
+ public static string GetMessageFromMsiExitCode(int errCode)
+ {
+ IntPtr hModuleInstance = LoadLibraryEx("msimsg.dll", IntPtr.Zero, LoadLibraryFlags.LOAD_LIBRARY_AS_DATAFILE);
+
+ StringBuilder sb = new StringBuilder(255);
+ LoadString(hModuleInstance, errCode, sb, sb.Capacity + 1);
+
+ return sb.ToString();
+ }
+ }
+
+ public class Explorer
+ {
+ private static readonly IntPtr HWND_BROADCAST = new IntPtr(0xffff);
+ private const int WM_SETTINGCHANGE = 0x1a;
+ private const int SMTO_ABORTIFHUNG = 0x0002;
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern bool SendNotifyMessage(IntPtr hWnd, int Msg, IntPtr wParam, IntPtr lParam);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr SendMessageTimeout(IntPtr hWnd, int Msg, IntPtr wParam, string lParam, int fuFlags, int uTimeout, IntPtr lpdwResult);
+
+ [DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern int SHChangeNotify(int eventId, int flags, IntPtr item1, IntPtr item2);
+
+ public static void RefreshDesktopAndEnvironmentVariables()
+ {
+ // Update desktop icons
+ SHChangeNotify(0x8000000, 0x1000, IntPtr.Zero, IntPtr.Zero);
+ SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, IntPtr.Zero, null, SMTO_ABORTIFHUNG, 100, IntPtr.Zero);
+ // Update environment variables
+ SendMessageTimeout(HWND_BROADCAST, WM_SETTINGCHANGE, IntPtr.Zero, "Environment", SMTO_ABORTIFHUNG, 100, IntPtr.Zero);
+ }
+ }
+
+ public sealed class FileVerb
+ {
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int LoadString(IntPtr h, int id, StringBuilder sb, int maxBuffer);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr LoadLibrary(string s);
+
+ public static string GetPinVerb(int VerbId)
+ {
+ IntPtr hShell32 = LoadLibrary("shell32.dll");
+ const int nChars = 255;
+ StringBuilder Buff = new StringBuilder("", nChars);
+
+ LoadString(hShell32, VerbId, Buff, Buff.Capacity);
+ return Buff.ToString();
+ }
+ }
+
+ public sealed class IniFile
+ {
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetPrivateProfileString(string lpAppName, string lpKeyName, string lpDefault, StringBuilder lpReturnedString, int nSize, string lpFileName);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool WritePrivateProfileString(string lpAppName, string lpKeyName, StringBuilder lpString, string lpFileName);
+
+ public static string GetIniValue(string section, string key, string filepath)
+ {
+ string sDefault = "";
+ const int nChars = 1024;
+ StringBuilder Buff = new StringBuilder(nChars);
+
+ GetPrivateProfileString(section, key, sDefault, Buff, Buff.Capacity, filepath);
+ return Buff.ToString();
+ }
+
+ public static void SetIniValue(string section, string key, StringBuilder value, string filepath)
+ {
+ WritePrivateProfileString(section, key, value, filepath);
+ }
+ }
+
+ public class UiAutomation
+ {
+ public enum GetWindow_Cmd : int
+ {
+ GW_HWNDFIRST = 0,
+ GW_HWNDLAST = 1,
+ GW_HWNDNEXT = 2,
+ GW_HWNDPREV = 3,
+ GW_OWNER = 4,
+ GW_CHILD = 5,
+ GW_ENABLEDPOPUP = 6
+ }
+
+ public enum ShowWindowEnum
+ {
+ Hide = 0,
+ ShowNormal = 1,
+ ShowMinimized = 2,
+ ShowMaximized = 3,
+ Maximize = 3,
+ ShowNormalNoActivate = 4,
+ Show = 5,
+ Minimize = 6,
+ ShowMinNoActivate = 7,
+ ShowNoActivate = 8,
+ Restore = 9,
+ ShowDefault = 10,
+ ForceMinimized = 11
+ }
+
+ public enum UserNotificationState
+ {
+ // http://msdn.microsoft.com/en-us/library/bb762533(v=vs.85).aspx
+ ScreenSaverOrLockedOrFastUserSwitching =1, // A screen saver is displayed, the machine is locked, or a nonactive Fast User Switching session is in progress.
+ FullScreenOrPresentationModeOrLoginScreen =2, // A full-screen application is running or Presentation Settings are applied. Presentation Settings allow a user to put their machine into a state fit for an uninterrupted presentation, such as a set of PowerPoint slides, with a single click. Also returns this state if machine is at the login screen.
+ RunningDirect3DFullScreen =3, // A full-screen, exclusive mode, Direct3D application is running.
+ PresentationMode =4, // The user has activated Windows presentation settings to block notifications and pop-up messages.
+ AcceptsNotifications =5, // None of the other states are found, notifications can be freely sent.
+ QuietTime =6, // Introduced in Windows 7. The current user is in "quiet time", which is the first hour after a new user logs into his or her account for the first time.
+ WindowsStoreAppRunning =7 // Introduced in Windows 8. A Windows Store app is running.
+ }
+
+ // Only for Vista or above
+ [DllImport("shell32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ static extern int SHQueryUserNotificationState(out UserNotificationState pquns);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool EnumWindows(EnumWindowsProcD lpEnumFunc, ref IntPtr lParam);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowText(IntPtr hWnd, StringBuilder lpString, int nMaxCount);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowTextLength(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr GetDesktopWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ private static extern IntPtr GetShellWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool IsWindowEnabled(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool IsWindowVisible(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool IsIconic(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool ShowWindow(IntPtr hWnd, ShowWindowEnum flags);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr SetActiveWindow(IntPtr hwnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ [return: MarshalAs(UnmanagedType.Bool)]
+ public static extern bool SetForegroundWindow(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetForegroundWindow();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr SetFocus(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool BringWindowToTop(IntPtr hWnd);
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetWindowThreadProcessId(IntPtr hWnd, out int lpdwProcessId);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetCurrentThreadId();
+
+ [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool AttachThreadInput(int idAttach, int idAttachTo, bool fAttach);
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLong", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetWindowLong32(IntPtr hWnd, int nIndex);
+
+ [DllImport("user32.dll", EntryPoint = "GetWindowLongPtr", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr GetWindowLongPtr64(IntPtr hWnd, int nIndex);
+
+ public delegate bool EnumWindowsProcD(IntPtr hWnd, ref IntPtr lItems);
+
+ public static bool EnumWindowsProc(IntPtr hWnd, ref IntPtr lItems)
+ {
+ if (hWnd != IntPtr.Zero)
+ {
+ GCHandle hItems = GCHandle.FromIntPtr(lItems);
+ List items = hItems.Target as List;
+ items.Add(hWnd);
+ return true;
+ }
+ else
+ {
+ return false;
+ }
+ }
+
+ public static List EnumWindows()
+ {
+ try
+ {
+ List items = new List();
+ EnumWindowsProcD CallBackPtr = new EnumWindowsProcD(EnumWindowsProc);
+ GCHandle hItems = GCHandle.Alloc(items);
+ IntPtr lItems = GCHandle.ToIntPtr(hItems);
+ EnumWindows(CallBackPtr, ref lItems);
+ return items;
+ }
+ catch (Exception ex)
+ {
+ throw new Exception("An error occured during window enumeration: " + ex.Message);
+ }
+ }
+
+ public static string GetWindowText(IntPtr hWnd)
+ {
+ int iTextLength = GetWindowTextLength(hWnd);
+ if (iTextLength > 0)
+ {
+ StringBuilder sb = new StringBuilder(iTextLength);
+ GetWindowText(hWnd, sb, iTextLength + 1);
+ return sb.ToString();
+ }
+ else
+ {
+ return String.Empty;
+ }
+ }
+
+ public static bool BringWindowToFront(IntPtr windowHandle)
+ {
+ bool breturn = false;
+ if (IsIconic(windowHandle))
+ {
+ // Show minimized window because SetForegroundWindow does not work for minimized windows
+ ShowWindow(windowHandle, ShowWindowEnum.ShowMaximized);
+ }
+
+ int lpdwProcessId;
+ int windowThreadProcessId = GetWindowThreadProcessId(GetForegroundWindow(), out lpdwProcessId);
+ int currentThreadId = GetCurrentThreadId();
+ AttachThreadInput(windowThreadProcessId, currentThreadId, true);
+
+ BringWindowToTop(windowHandle);
+ breturn = SetForegroundWindow(windowHandle);
+ SetActiveWindow(windowHandle);
+ SetFocus(windowHandle);
+
+ AttachThreadInput(windowThreadProcessId, currentThreadId, false);
+ return breturn;
+ }
+
+ public static int GetWindowThreadProcessId(IntPtr windowHandle)
+ {
+ int processID = 0;
+ GetWindowThreadProcessId(windowHandle, out processID);
+ return processID;
+ }
+
+ public static IntPtr GetWindowLong(IntPtr hWnd, int nIndex)
+ {
+ if (IntPtr.Size == 4)
+ {
+ return GetWindowLong32(hWnd, nIndex);
+ }
+ return GetWindowLongPtr64(hWnd, nIndex);
+ }
+
+ public static string GetUserNotificationState()
+ {
+ // Only works for Windows Vista or higher
+ UserNotificationState state;
+ int returnVal = SHQueryUserNotificationState(out state);
+ return state.ToString();
+ }
+ }
+
+ public class QueryUser
+ {
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern IntPtr WTSOpenServer(string pServerName);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern void WTSCloseServer(IntPtr hServer);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Ansi, SetLastError = false)]
+ public static extern bool WTSQuerySessionInformation(IntPtr hServer, int sessionId, WTS_INFO_CLASS wtsInfoClass, out IntPtr pBuffer, out int pBytesReturned);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Ansi, SetLastError = false)]
+ public static extern int WTSEnumerateSessions(IntPtr hServer, int Reserved, int Version, out IntPtr pSessionInfo, out int pCount);
+
+ [DllImport("wtsapi32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern void WTSFreeMemory(IntPtr pMemory);
+
+ [DllImport("winsta.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int WinStationQueryInformation(IntPtr hServer, int sessionId, int information, ref WINSTATIONINFORMATIONW pBuffer, int bufferLength, ref int returnedLength);
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern int GetCurrentProcessId();
+
+ [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = false)]
+ public static extern bool ProcessIdToSessionId(int processId, ref int pSessionId);
+
+ public class TerminalSessionData
+ {
+ public int SessionId;
+ public string ConnectionState;
+ public string SessionName;
+ public bool IsUserSession;
+ public TerminalSessionData(int sessionId, string connState, string sessionName, bool isUserSession)
+ {
+ SessionId = sessionId;
+ ConnectionState = connState;
+ SessionName = sessionName;
+ IsUserSession = isUserSession;
+ }
+ }
+
+ public class TerminalSessionInfo
+ {
+ public string NTAccount;
+ public string SID;
+ public string UserName;
+ public string DomainName;
+ public int SessionId;
+ public string SessionName;
+ public string ConnectState;
+ public bool IsCurrentSession;
+ public bool IsConsoleSession;
+ public bool IsActiveUserSession;
+ public bool IsUserSession;
+ public bool IsRdpSession;
+ public bool IsLocalAdmin;
+ public DateTime? LogonTime;
+ public TimeSpan? IdleTime;
+ public DateTime? DisconnectTime;
+ public string ClientName;
+ public string ClientProtocolType;
+ public string ClientDirectory;
+ public int ClientBuildNumber;
+ }
+
+ [StructLayout(LayoutKind.Sequential)]
+ private struct WTS_SESSION_INFO
+ {
+ public Int32 SessionId;
+ [MarshalAs(UnmanagedType.LPStr)]
+ public string SessionName;
+ public WTS_CONNECTSTATE_CLASS State;
+ }
+
+ [StructLayout(LayoutKind.Sequential)]
+ public struct WINSTATIONINFORMATIONW
+ {
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 70)]
+ private byte[] Reserved1;
+ public int SessionId;
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 4)]
+ private byte[] Reserved2;
+ public FILETIME ConnectTime;
+ public FILETIME DisconnectTime;
+ public FILETIME LastInputTime;
+ public FILETIME LoginTime;
+ [MarshalAs(UnmanagedType.ByValArray, SizeConst = 1096)]
+ private byte[] Reserved3;
+ public FILETIME CurrentTime;
+ }
+
+ public enum WINSTATIONINFOCLASS
+ {
+ WinStationInformation = 8
+ }
+
+ public enum WTS_CONNECTSTATE_CLASS
+ {
+ Active,
+ Connected,
+ ConnectQuery,
+ Shadow,
+ Disconnected,
+ Idle,
+ Listen,
+ Reset,
+ Down,
+ Init
+ }
+
+ public enum WTS_INFO_CLASS
+ {
+ SessionId=4,
+ UserName,
+ SessionName,
+ DomainName,
+ ConnectState,
+ ClientBuildNumber,
+ ClientName,
+ ClientDirectory,
+ ClientProtocolType=16
+ }
+
+ private static IntPtr OpenServer(string Name)
+ {
+ IntPtr server = WTSOpenServer(Name);
+ return server;
+ }
+
+ private static void CloseServer(IntPtr ServerHandle)
+ {
+ WTSCloseServer(ServerHandle);
+ }
+
+ private static IList PtrToStructureList(IntPtr ppList, int count) where T : struct
+ {
+ List result = new List();
+ long pointer = ppList.ToInt64();
+ int sizeOf = Marshal.SizeOf(typeof(T));
+
+ for (int index = 0; index < count; index++)
+ {
+ T item = (T) Marshal.PtrToStructure(new IntPtr(pointer), typeof(T));
+ result.Add(item);
+ pointer += sizeOf;
+ }
+ return result;
+ }
+
+ public static DateTime? FileTimeToDateTime(FILETIME ft)
+ {
+ if (ft.dwHighDateTime == 0 && ft.dwLowDateTime == 0)
+ {
+ return null;
+ }
+ long hFT = (((long) ft.dwHighDateTime) << 32) + ft.dwLowDateTime;
+ return DateTime.FromFileTime(hFT);
+ }
+
+ public static WINSTATIONINFORMATIONW GetWinStationInformation(IntPtr server, int sessionId)
+ {
+ int retLen = 0;
+ WINSTATIONINFORMATIONW wsInfo = new WINSTATIONINFORMATIONW();
+ WinStationQueryInformation(server, sessionId, (int) WINSTATIONINFOCLASS.WinStationInformation, ref wsInfo, Marshal.SizeOf(typeof(WINSTATIONINFORMATIONW)), ref retLen);
+ return wsInfo;
+ }
+
+ public static TerminalSessionData[] ListSessions(string ServerName)
+ {
+ IntPtr server = IntPtr.Zero;
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+
+ List results = new List();
+
+ try
+ {
+ server = OpenServer(ServerName);
+ IntPtr ppSessionInfo = IntPtr.Zero;
+ int count;
+ bool _isUserSession = false;
+ IList sessionsInfo;
+
+ if (WTSEnumerateSessions(server, 0, 1, out ppSessionInfo, out count) == 0)
+ {
+ throw new Win32Exception();
+ }
+
+ try
+ {
+ sessionsInfo = PtrToStructureList(ppSessionInfo, count);
+ }
+ finally
+ {
+ WTSFreeMemory(ppSessionInfo);
+ }
+
+ foreach (WTS_SESSION_INFO sessionInfo in sessionsInfo)
+ {
+ if (sessionInfo.SessionName != "Services" && sessionInfo.SessionName != "RDP-Tcp")
+ {
+ _isUserSession = true;
+ }
+ results.Add(new TerminalSessionData(sessionInfo.SessionId, sessionInfo.State.ToString(), sessionInfo.SessionName, _isUserSession));
+ _isUserSession = false;
+ }
+ }
+ finally
+ {
+ CloseServer(server);
+ }
+
+ TerminalSessionData[] returnData = results.ToArray();
+ return returnData;
+ }
+
+ public static TerminalSessionInfo GetSessionInfo(string ServerName, int SessionId)
+ {
+ IntPtr server = IntPtr.Zero;
+ IntPtr buffer = IntPtr.Zero;
+ int bytesReturned;
+ TerminalSessionInfo data = new TerminalSessionInfo();
+ bool _IsCurrentSessionId = false;
+ bool _IsConsoleSession = false;
+ bool _IsUserSession = false;
+ int currentSessionID = 0;
+ string _NTAccount = String.Empty;
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+ if (ProcessIdToSessionId(GetCurrentProcessId(), ref currentSessionID) == false)
+ {
+ currentSessionID = -1;
+ }
+
+ // Get all members of the local administrators group
+ bool _IsLocalAdminCheckSuccess = false;
+ List localAdminGroupSidsList = new List();
+ try
+ {
+ DirectoryEntry localMachine = new DirectoryEntry("WinNT://" + ServerName + ",Computer");
+ string localAdminGroupName = new SecurityIdentifier("S-1-5-32-544").Translate(typeof(NTAccount)).Value.Split('\\')[1];
+ DirectoryEntry admGroup = localMachine.Children.Find(localAdminGroupName, "group");
+ object members = admGroup.Invoke("members", null);
+ foreach (object groupMember in (IEnumerable)members)
+ {
+ DirectoryEntry member = new DirectoryEntry(groupMember);
+ if (member.Name != String.Empty)
+ {
+ localAdminGroupSidsList.Add((new NTAccount(member.Name)).Translate(typeof(SecurityIdentifier)).Value);
+ }
+ }
+ _IsLocalAdminCheckSuccess = true;
+ }
+ catch { }
+
+ try
+ {
+ server = OpenServer(ServerName);
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientBuildNumber, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ int lData = Marshal.ReadInt32(buffer);
+ data.ClientBuildNumber = lData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientDirectory, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ string strData = Marshal.PtrToStringAnsi(buffer);
+ data.ClientDirectory = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.ClientName = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ClientProtocolType, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ Int16 intData = Marshal.ReadInt16(buffer);
+ if (intData == 2)
+ {
+ strData = "RDP";
+ data.IsRdpSession = true;
+ }
+ else
+ {
+ strData = "";
+ data.IsRdpSession = false;
+ }
+ data.ClientProtocolType = strData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.ConnectState, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ lData = Marshal.ReadInt32(buffer);
+ data.ConnectState = ((WTS_CONNECTSTATE_CLASS) lData).ToString();
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.SessionId, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ lData = Marshal.ReadInt32(buffer);
+ data.SessionId = lData;
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.DomainName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer).ToUpper();
+ data.DomainName = strData;
+ if (strData != String.Empty)
+ {
+ _NTAccount = strData;
+ }
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.UserName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.UserName = strData;
+ if (strData != String.Empty)
+ {
+ data.NTAccount = _NTAccount + "\\" + strData;
+ string _Sid = (new NTAccount(_NTAccount + "\\" + strData)).Translate(typeof(SecurityIdentifier)).Value;
+ data.SID = _Sid;
+ if (_IsLocalAdminCheckSuccess == true)
+ {
+ foreach (string localAdminGroupSid in localAdminGroupSidsList)
+ {
+ if (localAdminGroupSid == _Sid)
+ {
+ data.IsLocalAdmin = true;
+ break;
+ }
+ else
+ {
+ data.IsLocalAdmin = false;
+ }
+ }
+ }
+ }
+
+ if (WTSQuerySessionInformation(server, SessionId, WTS_INFO_CLASS.SessionName, out buffer, out bytesReturned) == false)
+ {
+ return data;
+ }
+ strData = Marshal.PtrToStringAnsi(buffer);
+ data.SessionName = strData;
+ if (strData != "Services" && strData != "RDP-Tcp" && data.UserName != String.Empty)
+ {
+ _IsUserSession = true;
+ }
+ data.IsUserSession = _IsUserSession;
+ if (strData == "Console")
+ {
+ _IsConsoleSession = true;
+ }
+ data.IsConsoleSession = _IsConsoleSession;
+
+ WINSTATIONINFORMATIONW wsInfo = GetWinStationInformation(server, SessionId);
+ DateTime? _loginTime = FileTimeToDateTime(wsInfo.LoginTime);
+ DateTime? _lastInputTime = FileTimeToDateTime(wsInfo.LastInputTime);
+ DateTime? _disconnectTime = FileTimeToDateTime(wsInfo.DisconnectTime);
+ DateTime? _currentTime = FileTimeToDateTime(wsInfo.CurrentTime);
+ TimeSpan? _idleTime = (_currentTime != null && _lastInputTime != null) ? _currentTime.Value - _lastInputTime.Value : TimeSpan.Zero;
+ data.LogonTime = _loginTime;
+ data.IdleTime = _idleTime;
+ data.DisconnectTime = _disconnectTime;
+
+ if (currentSessionID == SessionId)
+ {
+ _IsCurrentSessionId = true;
+ }
+ data.IsCurrentSession = _IsCurrentSessionId;
+ }
+ finally
+ {
+ WTSFreeMemory(buffer);
+ buffer = IntPtr.Zero;
+ CloseServer(server);
+ }
+ return data;
+ }
+
+ public static TerminalSessionInfo[] GetUserSessionInfo(string ServerName)
+ {
+ if (ServerName == "localhost" || ServerName == String.Empty)
+ {
+ ServerName = Environment.MachineName;
+ }
+
+ // Find and get detailed information for all user sessions
+ // Also determine the active user session. If a console user exists, then that will be the active user session.
+ // If no console user exists but users are logged in, such as on terminal servers, then select the first logged-in non-console user that is either 'Active' or 'Connected' as the active user.
+ TerminalSessionData[] sessions = ListSessions(ServerName);
+ TerminalSessionInfo sessionInfo = new TerminalSessionInfo();
+ List userSessionsInfo = new List();
+ string firstActiveUserNTAccount = String.Empty;
+ bool IsActiveUserSessionSet = false;
+ foreach (TerminalSessionData session in sessions)
+ {
+ if (session.IsUserSession == true)
+ {
+ sessionInfo = GetSessionInfo(ServerName, session.SessionId);
+ if (sessionInfo.IsUserSession == true)
+ {
+ if ((firstActiveUserNTAccount == String.Empty) && (sessionInfo.ConnectState == "Active" || sessionInfo.ConnectState == "Connected"))
+ {
+ firstActiveUserNTAccount = sessionInfo.NTAccount;
+ }
+
+ if (sessionInfo.IsConsoleSession == true)
+ {
+ sessionInfo.IsActiveUserSession = true;
+ IsActiveUserSessionSet = true;
+ }
+ else
+ {
+ sessionInfo.IsActiveUserSession = false;
+ }
+
+ userSessionsInfo.Add(sessionInfo);
+ }
+ }
+ }
+
+ TerminalSessionInfo[] userSessions = userSessionsInfo.ToArray();
+ if (IsActiveUserSessionSet == false)
+ {
+ foreach (TerminalSessionInfo userSession in userSessions)
+ {
+ if (userSession.NTAccount == firstActiveUserNTAccount)
+ {
+ userSession.IsActiveUserSession = true;
+ break;
+ }
+ }
+ }
+
+ return userSessions;
+ }
+ }
+}
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitMain.ps1 b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitMain.ps1
new file mode 100644
index 0000000..9687117
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/AppDeployToolkitMain.ps1
@@ -0,0 +1,10830 @@
+<#
+.SYNOPSIS
+ This script contains the functions and logic engine for the Deploy-Application.ps1 script.
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script can be called directly to dot-source the toolkit functions for testing, but it is usually called by the Deploy-Application.ps1 script.
+ The script can usually be updated to the latest version without impacting your per-application Deploy-Application scripts.
+ Please check release notes before upgrading.
+.PARAMETER CleanupBlockedApps
+ Clean up the blocked applications.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ShowBlockedAppDialog
+ Display a dialog box showing that the application execution is blocked.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredInstallName
+ Name of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredInstallTitle
+ Title of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER ReferredLogname
+ Logfile name of the referring application that invoked the script externally.
+ This parameter is passed to the script when it is called externally, e.g. from a scheduled task or asynchronously.
+.PARAMETER AsyncToolkitLaunch
+ This parameter is passed to the script when it is being called externally, e.g. from a scheduled task or asynchronously.
+.NOTES
+ The other parameters specified for this script that are not documented in this help section are for use only by functions in this script that call themselves by running this script again asynchronously.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+ ## Script Parameters: These parameters are passed to the script when it is called externally from a scheduled task or because of an Image File Execution Options registry setting
+ [switch]$ShowInstallationPrompt = $false,
+ [switch]$ShowInstallationRestartPrompt = $false,
+ [switch]$CleanupBlockedApps = $false,
+ [switch]$ShowBlockedAppDialog = $false,
+ [switch]$DisableLogging = $false,
+ [string]$ReferredInstallName = '',
+ [string]$ReferredInstallTitle = '',
+ [string]$ReferredLogName = '',
+ [string]$Message = '',
+ [string]$MessageAlignment = '',
+ [string]$ButtonRightText = '',
+ [string]$ButtonLeftText = '',
+ [string]$ButtonMiddleText = '',
+ [string]$Icon = '',
+ [string]$Timeout = '',
+ [switch]$ExitOnTimeout = $false,
+ [boolean]$MinimizeWindows = $false,
+ [switch]$PersistPrompt = $false,
+ [int32]$CountdownSeconds,
+ [int32]$CountdownNoHideSeconds,
+ [switch]$NoCountdown = $false,
+ [switch]$AsyncToolkitLaunch = $false
+)
+
+##*=============================================
+##* VARIABLE DECLARATION
+##*=============================================
+#region VariableDeclaration
+
+## Variables: Toolkit Name
+[string]$appDeployToolkitName = 'PSAppDeployToolkit'
+[string]$appDeployMainScriptFriendlyName = 'App Deploy Toolkit Main'
+
+## Variables: Script Info
+[version]$appDeployMainScriptVersion = [version]'3.7.0'
+[version]$appDeployMainScriptMinimumConfigVersion = [version]'3.6.9'
+[string]$appDeployMainScriptDate = '02/13/2018'
+[hashtable]$appDeployMainScriptParameters = $PSBoundParameters
+
+## Variables: Datetime and Culture
+[datetime]$currentDateTime = Get-Date
+[string]$currentTime = Get-Date -Date $currentDateTime -UFormat '%T'
+[string]$currentDate = Get-Date -Date $currentDateTime -UFormat '%d-%m-%Y'
+[timespan]$currentTimeZoneBias = [timezone]::CurrentTimeZone.GetUtcOffset([datetime]::Now)
+[Globalization.CultureInfo]$culture = Get-Culture
+[string]$currentLanguage = $culture.TwoLetterISOLanguageName.ToUpper()
+[Globalization.CultureInfo]$uiculture = Get-UICulture
+[string]$currentUILanguage = $uiculture.TwoLetterISOLanguageName.ToUpper()
+
+## Variables: Environment Variables
+[psobject]$envHost = $Host
+[psobject]$envShellFolders = Get-ItemProperty -Path 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\User Shell Folders' -ErrorAction 'SilentlyContinue'
+[string]$envAllUsersProfile = $env:ALLUSERSPROFILE
+[string]$envAppData = [Environment]::GetFolderPath('ApplicationData')
+[string]$envArchitecture = $env:PROCESSOR_ARCHITECTURE
+[string]$envCommonProgramFiles = [Environment]::GetFolderPath('CommonProgramFiles')
+[string]$envCommonProgramFilesX86 = ${env:CommonProgramFiles(x86)}
+[string]$envCommonDesktop = $envShellFolders | Select-Object -ExpandProperty 'Common Desktop' -ErrorAction 'SilentlyContinue'
+[string]$envCommonDocuments = $envShellFolders | Select-Object -ExpandProperty 'Common Documents' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartMenuPrograms = $envShellFolders | Select-Object -ExpandProperty 'Common Programs' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartMenu = $envShellFolders | Select-Object -ExpandProperty 'Common Start Menu' -ErrorAction 'SilentlyContinue'
+[string]$envCommonStartUp = $envShellFolders | Select-Object -ExpandProperty 'Common Startup' -ErrorAction 'SilentlyContinue'
+[string]$envCommonTemplates = $envShellFolders | Select-Object -ExpandProperty 'Common Templates' -ErrorAction 'SilentlyContinue'
+[string]$envComputerName = [Environment]::MachineName.ToUpper()
+[string]$envComputerNameFQDN = ([Net.Dns]::GetHostEntry('localhost')).HostName
+[string]$envHomeDrive = $env:HOMEDRIVE
+[string]$envHomePath = $env:HOMEPATH
+[string]$envHomeShare = $env:HOMESHARE
+[string]$envLocalAppData = [Environment]::GetFolderPath('LocalApplicationData')
+[string[]]$envLogicalDrives = [Environment]::GetLogicalDrives()
+[string]$envProgramFiles = [Environment]::GetFolderPath('ProgramFiles')
+[string]$envProgramFilesX86 = ${env:ProgramFiles(x86)}
+[string]$envProgramData = [Environment]::GetFolderPath('CommonApplicationData')
+[string]$envPublic = $env:PUBLIC
+[string]$envSystemDrive = $env:SYSTEMDRIVE
+[string]$envSystemRoot = $env:SYSTEMROOT
+[string]$envTemp = [IO.Path]::GetTempPath()
+[string]$envUserCookies = [Environment]::GetFolderPath('Cookies')
+[string]$envUserDesktop = [Environment]::GetFolderPath('DesktopDirectory')
+[string]$envUserFavorites = [Environment]::GetFolderPath('Favorites')
+[string]$envUserInternetCache = [Environment]::GetFolderPath('InternetCache')
+[string]$envUserInternetHistory = [Environment]::GetFolderPath('History')
+[string]$envUserMyDocuments = [Environment]::GetFolderPath('MyDocuments')
+[string]$envUserName = [Environment]::UserName
+[string]$envUserPictures = [Environment]::GetFolderPath('MyPictures')
+[string]$envUserProfile = $env:USERPROFILE
+[string]$envUserSendTo = [Environment]::GetFolderPath('SendTo')
+[string]$envUserStartMenu = [Environment]::GetFolderPath('StartMenu')
+[string]$envUserStartMenuPrograms = [Environment]::GetFolderPath('Programs')
+[string]$envUserStartUp = [Environment]::GetFolderPath('StartUp')
+[string]$envUserTemplates = [Environment]::GetFolderPath('Templates')
+[string]$envSystem32Directory = [Environment]::SystemDirectory
+[string]$envWinDir = $env:WINDIR
+# Handle X86 environment variables so they are never empty
+If (-not $envCommonProgramFilesX86) { [string]$envCommonProgramFilesX86 = $envCommonProgramFiles }
+If (-not $envProgramFilesX86) { [string]$envProgramFilesX86 = $envProgramFiles }
+
+## Variables: Domain Membership
+[boolean]$IsMachinePartOfDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').PartOfDomain
+[string]$envMachineWorkgroup = ''
+[string]$envMachineADDomain = ''
+[string]$envLogonServer = ''
+[string]$MachineDomainController = ''
+If ($IsMachinePartOfDomain) {
+ [string]$envMachineADDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').Domain | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+ Try {
+ [string]$envLogonServer = $env:LOGONSERVER | Where-Object { (($_) -and (-not $_.Contains('\\MicrosoftAccount'))) } | ForEach-Object { $_.TrimStart('\') } | ForEach-Object { ([Net.Dns]::GetHostEntry($_)).HostName }
+ # If running in system context, fall back on the logonserver value stored in the registry
+ If (-not $envLogonServer) { [string]$envLogonServer = Get-ItemProperty -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Group Policy\History' -ErrorAction 'SilentlyContinue' | Select-Object -ExpandProperty 'DCName' -ErrorAction 'SilentlyContinue' }
+ [string]$MachineDomainController = [DirectoryServices.ActiveDirectory.Domain]::GetCurrentDomain().FindDomainController().Name
+ }
+ Catch { }
+}
+Else {
+ [string]$envMachineWorkgroup = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'SilentlyContinue').Domain | Where-Object { $_ } | ForEach-Object { $_.ToUpper() }
+}
+[string]$envMachineDNSDomain = [Net.NetworkInformation.IPGlobalProperties]::GetIPGlobalProperties().DomainName | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+[string]$envUserDNSDomain = $env:USERDNSDOMAIN | Where-Object { $_ } | ForEach-Object { $_.ToLower() }
+Try {
+ [string]$envUserDomain = [Environment]::UserDomainName.ToUpper()
+}
+Catch { }
+
+## Variables: Operating System
+[psobject]$envOS = Get-WmiObject -Class 'Win32_OperatingSystem' -ErrorAction 'SilentlyContinue'
+[string]$envOSName = $envOS.Caption.Trim()
+[string]$envOSServicePack = $envOS.CSDVersion
+[version]$envOSVersion = $envOS.Version
+[string]$envOSVersionMajor = $envOSVersion.Major
+[string]$envOSVersionMinor = $envOSVersion.Minor
+[string]$envOSVersionBuild = $envOSVersion.Build
+If ($envOSVersionMajor -eq 10) {$envOSVersionRevision = (Get-ItemProperty -Path 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'UBR' -ErrorAction SilentlyContinue).UBR}
+Else { [string]$envOSVersionRevision = ,((Get-ItemProperty -Path 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name 'BuildLabEx' -ErrorAction 'SilentlyContinue').BuildLabEx -split '\.') | ForEach-Object { $_[1] } }
+If ($envOSVersionRevision -notmatch '^[\d\.]+$') { $envOSVersionRevision = '' }
+If ($envOSVersionRevision) { [string]$envOSVersion = "$($envOSVersion.ToString()).$envOSVersionRevision" } Else { "$($envOSVersion.ToString())" }
+# Get the operating system type
+[int32]$envOSProductType = $envOS.ProductType
+[boolean]$IsServerOS = [boolean]($envOSProductType -eq 3)
+[boolean]$IsDomainControllerOS = [boolean]($envOSProductType -eq 2)
+[boolean]$IsWorkStationOS = [boolean]($envOSProductType -eq 1)
+Switch ($envOSProductType) {
+ 3 { [string]$envOSProductTypeName = 'Server' }
+ 2 { [string]$envOSProductTypeName = 'Domain Controller' }
+ 1 { [string]$envOSProductTypeName = 'Workstation' }
+ Default { [string]$envOSProductTypeName = 'Unknown' }
+}
+# Get the OS Architecture
+[boolean]$Is64Bit = [boolean]((Get-WmiObject -Class 'Win32_Processor' -ErrorAction 'SilentlyContinue' | Where-Object { $_.DeviceID -eq 'CPU0' } | Select-Object -ExpandProperty 'AddressWidth') -eq 64)
+If ($Is64Bit) { [string]$envOSArchitecture = '64-bit' } Else { [string]$envOSArchitecture = '32-bit' }
+
+## Variables: Current Process Architecture
+[boolean]$Is64BitProcess = [boolean]([IntPtr]::Size -eq 8)
+If ($Is64BitProcess) { [string]$psArchitecture = 'x64' } Else { [string]$psArchitecture = 'x86' }
+
+## Variables: Hardware
+[int32]$envSystemRAM = Get-WMIObject -Class Win32_PhysicalMemory -ComputerName $env:COMPUTERNAME -ErrorAction 'SilentlyContinue' | Measure-Object -Property Capacity -Sum -ErrorAction SilentlyContinue | % {[Math]::Round(($_.sum / 1GB),2)}
+
+## Variables: PowerShell And CLR (.NET) Versions
+[hashtable]$envPSVersionTable = $PSVersionTable
+# PowerShell Version
+[version]$envPSVersion = $envPSVersionTable.PSVersion
+[string]$envPSVersionMajor = $envPSVersion.Major
+[string]$envPSVersionMinor = $envPSVersion.Minor
+[string]$envPSVersionBuild = $envPSVersion.Build
+[string]$envPSVersionRevision = $envPSVersion.Revision
+[string]$envPSVersion = $envPSVersion.ToString()
+# CLR (.NET) Version used by PowerShell
+[version]$envCLRVersion = $envPSVersionTable.CLRVersion
+[string]$envCLRVersionMajor = $envCLRVersion.Major
+[string]$envCLRVersionMinor = $envCLRVersion.Minor
+[string]$envCLRVersionBuild = $envCLRVersion.Build
+[string]$envCLRVersionRevision = $envCLRVersion.Revision
+[string]$envCLRVersion = $envCLRVersion.ToString()
+
+## Variables: Permissions/Accounts
+[Security.Principal.WindowsIdentity]$CurrentProcessToken = [Security.Principal.WindowsIdentity]::GetCurrent()
+[Security.Principal.SecurityIdentifier]$CurrentProcessSID = $CurrentProcessToken.User
+[string]$ProcessNTAccount = $CurrentProcessToken.Name
+[string]$ProcessNTAccountSID = $CurrentProcessSID.Value
+[boolean]$IsAdmin = [boolean]($CurrentProcessToken.Groups -contains [Security.Principal.SecurityIdentifier]'S-1-5-32-544')
+[boolean]$IsLocalSystemAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'LocalSystemSid')
+[boolean]$IsLocalServiceAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'LocalServiceSid')
+[boolean]$IsNetworkServiceAccount = $CurrentProcessSID.IsWellKnown([Security.Principal.WellKnownSidType]'NetworkServiceSid')
+[boolean]$IsServiceAccount = [boolean]($CurrentProcessToken.Groups -contains [Security.Principal.SecurityIdentifier]'S-1-5-6')
+[boolean]$IsProcessUserInteractive = [Environment]::UserInteractive
+[string]$LocalSystemNTAccount = (New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ([Security.Principal.WellKnownSidType]::'LocalSystemSid', $null)).Translate([Security.Principal.NTAccount]).Value
+# Check if script is running in session zero
+If ($IsLocalSystemAccount -or $IsLocalServiceAccount -or $IsNetworkServiceAccount -or $IsServiceAccount) { $SessionZero = $true } Else { $SessionZero = $false }
+
+## Variables: Script Name and Script Paths
+[string]$scriptPath = $MyInvocation.MyCommand.Definition
+[string]$scriptName = [IO.Path]::GetFileNameWithoutExtension($scriptPath)
+[string]$scriptFileName = Split-Path -Path $scriptPath -Leaf
+[string]$scriptRoot = Split-Path -Path $scriptPath -Parent
+[string]$invokingScript = (Get-Variable -Name 'MyInvocation').Value.ScriptName
+# Get the invoking script directory
+If ($invokingScript) {
+ # If this script was invoked by another script
+ [string]$scriptParentPath = Split-Path -Path $invokingScript -Parent
+}
+Else {
+ # If this script was not invoked by another script, fall back to the directory one level above this script
+ [string]$scriptParentPath = (Get-Item -LiteralPath $scriptRoot).Parent.FullName
+}
+
+## Variables: App Deploy Script Dependency Files
+[string]$appDeployLogoIcon = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitLogo.ico'
+[string]$appDeployLogoBanner = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitBanner.png'
+[string]$appDeployConfigFile = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitConfig.xml'
+[string]$appDeployCustomTypesSourceCode = Join-Path -Path $scriptRoot -ChildPath 'AppDeployToolkitMain.cs'
+# App Deploy Optional Extensions File
+[string]$appDeployToolkitDotSourceExtensions = 'AppDeployToolkitExtensions.ps1'
+# Check that dependency files are present
+If (-not (Test-Path -LiteralPath $appDeployLogoIcon -PathType 'Leaf')) { Throw 'App Deploy logo icon file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployLogoBanner -PathType 'Leaf')) { Throw 'App Deploy logo banner file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployConfigFile -PathType 'Leaf')) { Throw 'App Deploy XML configuration file not found.' }
+If (-not (Test-Path -LiteralPath $appDeployCustomTypesSourceCode -PathType 'Leaf')) { Throw 'App Deploy custom types source code file not found.' }
+
+## Import variables from XML configuration file
+[Xml.XmlDocument]$xmlConfigFile = Get-Content -LiteralPath $AppDeployConfigFile
+[Xml.XmlElement]$xmlConfig = $xmlConfigFile.AppDeployToolkit_Config
+# Get Config File Details
+[Xml.XmlElement]$configConfigDetails = $xmlConfig.Config_File
+[string]$configConfigVersion = [version]$configConfigDetails.Config_Version
+[string]$configConfigDate = $configConfigDetails.Config_Date
+# Get Toolkit Options
+[Xml.XmlElement]$xmlToolkitOptions = $xmlConfig.Toolkit_Options
+[boolean]$configToolkitRequireAdmin = [boolean]::Parse($xmlToolkitOptions.Toolkit_RequireAdmin)
+[string]$configToolkitTempPath = $ExecutionContext.InvokeCommand.ExpandString($xmlToolkitOptions.Toolkit_TempPath)
+[string]$configToolkitRegPath = $xmlToolkitOptions.Toolkit_RegPath
+[string]$configToolkitLogDir = $ExecutionContext.InvokeCommand.ExpandString($xmlToolkitOptions.Toolkit_LogPath)
+[boolean]$configToolkitCompressLogs = [boolean]::Parse($xmlToolkitOptions.Toolkit_CompressLogs)
+[string]$configToolkitLogStyle = $xmlToolkitOptions.Toolkit_LogStyle
+[double]$configToolkitLogMaxSize = $xmlToolkitOptions.Toolkit_LogMaxSize
+[boolean]$configToolkitLogWriteToHost = [boolean]::Parse($xmlToolkitOptions.Toolkit_LogWriteToHost)
+[boolean]$configToolkitLogDebugMessage = [boolean]::Parse($xmlToolkitOptions.Toolkit_LogDebugMessage)
+# Get MSI Options
+[Xml.XmlElement]$xmlConfigMSIOptions = $xmlConfig.MSI_Options
+[string]$configMSILoggingOptions = $xmlConfigMSIOptions.MSI_LoggingOptions
+[string]$configMSIInstallParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_InstallParams)
+[string]$configMSISilentParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_SilentParams)
+[string]$configMSIUninstallParams = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_UninstallParams)
+[string]$configMSILogDir = $ExecutionContext.InvokeCommand.ExpandString($xmlConfigMSIOptions.MSI_LogPath)
+[int32]$configMSIMutexWaitTime = $xmlConfigMSIOptions.MSI_MutexWaitTime
+# Get UI Options
+[Xml.XmlElement]$xmlConfigUIOptions = $xmlConfig.UI_Options
+[string]$configInstallationUILanguageOverride = $xmlConfigUIOptions.InstallationUI_LanguageOverride
+[boolean]$configShowBalloonNotifications = [boolean]::Parse($xmlConfigUIOptions.ShowBalloonNotifications)
+[int32]$configInstallationUITimeout = $xmlConfigUIOptions.InstallationUI_Timeout
+[int32]$configInstallationUIExitCode = $xmlConfigUIOptions.InstallationUI_ExitCode
+[int32]$configInstallationDeferExitCode = $xmlConfigUIOptions.InstallationDefer_ExitCode
+[int32]$configInstallationPersistInterval = $xmlConfigUIOptions.InstallationPrompt_PersistInterval
+[int32]$configInstallationRestartPersistInterval = $xmlConfigUIOptions.InstallationRestartPrompt_PersistInterval
+[int32]$configInstallationPromptToSave = $xmlConfigUIOptions.InstallationPromptToSave_Timeout
+[boolean]$configInstallationWelcomePromptDynamicRunningProcessEvaluation = [boolean]::Parse($xmlConfigUIOptions.InstallationWelcomePrompt_DynamicRunningProcessEvaluation)
+[int32]$configInstallationWelcomePromptDynamicRunningProcessEvaluationInterval = $xmlConfigUIOptions.InstallationWelcomePrompt_DynamicRunningProcessEvaluationInterval
+# Define ScriptBlock for Loading Message UI Language Options (default for English if no localization found)
+[scriptblock]$xmlLoadLocalizedUIMessages = {
+ # If a user is logged on, then get primary UI language for logged on user (even if running in session 0)
+ If ($RunAsActiveUser) {
+ # Read language defined by Group Policy
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKLM:SOFTWARE\Policies\Microsoft\MUI\Settings' -Value 'PreferredUILanguages'
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Software\Policies\Microsoft\Windows\Control Panel\Desktop' -Value 'PreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ # Read language for Win Vista & higher machines
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop' -Value 'PreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop\MuiCached' -Value 'MachinePreferredUILanguages' -SID $RunAsActiveUser.SID
+ }
+ If (-not $HKULanguages) {
+ [string[]]$HKULanguages = Get-RegistryKey -Key 'HKCU\Control Panel\International' -Value 'LocaleName' -SID $RunAsActiveUser.SID
+ }
+ # Read language for Win XP machines
+ If (-not $HKULanguages) {
+ [string]$HKULocale = Get-RegistryKey -Key 'HKCU\Control Panel\International' -Value 'Locale' -SID $RunAsActiveUser.SID
+ If ($HKULocale) {
+ [int32]$HKULocale = [Convert]::ToInt32('0x' + $HKULocale, 16)
+ [string[]]$HKULanguages = ([Globalization.CultureInfo]($HKULocale)).Name
+ }
+ }
+ If ($HKULanguages) {
+ [Globalization.CultureInfo]$PrimaryWindowsUILanguage = [Globalization.CultureInfo]($HKULanguages[0])
+ [string]$HKUPrimaryLanguageShort = $PrimaryWindowsUILanguage.TwoLetterISOLanguageName.ToUpper()
+
+ # If the detected language is Chinese, determine if it is simplified or traditional Chinese
+ If ($HKUPrimaryLanguageShort -eq 'ZH') {
+ If ($PrimaryWindowsUILanguage.EnglishName -match 'Simplified') {
+ [string]$HKUPrimaryLanguageShort = 'ZH-Hans'
+ }
+ If ($PrimaryWindowsUILanguage.EnglishName -match 'Traditional') {
+ [string]$HKUPrimaryLanguageShort = 'ZH-Hant'
+ }
+ }
+
+ # If the detected language is Portuguese, determine if it is Brazilian Portuguese
+ If ($HKUPrimaryLanguageShort -eq 'PT') {
+ If ($PrimaryWindowsUILanguage.ThreeLetterWindowsLanguageName -eq 'PTB') {
+ [string]$HKUPrimaryLanguageShort = 'PT-BR'
+ }
+ }
+ }
+ }
+
+ If ($HKUPrimaryLanguageShort) {
+ # Use the primary UI language of the logged in user
+ [string]$xmlUIMessageLanguage = "UI_Messages_$HKUPrimaryLanguageShort"
+ }
+ Else {
+ # Default to UI language of the account executing current process (even if it is the SYSTEM account)
+ [string]$xmlUIMessageLanguage = "UI_Messages_$currentLanguage"
+ }
+ # Default to English if the detected UI language is not available in the XMl config file
+ If (-not ($xmlConfig.$xmlUIMessageLanguage)) { [string]$xmlUIMessageLanguage = 'UI_Messages_EN' }
+ # Override the detected language if the override option was specified in the XML config file
+ If ($configInstallationUILanguageOverride) { [string]$xmlUIMessageLanguage = "UI_Messages_$configInstallationUILanguageOverride" }
+
+ [Xml.XmlElement]$xmlUIMessages = $xmlConfig.$xmlUIMessageLanguage
+ [string]$configDiskSpaceMessage = $xmlUIMessages.DiskSpace_Message
+ [string]$configBalloonTextStart = $xmlUIMessages.BalloonText_Start
+ [string]$configBalloonTextComplete = $xmlUIMessages.BalloonText_Complete
+ [string]$configBalloonTextRestartRequired = $xmlUIMessages.BalloonText_RestartRequired
+ [string]$configBalloonTextFastRetry = $xmlUIMessages.BalloonText_FastRetry
+ [string]$configBalloonTextError = $xmlUIMessages.BalloonText_Error
+ [string]$configProgressMessageInstall = $xmlUIMessages.Progress_MessageInstall
+ [string]$configProgressMessageUninstall = $xmlUIMessages.Progress_MessageUninstall
+ [string]$configClosePromptMessage = $xmlUIMessages.ClosePrompt_Message
+ [string]$configClosePromptButtonClose = $xmlUIMessages.ClosePrompt_ButtonClose
+ [string]$configClosePromptButtonDefer = $xmlUIMessages.ClosePrompt_ButtonDefer
+ [string]$configClosePromptButtonContinue = $xmlUIMessages.ClosePrompt_ButtonContinue
+ [string]$configClosePromptButtonContinueTooltip = $xmlUIMessages.ClosePrompt_ButtonContinueTooltip
+ [string]$configClosePromptCountdownMessage = $xmlUIMessages.ClosePrompt_CountdownMessage
+ [string]$configDeferPromptWelcomeMessage = $xmlUIMessages.DeferPrompt_WelcomeMessage
+ [string]$configDeferPromptExpiryMessage = $xmlUIMessages.DeferPrompt_ExpiryMessage
+ [string]$configDeferPromptWarningMessage = $xmlUIMessages.DeferPrompt_WarningMessage
+ [string]$configDeferPromptRemainingDeferrals = $xmlUIMessages.DeferPrompt_RemainingDeferrals
+ [string]$configDeferPromptDeadline = $xmlUIMessages.DeferPrompt_Deadline
+ [string]$configBlockExecutionMessage = $xmlUIMessages.BlockExecution_Message
+ [string]$configDeploymentTypeInstall = $xmlUIMessages.DeploymentType_Install
+ [string]$configDeploymentTypeUnInstall = $xmlUIMessages.DeploymentType_UnInstall
+ [string]$configRestartPromptTitle = $xmlUIMessages.RestartPrompt_Title
+ [string]$configRestartPromptMessage = $xmlUIMessages.RestartPrompt_Message
+ [string]$configRestartPromptMessageTime = $xmlUIMessages.RestartPrompt_MessageTime
+ [string]$configRestartPromptMessageRestart = $xmlUIMessages.RestartPrompt_MessageRestart
+ [string]$configRestartPromptTimeRemaining = $xmlUIMessages.RestartPrompt_TimeRemaining
+ [string]$configRestartPromptButtonRestartLater = $xmlUIMessages.RestartPrompt_ButtonRestartLater
+ [string]$configRestartPromptButtonRestartNow = $xmlUIMessages.RestartPrompt_ButtonRestartNow
+ [string]$configWelcomePromptCountdownMessage = $xmlUIMessages.WelcomePrompt_CountdownMessage
+ [string]$configWelcomePromptCustomMessage = $xmlUIMessages.WelcomePrompt_CustomMessage
+}
+
+## Variables: Script Directories
+[string]$dirFiles = Join-Path -Path $scriptParentPath -ChildPath 'Files'
+[string]$dirSupportFiles = Join-Path -Path $scriptParentPath -ChildPath 'SupportFiles'
+[string]$dirAppDeployTemp = Join-Path -Path $configToolkitTempPath -ChildPath $appDeployToolkitName
+
+## Set the deployment type to "Install" if it has not been specified
+If (-not $deploymentType) { [string]$deploymentType = 'Install' }
+
+## Variables: Executables
+[string]$exeWusa = 'wusa.exe' # Installs Standalone Windows Updates
+[string]$exeMsiexec = 'msiexec.exe' # Installs MSI Installers
+[string]$exeSchTasks = "$envWinDir\System32\schtasks.exe" # Manages Scheduled Tasks
+
+## Variables: RegEx Patterns
+[string]$MSIProductCodeRegExPattern = '^(\{{0,1}([0-9a-fA-F]){8}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){4}-([0-9a-fA-F]){12}\}{0,1})$'
+
+## Variables: Registry Keys
+# Registry keys for native and WOW64 applications
+[string[]]$regKeyApplications = 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall','HKLM:SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall'
+If ($is64Bit) {
+ [string]$regKeyLotusNotes = 'HKLM:SOFTWARE\Wow6432Node\Lotus\Notes'
+}
+Else {
+ [string]$regKeyLotusNotes = 'HKLM:SOFTWARE\Lotus\Notes'
+}
+[string]$regKeyAppExecution = 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options'
+
+## COM Objects: Initialize
+[__comobject]$Shell = New-Object -ComObject 'WScript.Shell' -ErrorAction 'SilentlyContinue'
+[__comobject]$ShellApp = New-Object -ComObject 'Shell.Application' -ErrorAction 'SilentlyContinue'
+
+## Variables: Reset/Remove Variables
+[boolean]$msiRebootDetected = $false
+[boolean]$BlockExecution = $false
+[boolean]$installationStarted = $false
+[boolean]$runningTaskSequence = $false
+If (Test-Path -LiteralPath 'variable:welcomeTimer') { Remove-Variable -Name 'welcomeTimer' -Scope 'Script'}
+# Reset the deferral history
+If (Test-Path -LiteralPath 'variable:deferHistory') { Remove-Variable -Name 'deferHistory' }
+If (Test-Path -LiteralPath 'variable:deferTimes') { Remove-Variable -Name 'deferTimes' }
+If (Test-Path -LiteralPath 'variable:deferDays') { Remove-Variable -Name 'deferDays' }
+
+## Variables: System DPI Scale Factor
+[scriptblock]$GetDisplayScaleFactor = {
+ # If a user is logged on, then get display scale factor for logged on user (even if running in session 0)
+ [boolean]$UserDisplayScaleFactor = $false
+ If ($RunAsActiveUser) {
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop\WindowMetrics' -Value 'AppliedDPI' -SID $RunAsActiveUser.SID
+ If (-not ([string]$dpiPixels)) {
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKCU\Control Panel\Desktop' -Value 'LogPixels' -SID $RunAsActiveUser.SID
+ }
+ [boolean]$UserDisplayScaleFactor = $true
+ }
+ If (-not ([string]$dpiPixels)) {
+ # This registry setting only exists if system scale factor has been changed at least once
+ [int32]$dpiPixels = Get-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows NT\CurrentVersion\FontDPI' -Value 'LogPixels'
+ [boolean]$UserDisplayScaleFactor = $false
+ }
+ Switch ($dpiPixels) {
+ 96 { [int32]$dpiScale = 100 }
+ 120 { [int32]$dpiScale = 125 }
+ 144 { [int32]$dpiScale = 150 }
+ 192 { [int32]$dpiScale = 200 }
+ Default { [int32]$dpiScale = 100 }
+ }
+}
+#endregion
+##*=============================================
+##* END VARIABLE DECLARATION
+##*=============================================
+
+##*=============================================
+##* FUNCTION LISTINGS
+##*=============================================
+#region FunctionListings
+
+#region Function Write-FunctionHeaderOrFooter
+Function Write-FunctionHeaderOrFooter {
+<#
+.SYNOPSIS
+ Write the function header or footer to the log upon first entering or exiting a function.
+.DESCRIPTION
+ Write the "Function Start" message, the bound parameters the function was invoked with, or the "Function End" message when entering or exiting a function.
+ Messages are debug messages so will only be logged if LogDebugMessage option is enabled in XML config file.
+.PARAMETER CmdletName
+ The name of the function this function is invoked from.
+.PARAMETER CmdletBoundParameters
+ The bound parameters of the function this function is invoked from.
+.PARAMETER Header
+ Write the function header.
+.PARAMETER Footer
+ Write the function footer.
+.EXAMPLE
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+.EXAMPLE
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$CmdletName,
+ [Parameter(Mandatory=$true,ParameterSetName='Header')]
+ [AllowEmptyCollection()]
+ [hashtable]$CmdletBoundParameters,
+ [Parameter(Mandatory=$true,ParameterSetName='Header')]
+ [switch]$Header,
+ [Parameter(Mandatory=$true,ParameterSetName='Footer')]
+ [switch]$Footer
+ )
+
+ If ($Header) {
+ Write-Log -Message 'Function Start' -Source ${CmdletName} -DebugMessage
+
+ ## Get the parameters that the calling function was invoked with
+ [string]$CmdletBoundParameters = $CmdletBoundParameters | Format-Table -Property @{ Label = 'Parameter'; Expression = { "[-$($_.Key)]" } }, @{ Label = 'Value'; Expression = { $_.Value }; Alignment = 'Left' }, @{ Label = 'Type'; Expression = { $_.Value.GetType().Name }; Alignment = 'Left' } -AutoSize -Wrap | Out-String
+ If ($CmdletBoundParameters) {
+ Write-Log -Message "Function invoked with bound parameter(s): `n$CmdletBoundParameters" -Source ${CmdletName} -DebugMessage
+ }
+ Else {
+ Write-Log -Message 'Function invoked without any bound parameters.' -Source ${CmdletName} -DebugMessage
+ }
+ }
+ ElseIf ($Footer) {
+ Write-Log -Message 'Function End' -Source ${CmdletName} -DebugMessage
+ }
+}
+#endregion
+#region Function Execute-MSP
+Function Execute-MSP {
+<#
+.SYNOPSIS
+ Reads SummaryInfo targeted product codes in MSP file and determines if the MSP file applies to any installed products
+ If a valid installed product is found, triggers the Execute-MSI function to patch the installation.
+.PARAMETER Path
+.EXAMPLE
+ Execute-MSP -Path 'Adobe_Reader_11.0.3_EN.msp'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,HelpMessage='Please enter the path to the MSP file')]
+ [ValidateScript({('.msp' -contains [IO.Path]::GetExtension($_))})]
+ [Alias('FilePath')]
+ [string]$Path
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If the MSP is in the Files directory, set the full path to the MSP
+ If (Test-Path -LiteralPath (Join-Path -Path $dirFiles -ChildPath $path -ErrorAction 'SilentlyContinue') -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ [string]$mspFile = Join-Path -Path $dirFiles -ChildPath $path
+ }
+ ElseIf (Test-Path -LiteralPath $Path -ErrorAction 'SilentlyContinue') {
+ [string]$mspFile = (Get-Item -LiteralPath $Path).FullName
+ }
+ Else {
+ Write-Log -Message "Failed to find MSP file [$path]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to find MSP file [$path]."
+ }
+ Continue
+ }
+ Write-Log -Message 'Checking MSP file for valid product codes' -Source ${CmdletName}
+
+ [boolean]$IsMSPNeeded = $false
+
+ $Installer = New-Object -com WindowsInstaller.Installer
+ $Database = $Installer.GetType().InvokeMember(“OpenDatabase”, “InvokeMethod”, $Null, $Installer, $($mspFile,([int32]32)))
+ [__comobject]$SummaryInformation = Get-ObjectProperty -InputObject $Database -PropertyName 'SummaryInformation'
+ [hashtable]$SummaryInfoProperty = @{}
+ $all = (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(7)).Split(";")
+ Foreach($FormattedProductCode in $all) {
+ [psobject]$MSIInstalled = Get-InstalledApplication -ProductCode $FormattedProductCode
+ If ($MSIInstalled) {[boolean]$IsMSPNeeded = $true }
+ }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SummaryInformation) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($DataBase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ If ($IsMSPNeeded) { Execute-MSI -Action Patch -Path $Path }
+ }
+}
+#endregion
+
+#region Function Write-Log
+Function Write-Log {
+<#
+.SYNOPSIS
+ Write messages to a log file in CMTrace.exe compatible format or Legacy text file format.
+.DESCRIPTION
+ Write messages to a log file in CMTrace.exe compatible format or Legacy text file format and optionally display in the console.
+.PARAMETER Message
+ The message to write to the log file or output to the console.
+.PARAMETER Severity
+ Defines message type. When writing to console or CMTrace.exe log format, it allows highlighting of message type.
+ Options: 1 = Information (default), 2 = Warning (highlighted in yellow), 3 = Error (highlighted in red)
+.PARAMETER Source
+ The source of the message being logged.
+.PARAMETER ScriptSection
+ The heading for the portion of the script that is being executed. Default is: $script:installPhase.
+.PARAMETER LogType
+ Choose whether to write a CMTrace.exe compatible log file or a Legacy text log file.
+.PARAMETER LogFileDirectory
+ Set the directory where the log file will be saved.
+.PARAMETER LogFileName
+ Set the name of the log file.
+.PARAMETER MaxLogFileSizeMB
+ Maximum file size limit for log file in megabytes (MB). Default is 10 MB.
+.PARAMETER WriteHost
+ Write the log message to the console.
+.PARAMETER ContinueOnError
+ Suppress writing log message to console on failure to write message to log file. Default is: $true.
+.PARAMETER PassThru
+ Return the message that was passed to the function
+.PARAMETER DebugMessage
+ Specifies that the message is a debug message. Debug messages only get logged if -LogDebugMessage is set to $true.
+.PARAMETER LogDebugMessage
+ Debug messages only get logged if this parameter is set to $true in the config XML file.
+.EXAMPLE
+ Write-Log -Message "Installing patch MS15-031" -Source 'Add-Patch' -LogType 'CMTrace'
+.EXAMPLE
+ Write-Log -Message "Script is running on Windows 8" -Source 'Test-ValidOS' -LogType 'Legacy'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [AllowEmptyCollection()]
+ [Alias('Text')]
+ [string[]]$Message,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateRange(1,3)]
+ [int16]$Severity = 1,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNull()]
+ [string]$Source = '',
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [string]$ScriptSection = $script:installPhase,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateSet('CMTrace','Legacy')]
+ [string]$LogType = $configToolkitLogStyle,
+ [Parameter(Mandatory=$false,Position=5)]
+ [ValidateNotNullorEmpty()]
+ [string]$LogFileDirectory = $(If ($configToolkitCompressLogs) { $logTempFolder } Else { $configToolkitLogDir }),
+ [Parameter(Mandatory=$false,Position=6)]
+ [ValidateNotNullorEmpty()]
+ [string]$LogFileName = $logName,
+ [Parameter(Mandatory=$false,Position=7)]
+ [ValidateNotNullorEmpty()]
+ [decimal]$MaxLogFileSizeMB = $configToolkitLogMaxSize,
+ [Parameter(Mandatory=$false,Position=8)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$WriteHost = $configToolkitLogWriteToHost,
+ [Parameter(Mandatory=$false,Position=9)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [Parameter(Mandatory=$false,Position=10)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false,Position=11)]
+ [switch]$DebugMessage = $false,
+ [Parameter(Mandatory=$false,Position=12)]
+ [boolean]$LogDebugMessage = $configToolkitLogDebugMessage
+ )
+
+ Begin {
+ ## Get the name of this function
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ ## Logging Variables
+ # Log file date/time
+ [string]$LogTime = (Get-Date -Format 'HH:mm:ss.fff').ToString()
+ [string]$LogDate = (Get-Date -Format 'MM-dd-yyyy').ToString()
+ If (-not (Test-Path -LiteralPath 'variable:LogTimeZoneBias')) { [int32]$script:LogTimeZoneBias = [timezone]::CurrentTimeZone.GetUtcOffset([datetime]::Now).TotalMinutes }
+ [string]$LogTimePlusBias = $LogTime + $script:LogTimeZoneBias
+ # Initialize variables
+ [boolean]$ExitLoggingFunction = $false
+ If (-not (Test-Path -LiteralPath 'variable:DisableLogging')) { $DisableLogging = $false }
+ # Check if the script section is defined
+ [boolean]$ScriptSectionDefined = [boolean](-not [string]::IsNullOrEmpty($ScriptSection))
+ # Get the file name of the source script
+ Try {
+ If ($script:MyInvocation.Value.ScriptName) {
+ [string]$ScriptSource = Split-Path -Path $script:MyInvocation.Value.ScriptName -Leaf -ErrorAction 'Stop'
+ }
+ Else {
+ [string]$ScriptSource = Split-Path -Path $script:MyInvocation.MyCommand.Definition -Leaf -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ $ScriptSource = ''
+ }
+
+ ## Create script block for generating CMTrace.exe compatible log entry
+ [scriptblock]$CMTraceLogString = {
+ Param (
+ [string]$lMessage,
+ [string]$lSource,
+ [int16]$lSeverity
+ )
+ "" + ""
+ }
+
+ ## Create script block for writing log entry to the console
+ [scriptblock]$WriteLogLineToHost = {
+ Param (
+ [string]$lTextLogLine,
+ [int16]$lSeverity
+ )
+ If ($WriteHost) {
+ # Only output using color options if running in a host which supports colors.
+ If ($Host.UI.RawUI.ForegroundColor) {
+ Switch ($lSeverity) {
+ 3 { Write-Host -Object $lTextLogLine -ForegroundColor 'Red' -BackgroundColor 'Black' }
+ 2 { Write-Host -Object $lTextLogLine -ForegroundColor 'Yellow' -BackgroundColor 'Black' }
+ 1 { Write-Host -Object $lTextLogLine }
+ }
+ }
+ # If executing "powershell.exe -File .ps1 > log.txt", then all the Write-Host calls are converted to Write-Output calls so that they are included in the text log.
+ Else {
+ Write-Output -InputObject $lTextLogLine
+ }
+ }
+ }
+
+ ## Exit function if it is a debug message and logging debug messages is not enabled in the config XML file
+ If (($DebugMessage) -and (-not $LogDebugMessage)) { [boolean]$ExitLoggingFunction = $true; Return }
+ ## Exit function if logging to file is disabled and logging to console host is disabled
+ If (($DisableLogging) -and (-not $WriteHost)) { [boolean]$ExitLoggingFunction = $true; Return }
+ ## Exit Begin block if logging is disabled
+ If ($DisableLogging) { Return }
+ ## Exit function function if it is an [Initialization] message and the toolkit has been relaunched
+ If (($AsyncToolkitLaunch) -and ($ScriptSection -eq 'Initialization')) { [boolean]$ExitLoggingFunction = $true; Return }
+
+ ## Create the directory where the log file will be saved
+ If (-not (Test-Path -LiteralPath $LogFileDirectory -PathType 'Container')) {
+ Try {
+ $null = New-Item -Path $LogFileDirectory -Type 'Directory' -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ [boolean]$ExitLoggingFunction = $true
+ # If error creating directory, write message to console
+ If (-not $ContinueOnError) {
+ Write-Host -Object "[$LogDate $LogTime] [${CmdletName}] $ScriptSection :: Failed to create the log directory [$LogFileDirectory]. `n$(Resolve-Error)" -ForegroundColor 'Red'
+ }
+ Return
+ }
+ }
+
+ ## Assemble the fully qualified path to the log file
+ [string]$LogFilePath = Join-Path -Path $LogFileDirectory -ChildPath $LogFileName
+ }
+ Process {
+ ## Exit function if logging is disabled
+ If ($ExitLoggingFunction) { Return }
+
+ ForEach ($Msg in $Message) {
+ ## If the message is not $null or empty, create the log entry for the different logging methods
+ [string]$CMTraceMsg = ''
+ [string]$ConsoleLogLine = ''
+ [string]$LegacyTextLogLine = ''
+ If ($Msg) {
+ # Create the CMTrace log message
+ If ($ScriptSectionDefined) { [string]$CMTraceMsg = "[$ScriptSection] :: $Msg" }
+
+ # Create a Console and Legacy "text" log entry
+ [string]$LegacyMsg = "[$LogDate $LogTime]"
+ If ($ScriptSectionDefined) { [string]$LegacyMsg += " [$ScriptSection]" }
+ If ($Source) {
+ [string]$ConsoleLogLine = "$LegacyMsg [$Source] :: $Msg"
+ Switch ($Severity) {
+ 3 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Error] :: $Msg" }
+ 2 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Warning] :: $Msg" }
+ 1 { [string]$LegacyTextLogLine = "$LegacyMsg [$Source] [Info] :: $Msg" }
+ }
+ }
+ Else {
+ [string]$ConsoleLogLine = "$LegacyMsg :: $Msg"
+ Switch ($Severity) {
+ 3 { [string]$LegacyTextLogLine = "$LegacyMsg [Error] :: $Msg" }
+ 2 { [string]$LegacyTextLogLine = "$LegacyMsg [Warning] :: $Msg" }
+ 1 { [string]$LegacyTextLogLine = "$LegacyMsg [Info] :: $Msg" }
+ }
+ }
+ }
+
+ ## Execute script block to create the CMTrace.exe compatible log entry
+ [string]$CMTraceLogLine = & $CMTraceLogString -lMessage $CMTraceMsg -lSource $Source -lSeverity $Severity
+
+ ## Choose which log type to write to file
+ If ($LogType -ieq 'CMTrace') {
+ [string]$LogLine = $CMTraceLogLine
+ }
+ Else {
+ [string]$LogLine = $LegacyTextLogLine
+ }
+
+ ## Write the log entry to the log file if logging is not currently disabled
+ If (-not $DisableLogging) {
+ Try {
+ $LogLine | Out-File -FilePath $LogFilePath -Append -NoClobber -Force -Encoding 'UTF8' -ErrorAction 'Stop'
+ }
+ Catch {
+ If (-not $ContinueOnError) {
+ Write-Host -Object "[$LogDate $LogTime] [$ScriptSection] [${CmdletName}] :: Failed to write message [$Msg] to the log file [$LogFilePath]. `n$(Resolve-Error)" -ForegroundColor 'Red'
+ }
+ }
+ }
+
+ ## Execute script block to write the log entry to the console if $WriteHost is $true
+ & $WriteLogLineToHost -lTextLogLine $ConsoleLogLine -lSeverity $Severity
+ }
+ }
+ End {
+ ## Archive log file if size is greater than $MaxLogFileSizeMB and $MaxLogFileSizeMB > 0
+ Try {
+ If ((-not $ExitLoggingFunction) -and (-not $DisableLogging)) {
+ [IO.FileInfo]$LogFile = Get-ChildItem -LiteralPath $LogFilePath -ErrorAction 'Stop'
+ [decimal]$LogFileSizeMB = $LogFile.Length/1MB
+ If (($LogFileSizeMB -gt $MaxLogFileSizeMB) -and ($MaxLogFileSizeMB -gt 0)) {
+ ## Change the file extension to "lo_"
+ [string]$ArchivedOutLogFile = [IO.Path]::ChangeExtension($LogFilePath, 'lo_')
+ [hashtable]$ArchiveLogParams = @{ ScriptSection = $ScriptSection; Source = ${CmdletName}; Severity = 2; LogFileDirectory = $LogFileDirectory; LogFileName = $LogFileName; LogType = $LogType; MaxLogFileSizeMB = 0; WriteHost = $WriteHost; ContinueOnError = $ContinueOnError; PassThru = $false }
+
+ ## Log message about archiving the log file
+ $ArchiveLogMessage = "Maximum log file size [$MaxLogFileSizeMB MB] reached. Rename log file to [$ArchivedOutLogFile]."
+ Write-Log -Message $ArchiveLogMessage @ArchiveLogParams
+
+ ## Archive existing log file from .log to .lo_. Overwrites any existing .lo_ file. This is the same method SCCM uses for log files.
+ Move-Item -LiteralPath $LogFilePath -Destination $ArchivedOutLogFile -Force -ErrorAction 'Stop'
+
+ ## Start new log file and Log message about archiving the old log file
+ $NewLogMessage = "Previous log file was renamed to [$ArchivedOutLogFile] because maximum log file size of [$MaxLogFileSizeMB MB] was reached."
+ Write-Log -Message $NewLogMessage @ArchiveLogParams
+ }
+ }
+ }
+ Catch {
+ ## If renaming of file fails, script will continue writing to log file even if size goes over the max file size
+ }
+ Finally {
+ If ($PassThru) { Write-Output -InputObject $Message }
+ }
+ }
+}
+#endregion
+
+
+#region Function New-ZipFile
+Function New-ZipFile {
+<#
+.SYNOPSIS
+ Create a new zip archive or add content to an existing archive.
+.DESCRIPTION
+ Create a new zip archive or add content to an existing archive by using the Shell object .CopyHere method.
+.PARAMETER DestinationArchiveDirectoryPath
+ The path to the directory path where the zip archive will be saved.
+.PARAMETER DestinationArchiveFileName
+ The name of the zip archive.
+.PARAMETER SourceDirectoryPath
+ The path to the directory to be archived, specified as absolute paths.
+.PARAMETER SourceFilePath
+ The path to the file to be archived, specified as absolute paths.
+.PARAMETER RemoveSourceAfterArchiving
+ Remove the source path after successfully archiving the content. Default is: $false.
+.PARAMETER OverWriteArchive
+ Overwrite the destination archive path if it already exists. Default is: $false.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $true.
+.EXAMPLE
+ New-ZipFile -DestinationArchiveDirectoryPath 'E:\Testing' -DestinationArchiveFileName 'TestingLogs.zip' -SourceDirectory 'E:\Testing\Logs'
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='CreateFromDirectory')]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullorEmpty()]
+ [string]$DestinationArchiveDirectoryPath,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$DestinationArchiveFileName,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='CreateFromDirectory')]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Container' })]
+ [string[]]$SourceDirectoryPath,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='CreateFromFile')]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string[]]$SourceFilePath,
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [switch]$RemoveSourceAfterArchiving = $false,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [switch]$OverWriteArchive = $false,
+ [Parameter(Mandatory=$false,Position=5)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Get the full destination path where the archive will be stored
+ [string]$DestinationPath = Join-Path -Path $DestinationArchiveDirectoryPath -ChildPath $DestinationArchiveFileName -ErrorAction 'Stop'
+ Write-Log -Message "Create a zip archive with the requested content at destination path [$DestinationPath]." -Source ${CmdletName}
+
+ ## If the destination archive already exists, delete it if the -OverWriteArchive option was selected
+ If (($OverWriteArchive) -and (Test-Path -LiteralPath $DestinationPath)) {
+ Write-Log -Message "An archive at the destination path already exists, deleting file [$DestinationPath]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $DestinationPath -Force -ErrorAction 'Stop'
+ }
+
+ ## If archive file does not exist, then create a zero-byte zip archive
+ If (-not (Test-Path -LiteralPath $DestinationPath)) {
+ ## Create a zero-byte file
+ Write-Log -Message "Create a zero-byte file [$DestinationPath]." -Source ${CmdletName}
+ $null = New-Item -Path $DestinationArchiveDirectoryPath -Name $DestinationArchiveFileName -ItemType 'File' -Force -ErrorAction 'Stop'
+
+ ## Write the file header for a zip file to the zero-byte file
+ [byte[]]$ZipArchiveByteHeader = 80, 75, 5, 6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
+ [IO.FileStream]$FileStream = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($DestinationPath, ([IO.FileMode]::Create))
+ [IO.BinaryWriter]$BinaryWriter = New-Object -TypeName 'System.IO.BinaryWriter' -ArgumentList ($FileStream)
+ Write-Log -Message "Write the file header for a zip archive to the zero-byte file [$DestinationPath]." -Source ${CmdletName}
+ $null = $BinaryWriter.Write($ZipArchiveByteHeader)
+ $BinaryWriter.Close()
+ $FileStream.Close()
+ }
+
+ ## Create a Shell object
+ [__comobject]$ShellApp = New-Object -ComObject 'Shell.Application' -ErrorAction 'Stop'
+ ## Create an object representing the archive file
+ [__comobject]$Archive = $ShellApp.NameSpace($DestinationPath)
+
+ ## Create the archive file
+ If ($PSCmdlet.ParameterSetName -eq 'CreateFromDirectory') {
+ ## Create the archive file from a source directory
+ ForEach ($Directory in $SourceDirectoryPath) {
+ Try {
+ # Create an object representing the source directory
+ [__comobject]$CreateFromDirectory = $ShellApp.NameSpace($Directory)
+ # Copy all of the files and folders from the source directory to the archive
+ $null = $Archive.CopyHere($CreateFromDirectory.Items())
+ # Wait for archive operation to complete. Archive file count property returns 0 if archive operation is in progress.
+ Write-Log -Message "Compressing [$($CreateFromDirectory.Count)] file(s) in source directory [$Directory] to destination path [$DestinationPath]..." -Source ${CmdletName}
+ Do { Start-Sleep -Milliseconds 250 } While ($Archive.Items().Count -eq 0)
+ }
+ Finally {
+ # Release the ComObject representing the source directory
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($CreateFromDirectory)
+ }
+
+ # If option was selected, recursively delete the source directory after successfully archiving the contents
+ If ($RemoveSourceAfterArchiving) {
+ Try {
+ Write-Log -Message "Recursively delete the source directory [$Directory] as contents have been successfully archived." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Directory -Recurse -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to recursively delete the source directory [$Directory]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Else {
+ ## Create the archive file from a list of one or more files
+ [IO.FileInfo[]]$SourceFilePath = [IO.FileInfo[]]$SourceFilePath
+ ForEach ($File in $SourceFilePath) {
+ # Copy the files and folders from the source directory to the archive
+ $null = $Archive.CopyHere($File.FullName)
+ # Wait for archive operation to complete. Archive file count property returns 0 if archive operation is in progress.
+ Write-Log -Message "Compressing file [$($File.FullName)] to destination path [$DestinationPath]..." -Source ${CmdletName}
+ Do { Start-Sleep -Milliseconds 250 } While ($Archive.Items().Count -eq 0)
+
+ # If option was selected, delete the source file after successfully archiving the content
+ If ($RemoveSourceAfterArchiving) {
+ Try {
+ Write-Log -Message "Delete the source file [$($File.FullName)] as it has been successfully archived." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $File.FullName -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to delete the source file [$($File.FullName)]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+
+ ## If the archive was created in session 0 or by an Admin, then it may only be readable by elevated users.
+ # Apply the parent folder's permissions to the archive file to fix the problem.
+ Write-Log -Message "If the archive was created in session 0 or by an Admin, then it may only be readable by elevated users. Apply permissions from parent folder [$DestinationArchiveDirectoryPath] to file [$DestinationPath]." -Source ${CmdletName}
+ Try {
+ [Security.AccessControl.DirectorySecurity]$DestinationArchiveDirectoryPathAcl = Get-Acl -Path $DestinationArchiveDirectoryPath -ErrorAction 'Stop'
+ Set-Acl -Path $DestinationPath -AclObject $DestinationArchiveDirectoryPathAcl -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to apply parent folder's [$DestinationArchiveDirectoryPath] permissions to file [$DestinationPath]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to archive the requested file(s). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to archive the requested file(s): $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ ## Release the ComObject representing the archive
+ If ($Archive) { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Archive) }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Exit-Script
+Function Exit-Script {
+<#
+.SYNOPSIS
+ Exit the script, perform cleanup actions, and pass an exit code to the parent process.
+.DESCRIPTION
+ Always use when exiting the script to ensure cleanup actions are performed.
+.PARAMETER ExitCode
+ The exit code to be passed from the script to the parent process, e.g. SCCM
+.EXAMPLE
+ Exit-Script -ExitCode 0
+.EXAMPLE
+ Exit-Script -ExitCode 1618
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ExitCode = 0
+ )
+
+ ## Get the name of this function
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ ## Stop the Close Program Dialog if running
+ If ($formCloseApps) { $formCloseApps.Close }
+
+ ## Close the Installation Progress Dialog if running
+ Close-InstallationProgress
+
+ ## If block execution variable is true, call the function to unblock execution
+ If ($BlockExecution) { Unblock-AppExecution }
+
+ ## If Terminal Server mode was set, turn it off
+ If ($terminalServerMode) { Disable-TerminalServerInstallMode }
+
+ ## Determine action based on exit code
+ Switch ($exitCode) {
+ $configInstallationUIExitCode { $installSuccess = $false }
+ $configInstallationDeferExitCode { $installSuccess = $false }
+ 3010 { $installSuccess = $true }
+ 1641 { $installSuccess = $true }
+ 0 { $installSuccess = $true }
+ Default { $installSuccess = $false }
+ }
+
+ ## Determine if balloon notification should be shown
+ If ($deployModeSilent) { [boolean]$configShowBalloonNotifications = $false }
+
+ If ($installSuccess) {
+ If (Test-Path -LiteralPath $regKeyDeferHistory -ErrorAction 'SilentlyContinue') {
+ Write-Log -Message 'Remove deferral history...' -Source ${CmdletName}
+ Remove-RegistryKey -Key $regKeyDeferHistory -Recurse
+ }
+
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextComplete"
+ ## Handle reboot prompts on successful script completion
+ If (($AllowRebootPassThru) -and ((($msiRebootDetected) -or ($exitCode -eq 3010)) -or ($exitCode -eq 1641))) {
+ Write-Log -Message 'A restart has been flagged as required.' -Source ${CmdletName}
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextRestartRequired"
+ If (($msiRebootDetected) -and ($exitCode -ne 1641)) { [int32]$exitCode = 3010 }
+ }
+ Else {
+ [int32]$exitCode = 0
+ }
+
+ Write-Log -Message "$installName $deploymentTypeName completed with exit code [$exitcode]." -Source ${CmdletName}
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText $balloonText }
+ }
+ ElseIf (-not $installSuccess) {
+ Write-Log -Message "$installName $deploymentTypeName completed with exit code [$exitcode]." -Source ${CmdletName}
+ If (($exitCode -eq $configInstallationUIExitCode) -or ($exitCode -eq $configInstallationDeferExitCode)) {
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextFastRetry"
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Warning' -BalloonTipText $balloonText }
+ }
+ Else {
+ [string]$balloonText = "$deploymentTypeName $configBalloonTextError"
+ If ($configShowBalloonNotifications) { Show-BalloonTip -BalloonTipIcon 'Error' -BalloonTipText $balloonText }
+ }
+ }
+
+ [string]$LogDash = '-' * 79
+ Write-Log -Message $LogDash -Source ${CmdletName}
+
+ ## Archive the log files to zip format and then delete the temporary logs folder
+ If ($configToolkitCompressLogs) {
+ ## Disable logging to file so that we can archive the log files
+ . $DisableScriptLogging
+
+ [string]$DestinationArchiveFileName = $installName + '_' + $deploymentType + '_' + ((Get-Date -Format 'yyyy-MM-dd-hh-mm-ss').ToString()) + '.zip'
+ New-ZipFile -DestinationArchiveDirectoryPath $configToolkitLogDir -DestinationArchiveFileName $DestinationArchiveFileName -SourceDirectory $logTempFolder -RemoveSourceAfterArchiving
+ }
+
+ If ($script:notifyIcon) { Try { $script:notifyIcon.Dispose() } Catch {} }
+ ## Exit the script, returning the exit code to SCCM
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $script:ExitCode = $exitCode; Exit } Else { Exit $exitCode }
+}
+#endregion
+
+
+#region Function Resolve-Error
+Function Resolve-Error {
+<#
+.SYNOPSIS
+ Enumerate error record details.
+.DESCRIPTION
+ Enumerate an error record, or a collection of error record, properties. By default, the details for the last error will be enumerated.
+.PARAMETER ErrorRecord
+ The error record to resolve. The default error record is the latest one: $global:Error[0]. This parameter will also accept an array of error records.
+.PARAMETER Property
+ The list of properties to display from the error record. Use "*" to display all properties.
+ Default list of error properties is: Message, FullyQualifiedErrorId, ScriptStackTrace, PositionMessage, InnerException
+.PARAMETER GetErrorRecord
+ Get error record details as represented by $_.
+.PARAMETER GetErrorInvocation
+ Get error record invocation information as represented by $_.InvocationInfo.
+.PARAMETER GetErrorException
+ Get error record exception details as represented by $_.Exception.
+.PARAMETER GetErrorInnerException
+ Get error record inner exception details as represented by $_.Exception.InnerException. Will retrieve all inner exceptions if there is more than one.
+.EXAMPLE
+ Resolve-Error
+.EXAMPLE
+ Resolve-Error -Property *
+.EXAMPLE
+ Resolve-Error -Property InnerException
+.EXAMPLE
+ Resolve-Error -GetErrorInvocation:$false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [AllowEmptyCollection()]
+ [array]$ErrorRecord,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Property = ('Message','InnerException','FullyQualifiedErrorId','ScriptStackTrace','PositionMessage'),
+ [Parameter(Mandatory=$false,Position=2)]
+ [switch]$GetErrorRecord = $true,
+ [Parameter(Mandatory=$false,Position=3)]
+ [switch]$GetErrorInvocation = $true,
+ [Parameter(Mandatory=$false,Position=4)]
+ [switch]$GetErrorException = $true,
+ [Parameter(Mandatory=$false,Position=5)]
+ [switch]$GetErrorInnerException = $true
+ )
+
+ Begin {
+ ## If function was called without specifying an error record, then choose the latest error that occurred
+ If (-not $ErrorRecord) {
+ If ($global:Error.Count -eq 0) {
+ #Write-Warning -Message "The `$Error collection is empty"
+ Return
+ }
+ Else {
+ [array]$ErrorRecord = $global:Error[0]
+ }
+ }
+
+ ## Allows selecting and filtering the properties on the error object if they exist
+ [scriptblock]$SelectProperty = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ $InputObject,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Property
+ )
+
+ [string[]]$ObjectProperty = $InputObject | Get-Member -MemberType '*Property' | Select-Object -ExpandProperty 'Name'
+ ForEach ($Prop in $Property) {
+ If ($Prop -eq '*') {
+ [string[]]$PropertySelection = $ObjectProperty
+ Break
+ }
+ ElseIf ($ObjectProperty -contains $Prop) {
+ [string[]]$PropertySelection += $Prop
+ }
+ }
+ Write-Output -InputObject $PropertySelection
+ }
+
+ # Initialize variables to avoid error if 'Set-StrictMode' is set
+ $LogErrorRecordMsg = $null
+ $LogErrorInvocationMsg = $null
+ $LogErrorExceptionMsg = $null
+ $LogErrorMessageTmp = $null
+ $LogInnerMessage = $null
+ }
+ Process {
+ If (-not $ErrorRecord) { Return }
+ ForEach ($ErrRecord in $ErrorRecord) {
+ ## Capture Error Record
+ If ($GetErrorRecord) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord -Property $Property
+ $LogErrorRecordMsg = $ErrRecord | Select-Object -Property $SelectedProperties
+ }
+
+ ## Error Invocation Information
+ If ($GetErrorInvocation) {
+ If ($ErrRecord.InvocationInfo) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord.InvocationInfo -Property $Property
+ $LogErrorInvocationMsg = $ErrRecord.InvocationInfo | Select-Object -Property $SelectedProperties
+ }
+ }
+
+ ## Capture Error Exception
+ If ($GetErrorException) {
+ If ($ErrRecord.Exception) {
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrRecord.Exception -Property $Property
+ $LogErrorExceptionMsg = $ErrRecord.Exception | Select-Object -Property $SelectedProperties
+ }
+ }
+
+ ## Display properties in the correct order
+ If ($Property -eq '*') {
+ # If all properties were chosen for display, then arrange them in the order the error object displays them by default.
+ If ($LogErrorRecordMsg) { [array]$LogErrorMessageTmp += $LogErrorRecordMsg }
+ If ($LogErrorInvocationMsg) { [array]$LogErrorMessageTmp += $LogErrorInvocationMsg }
+ If ($LogErrorExceptionMsg) { [array]$LogErrorMessageTmp += $LogErrorExceptionMsg }
+ }
+ Else {
+ # Display selected properties in our custom order
+ If ($LogErrorExceptionMsg) { [array]$LogErrorMessageTmp += $LogErrorExceptionMsg }
+ If ($LogErrorRecordMsg) { [array]$LogErrorMessageTmp += $LogErrorRecordMsg }
+ If ($LogErrorInvocationMsg) { [array]$LogErrorMessageTmp += $LogErrorInvocationMsg }
+ }
+
+ If ($LogErrorMessageTmp) {
+ $LogErrorMessage = 'Error Record:'
+ $LogErrorMessage += "`n-------------"
+ $LogErrorMsg = $LogErrorMessageTmp | Format-List | Out-String
+ $LogErrorMessage += $LogErrorMsg
+ }
+
+ ## Capture Error Inner Exception(s)
+ If ($GetErrorInnerException) {
+ If ($ErrRecord.Exception -and $ErrRecord.Exception.InnerException) {
+ $LogInnerMessage = 'Error Inner Exception(s):'
+ $LogInnerMessage += "`n-------------------------"
+
+ $ErrorInnerException = $ErrRecord.Exception.InnerException
+ $Count = 0
+
+ While ($ErrorInnerException) {
+ [string]$InnerExceptionSeperator = '~' * 40
+
+ [string[]]$SelectedProperties = & $SelectProperty -InputObject $ErrorInnerException -Property $Property
+ $LogErrorInnerExceptionMsg = $ErrorInnerException | Select-Object -Property $SelectedProperties | Format-List | Out-String
+
+ If ($Count -gt 0) { $LogInnerMessage += $InnerExceptionSeperator }
+ $LogInnerMessage += $LogErrorInnerExceptionMsg
+
+ $Count++
+ $ErrorInnerException = $ErrorInnerException.InnerException
+ }
+ }
+ }
+
+ If ($LogErrorMessage) { $Output = $LogErrorMessage }
+ If ($LogInnerMessage) { $Output += $LogInnerMessage }
+
+ Write-Output -InputObject $Output
+
+ If (Test-Path -LiteralPath 'variable:Output') { Clear-Variable -Name 'Output' }
+ If (Test-Path -LiteralPath 'variable:LogErrorMessage') { Clear-Variable -Name 'LogErrorMessage' }
+ If (Test-Path -LiteralPath 'variable:LogInnerMessage') { Clear-Variable -Name 'LogInnerMessage' }
+ If (Test-Path -LiteralPath 'variable:LogErrorMessageTmp') { Clear-Variable -Name 'LogErrorMessageTmp' }
+ }
+ }
+ End {
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationPrompt
+Function Show-InstallationPrompt {
+<#
+.SYNOPSIS
+ Displays a custom installation prompt with the toolkit branding and optional buttons.
+.DESCRIPTION
+ Any combination of Left, Middle or Right buttons can be displayed. The return value of the button clicked by the user is the button text specified.
+.PARAMETER Title
+ Title of the prompt. Default: the application installation name.
+.PARAMETER Message
+ Message text to be included in the prompt
+.PARAMETER MessageAlignment
+ Alignment of the message text. Options: Left, Center, Right. Default: Center.
+.PARAMETER ButtonLeftText
+ Show a button on the left of the prompt with the specified text
+.PARAMETER ButtonRightText
+ Show a button on the right of the prompt with the specified text
+.PARAMETER ButtonMiddleText
+ Show a button in the middle of the prompt with the specified text
+.PARAMETER Icon
+ Show a system icon in the prompt. Options: Application, Asterisk, Error, Exclamation, Hand, Information, None, Question, Shield, Warning, WinLogo. Default: None.
+.PARAMETER NoWait
+ Specifies whether to show the prompt asynchronously (i.e. allow the script to continue without waiting for a response). Default: $false.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds. The user will have no option but to respond to the prompt - resistance is futile!
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $false.
+.PARAMETER Timeout
+ Specifies the time period in seconds after which the prompt should timeout. Default: UI timeout value set in the config XML file.
+.PARAMETER ExitOnTimeout
+ Specifies whether to exit the script if the UI times out. Default: $true.
+.EXAMPLE
+ Show-InstallationPrompt -Message 'Do you want to proceed with the installation?' -ButtonRightText 'Yes' -ButtonLeftText 'No'
+.EXAMPLE
+ Show-InstallationPrompt -Title 'Funny Prompt' -Message 'How are you feeling today?' -ButtonRightText 'Good' -ButtonLeftText 'Bad' -ButtonMiddleText 'Indifferent'
+.EXAMPLE
+ Show-InstallationPrompt -Message 'You can customize text to appear at the end of an install, or remove it completely for unattended installations.' -Icon Information -NoWait
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Title = $installTitle,
+ [Parameter(Mandatory=$false)]
+ [string]$Message = '',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Left','Center','Right')]
+ [string]$MessageAlignment = 'Center',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonRightText = '',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonLeftText = '',
+ [Parameter(Mandatory=$false)]
+ [string]$ButtonMiddleText = '',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Application','Asterisk','Error','Exclamation','Hand','Information','None','Question','Shield','Warning','WinLogo')]
+ [string]$Icon = 'None',
+ [Parameter(Mandatory=$false)]
+ [switch]$NoWait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PersistPrompt = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$Timeout = $configInstallationUITimeout,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ExitOnTimeout = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in non-interactive mode
+ If ($deployModeSilent) {
+ Write-Log -Message "Bypassing Installation Prompt [Mode: $deployMode]... $Message" -Source ${CmdletName}
+ Return
+ }
+
+ ## Get parameters for calling function asynchronously
+ [hashtable]$installPromptParameters = $psBoundParameters
+
+ ## Check if the countdown was specified
+ If ($timeout -gt $configInstallationUITimeout) {
+ [string]$CountdownTimeoutErr = "The installation UI dialog timeout cannot be longer than the timeout specified in the XML configuration file."
+ Write-Log -Message $CountdownTimeoutErr -Severity 3 -Source ${CmdletName}
+ Throw $CountdownTimeoutErr
+ }
+
+ [Windows.Forms.Application]::EnableVisualStyles()
+ $formInstallationPrompt = New-Object -TypeName 'System.Windows.Forms.Form'
+ $pictureBanner = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $pictureIcon = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $labelText = New-Object -TypeName 'System.Windows.Forms.Label'
+ $buttonRight = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonMiddle = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonLeft = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonAbort = New-Object -TypeName 'System.Windows.Forms.Button'
+ $InitialFormInstallationPromptWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ ## Remove all event handlers from the controls
+ Try {
+ $labelText.remove_Click($handler_labelText_Click)
+ $buttonLeft.remove_Click($buttonLeft_OnClick)
+ $buttonRight.remove_Click($buttonRight_OnClick)
+ $buttonMiddle.remove_Click($buttonMiddle_OnClick)
+ $buttonAbort.remove_Click($buttonAbort_OnClick)
+ $timer.remove_Tick($timer_Tick)
+ $timer.Dispose()
+ $timer = $null
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $timerPersist.Dispose()
+ $timerPersist = $null
+ $formInstallationPrompt.remove_Load($Form_StateCorrection_Load)
+ $formInstallationPrompt.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formInstallationPrompt.WindowState = 'Normal'
+ $formInstallationPrompt.AutoSize = $true
+ $formInstallationPrompt.TopMost = $true
+ $formInstallationPrompt.BringToFront()
+ # Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formInstallationPromptStartPosition' -Value $formInstallationPrompt.Location -Scope 'Script'
+ }
+
+ ## Form
+ $formInstallationPrompt.Controls.Add($pictureBanner)
+
+ ##----------------------------------------------
+ ## Create padding object
+ $paddingNone = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $paddingNone.Top = 0
+ $paddingNone.Bottom = 0
+ $paddingNone.Left = 0
+ $paddingNone.Right = 0
+
+ ## Generic Button properties
+ $buttonWidth = 110
+ $buttonHeight = 23
+ $buttonPadding = 50
+ $buttonSize = New-Object -TypeName 'System.Drawing.Size'
+ $buttonSize.Width = $buttonWidth
+ $buttonSize.Height = $buttonHeight
+ $buttonPadding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $buttonPadding.Top = 0
+ $buttonPadding.Bottom = 5
+ $buttonPadding.Left = 50
+ $buttonPadding.Right = 0
+
+ ## Picture Banner
+ $pictureBanner.DataBindings.DefaultDataSourceUpdateMode = 0
+ $pictureBanner.ImageLocation = $appDeployLogoBanner
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $pictureBanner.Location = $System_Drawing_Point
+ $pictureBanner.Name = 'pictureBanner'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 50
+ $System_Drawing_Size.Width = 450
+ $pictureBanner.Size = $System_Drawing_Size
+ $pictureBanner.SizeMode = 'CenterImage'
+ $pictureBanner.Margin = $paddingNone
+ $pictureBanner.TabIndex = 0
+ $pictureBanner.TabStop = $false
+
+ ## Picture Icon
+ $pictureIcon.DataBindings.DefaultDataSourceUpdateMode = 0
+ If ($icon -ne 'None') { $pictureIcon.Image = ([Drawing.SystemIcons]::$Icon).ToBitmap() }
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 15
+ $System_Drawing_Point.Y = 105
+ $pictureIcon.Location = $System_Drawing_Point
+ $pictureIcon.Name = 'pictureIcon'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 32
+ $System_Drawing_Size.Width = 32
+ $pictureIcon.Size = $System_Drawing_Size
+ $pictureIcon.AutoSize = $true
+ $pictureIcon.Margin = $paddingNone
+ $pictureIcon.TabIndex = 0
+ $pictureIcon.TabStop = $false
+
+ ## Label Text
+ $labelText.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelText.Name = 'labelText'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 148
+ $System_Drawing_Size.Width = 385
+ $labelText.Size = $System_Drawing_Size
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 25
+ $System_Drawing_Point.Y = 50
+ $labelText.Location = $System_Drawing_Point
+ $labelText.Margin = '0,0,0,0'
+ $labelText.Padding = '40,0,20,0'
+ $labelText.TabIndex = 1
+ $labelText.Text = $message
+ $labelText.TextAlign = "Middle$($MessageAlignment)"
+ $labelText.Anchor = 'Top'
+ $labelText.add_Click($handler_labelText_Click)
+
+ ## Button Left
+ $buttonLeft.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonLeft.Location = '15,200'
+ $buttonLeft.Name = 'buttonLeft'
+ $buttonLeft.Size = $buttonSize
+ $buttonLeft.TabIndex = 5
+ $buttonLeft.Text = $buttonLeftText
+ $buttonLeft.DialogResult = 'No'
+ $buttonLeft.AutoSize = $false
+ $buttonLeft.UseVisualStyleBackColor = $true
+ $buttonLeft.add_Click($buttonLeft_OnClick)
+
+ ## Button Middle
+ $buttonMiddle.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonMiddle.Location = '170,200'
+ $buttonMiddle.Name = 'buttonMiddle'
+ $buttonMiddle.Size = $buttonSize
+ $buttonMiddle.TabIndex = 6
+ $buttonMiddle.Text = $buttonMiddleText
+ $buttonMiddle.DialogResult = 'Ignore'
+ $buttonMiddle.AutoSize = $true
+ $buttonMiddle.UseVisualStyleBackColor = $true
+ $buttonMiddle.add_Click($buttonMiddle_OnClick)
+
+ ## Button Right
+ $buttonRight.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonRight.Location = '325,200'
+ $buttonRight.Name = 'buttonRight'
+ $buttonRight.Size = $buttonSize
+ $buttonRight.TabIndex = 7
+ $buttonRight.Text = $ButtonRightText
+ $buttonRight.DialogResult = 'Yes'
+ $buttonRight.AutoSize = $true
+ $buttonRight.UseVisualStyleBackColor = $true
+ $buttonRight.add_Click($buttonRight_OnClick)
+
+ ## Button Abort (Hidden)
+ $buttonAbort.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonAbort.Name = 'buttonAbort'
+ $buttonAbort.Size = '1,1'
+ $buttonAbort.DialogResult = 'Abort'
+ $buttonAbort.TabStop = $false
+ $buttonAbort.UseVisualStyleBackColor = $true
+ $buttonAbort.add_Click($buttonAbort_OnClick)
+
+ ## Form Installation Prompt
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 270
+ $System_Drawing_Size.Width = 450
+ $formInstallationPrompt.Size = $System_Drawing_Size
+ $formInstallationPrompt.Padding = '0,0,0,10'
+ $formInstallationPrompt.Margin = $paddingNone
+ $formInstallationPrompt.DataBindings.DefaultDataSourceUpdateMode = 0
+ $formInstallationPrompt.Name = 'WelcomeForm'
+ $formInstallationPrompt.Text = $title
+ $formInstallationPrompt.StartPosition = 'CenterScreen'
+ $formInstallationPrompt.FormBorderStyle = 'FixedDialog'
+ $formInstallationPrompt.MaximizeBox = $false
+ $formInstallationPrompt.MinimizeBox = $false
+ $formInstallationPrompt.TopMost = $true
+ $formInstallationPrompt.TopLevel = $true
+ $formInstallationPrompt.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formInstallationPrompt.Controls.Add($pictureBanner)
+ $formInstallationPrompt.Controls.Add($pictureIcon)
+ $formInstallationPrompt.Controls.Add($labelText)
+ $formInstallationPrompt.Controls.Add($buttonAbort)
+ If ($buttonLeftText) { $formInstallationPrompt.Controls.Add($buttonLeft) }
+ If ($buttonMiddleText) { $formInstallationPrompt.Controls.Add($buttonMiddle) }
+ If ($buttonRightText) { $formInstallationPrompt.Controls.Add($buttonRight) }
+
+ ## Timer
+ $timer = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timer.Interval = ($timeout * 1000)
+ $timer.Add_Tick({
+ Write-Log -Message 'Installation action not taken within a reasonable amount of time.' -Source ${CmdletName}
+ $buttonAbort.PerformClick()
+ })
+
+ ## Save the initial state of the form
+ $InitialFormInstallationPromptWindowState = $formInstallationPrompt.WindowState
+ ## Init the OnLoad event to correct the initial state of the form
+ $formInstallationPrompt.add_Load($Form_StateCorrection_Load)
+ ## Clean up the control events
+ $formInstallationPrompt.add_FormClosed($Form_Cleanup_FormClosed)
+
+ ## Start the timer
+ $timer.Start()
+
+ ## Persistence Timer
+ [scriptblock]$RefreshInstallationPrompt = {
+ $formInstallationPrompt.BringToFront()
+ $formInstallationPrompt.Location = "$($formInstallationPromptStartPosition.X),$($formInstallationPromptStartPosition.Y)"
+ $formInstallationPrompt.Refresh()
+ }
+ If ($persistPrompt) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = { & $RefreshInstallationPrompt }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ ## Close the Installation Progress Dialog if running
+ Close-InstallationProgress
+
+ [string]$installPromptLoggedParameters = ($installPromptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' '
+ Write-Log -Message "Displaying custom installation prompt with the non-default parameters: [$installPromptLoggedParameters]." -Source ${CmdletName}
+
+ ## If the NoWait parameter is specified, launch a new PowerShell session to show the prompt asynchronously
+ If ($NoWait) {
+ # Remove the NoWait parameter so that the script is run synchronously in the new PowerShell session
+ $installPromptParameters.Remove('NoWait')
+ # Format the parameters as a string
+ [string]$installPromptParameters = ($installPromptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' '
+ Start-Process -FilePath "$PSHOME\powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$scriptPath`" -ReferredInstallTitle `"$Title`" -ReferredInstallName `"$installName`" -ReferredLogName `"$logName`" -ShowInstallationPrompt $installPromptParameters -AsyncToolkitLaunch" -WindowStyle 'Hidden' -ErrorAction 'SilentlyContinue'
+ }
+ ## Otherwise, show the prompt synchronously. If user cancels, then keep showing it until user responds using one of the buttons.
+ Else {
+ $showDialog = $true
+ While ($showDialog) {
+ # Minimize all other windows
+ If ($minimizeWindows) { $null = $shellApp.MinimizeAll() }
+ # Show the Form
+ $result = $formInstallationPrompt.ShowDialog()
+ If (($result -eq 'Yes') -or ($result -eq 'No') -or ($result -eq 'Ignore') -or ($result -eq 'Abort')) {
+ $showDialog = $false
+ }
+ }
+ $formInstallationPrompt.Dispose()
+
+ Switch ($result) {
+ 'Yes' { Write-Output -InputObject $buttonRightText }
+ 'No' { Write-Output -InputObject $buttonLeftText }
+ 'Ignore' { Write-Output -InputObject $buttonMiddleText }
+ 'Abort' {
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+ If ($ExitOnTimeout) {
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ Else {
+ Write-Log -Message 'UI timed out but `$ExitOnTimeout set to `$false. Continue...' -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-DialogBox
+Function Show-DialogBox {
+<#
+.SYNOPSIS
+ Display a custom dialog box with optional title, buttons, icon and timeout.
+ Show-InstallationPrompt is recommended over this function as it provides more customization and uses consistent branding with the other UI components.
+.DESCRIPTION
+ Display a custom dialog box with optional title, buttons, icon and timeout. The default button is "OK", the default Icon is "None", and the default Timeout is none.
+.PARAMETER Text
+ Text in the message dialog box
+.PARAMETER Title
+ Title of the message dialog box
+.PARAMETER Buttons
+ Buttons to be included on the dialog box. Options: OK, OKCancel, AbortRetryIgnore, YesNoCancel, YesNo, RetryCancel, CancelTryAgainContinue. Default: OK.
+.PARAMETER DefaultButton
+ The Default button that is selected. Options: First, Second, Third. Default: First.
+.PARAMETER Icon
+ Icon to display on the dialog box. Options: None, Stop, Question, Exclamation, Information. Default: None.
+.PARAMETER Timeout
+ Timeout period in seconds before automatically closing the dialog box with the return message "Timeout". Default: UI timeout value set in the config XML file.
+.PARAMETER TopMost
+ Specifies whether the message box is a system modal message box and appears in a topmost window. Default: $true.
+.EXAMPLE
+ Show-DialogBox -Title 'Installed Complete' -Text 'Installation has completed. Please click OK and restart your computer.' -Icon 'Information'
+.EXAMPLE
+ Show-DialogBox -Title 'Installation Notice' -Text 'Installation will take approximately 30 minutes. Do you wish to proceed?' -Buttons 'OKCancel' -DefaultButton 'Second' -Icon 'Exclamation' -Timeout 600 -Topmost $false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,HelpMessage='Enter a message for the dialog box')]
+ [ValidateNotNullorEmpty()]
+ [string]$Text,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Title = $installTitle,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('OK','OKCancel','AbortRetryIgnore','YesNoCancel','YesNo','RetryCancel','CancelTryAgainContinue')]
+ [string]$Buttons = 'OK',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('First','Second','Third')]
+ [string]$DefaultButton = 'First',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Exclamation','Information','None','Stop','Question')]
+ [string]$Icon = 'None',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Timeout = $configInstallationUITimeout,
+ [Parameter(Mandatory=$false)]
+ [boolean]$TopMost = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ # Bypass if in non-interactive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Dialog Box [Mode: $deployMode]: $Text..." -Source ${CmdletName}
+ Return
+ }
+
+ Write-Log -Message "Display Dialog Box with message: $Text..." -Source ${CmdletName}
+
+ [hashtable]$dialogButtons = @{
+ 'OK' = 0
+ 'OKCancel' = 1
+ 'AbortRetryIgnore' = 2
+ 'YesNoCancel' = 3
+ 'YesNo' = 4
+ 'RetryCancel' = 5
+ 'CancelTryAgainContinue' = 6
+ }
+
+ [hashtable]$dialogIcons = @{
+ 'None' = 0
+ 'Stop' = 16
+ 'Question' = 32
+ 'Exclamation' = 48
+ 'Information' = 64
+ }
+
+ [hashtable]$dialogDefaultButton = @{
+ 'First' = 0
+ 'Second' = 256
+ 'Third' = 512
+ }
+
+ Switch ($TopMost) {
+ $true { $dialogTopMost = 4096 }
+ $false { $dialogTopMost = 0 }
+ }
+
+ $response = $Shell.Popup($Text, $Timeout, $Title, ($dialogButtons[$Buttons] + $dialogIcons[$Icon] + $dialogDefaultButton[$DefaultButton] + $dialogTopMost))
+
+ Switch ($response) {
+ 1 {
+ Write-Log -Message 'Dialog Box Response: OK' -Source ${CmdletName}
+ Write-Output -InputObject 'OK'
+ }
+ 2 {
+ Write-Log -Message 'Dialog Box Response: Cancel' -Source ${CmdletName}
+ Write-Output -InputObject 'Cancel'
+ }
+ 3 {
+ Write-Log -Message 'Dialog Box Response: Abort' -Source ${CmdletName}
+ Write-Output -InputObject 'Abort'
+ }
+ 4 {
+ Write-Log -Message 'Dialog Box Response: Retry' -Source ${CmdletName}
+ Write-Output -InputObject 'Retry'
+ }
+ 5 {
+ Write-Log -Message 'Dialog Box Response: Ignore' -Source ${CmdletName}
+ Write-Output -InputObject 'Ignore'
+ }
+ 6 {
+ Write-Log -Message 'Dialog Box Response: Yes' -Source ${CmdletName}
+ Write-Output -InputObject 'Yes'
+ }
+ 7 {
+ Write-Log -Message 'Dialog Box Response: No' -Source ${CmdletName}
+ Write-Output -InputObject 'No'
+ }
+ 10 {
+ Write-Log -Message 'Dialog Box Response: Try Again' -Source ${CmdletName}
+ Write-Output -InputObject 'Try Again'
+ }
+ 11 {
+ Write-Log -Message 'Dialog Box Response: Continue' -Source ${CmdletName}
+ Write-Output -InputObject 'Continue'
+ }
+ -1 {
+ Write-Log -Message 'Dialog Box Timed Out...' -Source ${CmdletName}
+ Write-Output -InputObject 'Timeout'
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-HardwarePlatform
+Function Get-HardwarePlatform {
+<#
+.SYNOPSIS
+ Retrieves information about the hardware platform (physical or virtual)
+.DESCRIPTION
+ Retrieves information about the hardware platform (physical or virtual)
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-HardwarePlatform
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Retrieve hardware platform information.' -Source ${CmdletName}
+ $hwBios = Get-WmiObject -Class 'Win32_BIOS' -ErrorAction 'Stop' | Select-Object -Property 'Version', 'SerialNumber'
+ $hwMakeModel = Get-WMIObject -Class 'Win32_ComputerSystem' -ErrorAction 'Stop' | Select-Object -Property 'Model', 'Manufacturer'
+
+ If ($hwBIOS.Version -match 'VRTUAL') { $hwType = 'Virtual:Hyper-V' }
+ ElseIf ($hwBIOS.Version -match 'A M I') { $hwType = 'Virtual:Virtual PC' }
+ ElseIf ($hwBIOS.Version -like '*Xen*') { $hwType = 'Virtual:Xen' }
+ ElseIf ($hwBIOS.SerialNumber -like '*VMware*') { $hwType = 'Virtual:VMWare' }
+ ElseIf (($hwMakeModel.Manufacturer -like '*Microsoft*') -and ($hwMakeModel.Model -notlike '*Surface*')) { $hwType = 'Virtual:Hyper-V' }
+ ElseIf ($hwMakeModel.Manufacturer -like '*VMWare*') { $hwType = 'Virtual:VMWare' }
+ ElseIf ($hwMakeModel.Model -like '*Virtual*') { $hwType = 'Virtual' }
+ Else { $hwType = 'Physical' }
+
+ Write-Output -InputObject $hwType
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve hardware platform information. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve hardware platform information: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-FreeDiskSpace
+Function Get-FreeDiskSpace {
+<#
+.SYNOPSIS
+ Retrieves the free disk space in MB on a particular drive (defaults to system drive)
+.DESCRIPTION
+ Retrieves the free disk space in MB on a particular drive (defaults to system drive)
+.PARAMETER Drive
+ Drive to check free disk space on
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-FreeDiskSpace -Drive 'C:'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Drive = $envSystemDrive,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Retrieve free disk space for drive [$Drive]." -Source ${CmdletName}
+ $disk = Get-WmiObject -Class 'Win32_LogicalDisk' -Filter "DeviceID='$Drive'" -ErrorAction 'Stop'
+ [double]$freeDiskSpace = [math]::Round($disk.FreeSpace / 1MB)
+
+ Write-Log -Message "Free disk space for drive [$Drive]: [$freeDiskSpace MB]." -Source ${CmdletName}
+ Write-Output -InputObject $freeDiskSpace
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve free disk space for drive [$Drive]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve free disk space for drive [$Drive]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-InstalledApplication
+Function Get-InstalledApplication {
+<#
+.SYNOPSIS
+ Retrieves information about installed applications.
+.DESCRIPTION
+ Retrieves information about installed applications by querying the registry. You can specify an application name, a product code, or both.
+ Returns information about application publisher, name & version, product code, uninstall string, install source, location, date, and application architecture.
+.PARAMETER Name
+ The name of the application to retrieve information for. Performs a contains match on the application display name by default.
+.PARAMETER Exact
+ Specifies that the named application must be matched using the exact name.
+.PARAMETER WildCard
+ Specifies that the named application must be matched using a wildcard search.
+.PARAMETER RegEx
+ Specifies that the named application must be matched using a regular expression search.
+.PARAMETER ProductCode
+ The product code of the application to retrieve information for.
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.EXAMPLE
+ Get-InstalledApplication -Name 'Adobe Flash'
+.EXAMPLE
+ Get-InstalledApplication -ProductCode '{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Exact = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WildCard = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$RegEx = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$ProductCode,
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($name) {
+ Write-Log -Message "Get information for installed Application Name(s) [$($name -join ', ')]..." -Source ${CmdletName}
+ }
+ If ($productCode) {
+ Write-Log -Message "Get information for installed Product Code [$ProductCode]..." -Source ${CmdletName}
+ }
+
+ ## Enumerate the installed applications from the registry for applications that have the "DisplayName" property
+ [psobject[]]$regKeyApplication = @()
+ ForEach ($regKey in $regKeyApplications) {
+ If (Test-Path -LiteralPath $regKey -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorUninstallKeyPath') {
+ [psobject[]]$UninstallKeyApps = Get-ChildItem -LiteralPath $regKey -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorUninstallKeyPath'
+ ForEach ($UninstallKeyApp in $UninstallKeyApps) {
+ Try {
+ [psobject]$regKeyApplicationProps = Get-ItemProperty -LiteralPath $UninstallKeyApp.PSPath -ErrorAction 'Stop'
+ If ($regKeyApplicationProps.DisplayName) { [psobject[]]$regKeyApplication += $regKeyApplicationProps }
+ }
+ Catch{
+ Write-Log -Message "Unable to enumerate properties from registry key path [$($UninstallKeyApp.PSPath)]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ }
+ If ($ErrorUninstallKeyPath) {
+ Write-Log -Message "The following error(s) took place while enumerating installed applications from the registry. `n$(Resolve-Error -ErrorRecord $ErrorUninstallKeyPath)" -Severity 2 -Source ${CmdletName}
+ }
+
+ ## Create a custom object with the desired properties for the installed applications and sanitize property details
+ [psobject[]]$installedApplication = @()
+ ForEach ($regKeyApp in $regKeyApplication) {
+ Try {
+ [string]$appDisplayName = ''
+ [string]$appDisplayVersion = ''
+ [string]$appPublisher = ''
+
+ ## Bypass any updates or hotfixes
+ If (-not $IncludeUpdatesAndHotfixes) {
+ If ($regKeyApp.DisplayName -match '(?i)kb\d+') { Continue }
+ If ($regKeyApp.DisplayName -match 'Cumulative Update') { Continue }
+ If ($regKeyApp.DisplayName -match 'Security Update') { Continue }
+ If ($regKeyApp.DisplayName -match 'Hotfix') { Continue }
+ }
+
+ ## Remove any control characters which may interfere with logging and creating file path names from these variables
+ $appDisplayName = $regKeyApp.DisplayName -replace '[^\u001F-\u007F]',''
+ $appDisplayVersion = $regKeyApp.DisplayVersion -replace '[^\u001F-\u007F]',''
+ $appPublisher = $regKeyApp.Publisher -replace '[^\u001F-\u007F]',''
+
+ ## Determine if application is a 64-bit application
+ [boolean]$Is64BitApp = If (($is64Bit) -and ($regKeyApp.PSPath -notmatch '^Microsoft\.PowerShell\.Core\\Registry::HKEY_LOCAL_MACHINE\\SOFTWARE\\Wow6432Node')) { $true } Else { $false }
+
+ If ($ProductCode) {
+ ## Verify if there is a match with the product code passed to the script
+ If ($regKeyApp.PSChildName -match [regex]::Escape($productCode)) {
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] matching product code [$productCode]." -Source ${CmdletName}
+ $installedApplication += New-Object -TypeName 'PSObject' -Property @{
+ UninstallSubkey = $regKeyApp.PSChildName
+ ProductCode = If ($regKeyApp.PSChildName -match $MSIProductCodeRegExPattern) { $regKeyApp.PSChildName } Else { [string]::Empty }
+ DisplayName = $appDisplayName
+ DisplayVersion = $appDisplayVersion
+ UninstallString = $regKeyApp.UninstallString
+ InstallSource = $regKeyApp.InstallSource
+ InstallLocation = $regKeyApp.InstallLocation
+ InstallDate = $regKeyApp.InstallDate
+ Publisher = $appPublisher
+ Is64BitApplication = $Is64BitApp
+ }
+ }
+ }
+
+ If ($name) {
+ ## Verify if there is a match with the application name(s) passed to the script
+ ForEach ($application in $Name) {
+ $applicationMatched = $false
+ If ($exact) {
+ # Check for an exact application name match
+ If ($regKeyApp.DisplayName -eq $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using exact name matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($WildCard) {
+ # Check for wildcard application name match
+ If ($regKeyApp.DisplayName -like $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using wildcard matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($RegEx) {
+ # Check for a regex application name match
+ If ($regKeyApp.DisplayName -match $application) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using regex matching for search term [$application]." -Source ${CmdletName}
+ }
+ }
+ # Check for a contains application name match
+ ElseIf ($regKeyApp.DisplayName -match [regex]::Escape($application)) {
+ $applicationMatched = $true
+ Write-Log -Message "Found installed application [$appDisplayName] version [$appDisplayVersion] using contains matching for search term [$application]." -Source ${CmdletName}
+ }
+
+ If ($applicationMatched) {
+ $installedApplication += New-Object -TypeName 'PSObject' -Property @{
+ UninstallSubkey = $regKeyApp.PSChildName
+ ProductCode = If ($regKeyApp.PSChildName -match $MSIProductCodeRegExPattern) { $regKeyApp.PSChildName } Else { [string]::Empty }
+ DisplayName = $appDisplayName
+ DisplayVersion = $appDisplayVersion
+ UninstallString = $regKeyApp.UninstallString
+ InstallSource = $regKeyApp.InstallSource
+ InstallLocation = $regKeyApp.InstallLocation
+ InstallDate = $regKeyApp.InstallDate
+ Publisher = $appPublisher
+ Is64BitApplication = $Is64BitApp
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to resolve application details from registry for [$appDisplayName]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Continue
+ }
+ }
+
+ Write-Output -InputObject $installedApplication
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-MSI
+Function Execute-MSI {
+<#
+.SYNOPSIS
+ Executes msiexec.exe to perform the following actions for MSI & MSP files and MSI product codes: install, uninstall, patch, repair, active setup.
+.DESCRIPTION
+ Executes msiexec.exe to perform the following actions for MSI & MSP files and MSI product codes: install, uninstall, patch, repair, active setup.
+ If the -Action parameter is set to "Install" and the MSI is already installed, the function will exit.
+ Sets default switches to be passed to msiexec based on the preferences in the XML configuration file.
+ Automatically generates a log file name and creates a verbose log file for all msiexec operations.
+ Expects the MSI or MSP file to be located in the "Files" sub directory of the App Deploy Toolkit. Expects transform files to be in the same directory as the MSI file.
+.PARAMETER Action
+ The action to perform. Options: Install, Uninstall, Patch, Repair, ActiveSetup.
+.PARAMETER Path
+ The path to the MSI/MSP file or the product code of the installed MSI.
+.PARAMETER Transform
+ The name of the transform file(s) to be applied to the MSI. The transform file is expected to be in the same directory as the MSI file.
+.PARAMETER Patch
+ The name of the patch (msp) file(s) to be applied to the MSI for use with the "Install" action. The patch file is expected to be in the same directory as the MSI file.
+.PARAMETER Parameters
+ Overrides the default parameters specified in the XML configuration file. Install default is: "REBOOT=ReallySuppress /QB!". Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER AddParameters
+ Adds to the default parameters specified in the XML configuration file. Install default is: "REBOOT=ReallySuppress /QB!". Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER SecureParameters
+ Hides all parameters passed to the MSI or MSP file from the toolkit Log file.
+.PARAMETER LoggingOptions
+ Overrides the default logging options specified in the XML configuration file. Default options are: "/L*v".
+.PARAMETER LogName
+ Overrides the default log file name. The default log file name is generated from the MSI file name. If LogName does not end in .log, it will be automatically appended.
+ For uninstallations, by default the product code is resolved to the DisplayName and version of the application.
+.PARAMETER WorkingDirectory
+ Overrides the working directory. The working directory is set to the location of the MSI file.
+.PARAMETER SkipMSIAlreadyInstalledCheck
+ Skips the check to determine if the MSI is already installed on the system. Default is: $false.
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by msiexec that is not recognized by the App Deploy Toolkit. Default is: $false.
+.EXAMPLE
+ Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi'
+ Installs an MSI
+.EXAMPLE
+ Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi' -Transform 'Adobe_FlashPlayer_11.2.202.233_x64_EN_01.mst' -Parameters '/QN'
+ Installs an MSI, applying a transform and overriding the default MSI toolkit parameters
+.EXAMPLE
+ [psobject]$ExecuteMSIResult = Execute-MSI -Action 'Install' -Path 'Adobe_FlashPlayer_11.2.202.233_x64_EN.msi' -PassThru
+ Installs an MSI and stores the result of the execution into a variable by using the -PassThru option
+.EXAMPLE
+ Execute-MSI -Action 'Uninstall' -Path '{26923b43-4d38-484f-9b9e-de460746276c}'
+ Uninstalls an MSI using a product code
+.EXAMPLE
+ Execute-MSI -Action 'Patch' -Path 'Adobe_Reader_11.0.3_EN.msp'
+ Installs an MSP
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Install','Uninstall','Patch','Repair','ActiveSetup')]
+ [string]$Action = 'Install',
+ [Parameter(Mandatory=$true,HelpMessage='Please enter either the path to the MSI/MSP file or the ProductCode')]
+ [ValidateScript({($_ -match $MSIProductCodeRegExPattern) -or ('.msi','.msp' -contains [IO.Path]::GetExtension($_))})]
+ [Alias('FilePath')]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Transform,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$AddParameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Patch,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$LoggingOptions,
+ [Parameter(Mandatory=$false)]
+ [Alias('LogName')]
+ [string]$private:LogName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$SkipMSIAlreadyInstalledCheck = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Initialize variable indicating whether $Path variable is a Product Code or not
+ [boolean]$PathIsProductCode = $false
+
+ ## If the path matches a product code
+ If ($Path -match $MSIProductCodeRegExPattern) {
+ # Set variable indicating that $Path variable is a Product Code
+ [boolean]$PathIsProductCode = $true
+
+ # Resolve the product code to a publisher, application name, and version
+ Write-Log -Message 'Resolve product code to a publisher, application name, and version.' -Source ${CmdletName}
+
+ If ($IncludeUpdatesAndHotfixes) {
+ [psobject]$productCodeNameVersion = Get-InstalledApplication -ProductCode $path -IncludeUpdatesAndHotfixes | Select-Object -Property 'Publisher', 'DisplayName', 'DisplayVersion' -First 1 -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ [psobject]$productCodeNameVersion = Get-InstalledApplication -ProductCode $path | Select-Object -Property 'Publisher', 'DisplayName', 'DisplayVersion' -First 1 -ErrorAction 'SilentlyContinue'
+ }
+
+ # Build the log file name
+ If (-not $logName) {
+ If ($productCodeNameVersion) {
+ If ($productCodeNameVersion.Publisher) {
+ $logName = ($productCodeNameVersion.Publisher + '_' + $productCodeNameVersion.DisplayName + '_' + $productCodeNameVersion.DisplayVersion) -replace "[$invalidFileNameChars]",'' -replace ' ',''
+ }
+ Else {
+ $logName = ($productCodeNameVersion.DisplayName + '_' + $productCodeNameVersion.DisplayVersion) -replace "[$invalidFileNameChars]",'' -replace ' ',''
+ }
+ }
+ Else {
+ # Out of other options, make the Product Code the name of the log file
+ $logName = $Path
+ }
+ }
+ }
+ Else {
+ # Get the log file name without file extension
+ If (-not $logName) { $logName = ([IO.FileInfo]$path).BaseName } ElseIf ('.log','.txt' -contains [IO.Path]::GetExtension($logName)) { $logName = [IO.Path]::GetFileNameWithoutExtension($logName) }
+ }
+
+ If ($configToolkitCompressLogs) {
+ ## Build the log file path
+ [string]$logPath = Join-Path -Path $logTempFolder -ChildPath $logName
+ }
+ Else {
+ ## Create the Log directory if it doesn't already exist
+ If (-not (Test-Path -LiteralPath $configMSILogDir -PathType 'Container' -ErrorAction 'SilentlyContinue')) {
+ $null = New-Item -Path $configMSILogDir -ItemType 'Directory' -ErrorAction 'SilentlyContinue'
+ }
+ ## Build the log file path
+ [string]$logPath = Join-Path -Path $configMSILogDir -ChildPath $logName
+ }
+
+ ## Set the installation Parameters
+ If ($deployModeSilent) {
+ $msiInstallDefaultParams = $configMSISilentParams
+ $msiUninstallDefaultParams = $configMSISilentParams
+ }
+ Else {
+ $msiInstallDefaultParams = $configMSIInstallParams
+ $msiUninstallDefaultParams = $configMSIUninstallParams
+ }
+
+ ## Build the MSI Parameters
+ Switch ($action) {
+ 'Install' { $option = '/i'; [string]$msiLogFile = "$logPath" + '_Install'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'Uninstall' { $option = '/x'; [string]$msiLogFile = "$logPath" + '_Uninstall'; $msiDefaultParams = $msiUninstallDefaultParams }
+ 'Patch' { $option = '/update'; [string]$msiLogFile = "$logPath" + '_Patch'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'Repair' { $option = '/f'; [string]$msiLogFile = "$logPath" + '_Repair'; $msiDefaultParams = $msiInstallDefaultParams }
+ 'ActiveSetup' { $option = '/fups'; [string]$msiLogFile = "$logPath" + '_ActiveSetup' }
+ }
+
+ ## Append ".log" to the MSI logfile path and enclose in quotes
+ If ([IO.Path]::GetExtension($msiLogFile) -ne '.log') {
+ [string]$msiLogFile = $msiLogFile + '.log'
+ [string]$msiLogFile = "`"$msiLogFile`""
+ }
+
+ ## If the MSI is in the Files directory, set the full path to the MSI
+ If (Test-Path -LiteralPath (Join-Path -Path $dirFiles -ChildPath $path -ErrorAction 'SilentlyContinue') -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ [string]$msiFile = Join-Path -Path $dirFiles -ChildPath $path
+ }
+ ElseIf (Test-Path -LiteralPath $Path -ErrorAction 'SilentlyContinue') {
+ [string]$msiFile = (Get-Item -LiteralPath $Path).FullName
+ }
+ ElseIf ($PathIsProductCode) {
+ [string]$msiFile = $Path
+ }
+ Else {
+ Write-Log -Message "Failed to find MSI file [$path]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to find MSI file [$path]."
+ }
+ Continue
+ }
+
+ ## Set the working directory of the MSI
+ If ((-not $PathIsProductCode) -and (-not $workingDirectory)) { [string]$workingDirectory = Split-Path -Path $msiFile -Parent }
+
+ ## Enumerate all transforms specified, qualify the full path if possible and enclose in quotes
+ If ($transform) {
+ [string[]]$transforms = $transform -split ','
+ 0..($transforms.Length - 1) | ForEach-Object {
+ If (Test-Path -LiteralPath (Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $transforms[$_]) -PathType 'Leaf') {
+ $transforms[$_] = Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $transforms[$_].Replace('.\','')
+ }
+ Else {
+ $transforms[$_] = $transforms[$_]
+ }
+ }
+ [string]$mstFile = "`"$($transforms -join ';')`""
+ }
+
+ ## Enumerate all patches specified, qualify the full path if possible and enclose in quotes
+ If ($patch) {
+ [string[]]$patches = $patch -split ','
+ 0..($patches.Length - 1) | ForEach-Object {
+ If (Test-Path -LiteralPath (Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $patches[$_]) -PathType 'Leaf') {
+ $patches[$_] = Join-Path -Path (Split-Path -Path $msiFile -Parent) -ChildPath $patches[$_].Replace('.\','')
+ }
+ Else {
+ $patches[$_] = $patches[$_]
+ }
+ }
+ [string]$mspFile = "`"$($patches -join ';')`""
+ }
+
+ ## Get the ProductCode of the MSI
+ If ($PathIsProductCode) {
+ [string]$MSIProductCode = $path
+ }
+ ElseIf ([IO.Path]::GetExtension($msiFile) -eq '.msi') {
+ Try {
+ [hashtable]$GetMsiTablePropertySplat = @{ Path = $msiFile; Table = 'Property'; ContinueOnError = $false }
+ If ($transforms) { $GetMsiTablePropertySplat.Add( 'TransformPath', $transforms ) }
+ [string]$MSIProductCode = Get-MsiTableProperty @GetMsiTablePropertySplat | Select-Object -ExpandProperty 'ProductCode' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to get the ProductCode from the MSI file. Continue with requested action [$Action]..." -Source ${CmdletName}
+ }
+ }
+
+ ## Enclose the MSI file in quotes to avoid issues with spaces when running msiexec
+ [string]$msiFile = "`"$msiFile`""
+
+ ## Start building the MsiExec command line starting with the base action and file
+ [string]$argsMSI = "$option $msiFile"
+ # Add MST
+ If ($transform) { $argsMSI = "$argsMSI TRANSFORMS=$mstFile TRANSFORMSSECURE=1" }
+ # Add MSP
+ If ($patch) { $argsMSI = "$argsMSI PATCH=$mspFile" }
+ # Replace default parameters if specified.
+ If ($Parameters) { $argsMSI = "$argsMSI $Parameters" } Else { $argsMSI = "$argsMSI $msiDefaultParams" }
+ # Append parameters to default parameters if specified.
+ If ($AddParameters) { $argsMSI = "$argsMSI $AddParameters" }
+ # Add custom Logging Options if specified, otherwise, add default Logging Options from Config file
+ If ($LoggingOptions) { $argsMSI = "$argsMSI $LoggingOptions $msiLogFile" } Else { $argsMSI = "$argsMSI $configMSILoggingOptions $msiLogFile" }
+
+ ## Check if the MSI is already installed. If no valid ProductCode to check, then continue with requested MSI action.
+ If ($MSIProductCode) {
+ If ($SkipMSIAlreadyInstalledCheck) {
+ [boolean]$IsMsiInstalled = $false
+ }
+ Else {
+ If ($IncludeUpdatesAndHotfixes) {
+ [psobject]$MsiInstalled = Get-InstalledApplication -ProductCode $MSIProductCode -IncludeUpdatesAndHotfixes
+ }
+ Else {
+ [psobject]$MsiInstalled = Get-InstalledApplication -ProductCode $MSIProductCode
+ }
+ If ($MsiInstalled) { [boolean]$IsMsiInstalled = $true }
+ }
+ }
+ Else {
+ If ($Action -eq 'Install') { [boolean]$IsMsiInstalled = $false } Else { [boolean]$IsMsiInstalled = $true }
+ }
+
+ If (($IsMsiInstalled) -and ($Action -eq 'Install')) {
+ Write-Log -Message "The MSI is already installed on this system. Skipping action [$Action]..." -Source ${CmdletName}
+ }
+ ElseIf (((-not $IsMsiInstalled) -and ($Action -eq 'Install')) -or ($IsMsiInstalled)) {
+ Write-Log -Message "Executing MSI action [$Action]..." -Source ${CmdletName}
+ # Build the hashtable with the options that will be passed to Execute-Process using splatting
+ [hashtable]$ExecuteProcessSplat = @{ Path = $exeMsiexec
+ Parameters = $argsMSI
+ WindowStyle = 'Normal' }
+ If ($WorkingDirectory) { $ExecuteProcessSplat.Add( 'WorkingDirectory', $WorkingDirectory) }
+ If ($ContinueOnError) { $ExecuteProcessSplat.Add( 'ContinueOnError', $ContinueOnError) }
+ If ($SecureParameters) { $ExecuteProcessSplat.Add( 'SecureParameters', $SecureParameters) }
+ If ($PassThru) { $ExecuteProcessSplat.Add( 'PassThru', $PassThru) }
+ # Call the Execute-Process function
+ If ($PassThru) {
+ [psobject]$ExecuteResults = Execute-Process @ExecuteProcessSplat
+ }
+ Else {
+ Execute-Process @ExecuteProcessSplat
+ }
+ # Refresh environment variables for Windows Explorer process as Windows does not consistently update environment variables created by MSIs
+ Update-Desktop
+ }
+ Else {
+ Write-Log -Message "The MSI is not installed on this system. Skipping action [$Action]..." -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $ExecuteResults }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-MSIApplications
+Function Remove-MSIApplications {
+<#
+.SYNOPSIS
+ Removes all MSI applications matching the specified application name.
+.DESCRIPTION
+ Removes all MSI applications matching the specified application name.
+ Enumerates the registry for installed applications matching the specified application name and uninstalls that application using the product code, provided the uninstall string matches "msiexec".
+.PARAMETER Name
+ The name of the application to uninstall. Performs a contains match on the application display name by default.
+.PARAMETER Exact
+ Specifies that the named application must be matched using the exact name.
+.PARAMETER WildCard
+ Specifies that the named application must be matched using a wildcard search.
+.PARAMETER Parameters
+ Overrides the default parameters specified in the XML configuration file. Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER AddParameters
+ Adds to the default parameters specified in the XML configuration file. Uninstall default is: "REBOOT=ReallySuppress /QN".
+.PARAMETER FilterApplication
+ Two-dimensional array that contains one or more (property, value, match-type) sets that should be used to filter the list of results returned by Get-InstalledApplication to only those that should be uninstalled.
+ Properties that can be filtered upon: ProductCode, DisplayName, DisplayVersion, UninstallString, InstallSource, InstallLocation, InstallDate, Publisher, Is64BitApplication
+.PARAMETER ExcludeFromUninstall
+ Two-dimensional array that contains one or more (property, value, match-type) sets that should be excluded from uninstall if found.
+ Properties that can be excluded: ProductCode, DisplayName, DisplayVersion, UninstallString, InstallSource, InstallLocation, InstallDate, Publisher, Is64BitApplication
+.PARAMETER IncludeUpdatesAndHotfixes
+ Include matches against updates and hotfixes in results.
+.PARAMETER LoggingOptions
+ Overrides the default logging options specified in the XML configuration file. Default options are: "/L*v".
+.PARAMETER LogName
+ Overrides the default log file name. The default log file name is generated from the MSI file name. If LogName does not end in .log, it will be automatically appended.
+ For uninstallations, by default the product code is resolved to the DisplayName and version of the application.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by msiexec that is not recognized by the App Deploy Toolkit. Default is: $true.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Adobe Flash'
+ Removes all versions of software that match the name "Adobe Flash"
+.EXAMPLE
+ Remove-MSIApplications -Name 'Adobe'
+ Removes all versions of software that match the name "Adobe"
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -FilterApplication ('Is64BitApplication', $false, 'Exact'),('Publisher', 'Oracle Corporation', 'Exact')
+ Removes all versions of software that match the name "Java 8 Update" where the software is 32-bits and the publisher is "Oracle Corporation".
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -FilterApplication (,('Publisher', 'Oracle Corporation', 'Exact')) -ExcludeFromUninstall (,('DisplayName', 'Java 8 Update 45', 'Contains'))
+ Removes all versions of software that match the name "Java 8 Update" and also have "Oracle Corporation" as the Publisher; however, it does not uninstall "Java 8 Update 45" of the software.
+ NOTE: if only specifying a single row in the two-dimensional arrays, the array must have the extra parentheses and leading comma as in this example.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -ExcludeFromUninstall (,('DisplayName', 'Java 8 Update 45', 'Contains'))
+ Removes all versions of software that match the name "Java 8 Update"; however, it does not uninstall "Java 8 Update 45" of the software.
+ NOTE: if only specifying a single row in the two-dimensional array, the array must have the extra parentheses and leading comma as in this example.
+.EXAMPLE
+ Remove-MSIApplications -Name 'Java 8 Update' -ExcludeFromUninstall
+ ('Is64BitApplication', $true, 'Exact'),
+ ('DisplayName', 'Java 8 Update 45', 'Exact'),
+ ('DisplayName', 'Java 8 Update 4*', 'WildCard'),
+ ('DisplayName', 'Java \d Update \d{3}', 'RegEx'),
+ ('DisplayName', 'Java 8 Update', 'Contains')
+ Removes all versions of software that match the name "Java 8 Update"; however, it does not uninstall 64-bit versions of the software, Update 45 of the software, or any Update that starts with 4.
+.NOTES
+ More reading on how to create arrays if having trouble with -FilterApplication or -ExcludeFromUninstall parameter: http://blogs.msdn.com/b/powershell/archive/2007/01/23/array-literals-in-powershell.aspx
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Exact = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WildCard = $false,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$AddParameters,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [array]$FilterApplication = @(@()),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [array]$ExcludeFromUninstall = @(@()),
+ [Parameter(Mandatory=$false)]
+ [switch]$IncludeUpdatesAndHotfixes = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$LoggingOptions,
+ [Parameter(Mandatory=$false)]
+ [Alias('LogName')]
+ [string]$private:LogName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Build the hashtable with the options that will be passed to Get-InstalledApplication using splatting
+ [hashtable]$GetInstalledApplicationSplat = @{ Name = $name }
+ If ($Exact) { $GetInstalledApplicationSplat.Add( 'Exact', $Exact) }
+ ElseIf ($WildCard) { $GetInstalledApplicationSplat.Add( 'WildCard', $WildCard) }
+ If ($IncludeUpdatesAndHotfixes) { $GetInstalledApplicationSplat.Add( 'IncludeUpdatesAndHotfixes', $IncludeUpdatesAndHotfixes) }
+
+ [psobject[]]$installedApplications = Get-InstalledApplication @GetInstalledApplicationSplat
+
+ Write-Log -Message "Found [$($installedApplications.Count)] application(s) that matched the specified criteria [$Name]." -Source ${CmdletName}
+
+ ## Filter the results from Get-InstalledApplication
+ [Collections.ArrayList]$removeMSIApplications = New-Object -TypeName 'System.Collections.ArrayList'
+ If (($null -ne $installedApplications) -and ($installedApplications.Count)) {
+ ForEach ($installedApplication in $installedApplications) {
+ If ($installedApplication.UninstallString -notmatch 'msiexec') {
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName)] because uninstall string [$($installedApplication.UninstallString)] does not match `"msiexec`"." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ If ([string]::IsNullOrEmpty($installedApplication.ProductCode)) {
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName)] because unable to discover MSI ProductCode from application's registry Uninstall subkey [$($installedApplication.UninstallSubkey)]." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+
+ # Filter the results from Get-InstalledApplication to only those that should be uninstalled
+ If (($null -ne $FilterApplication) -and ($FilterApplication.Count)) {
+ Write-Log -Message "Filter the results to only those that should be uninstalled as specified in parameter [-FilterApplication]." -Source ${CmdletName}
+ [boolean]$addAppToRemoveList = $false
+ ForEach ($Filter in $FilterApplication) {
+ If ($Filter[2] -eq 'RegEx') {
+ If ($installedApplication.($Filter[0]) -match $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of regex match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'Contains') {
+ If ($installedApplication.($Filter[0]) -match [regex]::Escape($Filter[1])) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of contains match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'WildCard') {
+ If ($installedApplication.($Filter[0]) -like $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of wildcard match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Filter[2] -eq 'Exact') {
+ If ($installedApplication.($Filter[0]) -eq $Filter[1]) {
+ [boolean]$addAppToRemoveList = $true
+ Write-Log -Message "Preserve removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of exact match against [-FilterApplication] criteria." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Else {
+ [boolean]$addAppToRemoveList = $true
+ }
+
+ # Filter the results from Get-InstalledApplication to remove those that should never be uninstalled
+ If (($null -ne $ExcludeFromUninstall) -and ($ExcludeFromUninstall.Count)) {
+ ForEach ($Exclude in $ExcludeFromUninstall) {
+ If ($Exclude[2] -eq 'RegEx') {
+ If ($installedApplication.($Exclude[0]) -match $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of regex match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'Contains') {
+ If ($installedApplication.($Exclude[0]) -match [regex]::Escape($Exclude[1])) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of contains match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'WildCard') {
+ If ($installedApplication.($Exclude[0]) -like $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of wildcard match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ ElseIf ($Exclude[2] -eq 'Exact') {
+ If ($installedApplication.($Exclude[0]) -eq $Exclude[1]) {
+ [boolean]$addAppToRemoveList = $false
+ Write-Log -Message "Skipping removal of application [$($installedApplication.DisplayName) $($installedApplication.Version)] because of exact match against [-ExcludeFromUninstall] criteria." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+
+ If ($addAppToRemoveList) {
+ Write-Log -Message "Adding application to list for removal: [$($installedApplication.DisplayName) $($installedApplication.Version)]." -Source ${CmdletName}
+ $removeMSIApplications.Add($installedApplication)
+ }
+ }
+ }
+
+ ## Build the hashtable with the options that will be passed to Execute-MSI using splatting
+ [hashtable]$ExecuteMSISplat = @{ Action = 'Uninstall'; Path = '' }
+ If ($ContinueOnError) { $ExecuteMSISplat.Add( 'ContinueOnError', $ContinueOnError) }
+ If ($Parameters) { $ExecuteMSISplat.Add( 'Parameters', $Parameters) }
+ ElseIf ($AddParameters) { $ExecuteMSISplat.Add( 'AddParameters', $AddParameters) }
+ If ($LoggingOptions) { $ExecuteMSISplat.Add( 'LoggingOptions', $LoggingOptions) }
+ If ($LogName) { $ExecuteMSISplat.Add( 'LogName', $LogName) }
+ If ($PassThru) { $ExecuteMSISplat.Add( 'PassThru', $PassThru) }
+ If ($IncludeUpdatesAndHotfixes) { $ExecuteMSISplat.Add( 'IncludeUpdatesAndHotfixes', $IncludeUpdatesAndHotfixes) }
+
+ If (($null -ne $removeMSIApplications) -and ($removeMSIApplications.Count)) {
+ ForEach ($removeMSIApplication in $removeMSIApplications) {
+ Write-Log -Message "Remove application [$($removeMSIApplication.DisplayName) $($removeMSIApplication.Version)]." -Source ${CmdletName}
+ $ExecuteMSISplat.Path = $removeMSIApplication.ProductCode
+ If ($PassThru) {
+ [psobject[]]$ExecuteResults += Execute-MSI @ExecuteMSISplat
+ }
+ Else {
+ Execute-MSI @ExecuteMSISplat
+ }
+ }
+ }
+ Else {
+ Write-Log -Message 'No applications found for removal. Continue...' -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $ExecuteResults }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-Process
+Function Execute-Process {
+<#
+.SYNOPSIS
+ Execute a process with optional arguments, working directory, window style.
+.DESCRIPTION
+ Executes a process, e.g. a file included in the Files directory of the App Deploy Toolkit, or a file on the local machine.
+ Provides various options for handling the return codes (see Parameters).
+.PARAMETER Path
+ Path to the file to be executed. If the file is located directly in the "Files" directory of the App Deploy Toolkit, only the file name needs to be specified.
+ Otherwise, the full path of the file must be specified. If the files is in a subdirectory of "Files", use the "$dirFiles" variable as shown in the example.
+.PARAMETER Parameters
+ Arguments to be passed to the executable
+.PARAMETER SecureParameters
+ Hides all parameters passed to the executable from the Toolkit log file
+.PARAMETER WindowStyle
+ Style of the window of the process executed. Options: Normal, Hidden, Maximized, Minimized. Default: Normal.
+ Note: Not all processes honor the "Hidden" flag. If it it not working, then check the command line options for the process being executed to see it has a silent option.
+.PARAMETER CreateNoWindow
+ Specifies whether the process should be started with a new window to contain it. Default is false.
+.PARAMETER WorkingDirectory
+ The working directory used for executing the process. Defaults to the directory of the file being executed.
+.PARAMETER NoWait
+ Immediately continue after executing the process.
+.PARAMETER PassThru
+ Returns ExitCode, STDOut, and STDErr output from the process.
+.PARAMETER WaitForMsiExec
+ Sometimes an EXE bootstrapper will launch an MSI install. In such cases, this variable will ensure that
+ this function waits for the msiexec engine to become available before starting the install.
+.PARAMETER MsiExecWaitTime
+ Specify the length of time in seconds to wait for the msiexec engine to become available. Default: 600 seconds (10 minutes).
+.PARAMETER IgnoreExitCodes
+ List the exit codes to ignore.
+.PARAMETER ContinueOnError
+ Continue if an exit code is returned by the process that is not recognized by the App Deploy Toolkit. Default: $false.
+.EXAMPLE
+ Execute-Process -Path 'uninstall_flash_player_64bit.exe' -Parameters '/uninstall' -WindowStyle 'Hidden'
+ If the file is in the "Files" directory of the App Deploy Toolkit, only the file name needs to be specified.
+.EXAMPLE
+ Execute-Process -Path "$dirFiles\Bin\setup.exe" -Parameters '/S' -WindowStyle 'Hidden'
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters '/S' -IgnoreExitCodes '1,2'
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters "-s -f2`"$configToolkitLogDir\$installName.log`""
+ Launch InstallShield "setup.exe" from the ".\Files" sub-directory and force log files to the logging folder.
+.EXAMPLE
+ Execute-Process -Path 'setup.exe' -Parameters "/s /v`"ALLUSERS=1 /qn /L* \`"$configToolkitLogDir\$installName.log`"`""
+ Launch InstallShield "setup.exe" with embedded MSI and force log files to the logging folder.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [Alias('FilePath')]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [Alias('Arguments')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Parameters,
+ [Parameter(Mandatory=$false)]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Normal','Hidden','Maximized','Minimized')]
+ [Diagnostics.ProcessWindowStyle]$WindowStyle = 'Normal',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$CreateNoWindow = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [switch]$NoWait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$WaitForMsiExec = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [timespan]$MsiExecWaitTime = $(New-TimeSpan -Seconds $configMSIMutexWaitTime),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IgnoreExitCodes,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $private:returnCode = $null
+
+ ## Validate and find the fully qualified path for the $Path variable.
+ If (([IO.Path]::IsPathRooted($Path)) -and ([IO.Path]::HasExtension($Path))) {
+ Write-Log -Message "[$Path] is a valid fully qualified path, continue." -Source ${CmdletName}
+ If (-not (Test-Path -LiteralPath $Path -PathType 'Leaf' -ErrorAction 'Stop')) {
+ Throw "File [$Path] not found."
+ }
+ }
+ Else {
+ # The first directory to search will be the 'Files' subdirectory of the script directory
+ [string]$PathFolders = $dirFiles
+ # Add the current location of the console (Windows always searches this location first)
+ [string]$PathFolders = $PathFolders + ';' + (Get-Location -PSProvider 'FileSystem').Path
+ # Add the new path locations to the PATH environment variable
+ $env:PATH = $PathFolders + ';' + $env:PATH
+
+ # Get the fully qualified path for the file. Get-Command searches PATH environment variable to find this value.
+ [string]$FullyQualifiedPath = Get-Command -Name $Path -CommandType 'Application' -TotalCount 1 -Syntax -ErrorAction 'Stop'
+
+ # Revert the PATH environment variable to it's original value
+ $env:PATH = $env:PATH -replace [regex]::Escape($PathFolders + ';'), ''
+
+ If ($FullyQualifiedPath) {
+ Write-Log -Message "[$Path] successfully resolved to fully qualified path [$FullyQualifiedPath]." -Source ${CmdletName}
+ $Path = $FullyQualifiedPath
+ }
+ Else {
+ Throw "[$Path] contains an invalid path or file name."
+ }
+ }
+
+ ## Set the Working directory (if not specified)
+ If (-not $WorkingDirectory) { $WorkingDirectory = Split-Path -Path $Path -Parent -ErrorAction 'Stop' }
+
+ ## If MSI install, check to see if the MSI installer service is available or if another MSI install is already underway.
+ ## Please note that a race condition is possible after this check where another process waiting for the MSI installer
+ ## to become available grabs the MSI Installer mutex before we do. Not too concerned about this possible race condition.
+ If (($Path -match 'msiexec') -or ($WaitForMsiExec)) {
+ [boolean]$MsiExecAvailable = Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds $MsiExecWaitTime.TotalMilliseconds
+ Start-Sleep -Seconds 1
+ If (-not $MsiExecAvailable) {
+ # Default MSI exit code for install already in progress
+ [int32]$returnCode = 1618
+ Throw 'Please complete in progress MSI installation before proceeding with this install.'
+ }
+ }
+
+ Try {
+ ## Disable Zone checking to prevent warnings when running executables
+ $env:SEE_MASK_NOZONECHECKS = 1
+
+ ## Using this variable allows capture of exceptions from .NET methods. Private scope only changes value for current function.
+ $private:previousErrorActionPreference = $ErrorActionPreference
+ $ErrorActionPreference = 'Stop'
+
+ ## Define process
+ $processStartInfo = New-Object -TypeName 'System.Diagnostics.ProcessStartInfo' -ErrorAction 'Stop'
+ $processStartInfo.FileName = $Path
+ $processStartInfo.WorkingDirectory = $WorkingDirectory
+ $processStartInfo.UseShellExecute = $false
+ $processStartInfo.ErrorDialog = $false
+ $processStartInfo.RedirectStandardOutput = $true
+ $processStartInfo.RedirectStandardError = $true
+ $processStartInfo.CreateNoWindow = $CreateNoWindow
+ If ($Parameters) { $processStartInfo.Arguments = $Parameters }
+ If ($windowStyle) { $processStartInfo.WindowStyle = $WindowStyle }
+ $process = New-Object -TypeName 'System.Diagnostics.Process' -ErrorAction 'Stop'
+ $process.StartInfo = $processStartInfo
+
+ ## Add event handler to capture process's standard output redirection
+ [scriptblock]$processEventHandler = { If (-not [string]::IsNullOrEmpty($EventArgs.Data)) { $Event.MessageData.AppendLine($EventArgs.Data) } }
+ $stdOutBuilder = New-Object -TypeName 'System.Text.StringBuilder' -ArgumentList ''
+ $stdOutEvent = Register-ObjectEvent -InputObject $process -Action $processEventHandler -EventName 'OutputDataReceived' -MessageData $stdOutBuilder -ErrorAction 'Stop'
+
+ ## Start Process
+ Write-Log -Message "Working Directory is [$WorkingDirectory]." -Source ${CmdletName}
+ If ($Parameters) {
+ If ($Parameters -match '-Command \&') {
+ Write-Log -Message "Executing [$Path [PowerShell ScriptBlock]]..." -Source ${CmdletName}
+ }
+ Else {
+ If ($SecureParameters) {
+ Write-Log -Message "Executing [$Path (Parameters Hidden)]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Executing [$Path $Parameters]..." -Source ${CmdletName}
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Executing [$Path]..." -Source ${CmdletName}
+ }
+ [boolean]$processStarted = $process.Start()
+
+ If ($NoWait) {
+ Write-Log -Message 'NoWait parameter specified. Continuing without waiting for exit code...' -Source ${CmdletName}
+ }
+ Else {
+ $process.BeginOutputReadLine()
+ $stdErr = $($process.StandardError.ReadToEnd()).ToString() -replace $null,''
+
+ ## Instructs the Process component to wait indefinitely for the associated process to exit.
+ $process.WaitForExit()
+
+ ## HasExited indicates that the associated process has terminated, either normally or abnormally. Wait until HasExited returns $true.
+ While (-not ($process.HasExited)) { $process.Refresh(); Start-Sleep -Seconds 1 }
+
+ ## Get the exit code for the process
+ Try {
+ [int32]$returnCode = $process.ExitCode
+ }
+ Catch [System.Management.Automation.PSInvalidCastException] {
+ # Catch exit codes that are out of int32 range
+ [int32]$returnCode = 60013
+ }
+
+ ## Unregister standard output event to retrieve process output
+ If ($stdOutEvent) { Unregister-Event -SourceIdentifier $stdOutEvent.Name -ErrorAction 'Stop'; $stdOutEvent = $null }
+ $stdOut = $stdOutBuilder.ToString() -replace $null,''
+
+ If ($stdErr.Length -gt 0) {
+ Write-Log -Message "Standard error output from the process: $stdErr" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ Finally {
+ ## Make sure the standard output event is unregistered
+ If ($stdOutEvent) { Unregister-Event -SourceIdentifier $stdOutEvent.Name -ErrorAction 'Stop'}
+
+ ## Free resources associated with the process, this does not cause process to exit
+ If ($process) { $process.Close() }
+
+ ## Re-enable Zone checking
+ Remove-Item -LiteralPath 'env:SEE_MASK_NOZONECHECKS' -ErrorAction 'SilentlyContinue'
+
+ If ($private:previousErrorActionPreference) { $ErrorActionPreference = $private:previousErrorActionPreference }
+ }
+
+ If (-not $NoWait) {
+ ## Check to see whether we should ignore exit codes
+ $ignoreExitCodeMatch = $false
+ If ($ignoreExitCodes) {
+ # Split the processes on a comma
+ [int32[]]$ignoreExitCodesArray = $ignoreExitCodes -split ','
+ ForEach ($ignoreCode in $ignoreExitCodesArray) {
+ If ($returnCode -eq $ignoreCode) { $ignoreExitCodeMatch = $true }
+ }
+ }
+ # Or always ignore exit codes
+ If ($ContinueOnError) { $ignoreExitCodeMatch = $true }
+
+ ## If the passthru switch is specified, return the exit code and any output from process
+ If ($PassThru) {
+ Write-Log -Message "Execution completed with exit code [$returnCode]." -Source ${CmdletName}
+ [psobject]$ExecutionResults = New-Object -TypeName 'PSObject' -Property @{ ExitCode = $returnCode; StdOut = $stdOut; StdErr = $stdErr }
+ Write-Output -InputObject $ExecutionResults
+ }
+ ElseIf ($ignoreExitCodeMatch) {
+ Write-Log -Message "Execution complete and the exit code [$returncode] is being ignored." -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq 3010) -or ($returnCode -eq 1641)) {
+ Write-Log -Message "Execution completed successfully with exit code [$returnCode]. A reboot is required." -Severity 2 -Source ${CmdletName}
+ Set-Variable -Name 'msiRebootDetected' -Value $true -Scope 'Script'
+ }
+ ElseIf (($returnCode -eq 1605) -and ($Path -match 'msiexec')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the product is not currently installed." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq -2145124329) -and ($Path -match 'wusa')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the Windows Update is not applicable to this system." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf (($returnCode -eq 17025) -and ($Path -match 'fullfile')) {
+ Write-Log -Message "Execution failed with exit code [$returnCode] because the Office Update is not applicable to this system." -Severity 3 -Source ${CmdletName}
+ }
+ ElseIf ($returnCode -eq 0) {
+ Write-Log -Message "Execution completed successfully with exit code [$returnCode]." -Source ${CmdletName}
+ }
+ Else {
+ [string]$MsiExitCodeMessage = ''
+ If ($Path -match 'msiexec') {
+ [string]$MsiExitCodeMessage = Get-MsiExitCodeMessage -MsiExitCode $returnCode
+ }
+
+ If ($MsiExitCodeMessage) {
+ Write-Log -Message "Execution failed with exit code [$returnCode]: $MsiExitCodeMessage" -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Execution failed with exit code [$returnCode]." -Severity 3 -Source ${CmdletName}
+ }
+ Exit-Script -ExitCode $returnCode
+ }
+ }
+ }
+ Catch {
+ If ([string]::IsNullOrEmpty([string]$returnCode)) {
+ [int32]$returnCode = 60002
+ Write-Log -Message "Function failed, setting exit code to [$returnCode]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Execution completed with exit code [$returnCode]. Function failed. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ If ($PassThru) {
+ [psobject]$ExecutionResults = New-Object -TypeName 'PSObject' -Property @{ ExitCode = $returnCode; StdOut = If ($stdOut) { $stdOut } Else { '' }; StdErr = If ($stdErr) { $stdErr } Else { '' } }
+ Write-Output -InputObject $ExecutionResults
+ }
+ Else {
+ Exit-Script -ExitCode $returnCode
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-MsiExitCodeMessage
+Function Get-MsiExitCodeMessage {
+<#
+.SYNOPSIS
+ Get message for MSI error code
+.DESCRIPTION
+ Get message for MSI error code by reading it from msimsg.dll
+.PARAMETER MsiErrorCode
+ MSI error code
+.EXAMPLE
+ Get-MsiExitCodeMessage -MsiErrorCode 1618
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://msdn.microsoft.com/en-us/library/aa368542(v=vs.85).aspx
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [int32]$MsiExitCode
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get message for exit code [$MsiExitCode]." -Source ${CmdletName}
+ [string]$MsiExitCodeMsg = [PSADT.Msi]::GetMessageFromMsiExitCode($MsiExitCode)
+ Write-Output -InputObject $MsiExitCodeMsg
+ }
+ Catch {
+ Write-Log -Message "Failed to get message for exit code [$MsiExitCode]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-IsMutexAvailable
+Function Test-IsMutexAvailable {
+<#
+.SYNOPSIS
+ Wait, up to a timeout value, to check if current thread is able to acquire an exclusive lock on a system mutex.
+.DESCRIPTION
+ A mutex can be used to serialize applications and prevent multiple instances from being opened at the same time.
+ Wait, up to a timeout (default is 1 millisecond), for the mutex to become available for an exclusive lock.
+.PARAMETER MutexName
+ The name of the system mutex.
+.PARAMETER MutexWaitTime
+ The number of milliseconds the current thread should wait to acquire an exclusive lock of a named mutex. Default is: 1 millisecond.
+ A wait time of -1 milliseconds means to wait indefinitely. A wait time of zero does not acquire an exclusive lock but instead tests the state of the wait handle and returns immediately.
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds 500
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds (New-TimeSpan -Minutes 5).TotalMilliseconds
+.EXAMPLE
+ Test-IsMutexAvailable -MutexName 'Global\_MSIExecute' -MutexWaitTimeInMilliseconds (New-TimeSpan -Seconds 60).TotalMilliseconds
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://msdn.microsoft.com/en-us/library/aa372909(VS.85).asp
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateLength(1,260)]
+ [string]$MutexName,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({($_ -ge -1) -and ($_ -le [int32]::MaxValue)})]
+ [int32]$MutexWaitTimeInMilliseconds = 1
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Initialize Variables
+ [timespan]$MutexWaitTime = [timespan]::FromMilliseconds($MutexWaitTimeInMilliseconds)
+ If ($MutexWaitTime.TotalMinutes -ge 1) {
+ [string]$WaitLogMsg = "$($MutexWaitTime.TotalMinutes) minute(s)"
+ }
+ ElseIf ($MutexWaitTime.TotalSeconds -ge 1) {
+ [string]$WaitLogMsg = "$($MutexWaitTime.TotalSeconds) second(s)"
+ }
+ Else {
+ [string]$WaitLogMsg = "$($MutexWaitTime.Milliseconds) millisecond(s)"
+ }
+ [boolean]$IsUnhandledException = $false
+ [boolean]$IsMutexFree = $false
+ [Threading.Mutex]$OpenExistingMutex = $null
+ }
+ Process {
+ Write-Log -Message "Check to see if mutex [$MutexName] is available. Wait up to [$WaitLogMsg] for the mutex to become available." -Source ${CmdletName}
+ Try {
+ ## Using this variable allows capture of exceptions from .NET methods. Private scope only changes value for current function.
+ $private:previousErrorActionPreference = $ErrorActionPreference
+ $ErrorActionPreference = 'Stop'
+
+ ## Open the specified named mutex, if it already exists, without acquiring an exclusive lock on it. If the system mutex does not exist, this method throws an exception instead of creating the system object.
+ [Threading.Mutex]$OpenExistingMutex = [Threading.Mutex]::OpenExisting($MutexName)
+ ## Attempt to acquire an exclusive lock on the mutex. Use a Timespan to specify a timeout value after which no further attempt is made to acquire a lock on the mutex.
+ $IsMutexFree = $OpenExistingMutex.WaitOne($MutexWaitTime, $false)
+ }
+ Catch [Threading.WaitHandleCannotBeOpenedException] {
+ ## The named mutex does not exist
+ $IsMutexFree = $true
+ }
+ Catch [ObjectDisposedException] {
+ ## Mutex was disposed between opening it and attempting to wait on it
+ $IsMutexFree = $true
+ }
+ Catch [UnauthorizedAccessException] {
+ ## The named mutex exists, but the user does not have the security access required to use it
+ $IsMutexFree = $false
+ }
+ Catch [Threading.AbandonedMutexException] {
+ ## The wait completed because a thread exited without releasing a mutex. This exception is thrown when one thread acquires a mutex object that another thread has abandoned by exiting without releasing it.
+ $IsMutexFree = $true
+ }
+ Catch {
+ $IsUnhandledException = $true
+ ## Return $true, to signify that mutex is available, because function was unable to successfully complete a check due to an unhandled exception. Default is to err on the side of the mutex being available on a hard failure.
+ Write-Log -Message "Unable to check if mutex [$MutexName] is available due to an unhandled exception. Will default to return value of [$true]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ $IsMutexFree = $true
+ }
+ Finally {
+ If ($IsMutexFree) {
+ If (-not $IsUnhandledException) {
+ Write-Log -Message "Mutex [$MutexName] is available for an exclusive lock." -Source ${CmdletName}
+ }
+ }
+ Else {
+ If ($MutexName -eq 'Global\_MSIExecute') {
+ ## Get the command line for the MSI installation in progress
+ Try {
+ [string]$msiInProgressCmdLine = Get-WmiObject -Class 'Win32_Process' -Filter "name = 'msiexec.exe'" -ErrorAction 'Stop' | Where-Object { $_.CommandLine } | Select-Object -ExpandProperty 'CommandLine' | Where-Object { $_ -match '\.msi' } | ForEach-Object { $_.Trim() }
+ }
+ Catch { }
+ Write-Log -Message "Mutex [$MutexName] is not available for an exclusive lock because the following MSI installation is in progress [$msiInProgressCmdLine]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Mutex [$MutexName] is not available because another thread already has an exclusive lock on it." -Source ${CmdletName}
+ }
+ }
+
+ If (($null -ne $OpenExistingMutex) -and ($IsMutexFree)) {
+ ## Release exclusive lock on the mutex
+ $null = $OpenExistingMutex.ReleaseMutex()
+ $OpenExistingMutex.Close()
+ }
+ If ($private:previousErrorActionPreference) { $ErrorActionPreference = $private:previousErrorActionPreference }
+ }
+ }
+ End {
+ Write-Output -InputObject $IsMutexFree
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-Folder
+Function New-Folder {
+<#
+.SYNOPSIS
+ Create a new folder.
+.DESCRIPTION
+ Create a new folder if it does not exist.
+.PARAMETER Path
+ Path to the new folder to create.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ New-Folder -Path "$envWinDir\System32"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If (-not (Test-Path -LiteralPath $Path -PathType 'Container')) {
+ Write-Log -Message "Create folder [$Path]." -Source ${CmdletName}
+ $null = New-Item -Path $Path -ItemType 'Directory' -ErrorAction 'Stop'
+ }
+ Else {
+ Write-Log -Message "Folder [$Path] already exists." -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create folder [$Path]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create folder [$Path]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-Folder
+Function Remove-Folder {
+<#
+.SYNOPSIS
+ Remove folder and files if they exist.
+.DESCRIPTION
+ Remove folder and all files recursively in a given path.
+.PARAMETER Path
+ Path to the folder to remove.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-Folder -Path "$envWinDir\Downloaded Program Files"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If (Test-Path -LiteralPath $Path -PathType 'Container') {
+ Try {
+ Remove-Item -LiteralPath $Path -Force -Recurse -ErrorAction 'SilentlyContinue' -ErrorVariable '+ErrorRemoveFolder'
+ If ($ErrorRemoveFolder) {
+ Write-Log -Message "The following error(s) took place while deleting folder(s) and file(s) recursively from path [$path]. `n$(Resolve-Error -ErrorRecord $ErrorRemoveFolder)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to delete folder(s) and file(s) recursively from path [$path]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete folder(s) and file(s) recursively from path [$path]: $($_.Exception.Message)"
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Folder [$Path] does not exists..." -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Copy-File
+Function Copy-File {
+<#
+.SYNOPSIS
+ Copy a file or group of files to a destination path.
+.DESCRIPTION
+ Copy a file or group of files to a destination path.
+.PARAMETER Path
+ Path of the file to copy.
+.PARAMETER Destination
+ Destination Path of the file to copy.
+.PARAMETER Recurse
+ Copy files in subdirectories.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. This will continue the deployment script, but will not continue copying files if an error is encountered. Default is: $true.
+.PARAMETER ContinueFileCopyOnError
+ Continue copying files if an error is encountered. This will continue the deployment script and will warn about files that failed to be copied. Default is: $false.
+.EXAMPLE
+ Copy-File -Path "$dirSupportFiles\MyApp.ini" -Destination "$envWindir\MyApp.ini"
+.EXAMPLE
+ Copy-File -Path "$dirSupportFiles\*.*" -Destination "$envTemp\tempfiles"
+ Copy all of the files in a folder to a destination folder.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Path,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Destination,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueFileCopyOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $null = $fileCopyError
+ If ((-not ([IO.Path]::HasExtension($Destination))) -and (-not (Test-Path -LiteralPath $Destination -PathType 'Container'))) {
+ Write-Log -Message "Destination folder does not exist, creating destination folder [$destination]." -Source ${CmdletName}
+ $null = New-Item -Path $Destination -Type 'Directory' -Force -ErrorAction 'Stop'
+ }
+
+ $null = $FileCopyError
+ If ($Recurse) {
+ Write-Log -Message "Copy file(s) recursively in path [$path] to destination [$destination]." -Source ${CmdletName}
+ If (-not $ContinueFileCopyOnError) {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -Recurse -ErrorAction 'Stop'
+ }
+ Else {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -Recurse -ErrorAction 'SilentlyContinue' -ErrorVariable FileCopyError
+ }
+ }
+ Else {
+ Write-Log -Message "Copy file in path [$path] to destination [$destination]." -Source ${CmdletName}
+ If (-not $ContinueFileCopyOnError) {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -ErrorAction 'Stop'
+ }
+ Else {
+ $null = Copy-Item -Path $Path -Destination $Destination -Force -ErrorAction 'SilentlyContinue' -ErrorVariable FileCopyError
+ }
+ }
+
+ If ($fileCopyError) {
+ Write-Log -Message "The following warnings were detected while copying file(s) in path [$path] to destination [$destination]. `n$FileCopyError" -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "File copy completed successfully." -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to copy file(s) in path [$path] to destination [$destination]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to copy file(s) in path [$path] to destination [$destination]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-File
+Function Remove-File {
+<#
+.SYNOPSIS
+ Removes one or more items from a given path on the filesystem.
+.DESCRIPTION
+ Removes one or more items from a given path on the filesystem.
+.PARAMETER Path
+ Specifies the path on the filesystem to be resolved. The value of Path will accept wildcards. Will accept an array of values.
+.PARAMETER LiteralPath
+ Specifies the path on the filesystem to be resolved. The value of LiteralPath is used exactly as it is typed; no characters are interpreted as wildcards. Will accept an array of values.
+.PARAMETER Recurse
+ Deletes the files in the specified location(s) and in all child items of the location(s).
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-File -Path 'C:\Windows\Downloaded Program Files\Temp.inf'
+.EXAMPLE
+ Remove-File -LiteralPath 'C:\Windows\Downloaded Program Files' -Recurse
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='Path')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$Path,
+ [Parameter(Mandatory=$true,ParameterSetName='LiteralPath')]
+ [ValidateNotNullorEmpty()]
+ [string[]]$LiteralPath,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Build hashtable of parameters/value pairs to be passed to Remove-Item cmdlet
+ [hashtable]$RemoveFileSplat = @{ 'Recurse' = $Recurse
+ 'Force' = $true
+ 'ErrorVariable' = '+ErrorRemoveItem'
+ }
+ If ($ContinueOnError) {
+ $RemoveFileSplat.Add('ErrorAction', 'SilentlyContinue')
+ }
+ Else {
+ $RemoveFileSplat.Add('ErrorAction', 'Stop')
+ }
+
+ ## Resolve the specified path, if the path does not exist, display a warning instead of an error
+ If ($PSCmdlet.ParameterSetName -eq 'Path') { [string[]]$SpecifiedPath = $Path } Else { [string[]]$SpecifiedPath = $LiteralPath }
+ ForEach ($Item in $SpecifiedPath) {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'Path') {
+ [string[]]$ResolvedPath += Resolve-Path -Path $Item -ErrorAction 'Stop' | Where-Object { $_.Path } | Select-Object -ExpandProperty 'Path' -ErrorAction 'Stop'
+ }
+ Else {
+ [string[]]$ResolvedPath += Resolve-Path -LiteralPath $Item -ErrorAction 'Stop' | Where-Object { $_.Path } | Select-Object -ExpandProperty 'Path' -ErrorAction 'Stop'
+ }
+ }
+ Catch [System.Management.Automation.ItemNotFoundException] {
+ Write-Log -Message "Unable to resolve file(s) for deletion in path [$Item] because path does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to resolve file(s) for deletion in path [$Item]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to resolve file(s) for deletion in path [$Item]: $($_.Exception.Message)"
+ }
+ }
+ }
+
+ ## Delete specified path if it was successfully resolved
+ If ($ResolvedPath) {
+ ForEach ($Item in $ResolvedPath) {
+ Try {
+ If (($Recurse) -and (Test-Path -LiteralPath $Item -PathType 'Container')) {
+ Write-Log -Message "Delete file(s) recursively in path [$Item]..." -Source ${CmdletName}
+ }
+ ElseIf ((-not $Recurse) -and (Test-Path -LiteralPath $Item -PathType 'Container')) {
+ Write-Log -Message "Skipping folder [$Item] because the Recurse switch was not specified"
+ Continue
+ }
+ Else {
+ Write-Log -Message "Delete file in path [$Item]..." -Source ${CmdletName}
+ }
+ $null = Remove-Item @RemoveFileSplat -LiteralPath $Item
+ }
+ Catch {
+ Write-Log -Message "Failed to delete file(s) in path [$Item]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete file(s) in path [$Item]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+
+ If ($ErrorRemoveItem) {
+ Write-Log -Message "The following error(s) took place while removing file(s) in path [$SpecifiedPath]. `n$(Resolve-Error -ErrorRecord $ErrorRemoveItem)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Convert-RegistryPath
+Function Convert-RegistryPath {
+<#
+.SYNOPSIS
+ Converts the specified registry key path to a format that is compatible with built-in PowerShell cmdlets.
+.DESCRIPTION
+ Converts the specified registry key path to a format that is compatible with built-in PowerShell cmdlets.
+ Converts registry key hives to their full paths. Example: HKLM is converted to "Registry::HKEY_LOCAL_MACHINE".
+.PARAMETER Key
+ Path to the registry key to convert (can be a registry hive or fully qualified path)
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.EXAMPLE
+ Convert-RegistryPath -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.EXAMPLE
+ Convert-RegistryPath -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Convert the registry key hive to the full path, only match if at the beginning of the line
+ If ($Key -match '^HKLM:\\|^HKCU:\\|^HKCR:\\|^HKU:\\|^HKCC:\\|^HKPD:\\') {
+ # Converts registry paths that start with, e.g.: HKLM:\
+ $key = $key -replace '^HKLM:\\', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR:\\', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU:\\', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU:\\', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC:\\', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD:\\', 'HKEY_PERFORMANCE_DATA\'
+ }
+ ElseIf ($Key -match '^HKLM:|^HKCU:|^HKCR:|^HKU:|^HKCC:|^HKPD:') {
+ # Converts registry paths that start with, e.g.: HKLM:
+ $key = $key -replace '^HKLM:', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR:', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU:', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU:', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC:', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD:', 'HKEY_PERFORMANCE_DATA\'
+ }
+ ElseIf ($Key -match '^HKLM\\|^HKCU\\|^HKCR\\|^HKU\\|^HKCC\\|^HKPD\\') {
+ # Converts registry paths that start with, e.g.: HKLM\
+ $key = $key -replace '^HKLM\\', 'HKEY_LOCAL_MACHINE\'
+ $key = $key -replace '^HKCR\\', 'HKEY_CLASSES_ROOT\'
+ $key = $key -replace '^HKCU\\', 'HKEY_CURRENT_USER\'
+ $key = $key -replace '^HKU\\', 'HKEY_USERS\'
+ $key = $key -replace '^HKCC\\', 'HKEY_CURRENT_CONFIG\'
+ $key = $key -replace '^HKPD\\', 'HKEY_PERFORMANCE_DATA\'
+ }
+
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($key -match '^HKEY_CURRENT_USER\\') { $key = $key -replace '^HKEY_CURRENT_USER\\', "HKEY_USERS\$SID\" }
+ }
+
+ ## Append the PowerShell drive to the registry key path
+ If ($key -notmatch '^Registry::') {[string]$key = "Registry::$key" }
+
+ If($Key -match '^Registry::HKEY_LOCAL_MACHINE|^Registry::HKEY_CLASSES_ROOT|^Registry::HKEY_CURRENT_USER|^Registry::HKEY_USERS|^Registry::HKEY_CURRENT_CONFIG|^Registry::HKEY_PERFORMANCE_DATA') {
+ ## Check for expected key string format
+ Write-Log -Message "Return fully qualified registry key path [$key]." -Source ${CmdletName}
+ Write-Output -InputObject $key
+ }
+ Else{
+ # If key string is not properly formatted, throw an error
+ Throw "Unable to detect target registry hive in string [$key]."
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-RegistryValue
+Function Test-RegistryValue {
+<#
+.SYNOPSIS
+ Test if a registry value exists.
+.DESCRIPTION
+ Checks a registry key path to see if it has a value with a given name. Can correctly handle cases where a value simply has an empty or null value.
+.PARAMETER Key
+ Path of the registry key.
+.PARAMETER Value
+ Specify the registry key value to check the existence of.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.EXAMPLE
+ Test-RegistryValue -Key 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -Value 'PendingFileRenameOperations'
+.NOTES
+ To test if registry key exists, use Test-Path function like so:
+ Test-Path -Path $Key -PathType 'Container'
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ Param (
+ [Parameter(Mandatory=$true,Position=0,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]$Key,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullOrEmpty()]$Value,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ Try {
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$Key = Convert-RegistryPath -Key $Key -SID $SID
+ }
+ Else {
+ [string]$Key = Convert-RegistryPath -Key $Key
+ }
+ }
+ Catch {
+ Throw
+ }
+ [boolean]$IsRegistryValueExists = $false
+ Try {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ [string[]]$PathProperties = Get-Item -LiteralPath $Key -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Property' -ErrorAction 'Stop'
+ If ($PathProperties -contains $Value) { $IsRegistryValueExists = $true }
+ }
+ }
+ Catch { }
+
+ If ($IsRegistryValueExists) {
+ Write-Log -Message "Registry key value [$Key] [$Value] does exist." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Registry key value [$Key] [$Value] does not exist." -Source ${CmdletName}
+ }
+ Write-Output -InputObject $IsRegistryValueExists
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-RegistryKey
+Function Get-RegistryKey {
+<#
+.SYNOPSIS
+ Retrieves value names and value data for a specified registry key or optionally, a specific value.
+.DESCRIPTION
+ Retrieves value names and value data for a specified registry key or optionally, a specific value.
+ If the registry key does not exist or contain any values, the function will return $null by default. To test for existence of a registry key path, use built-in Test-Path cmdlet.
+.PARAMETER Key
+ Path of the registry key.
+.PARAMETER Value
+ Value to retrieve (optional).
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ReturnEmptyKeyIfExists
+ Return the registry key if it exists but it has no property/value pairs underneath it. Default is: $false.
+.PARAMETER DoNotExpandEnvironmentNames
+ Return unexpanded REG_EXPAND_SZ values. Default is: $false.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\{1AD147D0-BE0E-3D6C-AC11-64F6DC4163F1}'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Image File Execution Options\iexplore.exe'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKLM:Software\Wow6432Node\Microsoft\Microsoft SQL Server Compact Edition\v3.5' -Value 'Version'
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment' -Value 'Path' -DoNotExpandEnvironmentNames
+ Returns %ProgramFiles%\Java instead of C:\Program Files\Java
+.EXAMPLE
+ Get-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Example' -Value '(Default)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$ReturnEmptyKeyIfExists = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$DoNotExpandEnvironmentNames = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$key = Convert-RegistryPath -Key $key -SID $SID
+ }
+ Else {
+ [string]$key = Convert-RegistryPath -Key $key
+ }
+
+ ## Check if the registry key exists
+ If (-not (Test-Path -LiteralPath $key -ErrorAction 'Stop')) {
+ Write-Log -Message "Registry key [$key] does not exist. Return `$null." -Severity 2 -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ Else {
+ If ($PSBoundParameters.ContainsKey('Value')) {
+ Write-Log -Message "Get registry key [$key] value [$value]." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Get registry key [$key] and all property values." -Source ${CmdletName}
+ }
+
+ ## Get all property values for registry key
+ $regKeyValue = Get-ItemProperty -LiteralPath $key -ErrorAction 'Stop'
+ [int32]$regKeyValuePropertyCount = $regKeyValue | Measure-Object | Select-Object -ExpandProperty 'Count'
+
+ ## Select requested property
+ If ($PSBoundParameters.ContainsKey('Value')) {
+ # Check if registry value exists
+ [boolean]$IsRegistryValueExists = $false
+ If ($regKeyValuePropertyCount -gt 0) {
+ Try {
+ [string[]]$PathProperties = Get-Item -LiteralPath $Key -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Property' -ErrorAction 'Stop'
+ If ($PathProperties -contains $Value) { $IsRegistryValueExists = $true }
+ }
+ Catch { }
+ }
+
+ # Get the Value (do not make a strongly typed variable because it depends entirely on what kind of value is being read)
+ If ($IsRegistryValueExists) {
+ If ($DoNotExpandEnvironmentNames) { #Only useful on 'ExpandString' values
+ If ($Value -like '(Default)') {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($null,$null,[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ }
+ Else {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($Value,$null,[Microsoft.Win32.RegistryValueOptions]::DoNotExpandEnvironmentNames)
+ }
+ }
+ ElseIf ($Value -like '(Default)') {
+ $regKeyValue = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').GetValue($null)
+ }
+ Else {
+ $regKeyValue = $regKeyValue | Select-Object -ExpandProperty $Value -ErrorAction 'SilentlyContinue'
+ }
+ }
+ Else {
+ Write-Log -Message "Registry key value [$Key] [$Value] does not exist. Return `$null." -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ }
+ ## Select all properties or return empty key object
+ Else {
+ If ($regKeyValuePropertyCount -eq 0) {
+ If ($ReturnEmptyKeyIfExists) {
+ Write-Log -Message "No property values found for registry key. Return empty registry key object [$key]." -Source ${CmdletName}
+ $regKeyValue = Get-Item -LiteralPath $key -Force -ErrorAction 'Stop'
+ }
+ Else {
+ Write-Log -Message "No property values found for registry key. Return `$null." -Source ${CmdletName}
+ $regKeyValue = $null
+ }
+ }
+ }
+ }
+ Write-Output -InputObject ($regKeyValue)
+ }
+ Catch {
+ If (-not $Value) {
+ Write-Log -Message "Failed to read registry key [$key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read registry key [$key]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to read registry key [$key] value [$value]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read registry key [$key] value [$value]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-RegistryKey
+Function Set-RegistryKey {
+<#
+.SYNOPSIS
+ Creates a registry key name, value, and value data; it sets the same if it already exists.
+.DESCRIPTION
+ Creates a registry key name, value, and value data; it sets the same if it already exists.
+.PARAMETER Key
+ The registry key path.
+.PARAMETER Name
+ The value name.
+.PARAMETER Value
+ The value data.
+.PARAMETER Type
+ The type of registry value to create or set. Options: 'Binary','DWord','ExpandString','MultiString','None','QWord','String','Unknown'. Default: String.
+ Dword should be specified as a decimal.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-RegistryKey -Key $blockedAppPath -Name 'Debugger' -Value $blockedAppDebuggerValue
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE' -Name 'Application' -Type 'Dword' -Value '1'
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\RunOnce' -Name 'Debugger' -Value $blockedAppDebuggerValue -Type String
+.EXAMPLE
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Example' -Name 'Data' -Value (0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x02,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x02,0x01,0x01,0x01,0x01,0x01,0x01,0x01,0x00,0x01,0x01,0x01,0x02,0x02,0x02) -Type 'Binary'
+.EXAMPLE
+ Set-RegistryKey -Key 'HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Example' -Value '(Default)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ $Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Binary','DWord','ExpandString','MultiString','None','QWord','String','Unknown')]
+ [Microsoft.Win32.RegistryValueKind]$Type = 'String',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ [string]$RegistryValueWriteAction = 'set'
+
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$key = Convert-RegistryPath -Key $key -SID $SID
+ }
+ Else {
+ [string]$key = Convert-RegistryPath -Key $key
+ }
+
+ ## Create registry key if it doesn't exist
+ If (-not (Test-Path -LiteralPath $key -ErrorAction 'Stop')) {
+ Try {
+ Write-Log -Message "Create registry key [$key]." -Source ${CmdletName}
+ # No forward slash found in Key. Use New-Item cmdlet to create registry key
+ If ((($Key -split '/').Count - 1) -eq 0)
+ {
+ $null = New-Item -Path $key -ItemType 'Registry' -Force -ErrorAction 'Stop'
+ }
+ # Forward slash was found in Key. Use REG.exe ADD to create registry key
+ Else
+ {
+ [string]$CreateRegkeyResult = & reg.exe Add "$($Key.Substring($Key.IndexOf('::') + 2))"
+ If ($global:LastExitCode -ne 0)
+ {
+ Throw "Failed to create registry key [$Key]"
+ }
+ }
+ }
+ Catch {
+ Throw
+ }
+ }
+
+ If ($Name) {
+ ## Set registry value if it doesn't exist
+ If (-not (Get-ItemProperty -LiteralPath $key -Name $Name -ErrorAction 'SilentlyContinue')) {
+ Write-Log -Message "Set registry key value: [$key] [$name = $value]." -Source ${CmdletName}
+ $null = New-ItemProperty -LiteralPath $key -Name $name -Value $value -PropertyType $Type -ErrorAction 'Stop'
+ }
+ ## Update registry value if it does exist
+ Else {
+ [string]$RegistryValueWriteAction = 'update'
+ If ($Name -eq '(Default)') {
+ ## Set Default registry key value with the following workaround, because Set-ItemProperty contains a bug and cannot set Default registry key value
+ $null = $(Get-Item -LiteralPath $key -ErrorAction 'Stop').OpenSubKey('','ReadWriteSubTree').SetValue($null,$value)
+ }
+ Else {
+ Write-Log -Message "Update registry key value: [$key] [$name = $value]." -Source ${CmdletName}
+ $null = Set-ItemProperty -LiteralPath $key -Name $name -Value $value -ErrorAction 'Stop'
+ }
+ }
+ }
+ }
+ Catch {
+ If ($Name) {
+ Write-Log -Message "Failed to $RegistryValueWriteAction value [$value] for registry key [$key] [$name]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $RegistryValueWriteAction value [$value] for registry key [$key] [$name]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to set registry key [$key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set registry key [$key]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Remove-RegistryKey
+Function Remove-RegistryKey {
+<#
+.SYNOPSIS
+ Deletes the specified registry key or value.
+.DESCRIPTION
+ Deletes the specified registry key or value.
+.PARAMETER Key
+ Path of the registry key to delete.
+.PARAMETER Name
+ Name of the registry value to delete.
+.PARAMETER Recurse
+ Delete registry key recursively.
+.PARAMETER SID
+ The security identifier (SID) for a user. Specifying this parameter will convert a HKEY_CURRENT_USER registry key to the HKEY_USERS\$SID format.
+ Specify this parameter from the Invoke-HKCURegistrySettingsForAllUsers function to read/edit HKCU registry settings for all users on the system.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Remove-RegistryKey -Key 'HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\RunOnce'
+.EXAMPLE
+ Remove-RegistryKey -Key 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Run' -Name 'RunAppInstall'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [switch]$Recurse,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If the SID variable is specified, then convert all HKEY_CURRENT_USER key's to HKEY_USERS\$SID
+ If ($PSBoundParameters.ContainsKey('SID')) {
+ [string]$Key = Convert-RegistryPath -Key $Key -SID $SID
+ }
+ Else {
+ [string]$Key = Convert-RegistryPath -Key $Key
+ }
+
+ If (-not ($Name)) {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ If ($Recurse) {
+ Write-Log -Message "Delete registry key recursively [$Key]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Key -Force -Recurse -ErrorAction 'Stop'
+ }
+ Else {
+ If ($null -eq (Get-ChildItem -LiteralPath $Key -ErrorAction 'Stop')){
+ ## Check if there are subkeys of $Key, if so, executing Remove-Item will hang. Avoiding this with Get-ChildItem.
+ Write-Log -Message "Delete registry key [$Key]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $Key -Force -ErrorAction 'Stop'
+ }
+ Else {
+ Throw "Unable to delete child key(s) of [$Key] without [-Recurse] switch."
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Unable to delete registry key [$Key] because it does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ }
+ Else {
+ If (Test-Path -LiteralPath $Key -ErrorAction 'Stop') {
+ Write-Log -Message "Delete registry value [$Key] [$Name]." -Source ${CmdletName}
+
+ If ($Name -eq '(Default)') {
+ ## Remove (Default) registry key value with the following workaround because Remove-ItemProperty cannot remove the (Default) registry key value
+ $null = (Get-Item -LiteralPath $Key -ErrorAction 'Stop').OpenSubKey('','ReadWriteSubTree').DeleteValue('')
+ }
+ Else {
+ $null = Remove-ItemProperty -LiteralPath $Key -Name $Name -Force -ErrorAction 'Stop'
+ }
+ }
+ Else {
+ Write-Log -Message "Unable to delete registry value [$Key] [$Name] because registry key does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ Catch [System.Management.Automation.PSArgumentException] {
+ Write-Log -Message "Unable to delete registry value [$Key] [$Name] because it does not exist." -Severity 2 -Source ${CmdletName}
+ }
+ Catch {
+ If (-not ($Name)) {
+ Write-Log -Message "Failed to delete registry key [$Key]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete registry key [$Key]: $($_.Exception.Message)"
+ }
+ }
+ Else {
+ Write-Log -Message "Failed to delete registry value [$Key] [$Name]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to delete registry value [$Key] [$Name]: $($_.Exception.Message)"
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-HKCURegistrySettingsForAllUsers
+Function Invoke-HKCURegistrySettingsForAllUsers {
+<#
+.SYNOPSIS
+ Set current user registry settings for all current users and any new users in the future.
+.DESCRIPTION
+ Set HKCU registry settings for all current and future users by loading their NTUSER.dat registry hive file, and making the modifications.
+ This function will modify HKCU settings for all users even when executed under the SYSTEM account.
+ To ensure new users in the future get the registry edits, the Default User registry hive used to provision the registry for new users is modified.
+ This function can be used as an alternative to using ActiveSetup for registry settings.
+ The advantage of using this function over ActiveSetup is that a user does not have to log off and log back on before the changes take effect.
+.PARAMETER RegistrySettings
+ Script block which contains HKCU registry settings which should be modified for all users on the system. Must specify the -SID parameter for all HKCU settings.
+.PARAMETER UserProfiles
+ Specify the user profiles to modify HKCU registry settings for. Default is all user profiles except for system profiles.
+.EXAMPLE
+ [scriptblock]$HKCURegistrySettings = {
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'qmenable' -Value 0 -Type DWord -SID $UserProfile.SID
+ Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'updatereliabilitydata' -Value 1 -Type DWord -SID $UserProfile.SID
+ }
+ Invoke-HKCURegistrySettingsForAllUsers -RegistrySettings $HKCURegistrySettings
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [scriptblock]$RegistrySettings,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [psobject[]]$UserProfiles = (Get-UserProfiles)
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ForEach ($UserProfile in $UserProfiles) {
+ Try {
+ # Set the path to the user's registry hive when it is loaded
+ [string]$UserRegistryPath = "Registry::HKEY_USERS\$($UserProfile.SID)"
+
+ # Set the path to the user's registry hive file
+ [string]$UserRegistryHiveFile = Join-Path -Path $UserProfile.ProfilePath -ChildPath 'NTUSER.DAT'
+
+ # Load the User profile registry hive if it is not already loaded because the User is logged in
+ [boolean]$ManuallyLoadedRegHive = $false
+ If (-not (Test-Path -LiteralPath $UserRegistryPath)) {
+ # Load the User registry hive if the registry hive file exists
+ If (Test-Path -LiteralPath $UserRegistryHiveFile -PathType 'Leaf') {
+ Write-Log -Message "Load the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe load "`"HKEY_USERS\$($UserProfile.SID)`"" "`"$UserRegistryHiveFile`""
+
+ If ($global:LastExitCode -ne 0) {
+ Throw "Failed to load the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. Failure message [$HiveLoadResult]. Continue..."
+ }
+
+ [boolean]$ManuallyLoadedRegHive = $true
+ }
+ Else {
+ Throw "Failed to find the registry hive file [$UserRegistryHiveFile] for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. Continue..."
+ }
+ }
+ Else {
+ Write-Log -Message "The User [$($UserProfile.NTAccount)] registry hive is already loaded in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ }
+
+ ## Execute ScriptBlock which contains code to manipulate HKCU registry.
+ # Make sure read/write calls to the HKCU registry hive specify the -SID parameter or settings will not be changed for all users.
+ # Example: Set-RegistryKey -Key 'HKCU\Software\Microsoft\Office\14.0\Common' -Name 'qmenable' -Value 0 -Type DWord -SID $UserProfile.SID
+ Write-Log -Message 'Execute ScriptBlock to modify HKCU registry settings for all users.' -Source ${CmdletName}
+ & $RegistrySettings
+ }
+ Catch {
+ Write-Log -Message "Failed to modify the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)] `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Finally {
+ If ($ManuallyLoadedRegHive) {
+ Try {
+ Write-Log -Message "Unload the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe unload "`"HKEY_USERS\$($UserProfile.SID)`""
+
+ If ($global:LastExitCode -ne 0) {
+ Write-Log -Message "REG.exe failed to unload the registry hive and exited with exit code [$($global:LastExitCode)]. Performing manual garbage collection to ensure successful unloading of registry hive." -Severity 2 -Source ${CmdletName}
+ [GC]::Collect()
+ [GC]::WaitForPendingFinalizers()
+ Start-Sleep -Seconds 5
+
+ Write-Log -Message "Unload the User [$($UserProfile.NTAccount)] registry hive in path [HKEY_USERS\$($UserProfile.SID)]." -Source ${CmdletName}
+ [string]$HiveLoadResult = & reg.exe unload "`"HKEY_USERS\$($UserProfile.SID)`""
+ If ($global:LastExitCode -ne 0) { Throw "REG.exe failed with exit code [$($global:LastExitCode)] and result [$HiveLoadResult]." }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to unload the registry hive for User [$($UserProfile.NTAccount)] with SID [$($UserProfile.SID)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function ConvertTo-NTAccountOrSID
+Function ConvertTo-NTAccountOrSID {
+<#
+.SYNOPSIS
+ Convert between NT Account names and their security identifiers (SIDs).
+.DESCRIPTION
+ Specify either the NT Account name or the SID and get the other. Can also convert well known sid types.
+.PARAMETER AccountName
+ The Windows NT Account name specified in \ format.
+ Use fully qualified account names (e.g., \) instead of isolated names (e.g, ) because they are unambiguous and provide better performance.
+.PARAMETER SID
+ The Windows NT Account SID.
+.PARAMETER WellKnownSIDName
+ Specify the Well Known SID name translate to the actual SID (e.g., LocalServiceSid).
+ To get all well known SIDs available on system: [enum]::GetNames([Security.Principal.WellKnownSidType])
+.PARAMETER WellKnownToNTAccount
+ Convert the Well Known SID to an NTAccount name
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -AccountName 'CONTOSO\User1'
+ Converts a Windows NT Account name to the corresponding SID
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -SID 'S-1-5-21-1220945662-2111687655-725345543-14012660'
+ Converts a Windows NT Account SID to the corresponding NT Account Name
+.EXAMPLE
+ ConvertTo-NTAccountOrSID -WellKnownSIDName 'NetworkServiceSid'
+ Converts a Well Known SID name to a SID
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ The conversion can return an empty result if the user account does not exist anymore or if translation fails.
+ http://blogs.technet.com/b/askds/archive/2011/07/28/troubleshooting-sid-translation-failures-from-the-obvious-to-the-not-so-obvious.aspx
+.LINK
+ http://psappdeploytoolkit.com
+ List of Well Known SIDs: http://msdn.microsoft.com/en-us/library/system.security.principal.wellknownsidtype(v=vs.110).aspx
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='NTAccountToSID',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$AccountName,
+ [Parameter(Mandatory=$true,ParameterSetName='SIDToNTAccount',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$SID,
+ [Parameter(Mandatory=$true,ParameterSetName='WellKnownName',ValueFromPipelineByPropertyName=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$WellKnownSIDName,
+ [Parameter(Mandatory=$false,ParameterSetName='WellKnownName')]
+ [ValidateNotNullOrEmpty()]
+ [switch]$WellKnownToNTAccount
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Switch ($PSCmdlet.ParameterSetName) {
+ 'SIDToNTAccount' {
+ [string]$msg = "the SID [$SID] to an NT Account name"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ $NTAccountSID = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList $SID
+ $NTAccount = $NTAccountSID.Translate([Security.Principal.NTAccount])
+ Write-Output -InputObject $NTAccount
+ }
+ 'NTAccountToSID' {
+ [string]$msg = "the NT Account [$AccountName] to a SID"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ $NTAccount = New-Object -TypeName 'System.Security.Principal.NTAccount' -ArgumentList $AccountName
+ $NTAccountSID = $NTAccount.Translate([Security.Principal.SecurityIdentifier])
+ Write-Output -InputObject $NTAccountSID
+ }
+ 'WellKnownName' {
+ If ($WellKnownToNTAccount) {
+ [string]$ConversionType = 'NTAccount'
+ }
+ Else {
+ [string]$ConversionType = 'SID'
+ }
+ [string]$msg = "the Well Known SID Name [$WellKnownSIDName] to a $ConversionType"
+ Write-Log -Message "Convert $msg." -Source ${CmdletName}
+
+ # Get the SID for the root domain
+ Try {
+ $MachineRootDomain = (Get-WmiObject -Class 'Win32_ComputerSystem' -ErrorAction 'Stop').Domain.ToLower()
+ $ADDomainObj = New-Object -TypeName 'System.DirectoryServices.DirectoryEntry' -ArgumentList "LDAP://$MachineRootDomain"
+ $DomainSidInBinary = $ADDomainObj.ObjectSid
+ $DomainSid = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ($DomainSidInBinary[0], 0)
+ }
+ Catch {
+ Write-Log -Message 'Unable to get Domain SID from Active Directory. Setting Domain SID to $null.' -Severity 2 -Source ${CmdletName}
+ $DomainSid = $null
+ }
+
+ # Get the SID for the well known SID name
+ $WellKnownSidType = [Security.Principal.WellKnownSidType]::$WellKnownSIDName
+ $NTAccountSID = New-Object -TypeName 'System.Security.Principal.SecurityIdentifier' -ArgumentList ($WellKnownSidType, $DomainSid)
+
+ If ($WellKnownToNTAccount) {
+ $NTAccount = $NTAccountSID.Translate([Security.Principal.NTAccount])
+ Write-Output -InputObject $NTAccount
+ }
+ Else {
+ Write-Output -InputObject $NTAccountSID
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to convert $msg. It may not be a valid account anymore or there is some other problem. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-UserProfiles
+Function Get-UserProfiles {
+<#
+.SYNOPSIS
+ Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine and also the Default User (which does not log on).
+.DESCRIPTION
+ Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine and also the Default User (which does not log on).
+ Please note that the NTAccount property may be empty for some user profiles but the SID and ProfilePath properties will always be populated.
+.PARAMETER ExcludeNTAccount
+ Specify NT account names in Domain\Username format to exclude from the list of user profiles.
+.PARAMETER ExcludeSystemProfiles
+ Exclude system profiles: SYSTEM, LOCAL SERVICE, NETWORK SERVICE. Default is: $true.
+.PARAMETER ExcludeDefaultUser
+ Exclude the Default User. Default is: $false.
+.EXAMPLE
+ Get-UserProfiles
+ Returns the following properties for each user profile on the system: NTAccount, SID, ProfilePath
+.EXAMPLE
+ Get-UserProfiles -ExcludeNTAccount 'CONTOSO\Robot','CONTOSO\ntadmin'
+.EXAMPLE
+ [string[]]$ProfilePaths = Get-UserProfiles | Select-Object -ExpandProperty 'ProfilePath'
+ Returns the user profile path for each user on the system. This information can then be used to make modifications under the user profile on the filesystem.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string[]]$ExcludeNTAccount,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ExcludeSystemProfiles = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$ExcludeDefaultUser = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Get the User Profile Path, User Account SID, and the User Account Name for all users that log onto the machine.' -Source ${CmdletName}
+
+ ## Get the User Profile Path, User Account Sid, and the User Account Name for all users that log onto the machine
+ [string]$UserProfileListRegKey = 'Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\ProfileList'
+ [psobject[]]$UserProfiles = Get-ChildItem -LiteralPath $UserProfileListRegKey -ErrorAction 'Stop' |
+ ForEach-Object {
+ Get-ItemProperty -LiteralPath $_.PSPath -ErrorAction 'Stop' | Where-Object { ($_.ProfileImagePath) } |
+ Select-Object @{ Label = 'NTAccount'; Expression = { $(ConvertTo-NTAccountOrSID -SID $_.PSChildName).Value } }, @{ Label = 'SID'; Expression = { $_.PSChildName } }, @{ Label = 'ProfilePath'; Expression = { $_.ProfileImagePath } }
+ }
+ If ($ExcludeSystemProfiles) {
+ [string[]]$SystemProfiles = 'S-1-5-18', 'S-1-5-19', 'S-1-5-20'
+ [psobject[]]$UserProfiles = $UserProfiles | Where-Object { $SystemProfiles -notcontains $_.SID }
+ }
+ If ($ExcludeNTAccount) {
+ [psobject[]]$UserProfiles = $UserProfiles | Where-Object { $ExcludeNTAccount -notcontains $_.NTAccount }
+ }
+
+ ## Find the path to the Default User profile
+ If (-not $ExcludeDefaultUser) {
+ [string]$UserProfilesDirectory = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'ProfilesDirectory' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'ProfilesDirectory'
+
+ # On Windows Vista or higher
+ If (([version]$envOSVersion).Major -gt 5) {
+ # Path to Default User Profile directory on Windows Vista or higher: By default, C:\Users\Default
+ [string]$DefaultUserProfileDirectory = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'Default' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Default'
+ }
+ # On Windows XP or lower
+ Else {
+ # Default User Profile Name: By default, 'Default User'
+ [string]$DefaultUserProfileName = Get-ItemProperty -LiteralPath $UserProfileListRegKey -Name 'DefaultUserProfile' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'DefaultUserProfile'
+
+ # Path to Default User Profile directory: By default, C:\Documents and Settings\Default User
+ [string]$DefaultUserProfileDirectory = Join-Path -Path $UserProfilesDirectory -ChildPath $DefaultUserProfileName
+ }
+
+ ## Create a custom object for the Default User profile.
+ # Since the Default User is not an actual User account, it does not have a username or a SID.
+ # We will make up a SID and add it to the custom object so that we have a location to load the default registry hive into later on.
+ [psobject]$DefaultUserProfile = New-Object -TypeName 'PSObject' -Property @{
+ NTAccount = 'Default User'
+ SID = 'S-1-5-21-Default-User'
+ ProfilePath = $DefaultUserProfileDirectory
+ }
+
+ ## Add the Default User custom object to the User Profile list.
+ $UserProfiles += $DefaultUserProfile
+ }
+
+ Write-Output -InputObject $UserProfiles
+ }
+ Catch {
+ Write-Log -Message "Failed to create a custom object representing all user profiles on the machine. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-FileVersion
+Function Get-FileVersion {
+<#
+.SYNOPSIS
+ Gets the version of the specified file
+.DESCRIPTION
+ Gets the version of the specified file
+.PARAMETER File
+ Path of the file
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-FileVersion -File "$envProgramFilesX86\Adobe\Reader 11.0\Reader\AcroRd32.exe"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$File,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get file version info for file [$file]." -Source ${CmdletName}
+
+ If (Test-Path -LiteralPath $File -PathType 'Leaf') {
+ $fileVersion = (Get-Command -Name $file -ErrorAction 'Stop').FileVersionInfo.FileVersion
+ If ($fileVersion) {
+ ## Remove product information to leave only the file version
+ $fileVersion = ($fileVersion -split ' ' | Select-Object -First 1)
+
+ Write-Log -Message "File version is [$fileVersion]." -Source ${CmdletName}
+ Write-Output -InputObject $fileVersion
+ }
+ Else {
+ Write-Log -Message 'No file version information found.' -Source ${CmdletName}
+ }
+ }
+ Else {
+ Throw "File path [$file] does not exist."
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get file version info. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get file version info: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-Shortcut
+Function New-Shortcut {
+<#
+.SYNOPSIS
+ Creates a new .lnk or .url type shortcut
+.DESCRIPTION
+ Creates a new shortcut .lnk or .url file, with configurable options
+.PARAMETER Path
+ Path to save the shortcut
+.PARAMETER TargetPath
+ Target path or URL that the shortcut launches
+.PARAMETER Arguments
+ Arguments to be passed to the target path
+.PARAMETER IconLocation
+ Location of the icon used for the shortcut
+.PARAMETER IconIndex
+ Executables, DLLs, ICO files with multiple icons need the icon index to be specified
+.PARAMETER Description
+ Description of the shortcut
+.PARAMETER WorkingDirectory
+ Working Directory to be used for the target path
+.PARAMETER WindowStyle
+ Windows style of the application. Options: Normal, Maximized, Minimized. Default is: Normal.
+.PARAMETER RunAsAdmin
+ Set shortcut to run program as administrator. This option will prompt user to elevate when executing shortcut.
+.PARAMETER Hotkey
+ Create a Hotkey to launch the shortcut, e.g. "CTRL+SHIFT+F"
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ New-Shortcut -Path "$envProgramData\Microsoft\Windows\Start Menu\My Shortcut.lnk" -TargetPath "$envWinDir\system32\notepad.exe" -IconLocation "$envWinDir\system32\notepad.exe" -Description 'Notepad' -WorkingDirectory "$envHomeDrive\$envHomePath"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$TargetPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Arguments,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IconLocation,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$IconIndex,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Description,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$WorkingDirectory,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Normal','Maximized','Minimized')]
+ [string]$WindowStyle,
+ [Parameter(Mandatory=$false)]
+ [switch]$RunAsAdmin,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Hotkey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ If (-not $Shell) { [__comobject]$Shell = New-Object -ComObject 'WScript.Shell' -ErrorAction 'Stop' }
+ }
+ Process {
+ Try {
+ Try {
+ [IO.FileInfo]$Path = [IO.FileInfo]$Path
+ [string]$PathDirectory = $Path.DirectoryName
+
+ If (-not (Test-Path -LiteralPath $PathDirectory -PathType 'Container' -ErrorAction 'Stop')) {
+ Write-Log -Message "Create shortcut directory [$PathDirectory]." -Source ${CmdletName}
+ $null = New-Item -Path $PathDirectory -ItemType 'Directory' -Force -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create shortcut directory [$PathDirectory]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Throw
+ }
+
+ Write-Log -Message "Create shortcut [$($path.FullName)]." -Source ${CmdletName}
+ If (($path.FullName).ToLower().EndsWith('.url')) {
+ [string[]]$URLFile = '[InternetShortcut]'
+ $URLFile += "URL=$targetPath"
+ If ($iconIndex) { $URLFile += "IconIndex=$iconIndex" }
+ If ($IconLocation) { $URLFile += "IconFile=$iconLocation" }
+ $URLFile | Out-File -FilePath $path.FullName -Force -Encoding 'default' -ErrorAction 'Stop'
+ }
+ ElseIf (($path.FullName).ToLower().EndsWith('.lnk')) {
+ If (($iconLocation -and $iconIndex) -and (-not ($iconLocation.Contains(',')))) {
+ $iconLocation = $iconLocation + ",$iconIndex"
+ }
+ Switch ($windowStyle) {
+ 'Normal' { $windowStyleInt = 1 }
+ 'Maximized' { $windowStyleInt = 3 }
+ 'Minimized' { $windowStyleInt = 7 }
+ Default { $windowStyleInt = 1 }
+ }
+ $shortcut = $shell.CreateShortcut($path.FullName)
+ $shortcut.TargetPath = $targetPath
+ $shortcut.Arguments = $arguments
+ $shortcut.Description = $description
+ $shortcut.WorkingDirectory = $workingDirectory
+ $shortcut.WindowStyle = $windowStyleInt
+ If ($hotkey) {$shortcut.Hotkey = $hotkey}
+ If ($iconLocation) { $shortcut.IconLocation = $iconLocation }
+ $shortcut.Save()
+
+ ## Set shortcut to run program as administrator
+ If ($RunAsAdmin) {
+ Write-Log -Message 'Set shortcut to run program as administrator.' -Source ${CmdletName}
+ $TempFileName = [IO.Path]::GetRandomFileName()
+ $TempFile = [IO.FileInfo][IO.Path]::Combine($Path.Directory, $TempFileName)
+ $Writer = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($TempFile, ([IO.FileMode]::Create)) -ErrorAction 'Stop'
+ $Reader = $Path.OpenRead()
+ While ($Reader.Position -lt $Reader.Length) {
+ $Byte = $Reader.ReadByte()
+ If ($Reader.Position -eq 22) { $Byte = 34 }
+ $Writer.WriteByte($Byte)
+ }
+ $Reader.Close()
+ $Writer.Close()
+ $Path.Delete()
+ $null = Rename-Item -Path $TempFile -NewName $Path.Name -Force -ErrorAction 'Stop'
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create shortcut [$($path.FullName)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create shortcut [$($path.FullName)]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Execute-ProcessAsUser
+Function Execute-ProcessAsUser {
+<#
+.SYNOPSIS
+ Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.
+.DESCRIPTION
+ Execute a process with a logged in user account, by using a scheduled task, to provide interaction with user in the SYSTEM context.
+.PARAMETER UserName
+ Logged in Username under which to run the process from. Default is: The active console user. If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user.
+.PARAMETER Path
+ Path to the file being executed.
+.PARAMETER Parameters
+ Arguments to be passed to the file being executed.
+.PARAMETER SecureParameters
+ Hides all parameters passed to the executable from the Toolkit log file.
+.PARAMETER RunLevel
+ Specifies the level of user rights that Task Scheduler uses to run the task. The acceptable values for this parameter are:
+ - HighestAvailable: Tasks run by using the highest available privileges (Admin privileges for Administrators). Default Value.
+ - LeastPrivilege: Tasks run by using the least-privileged user account (LUA) privileges.
+.PARAMETER Wait
+ Wait for the process, launched by the scheduled task, to complete execution before accepting more input. Default is $false.
+.PARAMETER PassThru
+ Returns the exit code from this function or the process launched by the scheduled task.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is $true.
+.EXAMPLE
+ Execute-ProcessAsUser -UserName 'CONTOSO\User' -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & `"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait
+ Execute process under a user account by specifying a username under which to execute it.
+.EXAMPLE
+ Execute-ProcessAsUser -Path "$PSHOME\powershell.exe" -Parameters "-Command & { & `"C:\Test\Script.ps1`"; Exit `$LastExitCode }" -Wait
+ Execute process under a user account by using the default active logged in user that was detected when the toolkit was launched.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$UserName = $RunAsActiveUser.NTAccount,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Parameters = '',
+ [Parameter(Mandatory=$false)]
+ [switch]$SecureParameters = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('HighestAvailable','LeastPrivilege')]
+ [string]$RunLevel = 'HighestAvailable',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$Wait = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Initialize exit code variable
+ [int32]$executeProcessAsUserExitCode = 0
+
+ ## Confirm that the username field is not empty
+ If (-not $UserName) {
+ [int32]$executeProcessAsUserExitCode = 60009
+ Write-Log -Message "The function [${CmdletName}] has a -UserName parameter that has an empty default value because no logged in users were detected when the toolkit was launched." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The function [${CmdletName}] has a -UserName parameter that has an empty default value because no logged in users were detected when the toolkit was launched."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Confirm if the toolkit is running with administrator privileges
+ If (($RunLevel -eq 'HighestAvailable') -and (-not $IsAdmin)) {
+ [int32]$executeProcessAsUserExitCode = 60003
+ Write-Log -Message "The function [${CmdletName}] requires the toolkit to be running with Administrator privileges if the [-RunLevel] parameter is set to 'HighestAvailable'." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The function [${CmdletName}] requires the toolkit to be running with Administrator privileges if the [-RunLevel] parameter is set to 'HighestAvailable'."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Build the scheduled task XML name
+ [string]$schTaskName = "$appDeployToolkitName-ExecuteAsUser"
+
+ ## Create the temporary App Deploy Toolkit files folder if it doesn't already exist
+ If (-not (Test-Path -LiteralPath $dirAppDeployTemp -PathType 'Container')) {
+ New-Item -Path $dirAppDeployTemp -ItemType 'Directory' -Force -ErrorAction 'Stop'
+ }
+
+ ## If PowerShell.exe is being launched, then create a VBScript to launch PowerShell so that we can suppress the console window that flashes otherwise
+ If (($Path -eq 'PowerShell.exe') -or ((Split-Path -Path $Path -Leaf) -eq 'PowerShell.exe')) {
+ # Permit inclusion of double quotes in parameters
+ If ($($Parameters.Substring($Parameters.Length - 1)) -eq '"') {
+ [string]$executeProcessAsUserParametersVBS = 'chr(34) & ' + "`"$($Path)`"" + ' & chr(34) & ' + '" ' + ($Parameters -replace '"', "`" & chr(34) & `"" -replace ' & chr\(34\) & "$', '') + ' & chr(34)' }
+ Else {
+ [string]$executeProcessAsUserParametersVBS = 'chr(34) & ' + "`"$($Path)`"" + ' & chr(34) & ' + '" ' + ($Parameters -replace '"', "`" & chr(34) & `"" -replace ' & chr\(34\) & "$','') + '"' }
+ [string[]]$executeProcessAsUserScript = "strCommand = $executeProcessAsUserParametersVBS"
+ $executeProcessAsUserScript += 'set oWShell = CreateObject("WScript.Shell")'
+ $executeProcessAsUserScript += 'intReturn = oWShell.Run(strCommand, 0, true)'
+ $executeProcessAsUserScript += 'WScript.Quit intReturn'
+ $executeProcessAsUserScript | Out-File -FilePath "$dirAppDeployTemp\$($schTaskName).vbs" -Force -Encoding 'default' -ErrorAction 'SilentlyContinue'
+ $Path = 'wscript.exe'
+ $Parameters = "`"$dirAppDeployTemp\$($schTaskName).vbs`""
+ }
+
+ ## Specify the scheduled task configuration in XML format
+ [string]$xmlSchTask = @"
+
+
+
+
+
+ StopExisting
+ false
+ false
+ true
+ false
+ false
+
+ false
+ false
+
+ true
+ true
+ false
+ false
+ false
+ PT72H
+ 7
+
+
+
+ $Path
+ $Parameters
+
+
+
+
+ $UserName
+ InteractiveToken
+ $RunLevel
+
+
+
+"@
+ ## Export the XML to file
+ Try {
+ # Specify the filename to export the XML to
+ [string]$xmlSchTaskFilePath = "$dirAppDeployTemp\$schTaskName.xml"
+ [string]$xmlSchTask | Out-File -FilePath $xmlSchTaskFilePath -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ [int32]$executeProcessAsUserExitCode = 60007
+ Write-Log -Message "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]: $($_.Exception.Message)"
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Create Scheduled Task to run the process with a logged-on user account
+ If ($Parameters) {
+ If ($SecureParameters) {
+ Write-Log -Message "Create scheduled task to run the process [$Path] (Parameters Hidden) as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Create scheduled task to run the process [$Path $Parameters] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message "Create scheduled task to run the process [$Path] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/create /f /tn $schTaskName /xml `"$xmlSchTaskFilePath`"" -WindowStyle 'Hidden' -CreateNoWindow -PassThru
+ If ($schTaskResult.ExitCode -ne 0) {
+ [int32]$executeProcessAsUserExitCode = $schTaskResult.ExitCode
+ Write-Log -Message "Failed to create the scheduled task by importing the scheduled task XML file [$xmlSchTaskFilePath]." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create the scheduled task by importing the scheduled task XML file [$xmlSchTaskFilePath]."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Trigger the Scheduled Task
+ If ($Parameters) {
+ If ($SecureParameters) {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path] (Parameters Hidden) as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path $Parameters] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message "Trigger execution of scheduled task with command [$Path] as the logged-on user [$userName]..." -Source ${CmdletName}
+ }
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/run /i /tn $schTaskName" -WindowStyle 'Hidden' -CreateNoWindow -Passthru
+ If ($schTaskResult.ExitCode -ne 0) {
+ [int32]$executeProcessAsUserExitCode = $schTaskResult.ExitCode
+ Write-Log -Message "Failed to trigger scheduled task [$schTaskName]." -Severity 3 -Source ${CmdletName}
+ # Delete Scheduled Task
+ Write-Log -Message 'Delete the scheduled task which did not trigger.' -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/delete /tn $schTaskName /f" -WindowStyle 'Hidden' -CreateNoWindow -ContinueOnError $true
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger scheduled task [$schTaskName]."
+ }
+ Else {
+ Return
+ }
+ }
+
+ ## Wait for the process launched by the scheduled task to complete execution
+ If ($Wait) {
+ Write-Log -Message "Waiting for the process launched by the scheduled task [$schTaskName] to complete execution (this may take some time)..." -Source ${CmdletName}
+ Start-Sleep -Seconds 1
+ #If on Windows Vista or higer, Windows Task Scheduler 2.0 is supported. 'Schedule.Service' ComObject output is UI language independent
+ If (([version]$envOSVersion).Major -gt 5) {
+ Try {
+ [__comobject]$ScheduleService = New-Object -ComObject 'Schedule.Service' -ErrorAction Stop
+ $ScheduleService.Connect()
+ $RootFolder = $ScheduleService.GetFolder('\')
+ $Task = $RootFolder.GetTask("$schTaskName")
+ # Task State(Status) 4 = 'Running'
+ While ($Task.State -eq 4) {
+ Start-Sleep -Seconds 5
+ }
+ # Get the exit code from the process launched by the scheduled task
+ [int32]$executeProcessAsUserExitCode = $Task.LastTaskResult
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve information from Task Scheduler. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ Finally {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($ScheduleService) } Catch { }
+ }
+ }
+ #Windows Task Scheduler 1.0
+ Else {
+ While ((($exeSchTasksResult = & $exeSchTasks /query /TN $schTaskName /V /FO CSV) | ConvertFrom-CSV | Select-Object -ExpandProperty 'Status' | Select-Object -First 1) -eq 'Running') {
+ Start-Sleep -Seconds 5
+ }
+ # Get the exit code from the process launched by the scheduled task
+ [int32]$executeProcessAsUserExitCode = ($exeSchTasksResult = & $exeSchTasks /query /TN $schTaskName /V /FO CSV) | ConvertFrom-CSV | Select-Object -ExpandProperty 'Last Result' | Select-Object -First 1
+ }
+ Write-Log -Message "Exit code from process launched by scheduled task [$executeProcessAsUserExitCode]." -Source ${CmdletName}
+ }
+ Else {
+ Start-Sleep -Seconds 1
+ }
+
+ ## Delete scheduled task
+ Try {
+ Write-Log -Message "Delete scheduled task [$schTaskName]." -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/delete /tn $schTaskName /f" -WindowStyle 'Hidden' -CreateNoWindow -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to delete scheduled task [$schTaskName]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ If ($PassThru) { Write-Output -InputObject $executeProcessAsUserExitCode }
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Update-Desktop
+Function Update-Desktop {
+<#
+.SYNOPSIS
+ Refresh the Windows Explorer Shell, which causes the desktop icons and the environment variables to be reloaded.
+.DESCRIPTION
+ Refresh the Windows Explorer Shell, which causes the desktop icons and the environment variables to be reloaded.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-Desktop
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Refresh the Desktop and the Windows Explorer environment process block.' -Source ${CmdletName}
+ [PSADT.Explorer]::RefreshDesktopAndEnvironmentVariables()
+ }
+ Catch {
+ Write-Log -Message "Failed to refresh the Desktop and the Windows Explorer environment process block. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to refresh the Desktop and the Windows Explorer environment process block: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Refresh-Desktop' -Value 'Update-Desktop' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Update-SessionEnvironmentVariables
+Function Update-SessionEnvironmentVariables {
+<#
+.SYNOPSIS
+ Updates the environment variables for the current PowerShell session with any environment variable changes that may have occurred during script execution.
+.DESCRIPTION
+ Environment variable changes that take place during script execution are not visible to the current PowerShell session.
+ Use this function to refresh the current PowerShell session with all environment variable settings.
+.PARAMETER LoadLoggedOnUserEnvironmentVariables
+ If script is running in SYSTEM context, this option allows loading environment variables from the active console user. If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-SessionEnvironmentVariables
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$LoadLoggedOnUserEnvironmentVariables = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ [scriptblock]$GetEnvironmentVar = {
+ Param (
+ $Key,
+ $Scope
+ )
+ [Environment]::GetEnvironmentVariable($Key, $Scope)
+ }
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Refresh the environment variables for this PowerShell session.' -Source ${CmdletName}
+
+ If ($LoadLoggedOnUserEnvironmentVariables -and $RunAsActiveUser) {
+ [string]$CurrentUserEnvironmentSID = $RunAsActiveUser.SID
+ }
+ Else {
+ [string]$CurrentUserEnvironmentSID = [Security.Principal.WindowsIdentity]::GetCurrent().User.Value
+ }
+ [string]$MachineEnvironmentVars = 'Registry::HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment'
+ [string]$UserEnvironmentVars = "Registry::HKEY_USERS\$CurrentUserEnvironmentSID\Environment"
+
+ ## Update all session environment variables. Ordering is important here: $UserEnvironmentVars comes second so that we can override $MachineEnvironmentVars.
+ $MachineEnvironmentVars, $UserEnvironmentVars | Get-Item | Where-Object { $_ } | ForEach-Object { $envRegPath = $_.PSPath; $_ | Select-Object -ExpandProperty 'Property' | ForEach-Object { Set-Item -LiteralPath "env:$($_)" -Value (Get-ItemProperty -LiteralPath $envRegPath -Name $_).$_ } }
+
+ ## Set PATH environment variable separately because it is a combination of the user and machine environment variables
+ [string[]]$PathFolders = 'Machine', 'User' | ForEach-Object { (& $GetEnvironmentVar -Key 'PATH' -Scope $_) } | Where-Object { $_ } | ForEach-Object { $_.Trim(';') } | ForEach-Object { $_.Split(';') } | ForEach-Object { $_.Trim() } | ForEach-Object { $_.Trim('"') } | Select-Object -Unique
+ $env:PATH = $PathFolders -join ';'
+ }
+ Catch {
+ Write-Log -Message "Failed to refresh the environment variables for this PowerShell session. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to refresh the environment variables for this PowerShell session: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Refresh-SessionEnvironmentVariables' -Value 'Update-SessionEnvironmentVariables' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Get-ScheduledTask
+Function Get-ScheduledTask {
+<#
+.SYNOPSIS
+ Retrieve all details for scheduled tasks on the local computer.
+.DESCRIPTION
+ Retrieve all details for scheduled tasks on the local computer using schtasks.exe. All property names have spaces and colons removed.
+.PARAMETER TaskName
+ Specify the name of the scheduled task to retrieve details for. Uses regex match to find scheduled task.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $true.
+.EXAMPLE
+ Get-ScheduledTask
+ To display a list of all scheduled task properties.
+.EXAMPLE
+ Get-ScheduledTask | Out-GridView
+ To display a grid view of all scheduled task properties.
+.EXAMPLE
+ Get-ScheduledTask | Select-Object -Property TaskName
+ To display a list of all scheduled task names.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$TaskName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ If (-not $exeSchTasks) { [string]$exeSchTasks = "$env:WINDIR\system32\schtasks.exe" }
+ [psobject[]]$ScheduledTasks = @()
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Retrieve Scheduled Tasks...' -Source ${CmdletName}
+ [string[]]$exeSchtasksResults = & $exeSchTasks /Query /V /FO CSV
+ If ($global:LastExitCode -ne 0) { Throw "Failed to retrieve scheduled tasks using [$exeSchTasks]." }
+ [psobject[]]$SchtasksResults = $exeSchtasksResults | ConvertFrom-CSV -Header 'HostName', 'TaskName', 'Next Run Time', 'Status', 'Logon Mode', 'Last Run Time', 'Last Result', 'Author', 'Task To Run', 'Start In', 'Comment', 'Scheduled Task State', 'Idle Time', 'Power Management', 'Run As User', 'Delete Task If Not Rescheduled', 'Stop Task If Runs X Hours and X Mins', 'Schedule', 'Schedule Type', 'Start Time', 'Start Date', 'End Date', 'Days', 'Months', 'Repeat: Every', 'Repeat: Until: Time', 'Repeat: Until: Duration', 'Repeat: Stop If Still Running' -ErrorAction 'Stop'
+
+ If ($SchtasksResults) {
+ ForEach ($SchtasksResult in $SchtasksResults) {
+ If ($SchtasksResult.TaskName -match $TaskName) {
+ $SchtasksResult | Get-Member -MemberType 'Properties' |
+ ForEach -Begin {
+ [hashtable]$Task = @{}
+ } -Process {
+ ## Remove spaces and colons in property names. Do not set property value if line being processed is a column header (this will only work on English language machines).
+ ($Task.($($_.Name).Replace(' ','').Replace(':',''))) = If ($_.Name -ne $SchtasksResult.($_.Name)) { $SchtasksResult.($_.Name) }
+ } -End {
+ ## Only add task to the custom object if all property values are not empty
+ If (($Task.Values | Select-Object -Unique | Measure-Object).Count) {
+ $ScheduledTasks += New-Object -TypeName 'PSObject' -Property $Task
+ }
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to retrieve scheduled tasks. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to retrieve scheduled tasks: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-Output -InputObject $ScheduledTasks
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Block-AppExecution
+Function Block-AppExecution {
+<#
+.SYNOPSIS
+ Block the execution of an application(s)
+.DESCRIPTION
+ This function is called when you pass the -BlockExecution parameter to the Stop-RunningApplications function. It does the following:
+ 1. Makes a copy of this script in a temporary directory on the local machine.
+ 2. Checks for an existing scheduled task from previous failed installation attempt where apps were blocked and if found, calls the Unblock-AppExecution function to restore the original IFEO registry keys.
+ This is to prevent the function from overriding the backup of the original IFEO options.
+ 3. Creates a scheduled task to restore the IFEO registry key values in case the script is terminated uncleanly by calling the local temporary copy of this script with the parameter -CleanupBlockedApps.
+ 4. Modifies the "Image File Execution Options" registry key for the specified process(s) to call this script with the parameter -ShowBlockedAppDialog.
+ 5. When the script is called with those parameters, it will display a custom message to the user to indicate that execution of the application has been blocked while the installation is in progress.
+ The text of this message can be customized in the XML configuration file.
+.PARAMETER ProcessName
+ Name of the process or processes separated by commas
+.EXAMPLE
+ Block-AppExecution -ProcessName ('winword','excel')
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ It is used when the -BlockExecution parameter is specified with the Show-InstallationWelcome function to block applications.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ ## Specify process names separated by commas
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string[]]$ProcessName
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Remove illegal characters from the scheduled task arguments string
+ [char[]]$invalidScheduledTaskChars = '$', '!', '''', '"', '(', ')', ';', '\', '`', '*', '?', '{', '}', '[', ']', '<', '>', '|', '&', '%', '#', '~', '@', ' '
+ [string]$SchInstallName = $installName
+ ForEach ($invalidChar in $invalidScheduledTaskChars) { [string]$SchInstallName = $SchInstallName -replace [regex]::Escape($invalidChar),'' }
+ [string]$schTaskUnblockAppsCommand += "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$dirAppDeployTemp\$scriptFileName`" -CleanupBlockedApps -ReferredInstallName `"$SchInstallName`" -ReferredInstallTitle `"$installTitle`" -ReferredLogName `"$logName`" -AsyncToolkitLaunch"
+ ## Specify the scheduled task configuration in XML format
+ [string]$xmlUnblockAppsSchTask = @"
+
+
+
+
+
+ true
+
+
+
+
+ S-1-5-18
+
+
+
+ IgnoreNew
+ false
+ false
+ true
+ false
+ false
+
+ false
+ false
+
+ true
+ true
+ false
+ false
+ false
+ PT1H
+ 7
+
+
+
+ powershell.exe
+ $schTaskUnblockAppsCommand
+
+
+
+"@
+ }
+ Process {
+ ## Bypass if in NonInteractive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Function [${CmdletName}] [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+
+ [string]$schTaskBlockedAppsName = $installName + '_BlockedApps'
+
+ ## Delete this file if it exists as it can cause failures (it is a bug from an older version of the toolkit)
+ If (Test-Path -LiteralPath "$configToolkitTempPath\PSAppDeployToolkit" -PathType 'Leaf' -ErrorAction 'SilentlyContinue') {
+ $null = Remove-Item -LiteralPath "$configToolkitTempPath\PSAppDeployToolkit" -Force -ErrorAction 'SilentlyContinue'
+ }
+ ## Create Temporary directory (if required) and copy Toolkit so it can be called by scheduled task later if required
+ If (-not (Test-Path -LiteralPath $dirAppDeployTemp -PathType 'Container' -ErrorAction 'SilentlyContinue')) {
+ $null = New-Item -Path $dirAppDeployTemp -ItemType 'Directory' -ErrorAction 'SilentlyContinue'
+ }
+
+ Copy-Item -Path "$scriptRoot\*.*" -Destination $dirAppDeployTemp -Exclude 'thumbs.db' -Force -Recurse -ErrorAction 'SilentlyContinue'
+
+ ## Build the debugger block value script
+ [string]$debuggerBlockMessageCmd = "`"powershell.exe -ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `" & chr(34) & `"$dirAppDeployTemp\$scriptFileName`" & chr(34) & `" -ShowBlockedAppDialog -AsyncToolkitLaunch -ReferredInstallTitle `" & chr(34) & `"$installTitle`" & chr(34)"
+ [string[]]$debuggerBlockScript = "strCommand = $debuggerBlockMessageCmd"
+ $debuggerBlockScript += 'set oWShell = CreateObject("WScript.Shell")'
+ $debuggerBlockScript += 'oWShell.Run strCommand, 0, false'
+ $debuggerBlockScript | Out-File -FilePath "$dirAppDeployTemp\AppDeployToolkit_BlockAppExecutionMessage.vbs" -Force -Encoding 'default' -ErrorAction 'SilentlyContinue'
+ [string]$debuggerBlockValue = "wscript.exe `"$dirAppDeployTemp\AppDeployToolkit_BlockAppExecutionMessage.vbs`""
+
+ ## Create a scheduled task to run on startup to call this script and clean up blocked applications in case the installation is interrupted, e.g. user shuts down during installation"
+ Write-Log -Message 'Create scheduled task to cleanup blocked applications in case installation is interrupted.' -Source ${CmdletName}
+ If (Get-ScheduledTask -ContinueOnError $true | Select-Object -Property 'TaskName' | Where-Object { $_.TaskName -eq "\$schTaskBlockedAppsName" }) {
+ Write-Log -Message "Scheduled task [$schTaskBlockedAppsName] already exists." -Source ${CmdletName}
+ }
+ Else {
+ ## Export the scheduled task XML to file
+ Try {
+ # Specify the filename to export the XML to
+ [string]$xmlSchTaskFilePath = "$dirAppDeployTemp\SchTaskUnBlockApps.xml"
+ [string]$xmlUnblockAppsSchTask | Out-File -FilePath $xmlSchTaskFilePath -Force -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to export the scheduled task XML file [$xmlSchTaskFilePath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Return
+ }
+
+ ## Import the Scheduled Task XML file to create the Scheduled Task
+ [psobject]$schTaskResult = Execute-Process -Path $exeSchTasks -Parameters "/create /f /tn $schTaskBlockedAppsName /xml `"$xmlSchTaskFilePath`"" -WindowStyle 'Hidden' -CreateNoWindow -PassThru
+ If ($schTaskResult.ExitCode -ne 0) {
+ Write-Log -Message "Failed to create the scheduled task [$schTaskBlockedAppsName] by importing the scheduled task XML file [$xmlSchTaskFilePath]." -Severity 3 -Source ${CmdletName}
+ Return
+ }
+ }
+
+ [string[]]$blockProcessName = $processName
+ ## Append .exe to match registry keys
+ [string[]]$blockProcessName = $blockProcessName | ForEach-Object { $_ + '.exe' } -ErrorAction 'SilentlyContinue'
+
+ ## Enumerate each process and set the debugger value to block application execution
+ ForEach ($blockProcess in $blockProcessName) {
+ Write-Log -Message "Set the Image File Execution Option registry key to block execution of [$blockProcess]." -Source ${CmdletName}
+ Set-RegistryKey -Key (Join-Path -Path $regKeyAppExecution -ChildPath $blockProcess) -Name 'Debugger' -Value $debuggerBlockValue -ContinueOnError $true
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Unblock-AppExecution
+Function Unblock-AppExecution {
+<#
+.SYNOPSIS
+ Unblocks the execution of applications performed by the Block-AppExecution function
+.DESCRIPTION
+ This function is called by the Exit-Script function or when the script itself is called with the parameters -CleanupBlockedApps
+.EXAMPLE
+ Unblock-AppExecution
+.NOTES
+ This is an internal script function and should typically not be called directly.
+ It is used when the -BlockExecution parameter is specified with the Show-InstallationWelcome function to undo the actions performed by Block-AppExecution.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in NonInteractive mode
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Bypassing Function [${CmdletName}] [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+
+ ## Remove Debugger values to unblock processes
+ [psobject[]]$unblockProcesses = $null
+ [psobject[]]$unblockProcesses += (Get-ChildItem -LiteralPath $regKeyAppExecution -Recurse -ErrorAction 'SilentlyContinue' | ForEach-Object { Get-ItemProperty -LiteralPath $_.PSPath -ErrorAction 'SilentlyContinue'})
+ ForEach ($unblockProcess in ($unblockProcesses | Where-Object { $_.Debugger -like '*AppDeployToolkit_BlockAppExecutionMessage*' })) {
+ Write-Log -Message "Remove the Image File Execution Options registry key to unblock execution of [$($unblockProcess.PSChildName)]." -Source ${CmdletName}
+ $unblockProcess | Remove-ItemProperty -Name 'Debugger' -ErrorAction 'SilentlyContinue'
+ }
+
+ ## If block execution variable is $true, set it to $false
+ If ($BlockExecution) {
+ # Make this variable globally available so we can check whether we need to call Unblock-AppExecution
+ Set-Variable -Name 'BlockExecution' -Value $false -Scope 'Script'
+ }
+
+ ## Remove the scheduled task if it exists
+ [string]$schTaskBlockedAppsName = $installName + '_BlockedApps'
+ Try {
+ If (Get-ScheduledTask -ContinueOnError $true | Select-Object -Property 'TaskName' | Where-Object { $_.TaskName -eq "\$schTaskBlockedAppsName" }) {
+ Write-Log -Message "Delete Scheduled Task [$schTaskBlockedAppsName]." -Source ${CmdletName}
+ Execute-Process -Path $exeSchTasks -Parameters "/Delete /TN $schTaskBlockedAppsName /F"
+ }
+ }
+ Catch {
+ Write-Log -Message "Error retrieving/deleting Scheduled Task.`n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-DeferHistory
+Function Get-DeferHistory {
+<#
+.SYNOPSIS
+ Get the history of deferrals from the registry for the current application, if it exists.
+.DESCRIPTION
+ Get the history of deferrals from the registry for the current application, if it exists.
+.EXAMPLE
+ Get-DeferHistory
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message 'Get deferral history...' -Source ${CmdletName}
+ Get-RegistryKey -Key $regKeyDeferHistory -ContinueOnError $true
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-DeferHistory
+Function Set-DeferHistory {
+<#
+.SYNOPSIS
+ Set the history of deferrals in the registry for the current application.
+.DESCRIPTION
+ Set the history of deferrals in the registry for the current application.
+.EXAMPLE
+ Set-DeferHistory
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [string]$deferTimesRemaining,
+ [Parameter(Mandatory=$false)]
+ [string]$deferDeadline
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($deferTimesRemaining -and ($deferTimesRemaining -ge 0)) {
+ Write-Log -Message "Set deferral history: [DeferTimesRemaining = $deferTimesRemaining]." -Source ${CmdletName}
+ Set-RegistryKey -Key $regKeyDeferHistory -Name 'DeferTimesRemaining' -Value $deferTimesRemaining -ContinueOnError $true
+ }
+ If ($deferDeadline) {
+ Write-Log -Message "Set deferral history: [DeferDeadline = $deferDeadline]." -Source ${CmdletName}
+ Set-RegistryKey -Key $regKeyDeferHistory -Name 'DeferDeadline' -Value $deferDeadline -ContinueOnError $true
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-UniversalDate
+Function Get-UniversalDate {
+<#
+.SYNOPSIS
+ Returns the date/time for the local culture in a universal sortable date time pattern.
+.DESCRIPTION
+ Converts the current datetime or a datetime string for the current culture into a universal sortable date time pattern, e.g. 2013-08-22 11:51:52Z
+.PARAMETER DateTime
+ Specify the DateTime in the current culture.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default: $false.
+.EXAMPLE
+ Get-UniversalDate
+ Returns the current date in a universal sortable date time pattern.
+.EXAMPLE
+ Get-UniversalDate -DateTime '25/08/2013'
+ Returns the date for the current culture in a universal sortable date time pattern.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ # Get the current date
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$DateTime = ((Get-Date -Format ($culture).DateTimeFormat.FullDateTimePattern).ToString()),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If a universal sortable date time pattern was provided, remove the Z, otherwise it could get converted to a different time zone.
+ If ($DateTime -match 'Z$') { $DateTime = $DateTime -replace 'Z$', '' }
+ [datetime]$DateTime = [datetime]::Parse($DateTime, $culture)
+
+ ## Convert the date to a universal sortable date time pattern based on the current culture
+ Write-Log -Message "Convert the date [$DateTime] to a universal sortable date time pattern based on the current culture [$($culture.Name)]." -Source ${CmdletName}
+ [string]$universalDateTime = (Get-Date -Date $DateTime -Format ($culture).DateTimeFormat.UniversalSortableDateTimePattern -ErrorAction 'Stop').ToString()
+ Write-Output -InputObject $universalDateTime
+ }
+ Catch {
+ Write-Log -Message "The specified date/time [$DateTime] is not in a format recognized by the current culture [$($culture.Name)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "The specified date/time [$DateTime] is not in a format recognized by the current culture: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-RunningProcesses
+Function Get-RunningProcesses {
+<#
+.SYNOPSIS
+ Gets the processes that are running from a custom list of process objects and also adds a property called ProcessDescription.
+.DESCRIPTION
+ Gets the processes that are running from a custom list of process objects and also adds a property called ProcessDescription.
+.PARAMETER ProcessObjects
+ Custom object containing the process objects to search for.
+.EXAMPLE
+ Get-RunningProcesses
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [psobject[]]$ProcessObjects,
+ [Parameter(Mandatory=$false,Position=1)]
+ [switch]$DisableLogging
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($processObjects) {
+ [string]$runningAppsCheck = ($processObjects | ForEach-Object { $_.ProcessName }) -join ','
+ If (-not($DisableLogging)) {
+ Write-Log -Message "Check for running application(s) [$runningAppsCheck]..." -Source ${CmdletName}
+ }
+ ## Create an array of process names to search for
+ [string[]]$processNames = $processObjects | ForEach-Object { $_.ProcessName }
+
+ ## Get all running processes and escape special characters. Match against the process names to search for to find running processes.
+ [Diagnostics.Process[]]$runningProcesses = Get-Process | Where-Object { $processNames -contains $_.ProcessName }
+
+ If ($runningProcesses) {
+ [string]$runningProcessList = ($runningProcesses | ForEach-Object { $_.ProcessName } | Select-Object -Unique) -join ','
+ If (-not($DisableLogging)) {
+ Write-Log -Message "The following processes are running: [$runningProcessList]." -Source ${CmdletName}
+ Write-Log -Message 'Resolve process descriptions...' -Source ${CmdletName}
+ }
+ ## Resolve the running process names to descriptions
+ ForEach ($runningProcess in $runningProcesses) {
+ ForEach ($processObject in $processObjects) {
+ If ($runningProcess.ProcessName -eq $processObject.ProcessName) {
+ If ($processObject.ProcessDescription) {
+ # The description of the process provided as a Parameter to the function, e.g. -ProcessName "winword=Microsoft Office Word".
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $processObject.ProcessDescription -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ ElseIf ($runningProcess.Description) {
+ # If the process already has a description field specified, then use it
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $runningProcess.Description -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ # Fall back on the process name if no description is provided by the process or as a parameter to the function
+ $runningProcess | Add-Member -MemberType 'NoteProperty' -Name 'ProcessDescription' -Value $runningProcess.ProcessName -Force -PassThru -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+ }
+ }
+ Else {
+ If (-not($DisableLogging)) {
+ Write-Log -Message 'Application(s) are not running.' -Source ${CmdletName}
+ }
+ }
+ Write-Output -InputObject $runningProcesses
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationWelcome
+Function Show-InstallationWelcome {
+<#
+.SYNOPSIS
+ Show a welcome dialog prompting the user with information about the installation and actions to be performed before the installation can begin.
+.DESCRIPTION
+ The following prompts can be included in the welcome dialog:
+ a) Close the specified running applications, or optionally close the applications without showing a prompt (using the -Silent switch).
+ b) Defer the installation a certain number of times, for a certain number of days or until a deadline is reached.
+ c) Countdown until applications are automatically closed.
+ d) Prevent users from launching the specified applications while the installation is in progress.
+ Notes:
+ The process descriptions are retrieved from WMI, with a fall back on the process name if no description is available. Alternatively, you can specify the description yourself with a '=' symbol - see examples.
+ The dialog box will timeout after the timeout specified in the XML configuration file (default 1 hour and 55 minutes) to prevent SCCM installations from timing out and returning a failure code to SCCM. When the dialog times out, the script will exit and return a 1618 code (SCCM fast retry code).
+.PARAMETER CloseApps
+ Name of the process to stop (do not include the .exe). Specify multiple processes separated by a comma. Specify custom descriptions like this: "winword=Microsoft Office Word,excel=Microsoft Office Excel"
+.PARAMETER Silent
+ Stop processes without prompting the user.
+.PARAMETER CloseAppsCountdown
+ Option to provide a countdown in seconds until the specified applications are automatically closed. This only takes effect if deferral is not allowed or has expired.
+.PARAMETER ForceCloseAppsCountdown
+ Option to provide a countdown in seconds until the specified applications are automatically closed regardless of whether deferral is allowed.
+.PARAMETER PromptToSave
+ Specify whether to prompt to save working documents when the user chooses to close applications by selecting the "Close Programs" button. Option does not work in SYSTEM context unless toolkit launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds. The user will have no option but to respond to the prompt. This only takes effect if deferral is not allowed or has expired.
+.PARAMETER BlockExecution
+ Option to prevent the user from launching the process/application during the installation.
+.PARAMETER AllowDefer
+ Enables an optional defer button to allow the user to defer the installation.
+.PARAMETER AllowDeferCloseApps
+ Enables an optional defer button to allow the user to defer the installation only if there are running applications that need to be closed.
+.PARAMETER DeferTimes
+ Specify the number of times the installation can be deferred.
+.PARAMETER DeferDays
+ Specify the number of days since first run that the installation can be deferred. This is converted to a deadline.
+.PARAMETER DeferDeadline
+ Specify the deadline date until which the installation can be deferred.
+ Specify the date in the local culture if the script is intended for that same culture.
+ If the script is intended to run on EN-US machines, specify the date in the format: "08/25/2013" or "08-25-2013" or "08-25-2013 18:00:00"
+ If the script is intended for multiple cultures, specify the date in the universal sortable date/time format: "2013-08-22 11:51:52Z"
+ The deadline date will be displayed to the user in the format of their culture.
+.PARAMETER CheckDiskSpace
+ Specify whether to check if there is enough disk space for the installation to proceed.
+ If this parameter is specified without the RequiredDiskSpace parameter, the required disk space is calculated automatically based on the size of the script source and associated files.
+.PARAMETER RequiredDiskSpace
+ Specify required disk space in MB, used in combination with CheckDiskSpace.
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $true.
+.PARAMETER TopMost
+ Specifies whether the windows is the topmost window. Default: $true.
+.PARAMETER ForceCountdown
+ Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled.
+.PARAMETER CustomText
+ Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'iexplore,winword,excel'
+ Prompt the user to close Internet Explorer, Word and Excel.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -Silent
+ Close Word and Excel without prompting the user.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -BlockExecution
+ Close Word and Excel and prevent the user from launching the applications while the installation is in progress.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword=Microsoft Office Word,excel=Microsoft Office Excel' -CloseAppsCountdown 600
+ Prompt the user to close Word and Excel, with customized descriptions for the applications and automatically close the applications after 10 minutes.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,msaccess,excel' -PersistPrompt
+ Prompt the user to close Word, MSAccess and Excel.
+ By using the PersistPrompt switch, the dialog will return to the center of the screen every 10 seconds so the user cannot ignore it by dragging it aside.
+.EXAMPLE
+ Show-InstallationWelcome -AllowDefer -DeferDeadline '25/08/2013'
+ Allow the user to defer the installation until the deadline is reached.
+.EXAMPLE
+ Show-InstallationWelcome -CloseApps 'winword,excel' -BlockExecution -AllowDefer -DeferTimes 10 -DeferDeadline '25/08/2013' -CloseAppsCountdown 600
+ Close Word and Excel and prevent the user from launching the applications while the installation is in progress.
+ Allow the user to defer the installation a maximum of 10 times or until the deadline is reached, whichever happens first.
+ When deferral expires, prompt the user to close the applications and automatically close them after 10 minutes.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParametersetName='None')]
+
+ Param (
+ ## Specify process names separated by commas. Optionally specify a process description with an equals symbol, e.g. "winword=Microsoft Office Word"
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$CloseApps,
+ ## Specify whether to prompt user or force close the applications
+ [Parameter(Mandatory=$false)]
+ [switch]$Silent = $false,
+ ## Specify a countdown to display before automatically closing applications where deferral is not allowed or has expired
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CloseAppsCountdown = 0,
+ ## Specify a countdown to display before automatically closing applications whether or not deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCloseAppsCountdown = 0,
+ ## Specify whether to prompt to save working documents when the user chooses to close applications by selecting the "Close Programs" button
+ [Parameter(Mandatory=$false)]
+ [switch]$PromptToSave = $false,
+ ## Specify whether to make the prompt persist in the center of the screen every 10 seconds.
+ [Parameter(Mandatory=$false)]
+ [switch]$PersistPrompt = $false,
+ ## Specify whether to block execution of the processes during installation
+ [Parameter(Mandatory=$false)]
+ [switch]$BlockExecution = $false,
+ ## Specify whether to enable the optional defer button on the dialog box
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDefer = $false,
+ ## Specify whether to enable the optional defer button on the dialog box only if an app needs to be closed
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDeferCloseApps = $false,
+ ## Specify the number of times the deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$DeferTimes = 0,
+ ## Specify the number of days since first run that the deferral is allowed
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$DeferDays = 0,
+ ## Specify the deadline (in format dd/mm/yyyy) for which deferral will expire as an option
+ [Parameter(Mandatory=$false)]
+ [string]$DeferDeadline = '',
+ ## Specify whether to check if there is enough disk space for the installation to proceed. If this parameter is specified without the RequiredDiskSpace parameter, the required disk space is calculated automatically based on the size of the script source and associated files.
+ [Parameter(ParameterSetName = "CheckDiskSpaceParameterSet",Mandatory=$true)]
+ [ValidateScript({$_.IsPresent -eq ($true -or $false)})]
+ [switch]$CheckDiskSpace,
+ ## Specify required disk space in MB, used in combination with $CheckDiskSpace.
+ [Parameter(ParameterSetName = "CheckDiskSpaceParameterSet",Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$RequiredDiskSpace = 0,
+ ## Specify whether to minimize other windows when displaying prompt
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $true,
+ ## Specifies whether the window is the topmost window
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true,
+ ## Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCountdown = 0,
+ ## Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+ [Parameter(Mandatory=$false)]
+ [switch]$CustomText = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## If running in NonInteractive mode, force the processes to close silently
+ If ($deployModeNonInteractive) { $Silent = $true }
+
+ ## If using Zero-Config MSI Deployment, append any executables found in the MSI to the CloseApps list
+ If ($useDefaultMsi) { $CloseApps = "$CloseApps,$defaultMsiExecutablesList" }
+
+ ## Check disk space requirements if specified
+ If ($CheckDiskSpace) {
+ Write-Log -Message 'Evaluate disk space requirements.' -Source ${CmdletName}
+ [double]$freeDiskSpace = Get-FreeDiskSpace
+ If ($RequiredDiskSpace -eq 0) {
+ Try {
+ # Determine the size of the Files folder
+ $fso = New-Object -ComObject 'Scripting.FileSystemObject' -ErrorAction 'Stop'
+ $RequiredDiskSpace = [math]::Round((($fso.GetFolder($scriptParentPath).Size) / 1MB))
+ }
+ Catch {
+ Write-Log -Message "Failed to calculate disk space requirement from source files. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ If ($freeDiskSpace -lt $RequiredDiskSpace) {
+ Write-Log -Message "Failed to meet minimum disk space requirement. Space Required [$RequiredDiskSpace MB], Space Available [$freeDiskSpace MB]." -Severity 3 -Source ${CmdletName}
+ If (-not $Silent) {
+ Show-InstallationPrompt -Message ($configDiskSpaceMessage -f $installTitle, $RequiredDiskSpace, ($freeDiskSpace)) -ButtonRightText 'OK' -Icon 'Error'
+ }
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ Else {
+ Write-Log -Message 'Successfully passed minimum disk space requirement check.' -Source ${CmdletName}
+ }
+ }
+
+ If ($CloseApps) {
+ ## Create a Process object with custom descriptions where they are provided (split on an '=' sign)
+ [psobject[]]$processObjects = @()
+ # Split multiple processes on a comma, then split on equal sign, then create custom object with process name and description
+ ForEach ($process in ($CloseApps -split ',' | Where-Object { $_ })) {
+ If ($process.Contains('=')) {
+ [string[]]$ProcessSplit = $process -split '='
+ $processObjects += New-Object -TypeName 'PSObject' -Property @{
+ ProcessName = $ProcessSplit[0]
+ ProcessDescription = $ProcessSplit[1]
+ }
+ }
+ Else {
+ [string]$ProcessInfo = $process
+ $processObjects += New-Object -TypeName 'PSObject' -Property @{
+ ProcessName = $process
+ ProcessDescription = ''
+ }
+ }
+ }
+ }
+
+ ## Check Deferral history and calculate remaining deferrals
+ If (($allowDefer) -or ($AllowDeferCloseApps)) {
+ # Set $allowDefer to true if $AllowDeferCloseApps is true
+ $allowDefer = $true
+
+ # Get the deferral history from the registry
+ $deferHistory = Get-DeferHistory
+ $deferHistoryTimes = $deferHistory | Select-Object -ExpandProperty 'DeferTimesRemaining' -ErrorAction 'SilentlyContinue'
+ $deferHistoryDeadline = $deferHistory | Select-Object -ExpandProperty 'DeferDeadline' -ErrorAction 'SilentlyContinue'
+
+ # Reset Switches
+ $checkDeferDays = $false
+ $checkDeferDeadline = $false
+ If ($DeferDays -ne 0) { $checkDeferDays = $true }
+ If ($DeferDeadline) { $checkDeferDeadline = $true }
+ If ($DeferTimes -ne 0) {
+ If ($deferHistoryTimes -ge 0) {
+ Write-Log -Message "Defer history shows [$($deferHistory.DeferTimesRemaining)] deferrals remaining." -Source ${CmdletName}
+ $DeferTimes = $deferHistory.DeferTimesRemaining - 1
+ }
+ Else {
+ $DeferTimes = $DeferTimes - 1
+ }
+ Write-Log -Message "User has [$deferTimes] deferrals remaining." -Source ${CmdletName}
+ If ($DeferTimes -lt 0) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ Else {
+ If (Test-Path -LiteralPath 'variable:deferTimes') { Remove-Variable -Name 'deferTimes' }
+ $DeferTimes = $null
+ }
+ If ($checkDeferDays -and $allowDefer) {
+ If ($deferHistoryDeadline) {
+ Write-Log -Message "Defer history shows a deadline date of [$deferHistoryDeadline]." -Source ${CmdletName}
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime $deferHistoryDeadline
+ }
+ Else {
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime (Get-Date -Date ((Get-Date).AddDays($deferDays)) -Format ($culture).DateTimeFormat.FullDateTimePattern)
+ }
+ Write-Log -Message "User has until [$deferDeadlineUniversal] before deferral expires." -Source ${CmdletName}
+ If ((Get-UniversalDate) -gt $deferDeadlineUniversal) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ If ($checkDeferDeadline -and $allowDefer) {
+ # Validate Date
+ Try {
+ [string]$deferDeadlineUniversal = Get-UniversalDate -DateTime $deferDeadline -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Date is not in the correct format for the current culture. Type the date in the current locale format, such as 20/08/2014 (Europe) or 08/20/2014 (United States). If the script is intended for multiple cultures, specify the date in the universal sortable date/time format, e.g. '2013-08-22 11:51:52Z'. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Throw "Date is not in the correct format for the current culture. Type the date in the current locale format, such as 20/08/2014 (Europe) or 08/20/2014 (United States). If the script is intended for multiple cultures, specify the date in the universal sortable date/time format, e.g. '2013-08-22 11:51:52Z': $($_.Exception.Message)"
+ }
+ Write-Log -Message "User has until [$deferDeadlineUniversal] remaining." -Source ${CmdletName}
+ If ((Get-UniversalDate) -gt $deferDeadlineUniversal) {
+ Write-Log -Message 'Deferral has expired.' -Source ${CmdletName}
+ $AllowDefer = $false
+ }
+ }
+ }
+ If (($deferTimes -lt 0) -and (-not ($deferDeadlineUniversal))) { $AllowDefer = $false }
+
+ ## Prompt the user to close running applications and optionally defer if enabled
+ If (-not ($deployModeSilent) -and (-not ($silent))) {
+ If ($forceCloseAppsCountdown -gt 0) {
+ # Keep the same variable for countdown to simplify the code:
+ $closeAppsCountdown = $forceCloseAppsCountdown
+ # Change this variable to a boolean now to switch the countdown on even with deferral
+ [boolean]$forceCloseAppsCountdown = $true
+ }
+ ElseIf ($forceCountdown -gt 0){
+ # Keep the same variable for countdown to simplify the code:
+ $closeAppsCountdown = $forceCountdown
+ # Change this variable to a boolean now to switch the countdown on
+ [boolean]$forceCountdown = $true
+ }
+ Set-Variable -Name 'closeAppsCountdownGlobal' -Value $closeAppsCountdown -Scope 'Script'
+
+ While ((Get-RunningProcesses -ProcessObjects $processObjects -OutVariable 'runningProcesses') -or (($promptResult -ne 'Defer') -and ($promptResult -ne 'Close'))) {
+ [string]$runningProcessDescriptions = ($runningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ # Check if we need to prompt the user to defer, to defer and close apps, or not to prompt them at all
+ If ($allowDefer) {
+ # If there is deferral and closing apps is allowed but there are no apps to be closed, break the while loop
+ If ($AllowDeferCloseApps -and (-not $runningProcessDescriptions)) {
+ Break
+ }
+ # Otherwise, as long as the user has not selected to close the apps or the processes are still running and the user has not selected to continue, prompt user to close running processes with deferral
+ ElseIf (($promptResult -ne 'Close') -or (($runningProcessDescriptions) -and ($promptResult -ne 'Continue'))) {
+ [string]$promptResult = Show-WelcomePrompt -ProcessDescriptions $runningProcessDescriptions -CloseAppsCountdown $closeAppsCountdownGlobal -ForceCloseAppsCountdown $forceCloseAppsCountdown -ForceCountdown $forceCountdown -PersistPrompt $PersistPrompt -AllowDefer -DeferTimes $deferTimes -DeferDeadline $deferDeadlineUniversal -MinimizeWindows $MinimizeWindows -CustomText:$CustomText -TopMost $TopMost
+ }
+ }
+ # If there is no deferral and processes are running, prompt the user to close running processes with no deferral option
+ ElseIf (($runningProcessDescriptions) -or ($forceCountdown)) {
+ [string]$promptResult = Show-WelcomePrompt -ProcessDescriptions $runningProcessDescriptions -CloseAppsCountdown $closeAppsCountdownGlobal -ForceCloseAppsCountdown $forceCloseAppsCountdown -ForceCountdown $forceCountdown -PersistPrompt $PersistPrompt -MinimizeWindows $minimizeWindows -CustomText:$CustomText -TopMost $TopMost
+ }
+ # If there is no deferral and no processes running, break the while loop
+ Else {
+ Break
+ }
+
+ # If the user has clicked OK, wait a few seconds for the process to terminate before evaluating the running processes again
+ If ($promptResult -eq 'Continue') {
+ Write-Log -Message 'User selected to continue...' -Source ${CmdletName}
+ Start-Sleep -Seconds 2
+
+ # Break the while loop if there are no processes to close and the user has clicked OK to continue
+ If (-not $runningProcesses) { Break }
+ }
+ # Force the applications to close
+ ElseIf ($promptResult -eq 'Close') {
+ Write-Log -Message 'User selected to force the application(s) to close...' -Source ${CmdletName}
+ If (($PromptToSave) -and ($SessionZero -and (-not $IsProcessUserInteractive))) {
+ Write-Log -Message 'Specified [-PromptToSave] option will not be available because current process is running in session zero and is not interactive.' -Severity 2 -Source ${CmdletName}
+ }
+
+ ForEach ($runningProcess in $runningProcesses) {
+ [psobject[]]$AllOpenWindowsForRunningProcess = Get-WindowTitle -GetAllWindowTitles -DisableFunctionLogging | Where-Object { $_.ParentProcess -eq $runningProcess.Name }
+ # If the PromptToSave parameter was specified and the process has a window open, then prompt the user to save work if there is work to be saved when closing window
+ If (($PromptToSave) -and (-not ($SessionZero -and (-not $IsProcessUserInteractive))) -and ($AllOpenWindowsForRunningProcess) -and ($runningProcess.MainWindowHandle -ne [IntPtr]::Zero)) {
+ [timespan]$PromptToSaveTimeout = New-TimeSpan -Seconds $configInstallationPromptToSave
+ [Diagnostics.StopWatch]$PromptToSaveStopWatch = [Diagnostics.StopWatch]::StartNew()
+ $PromptToSaveStopWatch.Reset()
+ ForEach ($OpenWindow in $AllOpenWindowsForRunningProcess) {
+ Try {
+ Write-Log -Message "Stop process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)] and prompt to save if there is work to be saved (timeout in [$configInstallationPromptToSave] seconds)..." -Source ${CmdletName}
+ [boolean]$IsBringWindowToFrontSuccess = [PSADT.UiAutomation]::BringWindowToFront($OpenWindow.WindowHandle)
+ [boolean]$IsCloseWindowCallSuccess = $runningProcess.CloseMainWindow()
+ If (-not $IsCloseWindowCallSuccess) {
+ Write-Log -Message "Failed to call the CloseMainWindow() method on process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)] because the main window may be disabled due to a modal dialog being shown." -Severity 3 -Source ${CmdletName}
+ }
+ Else {
+ $PromptToSaveStopWatch.Start()
+ Do {
+ [boolean]$IsWindowOpen = [boolean](Get-WindowTitle -GetAllWindowTitles -DisableFunctionLogging | Where-Object { $_.WindowHandle -eq $OpenWindow.WindowHandle })
+ If (-not $IsWindowOpen) { Break }
+ Start-Sleep -Seconds 3
+ } While (($IsWindowOpen) -and ($PromptToSaveStopWatch.Elapsed -lt $PromptToSaveTimeout))
+ $PromptToSaveStopWatch.Reset()
+ If ($IsWindowOpen) {
+ Write-Log -Message "Exceeded the [$configInstallationPromptToSave] seconds timeout value for the user to save work associated with process [$($runningProcess.Name)] with window title [$($OpenWindow.WindowTitle)]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Window [$($OpenWindow.WindowTitle)] for process [$($runningProcess.Name)] was successfully closed." -Source ${CmdletName}
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to close window [$($OpenWindow.WindowTitle)] for process [$($runningProcess.Name)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ Continue
+ }
+ Finally {
+ $runningProcess.Refresh()
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Stop process $($runningProcess.Name)..." -Source ${CmdletName}
+ Stop-Process -Id $runningProcess.Id -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ Start-Sleep -Seconds 2
+ }
+ # Stop the script (if not actioned before the timeout value)
+ ElseIf ($promptResult -eq 'Timeout') {
+ Write-Log -Message 'Installation not actioned before the timeout value.' -Source ${CmdletName}
+ $BlockExecution = $false
+
+ If (($deferTimes) -or ($deferDeadlineUniversal)) {
+ Set-DeferHistory -DeferTimesRemaining $DeferTimes -DeferDeadline $deferDeadlineUniversal
+ }
+ ## Dispose the welcome prompt timer here because if we dispose it within the Show-WelcomePrompt function we risk resetting the timer and missing the specified timeout period
+ If ($script:welcomeTimer) {
+ Try {
+ $script:welcomeTimer.Dispose()
+ $script:welcomeTimer = $null
+ }
+ Catch { }
+ }
+
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+
+ Exit-Script -ExitCode $configInstallationUIExitCode
+ }
+ # Stop the script (user chose to defer)
+ ElseIf ($promptResult -eq 'Defer') {
+ Write-Log -Message 'Installation deferred by the user.' -Source ${CmdletName}
+ $BlockExecution = $false
+
+ Set-DeferHistory -DeferTimesRemaining $DeferTimes -DeferDeadline $deferDeadlineUniversal
+
+ # Restore minimized windows
+ $null = $shellApp.UndoMinimizeAll()
+
+ Exit-Script -ExitCode $configInstallationDeferExitCode
+ }
+ }
+ }
+
+ ## Force the processes to close silently, without prompting the user
+ If (($Silent -or $deployModeSilent) -and $CloseApps) {
+ [array]$runningProcesses = $null
+ [array]$runningProcesses = Get-RunningProcesses $processObjects
+ If ($runningProcesses) {
+ [string]$runningProcessDescriptions = ($runningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ Write-Log -Message "Force close application(s) [$($runningProcessDescriptions)] without prompting user." -Source ${CmdletName}
+ $runningProcesses | Stop-Process -Force -ErrorAction 'SilentlyContinue'
+ Start-Sleep -Seconds 2
+ }
+ }
+
+ ## Force nsd.exe to stop if Notes is one of the required applications to close
+ If (($processObjects | Select-Object -ExpandProperty 'ProcessName') -contains 'notes') {
+ ## Get the path where Notes is installed
+ [string]$notesPath = Get-Item -LiteralPath $regKeyLotusNotes -ErrorAction 'SilentlyContinue' | Get-ItemProperty | Select-Object -ExpandProperty 'Path'
+
+ ## Ensure we aren't running as a Local System Account and Notes install directory was found
+ If ((-not $IsLocalSystemAccount) -and ($notesPath)) {
+ # Get a list of all the executables in the Notes folder
+ [string[]]$notesPathExes = Get-ChildItem -LiteralPath $notesPath -Filter '*.exe' -Recurse | Select-Object -ExpandProperty 'BaseName' | Sort-Object
+ ## Check for running Notes executables and run NSD if any are found
+ $notesPathExes | ForEach-Object {
+ If ((Get-Process | Select-Object -ExpandProperty 'Name') -contains $_) {
+ [string]$notesNSDExecutable = Join-Path -Path $notesPath -ChildPath 'NSD.exe'
+ Try {
+ If (Test-Path -LiteralPath $notesNSDExecutable -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "Execute [$notesNSDExecutable] with the -kill argument..." -Source ${CmdletName}
+ [Diagnostics.Process]$notesNSDProcess = Start-Process -FilePath $notesNSDExecutable -ArgumentList '-kill' -WindowStyle 'Hidden' -PassThru -ErrorAction 'SilentlyContinue'
+
+ If (-not ($notesNSDProcess.WaitForExit(10000))) {
+ Write-Log -Message "[$notesNSDExecutable] did not end in a timely manner. Force terminate process." -Source ${CmdletName}
+ Stop-Process -Name 'NSD' -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to launch [$notesNSDExecutable]. `n$(Resolve-Error)" -Source ${CmdletName}
+ }
+
+ Write-Log -Message "[$notesNSDExecutable] returned exit code [$($notesNSDProcess.ExitCode)]." -Source ${CmdletName}
+
+ # Force NSD process to stop in case the previous command was not successful
+ Stop-Process -Name 'NSD' -Force -ErrorAction 'SilentlyContinue'
+ }
+ }
+ }
+
+ # Strip all Notes processes from the process list except notes.exe, because the other notes processes (e.g. notes2.exe) may be invoked by the Notes installation, so we don't want to block their execution.
+ If ($notesPathExes) {
+ [array]$processesIgnoringNotesExceptions = Compare-Object -ReferenceObject ($processObjects | Select-Object -ExpandProperty 'ProcessName' | Sort-Object) -DifferenceObject $notesPathExes -IncludeEqual | Where-Object { ($_.SideIndicator -eq '<=') -or ($_.InputObject -eq 'notes') } | Select-Object -ExpandProperty 'InputObject'
+ [array]$processObjects = $processObjects | Where-Object { $processesIgnoringNotesExceptions -contains $_.ProcessName }
+ }
+ }
+
+ ## If block execution switch is true, call the function to block execution of these processes
+ If ($BlockExecution) {
+ # Make this variable globally available so we can check whether we need to call Unblock-AppExecution
+ Set-Variable -Name 'BlockExecution' -Value $BlockExecution -Scope 'Script'
+ Write-Log -Message '[-BlockExecution] parameter specified.' -Source ${CmdletName}
+ Block-AppExecution -ProcessName ($processObjects | Select-Object -ExpandProperty 'ProcessName')
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-WelcomePrompt
+Function Show-WelcomePrompt {
+<#
+.SYNOPSIS
+ Called by Show-InstallationWelcome to prompt the user to optionally do the following:
+ 1) Close the specified running applications.
+ 2) Provide an option to defer the installation.
+ 3) Show a countdown before applications are automatically closed.
+.DESCRIPTION
+ The user is presented with a Windows Forms dialog box to close the applications themselves and continue or to have the script close the applications for them.
+ If the -AllowDefer option is set to true, an optional "Defer" button will be shown to the user. If they select this option, the script will exit and return a 1618 code (SCCM fast retry code).
+ The dialog box will timeout after the timeout specified in the XML configuration file (default 1 hour and 55 minutes) to prevent SCCM installations from timing out and returning a failure code to SCCM. When the dialog times out, the script will exit and return a 1618 code (SCCM fast retry code).
+.PARAMETER ProcessDescriptions
+ The descriptive names of the applications that are running and need to be closed.
+.PARAMETER CloseAppsCountdown
+ Specify the countdown time in seconds before running applications are automatically closed when deferral is not allowed or expired.
+.PARAMETER ForceCloseAppsCountdown
+ Specify whether to show the countdown regardless of whether deferral is allowed.
+.PARAMETER PersistPrompt
+ Specify whether to make the prompt persist in the center of the screen every 10 seconds.
+.PARAMETER AllowDefer
+ Specify whether to provide an option to defer the installation.
+.PARAMETER DeferTimes
+ Specify the number of times the user is allowed to defer.
+.PARAMETER DeferDeadline
+ Specify the deadline date before the user is allowed to defer.
+.PARAMETER MinimizeWindows
+ Specifies whether to minimize other windows when displaying prompt. Default: $true.
+.PARAMETER TopMost
+ Specifies whether the windows is the topmost window. Default: $true.
+.PARAMETER ForceCountdown
+ Specify a countdown to display before automatically proceeding with the installation when a deferral is enabled.
+.PARAMETER CustomText
+ Specify whether to display a custom message specified in the XML file. Custom message must be populated for each language section in the XML.
+.EXAMPLE
+ Show-WelcomePrompt -ProcessDescriptions 'Lotus Notes, Microsoft Word' -CloseAppsCountdown 600 -AllowDefer -DeferTimes 10
+.NOTES
+ This is an internal script function and should typically not be called directly. It is used by the Show-InstallationWelcome prompt to display a custom prompt.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [string]$ProcessDescriptions,
+ [Parameter(Mandatory=$false)]
+ [int32]$CloseAppsCountdown,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ForceCloseAppsCountdown,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$PersistPrompt = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowDefer = $false,
+ [Parameter(Mandatory=$false)]
+ [string]$DeferTimes,
+ [Parameter(Mandatory=$false)]
+ [string]$DeferDeadline,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$MinimizeWindows = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$ForceCountdown = 0,
+ [Parameter(Mandatory=$false)]
+ [switch]$CustomText = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Reset switches
+ [boolean]$showCloseApps = $false
+ [boolean]$showDefer = $false
+ [boolean]$persistWindow = $false
+
+ ## Reset times
+ [datetime]$startTime = Get-Date
+ [datetime]$countdownTime = $startTime
+
+ ## Check if the countdown was specified
+ If ($CloseAppsCountdown) {
+ If ($CloseAppsCountdown -gt $configInstallationUITimeout) {
+ Throw 'The close applications countdown time cannot be longer than the timeout specified in the XML configuration for installation UI dialogs to timeout.'
+ }
+ }
+
+ ## Initial form layout: Close Applications / Allow Deferral
+ If ($processDescriptions) {
+ Write-Log -Message "Prompt user to close application(s) [$processDescriptions]..." -Source ${CmdletName}
+ $showCloseApps = $true
+ }
+ If (($allowDefer) -and (($deferTimes -ge 0) -or ($deferDeadline))) {
+ Write-Log -Message 'User has the option to defer.' -Source ${CmdletName}
+ $showDefer = $true
+ If ($deferDeadline) {
+ # Remove the Z from universal sortable date time format, otherwise it could be converted to a different time zone
+ $deferDeadline = $deferDeadline -replace 'Z',''
+ # Convert the deadline date to a string
+ [string]$deferDeadline = (Get-Date -Date $deferDeadline).ToString()
+ }
+ }
+
+ ## If deferral is being shown and 'close apps countdown' or 'persist prompt' was specified, enable those features.
+ If (-not $showDefer) {
+ If ($closeAppsCountdown -gt 0) {
+ Write-Log -Message "Close applications countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+ }
+ If ($showDefer) {
+ If ($persistPrompt) { $persistWindow = $true }
+ }
+ ## If 'force close apps countdown' was specified, enable that feature.
+ If ($forceCloseAppsCountdown -eq $true) {
+ Write-Log -Message "Close applications countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+ ## If 'force countdown' was specified, enable that feature.
+ If ($forceCountdown -eq $true) {
+ Write-Log -Message "Countdown has [$closeAppsCountdown] seconds remaining." -Source ${CmdletName}
+ $showCountdown = $true
+ }
+
+ [string[]]$processDescriptions = $processDescriptions -split ','
+ [Windows.Forms.Application]::EnableVisualStyles()
+
+ $formWelcome = New-Object -TypeName 'System.Windows.Forms.Form'
+ $pictureBanner = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $labelAppName = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelCountdown = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelDefer = New-Object -TypeName 'System.Windows.Forms.Label'
+ $listBoxCloseApps = New-Object -TypeName 'System.Windows.Forms.ListBox'
+ $buttonContinue = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonDefer = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonCloseApps = New-Object -TypeName 'System.Windows.Forms.Button'
+ $buttonAbort = New-Object -TypeName 'System.Windows.Forms.Button'
+ $formWelcomeWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+ $flowLayoutPanel = New-Object -TypeName 'System.Windows.Forms.FlowLayoutPanel'
+ $panelButtons = New-Object -TypeName 'System.Windows.Forms.Panel'
+ $toolTip = New-Object -TypeName 'System.Windows.Forms.ToolTip'
+
+ ## Remove all event handlers from the controls
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ Try {
+ $labelAppName.remove_Click($handler_labelAppName_Click)
+ $labelDefer.remove_Click($handler_labelDefer_Click)
+ $buttonCloseApps.remove_Click($buttonCloseApps_OnClick)
+ $buttonContinue.remove_Click($buttonContinue_OnClick)
+ $buttonDefer.remove_Click($buttonDefer_OnClick)
+ $buttonAbort.remove_Click($buttonAbort_OnClick)
+ $script:welcomeTimer.remove_Tick($timer_Tick)
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $timerRunningProcesses.remove_Tick($timerRunningProcesses_Tick)
+ $formWelcome.remove_Load($Form_StateCorrection_Load)
+ $formWelcome.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formWelcome.WindowState = 'Normal'
+ $formWelcome.AutoSize = $true
+ $formWelcome.TopMost = $TopMost
+ $formWelcome.BringToFront()
+ # Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formWelcomeStartPosition' -Value $formWelcome.Location -Scope 'Script'
+
+ ## Initialize the countdown timer
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($CloseAppsCountdown)
+ $script:welcomeTimer.Start()
+
+ ## Set up the form
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ [string]$labelCountdownSeconds = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($forceCountdown -eq $true) {
+ If ($deploymentType -ieq 'Install') { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $($configDeploymentTypeInstall.ToLower())) + "`n$labelCountdownSeconds" }
+ Else { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $($configDeploymentTypeUninstall.ToLower())) + "`n$labelCountdownSeconds" }
+ }
+ Else { $labelCountdown.Text = "$configClosePromptCountdownMessage`n$labelCountdownSeconds" }
+ }
+
+ ## Add the timer if it doesn't already exist - this avoids the timer being reset if the continue button is clicked
+ If (-not ($script:welcomeTimer)) {
+ $script:welcomeTimer = New-Object -TypeName 'System.Windows.Forms.Timer'
+ }
+
+ If ($showCountdown) {
+ [scriptblock]$timer_Tick = {
+ ## Get the time information
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($CloseAppsCountdown)
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ Set-Variable -Name 'closeAppsCountdownGlobal' -Value $remainingTime.TotalSeconds -Scope 'Script'
+
+ ## If the countdown is complete, close the application(s) or continue
+ If ($countdownTime -lt $currentTime) {
+ If ($forceCountdown -eq $true) {
+ Write-Log -Message 'Countdown timer has elapsed. Force continue.' -Source ${CmdletName}
+ $buttonContinue.PerformClick()
+ }
+ Else {
+ Write-Log -Message 'Close application(s) countdown timer has elapsed. Force closing application(s).' -Source ${CmdletName}
+ $buttonCloseApps.PerformClick()
+ }
+ }
+ Else {
+ # Update the form
+ [string]$labelCountdownSeconds = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($forceCountdown -eq $true) {
+ If ($deploymentType -ieq 'Install') { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $configDeploymentTypeInstall) + "`n$labelCountdownSeconds" }
+ Else { $labelCountdown.Text = ($configWelcomePromptCountdownMessage -f $configDeploymentTypeUninstall) + "`n$labelCountdownSeconds" }
+ }
+ Else { $labelCountdown.Text = "$configClosePromptCountdownMessage`n$labelCountdownSeconds" }
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+ }
+ Else {
+ $script:welcomeTimer.Interval = ($configInstallationUITimeout * 1000)
+ [scriptblock]$timer_Tick = { $buttonAbort.PerformClick() }
+ }
+
+ $script:welcomeTimer.add_Tick($timer_Tick)
+
+ ## Persistence Timer
+ If ($persistWindow) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = { Update-InstallationWelcome }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ ## Process Re-Enumeration Timer
+ If ($configInstallationWelcomePromptDynamicRunningProcessEvaluation) {
+ $timerRunningProcesses = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerRunningProcesses.Interval = ($configInstallationWelcomePromptDynamicRunningProcessEvaluationInterval * 1000)
+ [scriptblock]$timerRunningProcesses_Tick = { Get-RunningProcessesDynamically }
+ $timerRunningProcesses.add_Tick($timerRunningProcesses_Tick)
+ $timerRunningProcesses.Start()
+ }
+
+ ## Form
+ $formWelcome.Controls.Add($pictureBanner)
+ $formWelcome.Controls.Add($buttonAbort)
+
+ ##----------------------------------------------
+ ## Create padding object
+ $paddingNone = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $paddingNone.Top = 0
+ $paddingNone.Bottom = 0
+ $paddingNone.Left = 0
+ $paddingNone.Right = 0
+
+ ## Generic Button properties
+ $buttonWidth = 110
+ $buttonHeight = 23
+ $buttonPadding = 50
+ $buttonSize = New-Object -TypeName 'System.Drawing.Size'
+ $buttonSize.Width = $buttonWidth
+ $buttonSize.Height = $buttonHeight
+ $buttonPadding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $buttonPadding.Top = 0
+ $buttonPadding.Bottom = 5
+ $buttonPadding.Left = 50
+ $buttonPadding.Right = 0
+
+ ## Picture Banner
+ $pictureBanner.DataBindings.DefaultDataSourceUpdateMode = 0
+ $pictureBanner.ImageLocation = $appDeployLogoBanner
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 0
+ $pictureBanner.Location = $System_Drawing_Point
+ $pictureBanner.Name = 'pictureBanner'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 50
+ $System_Drawing_Size.Width = 450
+ $pictureBanner.Size = $System_Drawing_Size
+ $pictureBanner.SizeMode = 'CenterImage'
+ $pictureBanner.Margin = $paddingNone
+ $pictureBanner.TabIndex = 0
+ $pictureBanner.TabStop = $false
+
+ ## Label App Name
+ $labelAppName.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelAppName.Name = 'labelAppName'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ If (-not $showCloseApps) {
+ $System_Drawing_Size.Height = 40
+ }
+ Else {
+ $System_Drawing_Size.Height = 65
+ }
+ $System_Drawing_Size.Width = 450
+ $labelAppName.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelAppName.MaximumSize = $System_Drawing_Size
+ $labelAppName.Margin = '0,15,0,15'
+ $labelAppName.Padding = '20,0,20,0'
+ $labelAppName.TabIndex = 1
+
+ ## Initial form layout: Close Applications / Allow Deferral
+ If ($showCloseApps) {
+ $labelAppNameText = $configClosePromptMessage
+ }
+ ElseIf (($showDefer) -or ($forceCountdown)) {
+ $labelAppNameText = "$configDeferPromptWelcomeMessage `n$installTitle"
+ }
+ If ($CustomText) {
+ $labelAppNameText = "$labelAppNameText `n`n$configWelcomePromptCustomMessage"
+ }
+ $labelAppName.Text = $labelAppNameText
+ $labelAppName.TextAlign = 'TopCenter'
+ $labelAppName.Anchor = 'Top'
+ $labelAppName.AutoSize = $true
+ $labelAppName.add_Click($handler_labelAppName_Click)
+
+ ## Listbox Close Applications
+ $listBoxCloseApps.DataBindings.DefaultDataSourceUpdateMode = 0
+ $listBoxCloseApps.FormattingEnabled = $true
+ $listBoxCloseApps.HorizontalScrollbar = $true
+ $listBoxCloseApps.Name = 'listBoxCloseApps'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 100
+ $System_Drawing_Size.Width = 300
+ $listBoxCloseApps.Size = $System_Drawing_Size
+ $listBoxCloseApps.Margin = '75,0,0,0'
+ $listBoxCloseApps.TabIndex = 3
+ $ProcessDescriptions | ForEach-Object { $null = $listboxCloseApps.Items.Add($_) }
+
+ ## Label Defer
+ $labelDefer.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelDefer.Name = 'labelDefer'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 90
+ $System_Drawing_Size.Width = 450
+ $labelDefer.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelDefer.MaximumSize = $System_Drawing_Size
+ $labelDefer.Margin = $paddingNone
+ $labelDefer.Padding = '40,0,20,0'
+ $labelDefer.TabIndex = 4
+ $deferralText = "$configDeferPromptExpiryMessage`n"
+
+ If ($deferTimes -ge 0) {
+ $deferralText = "$deferralText `n$configDeferPromptRemainingDeferrals $([int32]$deferTimes + 1)"
+ }
+ If ($deferDeadline) {
+ $deferralText = "$deferralText `n$configDeferPromptDeadline $deferDeadline"
+ }
+ If (($deferTimes -lt 0) -and (-not $DeferDeadline)) {
+ $deferralText = "$deferralText `n$configDeferPromptNoDeadline"
+ }
+ $deferralText = "$deferralText `n`n$configDeferPromptWarningMessage"
+ $labelDefer.Text = $deferralText
+ $labelDefer.TextAlign = 'MiddleCenter'
+ $labelDefer.AutoSize = $true
+ $labelDefer.add_Click($handler_labelDefer_Click)
+
+ ## Label Countdown
+ $labelCountdown.DataBindings.DefaultDataSourceUpdateMode = 0
+ $labelCountdown.Name = 'labelCountdown'
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 40
+ $System_Drawing_Size.Width = 450
+ $labelCountdown.Size = $System_Drawing_Size
+ $System_Drawing_Size.Height = 0
+ $labelCountdown.MaximumSize = $System_Drawing_Size
+ $labelCountdown.Margin = $paddingNone
+ $labelCountdown.Padding = '40,0,20,0'
+ $labelCountdown.TabIndex = 4
+ $labelCountdown.Font = 'Microsoft Sans Serif, 9pt, style=Bold'
+ $labelCountdown.Text = '00:00:00'
+ $labelCountdown.TextAlign = 'MiddleCenter'
+ $labelCountdown.AutoSize = $true
+ $labelCountdown.add_Click($handler_labelDefer_Click)
+
+ ## Panel Flow Layout
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ $System_Drawing_Point.Y = 50
+ $flowLayoutPanel.Location = $System_Drawing_Point
+ $flowLayoutPanel.AutoSize = $true
+ $flowLayoutPanel.Anchor = 'Top'
+ $flowLayoutPanel.FlowDirection = 'TopDown'
+ $flowLayoutPanel.WrapContents = $true
+ $flowLayoutPanel.Controls.Add($labelAppName)
+ If ($showCloseApps) { $flowLayoutPanel.Controls.Add($listBoxCloseApps) }
+ If ($showDefer) {
+ $flowLayoutPanel.Controls.Add($labelDefer)
+ }
+ If ($showCountdown) {
+ $flowLayoutPanel.Controls.Add($labelCountdown)
+ }
+
+ ## Button Close For Me
+ $buttonCloseApps.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonCloseApps.Location = '15,0'
+ $buttonCloseApps.Name = 'buttonCloseApps'
+ $buttonCloseApps.Size = $buttonSize
+ $buttonCloseApps.TabIndex = 5
+ $buttonCloseApps.Text = $configClosePromptButtonClose
+ $buttonCloseApps.DialogResult = 'Yes'
+ $buttonCloseApps.AutoSize = $true
+ $buttonCloseApps.UseVisualStyleBackColor = $true
+ $buttonCloseApps.add_Click($buttonCloseApps_OnClick)
+
+ ## Button Defer
+ $buttonDefer.DataBindings.DefaultDataSourceUpdateMode = 0
+ If (-not $showCloseApps) {
+ $buttonDefer.Location = '15,0'
+ }
+ Else {
+ $buttonDefer.Location = '170,0'
+ }
+ $buttonDefer.Name = 'buttonDefer'
+ $buttonDefer.Size = $buttonSize
+ $buttonDefer.TabIndex = 6
+ $buttonDefer.Text = $configClosePromptButtonDefer
+ $buttonDefer.DialogResult = 'No'
+ $buttonDefer.AutoSize = $true
+ $buttonDefer.UseVisualStyleBackColor = $true
+ $buttonDefer.add_Click($buttonDefer_OnClick)
+
+ ## Button Continue
+ $buttonContinue.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonContinue.Location = '325,0'
+ $buttonContinue.Name = 'buttonContinue'
+ $buttonContinue.Size = $buttonSize
+ $buttonContinue.TabIndex = 7
+ $buttonContinue.Text = $configClosePromptButtonContinue
+ $buttonContinue.DialogResult = 'OK'
+ $buttonContinue.AutoSize = $true
+ $buttonContinue.UseVisualStyleBackColor = $true
+ $buttonContinue.add_Click($buttonContinue_OnClick)
+ If ($showCloseApps) {
+ # Add tooltip to Continue button
+ $toolTip.BackColor = [Drawing.Color]::LightGoldenrodYellow
+ $toolTip.IsBalloon = $false
+ $toolTip.InitialDelay = 100
+ $toolTip.ReshowDelay = 100
+ $toolTip.SetToolTip($buttonContinue, $configClosePromptButtonContinueTooltip)
+ }
+
+ ## Button Abort (Hidden)
+ $buttonAbort.DataBindings.DefaultDataSourceUpdateMode = 0
+ $buttonAbort.Name = 'buttonAbort'
+ $buttonAbort.Size = '1,1'
+ $buttonAbort.TabStop = $false
+ $buttonAbort.DialogResult = 'Abort'
+ $buttonAbort.TabIndex = 5
+ $buttonAbort.UseVisualStyleBackColor = $true
+ $buttonAbort.add_Click($buttonAbort_OnClick)
+
+ ## Form Welcome
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 0
+ $System_Drawing_Size.Width = 0
+ $formWelcome.Size = $System_Drawing_Size
+ $formWelcome.Padding = $paddingNone
+ $formWelcome.Margin = $paddingNone
+ $formWelcome.DataBindings.DefaultDataSourceUpdateMode = 0
+ $formWelcome.Name = 'WelcomeForm'
+ $formWelcome.Text = $installTitle
+ $formWelcome.StartPosition = 'CenterScreen'
+ $formWelcome.FormBorderStyle = 'FixedDialog'
+ $formWelcome.MaximizeBox = $false
+ $formWelcome.MinimizeBox = $false
+ $formWelcome.TopMost = $TopMost
+ $formWelcome.TopLevel = $true
+ $formWelcome.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formWelcome.AutoSize = $true
+ $formWelcome.Controls.Add($pictureBanner)
+ $formWelcome.Controls.Add($flowLayoutPanel)
+
+ ## Panel Button
+ $System_Drawing_Point = New-Object -TypeName 'System.Drawing.Point'
+ $System_Drawing_Point.X = 0
+ # Calculate the position of the panel relative to the size of the form
+ $System_Drawing_Point.Y = (($formWelcome.Size | Select-Object -ExpandProperty 'Height') - 10)
+ $panelButtons.Location = $System_Drawing_Point
+ $System_Drawing_Size = New-Object -TypeName 'System.Drawing.Size'
+ $System_Drawing_Size.Height = 40
+ $System_Drawing_Size.Width = 450
+ $panelButtons.Size = $System_Drawing_Size
+ $panelButtons.AutoSize = $true
+ $panelButtons.Anchor = 'Top'
+ $padding = New-Object -TypeName 'System.Windows.Forms.Padding'
+ $padding.Top = 0
+ $padding.Bottom = 0
+ $padding.Left = 0
+ $padding.Right = 0
+ $panelButtons.Margin = $padding
+ If ($showCloseApps) { $panelButtons.Controls.Add($buttonCloseApps) }
+ If ($showDefer) { $panelButtons.Controls.Add($buttonDefer) }
+ $panelButtons.Controls.Add($buttonContinue)
+
+ ## Add the Buttons Panel to the form
+ $formWelcome.Controls.Add($panelButtons)
+
+ ## Save the initial state of the form
+ $formWelcomeWindowState = $formWelcome.WindowState
+ # Init the OnLoad event to correct the initial state of the form
+ $formWelcome.add_Load($Form_StateCorrection_Load)
+ # Clean up the control events
+ $formWelcome.add_FormClosed($Form_Cleanup_FormClosed)
+
+ Function Update-InstallationWelcome {
+ $formWelcome.BringToFront()
+ $formWelcome.Location = "$($formWelcomeStartPosition.X),$($formWelcomeStartPosition.Y)"
+ $formWelcome.Refresh()
+ }
+
+ # Function invoked by a timer to periodically check running processes dynamically whilst showing the welcome prompt
+ Function Get-RunningProcessesDynamically {
+ $dynamicRunningProcesses = $null
+ Get-RunningProcesses -ProcessObjects $processObjects -DisableLogging -OutVariable 'dynamicRunningProcesses'
+ [string]$dynamicRunningProcessDescriptions = ($dynamicRunningProcesses | Where-Object { $_.ProcessDescription } | Select-Object -ExpandProperty 'ProcessDescription' | Select-Object -Unique | Sort-Object) -join ','
+ If ($dynamicRunningProcessDescriptions -ne $script:runningProcessDescriptions) {
+ # Update the runningProcessDescriptions variable for the next time this function runs
+ Set-Variable -Name 'runningProcessDescriptions' -Value $dynamicRunningProcessDescriptions -Force -Scope 'Script'
+ If ($dynamicrunningProcesses) {
+ Write-Log -Message "The running processes have changed. Updating the apps to close: [$script:runningProcessDescriptions]..." -Source ${CmdletName}
+ }
+ # Update the list box with the processes to close
+ $listboxCloseApps.Items.Clear()
+ $script:runningProcessDescriptions -split "," | ForEach-Object { $null = $listboxCloseApps.Items.Add($_) }
+ }
+ # If CloseApps processes were running when the prompt was shown, and they are subsequently detected to be closed while the form is showing, then close the form. The deferral and CloseApps conditions will be re-evaluated.
+ If ($ProcessDescriptions) {
+ If (-not ($dynamicRunningProcesses)) {
+ Write-Log -Message 'Previously detected running processes are no longer running.' -Source ${CmdletName}
+ $formWelcome.Dispose()
+ }
+ }
+ # If CloseApps processes were not running when the prompt was shown, and they are subsequently detected to be running while the form is showing, then close the form for relaunch. The deferral and CloseApps conditions will be re-evaluated.
+ ElseIf (-not $ProcessDescriptions) {
+ If ($dynamicRunningProcesses) {
+ Write-Log -Message 'New running processes detected. Updating the form to prompt to close the running applications.' -Source ${CmdletName}
+ $formWelcome.Dispose()
+ }
+ }
+ }
+
+ ## Minimize all other windows
+ If ($minimizeWindows) { $null = $shellApp.MinimizeAll() }
+
+ ## Show the form
+ $result = $formWelcome.ShowDialog()
+ $formWelcome.Dispose()
+
+ Switch ($result) {
+ OK { $result = 'Continue' }
+ No { $result = 'Defer' }
+ Yes { $result = 'Close' }
+ Abort { $result = 'Timeout' }
+ }
+
+ Write-Output -InputObject $result
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationRestartPrompt
+Function Show-InstallationRestartPrompt {
+<#
+.SYNOPSIS
+ Displays a restart prompt with a countdown to a forced restart.
+.DESCRIPTION
+ Displays a restart prompt with a countdown to a forced restart.
+.PARAMETER CountdownSeconds
+ Specifies the number of seconds to countdown before the system restart.
+.PARAMETER CountdownNoHideSeconds
+ Specifies the number of seconds to display the restart prompt without allowing the window to be hidden.
+.PARAMETER NoCountdown
+ Specifies not to show a countdown, just the Restart Now and Restart Later buttons.
+ The UI will restore/reposition itself persistently based on the interval value specified in the config file.
+.EXAMPLE
+ Show-InstallationRestartPrompt -Countdownseconds 600 -CountdownNoHideSeconds 60
+.EXAMPLE
+ Show-InstallationRestartPrompt -NoCountdown
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CountdownSeconds = 60,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$CountdownNoHideSeconds = 30,
+ [Parameter(Mandatory=$false)]
+ [switch]$NoCountdown = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Bypass if in non-interactive mode
+ If ($deployModeSilent) {
+ Write-Log -Message "Bypass Installation Restart Prompt [Mode: $deployMode]." -Source ${CmdletName}
+ Return
+ }
+ ## Get the parameters passed to the function for invoking the function asynchronously
+ [hashtable]$installRestartPromptParameters = $psBoundParameters
+
+ ## Check if we are already displaying a restart prompt
+ If (Get-Process | Where-Object { $_.MainWindowTitle -match $configRestartPromptTitle }) {
+ Write-Log -Message "${CmdletName} was invoked, but an existing restart prompt was detected. Cancelling restart prompt." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ [datetime]$startTime = Get-Date
+ [datetime]$countdownTime = $startTime
+
+ [Windows.Forms.Application]::EnableVisualStyles()
+ $formRestart = New-Object -TypeName 'System.Windows.Forms.Form'
+ $labelCountdown = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelTimeRemaining = New-Object -TypeName 'System.Windows.Forms.Label'
+ $labelMessage = New-Object -TypeName 'System.Windows.Forms.Label'
+ $buttonRestartLater = New-Object -TypeName 'System.Windows.Forms.Button'
+ $picturebox = New-Object -TypeName 'System.Windows.Forms.PictureBox'
+ $buttonRestartNow = New-Object -TypeName 'System.Windows.Forms.Button'
+ $timerCountdown = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $InitialFormWindowState = New-Object -TypeName 'System.Windows.Forms.FormWindowState'
+
+ [scriptblock]$RestartComputer = {
+ Write-Log -Message 'Force restart the computer...' -Source ${CmdletName}
+ Restart-Computer -Force
+ }
+
+ [scriptblock]$FormEvent_Load = {
+ ## Initialize the countdown timer
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($countdownSeconds)
+ $timerCountdown.Start()
+ ## Set up the form
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ $labelCountdown.Text = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($remainingTime.TotalSeconds -le $countdownNoHideSeconds) { $buttonRestartLater.Enabled = $false }
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ }
+
+ [scriptblock]$Form_StateCorrection_Load = {
+ ## Correct the initial state of the form to prevent the .NET maximized form issue
+ $formRestart.WindowState = $InitialFormWindowState
+ $formRestart.AutoSize = $true
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ ## Get the start position of the form so we can return the form to this position if PersistPrompt is enabled
+ Set-Variable -Name 'formInstallationRestartPromptStartPosition' -Value $formRestart.Location -Scope 'Script'
+ }
+
+ ## Persistence Timer
+ If ($NoCountdown) {
+ $timerPersist = New-Object -TypeName 'System.Windows.Forms.Timer'
+ $timerPersist.Interval = ($configInstallationRestartPersistInterval * 1000)
+ [scriptblock]$timerPersist_Tick = {
+ # Show the Restart Popup
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ $formRestart.Location = "$($formInstallationRestartPromptStartPosition.X),$($formInstallationRestartPromptStartPosition.Y)"
+ $formRestart.Refresh()
+ [Windows.Forms.Application]::DoEvents()
+ }
+ $timerPersist.add_Tick($timerPersist_Tick)
+ $timerPersist.Start()
+ }
+
+ [scriptblock]$buttonRestartLater_Click = {
+ ## Minimize the form
+ $formRestart.WindowState = 'Minimized'
+ If ($NoCountdown) {
+ ## Reset the persistence timer
+ $timerPersist.Stop()
+ $timerPersist.Start()
+ }
+ }
+
+ ## Restart the computer
+ [scriptblock]$buttonRestartNow_Click = { & $RestartComputer }
+
+ ## Hide the form if minimized
+ [scriptblock]$formRestart_Resize = { If ($formRestart.WindowState -eq 'Minimized') { $formRestart.WindowState = 'Minimized' } }
+
+ [scriptblock]$timerCountdown_Tick = {
+ ## Get the time information
+ [datetime]$currentTime = Get-Date
+ [datetime]$countdownTime = $startTime.AddSeconds($countdownSeconds)
+ [timespan]$remainingTime = $countdownTime.Subtract($currentTime)
+ ## If the countdown is complete, restart the machine
+ If ($countdownTime -lt $currentTime) {
+ $buttonRestartNow.PerformClick()
+ }
+ Else {
+ ## Update the form
+ $labelCountdown.Text = [string]::Format('{0}:{1:d2}:{2:d2}', $remainingTime.Hours, $remainingTime.Minutes, $remainingTime.Seconds)
+ If ($remainingTime.TotalSeconds -le $countdownNoHideSeconds) {
+ $buttonRestartLater.Enabled = $false
+ # If the form is hidden when we hit the "No Hide", bring it back up
+ If ($formRestart.WindowState -eq 'Minimized') {
+ # Show Popup
+ $formRestart.WindowState = 'Normal'
+ $formRestart.TopMost = $true
+ $formRestart.BringToFront()
+ $formRestart.Location = "$($formInstallationRestartPromptStartPosition.X),$($formInstallationRestartPromptStartPosition.Y)"
+ $formRestart.Refresh()
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+ [Windows.Forms.Application]::DoEvents()
+ }
+ }
+
+ ## Remove all event handlers from the controls
+ [scriptblock]$Form_Cleanup_FormClosed = {
+ Try {
+ $buttonRestartLater.remove_Click($buttonRestartLater_Click)
+ $buttonRestartNow.remove_Click($buttonRestartNow_Click)
+ $formRestart.remove_Load($FormEvent_Load)
+ $formRestart.remove_Resize($formRestart_Resize)
+ $timerCountdown.remove_Tick($timerCountdown_Tick)
+ $timerPersist.remove_Tick($timerPersist_Tick)
+ $formRestart.remove_Load($Form_StateCorrection_Load)
+ $formRestart.remove_FormClosed($Form_Cleanup_FormClosed)
+ }
+ Catch { }
+ }
+
+ ## Form
+ If (-not $NoCountdown) {
+ $formRestart.Controls.Add($labelCountdown)
+ $formRestart.Controls.Add($labelTimeRemaining)
+ }
+ $formRestart.Controls.Add($labelMessage)
+ $formRestart.Controls.Add($buttonRestartLater)
+ $formRestart.Controls.Add($picturebox)
+ $formRestart.Controls.Add($buttonRestartNow)
+ $formRestart.ClientSize = '450,260'
+ $formRestart.ControlBox = $false
+ $formRestart.FormBorderStyle = 'FixedDialog'
+ $formRestart.Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ $formRestart.MaximizeBox = $false
+ $formRestart.MinimizeBox = $false
+ $formRestart.Name = 'formRestart'
+ $formRestart.StartPosition = 'CenterScreen'
+ $formRestart.Text = "$($configRestartPromptTitle): $installTitle"
+ $formRestart.add_Load($FormEvent_Load)
+ $formRestart.add_Resize($formRestart_Resize)
+
+ ## Banner
+ $picturebox.Anchor = 'Top'
+ $picturebox.Image = [Drawing.Image]::Fromfile($AppDeployLogoBanner)
+ $picturebox.Location = '0,0'
+ $picturebox.Name = 'picturebox'
+ $picturebox.Size = '450,50'
+ $picturebox.SizeMode = 'CenterImage'
+ $picturebox.TabIndex = 1
+ $picturebox.TabStop = $false
+
+ ## Label Message
+ $labelMessage.Location = '20,58'
+ $labelMessage.Name = 'labelMessage'
+ $labelMessage.Size = '400,79'
+ $labelMessage.TabIndex = 3
+ $labelMessage.Text = "$configRestartPromptMessage $configRestartPromptMessageTime `n`n$configRestartPromptMessageRestart"
+ If ($NoCountdown) { $labelMessage.Text = $configRestartPromptMessage }
+ $labelMessage.TextAlign = 'MiddleCenter'
+
+ ## Label Time Remaining
+ $labelTimeRemaining.Location = '20,138'
+ $labelTimeRemaining.Name = 'labelTimeRemaining'
+ $labelTimeRemaining.Size = '400,23'
+ $labelTimeRemaining.TabIndex = 4
+ $labelTimeRemaining.Text = $configRestartPromptTimeRemaining
+ $labelTimeRemaining.TextAlign = 'MiddleCenter'
+
+ ## Label Countdown
+ $labelCountdown.Font = 'Microsoft Sans Serif, 18pt, style=Bold'
+ $labelCountdown.Location = '20,165'
+ $labelCountdown.Name = 'labelCountdown'
+ $labelCountdown.Size = '400,30'
+ $labelCountdown.TabIndex = 5
+ $labelCountdown.Text = '00:00:00'
+ $labelCountdown.TextAlign = 'MiddleCenter'
+
+ ## Label Restart Later
+ $buttonRestartLater.Anchor = 'Bottom,Left'
+ $buttonRestartLater.Location = '20,216'
+ $buttonRestartLater.Name = 'buttonRestartLater'
+ $buttonRestartLater.Size = '159,23'
+ $buttonRestartLater.TabIndex = 0
+ $buttonRestartLater.Text = $configRestartPromptButtonRestartLater
+ $buttonRestartLater.UseVisualStyleBackColor = $true
+ $buttonRestartLater.add_Click($buttonRestartLater_Click)
+
+ ## Label Restart Now
+ $buttonRestartNow.Anchor = 'Bottom,Right'
+ $buttonRestartNow.Location = '265,216'
+ $buttonRestartNow.Name = 'buttonRestartNow'
+ $buttonRestartNow.Size = '159,23'
+ $buttonRestartNow.TabIndex = 2
+ $buttonRestartNow.Text = $configRestartPromptButtonRestartNow
+ $buttonRestartNow.UseVisualStyleBackColor = $true
+ $buttonRestartNow.add_Click($buttonRestartNow_Click)
+
+ ## Timer Countdown
+ If (-not $NoCountdown) { $timerCountdown.add_Tick($timerCountdown_Tick) }
+
+ ##----------------------------------------------
+
+ ## Save the initial state of the form
+ $InitialFormWindowState = $formRestart.WindowState
+ # Init the OnLoad event to correct the initial state of the form
+ $formRestart.add_Load($Form_StateCorrection_Load)
+ # Clean up the control events
+ $formRestart.add_FormClosed($Form_Cleanup_FormClosed)
+ $formRestartClosing = [Windows.Forms.FormClosingEventHandler]{ If ($_.CloseReason -eq 'UserClosing') { $_.Cancel = $true } }
+ $formRestart.add_FormClosing($formRestartClosing)
+
+ ## If the script has been dot-source invoked by the deploy app script, display the restart prompt asynchronously
+ If ($deployAppScriptFriendlyName) {
+ If ($NoCountdown) {
+ Write-Log -Message "Invoking ${CmdletName} asynchronously with no countdown..." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Invoking ${CmdletName} asynchronously with a [$countDownSeconds] second countdown..." -Source ${CmdletName}
+ }
+ [string]$installRestartPromptParameters = ($installRestartPromptParameters.GetEnumerator() | ForEach-Object {
+ If ($_.Value.GetType().Name -eq 'SwitchParameter') {
+ "-$($_.Key)"
+ }
+ ElseIf ($_.Value.GetType().Name -eq 'Boolean') {
+ "-$($_.Key) `$" + "$($_.Value)".ToLower()
+ }
+ ElseIf ($_.Value.GetType().Name -eq 'Int32') {
+ "-$($_.Key) $($_.Value)"
+ }
+ Else {
+ "-$($_.Key) `"$($_.Value)`""
+ }
+ }) -join ' '
+ Start-Process -FilePath "$PSHOME\powershell.exe" -ArgumentList "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -File `"$scriptPath`" -ReferredInstallTitle `"$installTitle`" -ReferredInstallName `"$installName`" -ReferredLogName `"$logName`" -ShowInstallationRestartPrompt $installRestartPromptParameters -AsyncToolkitLaunch" -WindowStyle 'Hidden' -ErrorAction 'SilentlyContinue'
+ }
+ Else {
+ If ($NoCountdown) {
+ Write-Log -Message 'Display restart prompt with no countdown.' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Display restart prompt with a [$countDownSeconds] second countdown." -Source ${CmdletName}
+ }
+
+ # Show the Form
+ Write-Output -InputObject $formRestart.ShowDialog()
+ $formRestart.Dispose()
+
+ # Activate the Window
+ [Diagnostics.Process]$powershellProcess = Get-Process | Where-Object { $_.MainWindowTitle -match $installTitle }
+ [Microsoft.VisualBasic.Interaction]::AppActivate($powershellProcess.ID)
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-BalloonTip
+Function Show-BalloonTip {
+<#
+.SYNOPSIS
+ Displays a balloon tip notification in the system tray.
+.DESCRIPTION
+ Displays a balloon tip notification in the system tray.
+.PARAMETER BalloonTipText
+ Text of the balloon tip.
+.PARAMETER BalloonTipTitle
+ Title of the balloon tip.
+.PARAMETER BalloonTipIcon
+ Icon to be used. Options: 'Error', 'Info', 'None', 'Warning'. Default is: Info.
+.PARAMETER BalloonTipTime
+ Time in milliseconds to display the balloon tip. Default: 500.
+.EXAMPLE
+ Show-BalloonTip -BalloonTipText 'Installation Started' -BalloonTipTitle 'Application Name'
+.EXAMPLE
+ Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText 'Installation Started' -BalloonTipTitle 'Application Name' -BalloonTipTime 1000
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullOrEmpty()]
+ [string]$BalloonTipText,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$BalloonTipTitle = $installTitle,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateSet('Error','Info','None','Warning')]
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = 'Info',
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [int32]$BalloonTipTime = 10000
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ ## Skip balloon if in silent mode
+ If (($deployModeSilent) -or (-not $configShowBalloonNotifications) -or (Test-PowerPoint)) { Return }
+
+ ## Dispose of previous balloon
+ If ($script:notifyIcon) { Try { $script:notifyIcon.Dispose() } Catch {} }
+
+ ## Get the calling function so we know when to display the exiting balloon tip notification in an asynchronous script
+ Try { [string]$callingFunction = (Get-Variable -Name MyInvocation -Scope 1).Value.Mycommand.Name } Catch { }
+
+ If ($callingFunction -eq 'Exit-Script') {
+ Write-Log -Message "Display balloon tip notification asynchronously with message [$BalloonTipText]." -Source ${CmdletName}
+ ## Create a script block to display the balloon notification in a new PowerShell process so that we can wait to cleanly dispose of the balloon tip without having to make the deployment script wait
+ [scriptblock]$notifyIconScriptBlock = {
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNullOrEmpty()]
+ [string]$BalloonTipText,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$BalloonTipTitle,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateSet('Error','Info','None','Warning')]
+ $BalloonTipIcon, # Don't strongly type variable as System.Drawing; assembly not loaded yet in asynchronous scriptblock so will throw error
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [int32]$BalloonTipTime,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [string]$AppDeployLogoIcon
+ )
+
+ ## Load assembly containing class System.Windows.Forms and System.Drawing
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'System.Drawing' -ErrorAction 'Stop'
+
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = $BalloonTipIcon
+ $script:notifyIcon = New-Object -TypeName 'System.Windows.Forms.NotifyIcon' -Property @{
+ BalloonTipIcon = $BalloonTipIcon
+ BalloonTipText = $BalloonTipText
+ BalloonTipTitle = $BalloonTipTitle
+ Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ Text = -join $BalloonTipText[0..62]
+ Visible = $true
+ }
+
+ ## Display the balloon tip notification asynchronously
+ $script:NotifyIcon.ShowBalloonTip($BalloonTipTime)
+
+ ## Keep the asynchronous PowerShell process running so that we can dispose of the balloon tip icon
+ Start-Sleep -Milliseconds ($BalloonTipTime)
+ $script:notifyIcon.Dispose()
+ }
+
+ ## Invoke a separate PowerShell process passing the script block as a command and associated parameters to display the balloon tip notification asynchronously
+ Try {
+ Execute-Process -Path "$PSHOME\powershell.exe" -Parameters "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -Command & {$notifyIconScriptBlock} '$BalloonTipText' '$BalloonTipTitle' '$BalloonTipIcon' '$BalloonTipTime' '$AppDeployLogoIcon'" -NoWait -WindowStyle 'Hidden' -CreateNoWindow
+ }
+ Catch { }
+ }
+ ## Otherwise create the balloontip icon synchronously
+ Else {
+ Write-Log -Message "Display balloon tip notification with message [$BalloonTipText]." -Source ${CmdletName}
+ [Windows.Forms.ToolTipIcon]$BalloonTipIcon = $BalloonTipIcon
+ $script:notifyIcon = New-Object -TypeName 'System.Windows.Forms.NotifyIcon' -Property @{
+ BalloonTipIcon = $BalloonTipIcon
+ BalloonTipText = $BalloonTipText
+ BalloonTipTitle = $BalloonTipTitle
+ Icon = New-Object -TypeName 'System.Drawing.Icon' -ArgumentList $AppDeployLogoIcon
+ Text = -join $BalloonTipText[0..62]
+ Visible = $true
+ }
+
+ ## Display the balloon tip notification
+ $script:NotifyIcon.ShowBalloonTip($BalloonTipTime)
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Show-InstallationProgress
+Function Show-InstallationProgress {
+<#
+.SYNOPSIS
+ Displays a progress dialog in a separate thread with an updateable custom message.
+.DESCRIPTION
+ Create a WPF window in a separate thread to display a marquee style progress ellipse with a custom message that can be updated.
+ The status message supports line breaks.
+ The first time this function is called in a script, it will display a balloon tip notification to indicate that the installation has started (provided balloon tips are enabled in the configuration).
+.PARAMETER StatusMessage
+ The status message to be displayed. The default status message is taken from the XML configuration file.
+.PARAMETER WindowLocation
+ The location of the progress window. Default: just below top, centered.
+.PARAMETER TopMost
+ Specifies whether the progress window should be topmost. Default: $true.
+.EXAMPLE
+ Show-InstallationProgress
+ Uses the default status message from the XML configuration file.
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage 'Installation in Progress...'
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage "Installation in Progress...`nThe installation may take 20 minutes to complete."
+.EXAMPLE
+ Show-InstallationProgress -StatusMessage 'Installation in Progress...' -WindowLocation 'BottomRight' -TopMost $false
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$StatusMessage = $configProgressMessageInstall,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Default','BottomRight')]
+ [string]$WindowLocation = 'Default',
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$TopMost = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($deployModeSilent) { Return }
+
+ ## If the default progress message hasn't been overridden and the deployment type is uninstall, use the default uninstallation message
+ If (($StatusMessage -eq $configProgressMessageInstall) -and ($deploymentType -eq 'Uninstall')) {
+ $StatusMessage = $configProgressMessageUninstall
+ }
+
+ If ($envHost.Name -match 'PowerGUI') {
+ Write-Log -Message "$($envHost.Name) is not a supported host for WPF multi-threading. Progress dialog with message [$statusMessage] will not be displayed." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ ## Check if the progress thread is running before invoking methods on it
+ If ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -ne 'Running') {
+ # Notify user that the software installation has started
+ $balloonText = "$deploymentTypeName $configBalloonTextStart"
+ Show-BalloonTip -BalloonTipIcon 'Info' -BalloonTipText $balloonText
+ # Create a synchronized hashtable to share objects between runspaces
+ $script:ProgressSyncHash = [hashtable]::Synchronized(@{ })
+ # Create a new runspace for the progress bar
+ $script:ProgressRunspace = [runspacefactory]::CreateRunspace()
+ $script:ProgressRunspace.ApartmentState = 'STA'
+ $script:ProgressRunspace.ThreadOptions = 'ReuseThread'
+ $script:ProgressRunspace.Open()
+ # Add the sync hash to the runspace
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('progressSyncHash', $script:ProgressSyncHash)
+ # Add other variables from the parent thread required in the progress runspace
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('installTitle', $installTitle)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('windowLocation', $windowLocation)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('topMost', $topMost.ToString())
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('appDeployLogoBanner', $appDeployLogoBanner)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('progressStatusMessage', $statusMessage)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('AppDeployLogoIcon', $AppDeployLogoIcon)
+ $script:ProgressRunspace.SessionStateProxy.SetVariable('dpiScale', $dpiScale)
+
+ # Add the script block to be executed in the progress runspace
+ $progressCmd = [PowerShell]::Create().AddScript({
+ [Xml.XmlDocument]$xamlProgress = @'
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+'@
+
+ ## Set the configurable values using variables added to the runspace from the parent thread
+ # Calculate the position on the screen where the progress dialog should be placed
+ $screen = [Windows.Forms.Screen]::PrimaryScreen
+ $screenWorkingArea = $screen.WorkingArea
+ [int32]$screenWidth = $screenWorkingArea | Select-Object -ExpandProperty 'Width'
+ [int32]$screenHeight = $screenWorkingArea | Select-Object -ExpandProperty 'Height'
+ # Set the start position of the Window based on the screen size
+ If ($windowLocation -eq 'BottomRight') {
+ $xamlProgress.Window.Left = [string](($screenWidth / ($dpiscale / 100)) - ($xamlProgress.Window.Width))
+ $xamlProgress.Window.Top = [string](($screenHeight / ($dpiscale / 100)) - ($xamlProgress.Window.Height))
+ }
+ # Show the default location (Top center)
+ Else {
+ # Center the progress window by calculating the center of the workable screen based on the width of the screen relative to the DPI scale minus half the width of the progress bar
+ $xamlProgress.Window.Left = [string](($screenWidth / (2 * ($dpiscale / 100) )) - (($xamlProgress.Window.Width / 2)))
+ $xamlProgress.Window.Top = [string]($screenHeight / 9.5)
+ }
+ $xamlProgress.Window.TopMost = $topMost
+ $xamlProgress.Window.Icon = $AppDeployLogoIcon
+ $xamlProgress.Window.Grid.Image.Source = $appDeployLogoBanner
+ $xamlProgress.Window.Grid.TextBlock.Text = $ProgressStatusMessage
+ $xamlProgress.Window.Title = $installTitle
+ # Parse the XAML
+ $progressReader = New-Object -TypeName 'System.Xml.XmlNodeReader' -ArgumentList $xamlProgress
+ $script:ProgressSyncHash.Window = [Windows.Markup.XamlReader]::Load($progressReader)
+ $script:ProgressSyncHash.ProgressText = $script:ProgressSyncHash.Window.FindName('ProgressText')
+ # Add an action to the Window.Closing event handler to disable the close button
+ $script:ProgressSyncHash.Window.Add_Closing({ $_.Cancel = $true })
+ # Allow the window to be dragged by clicking on it anywhere
+ $script:ProgressSyncHash.Window.Add_MouseLeftButtonDown({ $script:ProgressSyncHash.Window.DragMove() })
+ # Add a tooltip
+ $script:ProgressSyncHash.Window.ToolTip = $installTitle
+ $null = $script:ProgressSyncHash.Window.ShowDialog()
+ $script:ProgressSyncHash.Error = $Error
+ })
+
+ $progressCmd.Runspace = $script:ProgressRunspace
+ Write-Log -Message "Spin up progress dialog in a separate thread with message: [$statusMessage]." -Source ${CmdletName}
+ # Invoke the progress runspace
+ $progressData = $progressCmd.BeginInvoke()
+ # Allow the thread to be spun up safely before invoking actions against it.
+ Start-Sleep -Seconds 1
+ If ($script:ProgressSyncHash.Error) {
+ Write-Log -Message "Failure while displaying progress dialog. `n$(Resolve-Error -ErrorRecord $script:ProgressSyncHash.Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ ## Check if the progress thread is running before invoking methods on it
+ ElseIf ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -eq 'Running') {
+ # Update the progress text
+ Try {
+ $script:ProgressSyncHash.Window.Dispatcher.Invoke([Windows.Threading.DispatcherPriority]'Send', [Windows.Input.InputEventHandler]{ $script:ProgressSyncHash.ProgressText.Text = $statusMessage }, $null, $null)
+ Write-Log -Message "Updated progress message: [$statusMessage]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Unable to update the progress message. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Close-InstallationProgress
+Function Close-InstallationProgress {
+<#
+.SYNOPSIS
+ Closes the dialog created by Show-InstallationProgress.
+.DESCRIPTION
+ Closes the dialog created by Show-InstallationProgress.
+ This function is called by the Exit-Script function to close a running instance of the progress dialog if found.
+.EXAMPLE
+ Close-InstallationProgress
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ If ($script:ProgressSyncHash.Window.Dispatcher.Thread.ThreadState -eq 'Running') {
+ ## Close the progress thread
+ Write-Log -Message 'Close the installation progress dialog.' -Source ${CmdletName}
+ $script:ProgressSyncHash.Window.Dispatcher.InvokeShutdown()
+ $script:ProgressSyncHash.Clear()
+ $script:ProgressRunspace.Close()
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-PinnedApplication
+Function Set-PinnedApplication {
+<#
+.SYNOPSIS
+ Pins or unpins a shortcut to the start menu or task bar.
+.DESCRIPTION
+ Pins or unpins a shortcut to the start menu or task bar.
+ This should typically be run in the user context, as pinned items are stored in the user profile.
+.PARAMETER Action
+ Action to be performed. Options: 'PintoStartMenu','UnpinfromStartMenu','PintoTaskbar','UnpinfromTaskbar'.
+.PARAMETER FilePath
+ Path to the shortcut file to be pinned or unpinned.
+.EXAMPLE
+ Set-PinnedApplication -Action 'PintoStartMenu' -FilePath "$envProgramFilesX86\IBM\Lotus\Notes\notes.exe"
+.EXAMPLE
+ Set-PinnedApplication -Action 'UnpinfromTaskbar' -FilePath "$envProgramFilesX86\IBM\Lotus\Notes\notes.exe"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('PintoStartMenu','UnpinfromStartMenu','PintoTaskbar','UnpinfromTaskbar')]
+ [string]$Action,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ #region Function Get-PinVerb
+ Function Get-PinVerb {
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [int32]$VerbId
+ )
+
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-Log -Message "Get localized pin verb for verb id [$VerbID]." -Source ${CmdletName}
+ [string]$PinVerb = [PSADT.FileVerb]::GetPinVerb($VerbId)
+ Write-Log -Message "Verb ID [$VerbID] has a localized pin verb of [$PinVerb]." -Source ${CmdletName}
+ Write-Output -InputObject $PinVerb
+ }
+ #endregion
+
+ #region Function Invoke-Verb
+ Function Invoke-Verb {
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Verb
+ )
+
+ Try {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ $verb = $verb.Replace('&','')
+ $path = Split-Path -Path $FilePath -Parent -ErrorAction 'Stop'
+ $folder = $shellApp.Namespace($path)
+ $item = $folder.ParseName((Split-Path -Path $FilePath -Leaf -ErrorAction 'Stop'))
+ $itemVerb = $item.Verbs() | Where-Object { $_.Name.Replace('&','') -eq $verb } -ErrorAction 'Stop'
+
+ If ($null -eq $itemVerb) {
+ Write-Log -Message "Performing action [$verb] is not programmatically supported for this file [$FilePath]." -Severity 2 -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Perform action [$verb] on [$FilePath]." -Source ${CmdletName}
+ $itemVerb.DoIt()
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to perform action [$verb] on [$FilePath]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ #endregion
+
+ If (([version]$envOSVersion).Major -ge 10) {
+ Write-Log -Message "Detected Windows 10 or higher, using Windows 10 verb codes." -Source ${CmdletName}
+ [hashtable]$Verbs = @{
+ 'PintoStartMenu' = 51201
+ 'UnpinfromStartMenu' = 51394
+ 'PintoTaskbar' = 5386
+ 'UnpinfromTaskbar' = 5387
+ }
+ }
+ Else {
+ [hashtable]$Verbs = @{
+ 'PintoStartMenu' = 5381
+ 'UnpinfromStartMenu' = 5382
+ 'PintoTaskbar' = 5386
+ 'UnpinfromTaskbar' = 5387
+ }
+ }
+
+ }
+ Process {
+ Try {
+ Write-Log -Message "Execute action [$Action] for file [$FilePath]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf' -ErrorAction 'Stop')) {
+ Throw "Path [$filePath] does not exist."
+ }
+
+ If (-not ($Verbs.$Action)) {
+ Throw "Action [$Action] not supported. Supported actions are [$($Verbs.Keys -join ', ')]."
+ }
+
+ [string]$PinVerbAction = Get-PinVerb -VerbId $Verbs.$Action
+ If (-not ($PinVerbAction)) {
+ Throw "Failed to get a localized pin verb for action [$Action]. Action is not supported on this operating system."
+ }
+
+ Invoke-Verb -FilePath $FilePath -Verb $PinVerbAction
+ }
+ Catch {
+ Write-Log -Message "Failed to execute action [$Action]. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-IniValue
+Function Get-IniValue {
+<#
+.SYNOPSIS
+ Parses an INI file and returns the value of the specified section and key.
+.DESCRIPTION
+ Parses an INI file and returns the value of the specified section and key.
+.PARAMETER FilePath
+ Path to the INI file.
+.PARAMETER Section
+ Section within the INI file.
+.PARAMETER Key
+ Key within the section of the INI file.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-IniValue -FilePath "$envProgramFilesX86\IBM\Notes\notes.ini" -Section 'Notes' -Key 'KeyFileName'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Section,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Read INI Key: [Section = $Section] [Key = $Key]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ $IniValue = [PSADT.IniFile]::GetIniValue($Section, $Key, $FilePath)
+ Write-Log -Message "INI Key Value: [Section = $Section] [Key = $Key] [Value = $IniValue]." -Source ${CmdletName}
+
+ Write-Output -InputObject $IniValue
+ }
+ Catch {
+ Write-Log -Message "Failed to read INI file key value. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to read INI file key value: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-IniValue
+Function Set-IniValue {
+<#
+.SYNOPSIS
+ Opens an INI file and sets the value of the specified section and key.
+.DESCRIPTION
+ Opens an INI file and sets the value of the specified section and key.
+.PARAMETER FilePath
+ Path to the INI file.
+.PARAMETER Section
+ Section within the INI file.
+.PARAMETER Key
+ Key within the section of the INI file.
+.PARAMETER Value
+ Value for the key within the section of the INI file. To remove a value, set this variable to $null.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-IniValue -FilePath "$envProgramFilesX86\IBM\Notes\notes.ini" -Section 'Notes' -Key 'KeyFileName' -Value 'MyFile.ID'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Section,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key,
+ # Don't strongly type this variable as [string] b/c PowerShell replaces [string]$Value = $null with an empty string
+ [Parameter(Mandatory=$true)]
+ [AllowNull()]
+ $Value,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Write INI Key Value: [Section = $Section] [Key = $Key] [Value = $Value]." -Source ${CmdletName}
+
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ [PSADT.IniFile]::SetIniValue($Section, $Key, ([Text.StringBuilder]$Value), $FilePath)
+ }
+ Catch {
+ Write-Log -Message "Failed to write INI file key value. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to write INI file key value: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-PEFileArchitecture
+Function Get-PEFileArchitecture {
+<#
+.SYNOPSIS
+ Determine if a PE file is a 32-bit or a 64-bit file.
+.DESCRIPTION
+ Determine if a PE file is a 32-bit or a 64-bit file by examining the file's image file header.
+ PE file extensions: .exe, .dll, .ocx, .drv, .sys, .scr, .efi, .cpl, .fon
+.PARAMETER FilePath
+ Path to the PE file to examine.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.PARAMETER PassThru
+ Get the file object, attach a property indicating the file binary type, and write to pipeline
+.EXAMPLE
+ Get-PEFileArchitecture -FilePath "$env:windir\notepad.exe"
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ValueFromPipeline=$true,ValueFromPipelineByPropertyName=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [IO.FileInfo[]]$FilePath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true,
+ [Parameter(Mandatory=$false)]
+ [switch]$PassThru
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ [string[]]$PEFileExtensions = '.exe', '.dll', '.ocx', '.drv', '.sys', '.scr', '.efi', '.cpl', '.fon'
+ [int32]$MACHINE_OFFSET = 4
+ [int32]$PE_POINTER_OFFSET = 60
+ }
+ Process {
+ ForEach ($Path in $filePath) {
+ Try {
+ If ($PEFileExtensions -notcontains $Path.Extension) {
+ Throw "Invalid file type. Please specify one of the following PE file types: $($PEFileExtensions -join ', ')"
+ }
+
+ [byte[]]$data = New-Object -TypeName 'System.Byte[]' -ArgumentList 4096
+ $stream = New-Object -TypeName 'System.IO.FileStream' -ArgumentList ($Path.FullName, 'Open', 'Read')
+ $null = $stream.Read($data, 0, 4096)
+ $stream.Flush()
+ $stream.Close()
+
+ [int32]$PE_HEADER_ADDR = [BitConverter]::ToInt32($data, $PE_POINTER_OFFSET)
+ [uint16]$PE_IMAGE_FILE_HEADER = [BitConverter]::ToUInt16($data, $PE_HEADER_ADDR + $MACHINE_OFFSET)
+ Switch ($PE_IMAGE_FILE_HEADER) {
+ 0 { $PEArchitecture = 'Native' } # The contents of this file are assumed to be applicable to any machine type
+ 0x014c { $PEArchitecture = '32BIT' } # File for Windows 32-bit systems
+ 0x0200 { $PEArchitecture = 'Itanium-x64' } # File for Intel Itanium x64 processor family
+ 0x8664 { $PEArchitecture = '64BIT' } # File for Windows 64-bit systems
+ Default { $PEArchitecture = 'Unknown' }
+ }
+ Write-Log -Message "File [$($Path.FullName)] has a detected file architecture of [$PEArchitecture]." -Source ${CmdletName}
+
+ If ($PassThru) {
+ # Get the file object, attach a property indicating the type, and write to pipeline
+ Get-Item -LiteralPath $Path.FullName -Force | Add-Member -MemberType 'NoteProperty' -Name 'BinaryType' -Value $PEArchitecture -Force -PassThru | Write-Output
+ }
+ Else {
+ Write-Output -InputObject $PEArchitecture
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get the PE file architecture. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the PE file architecture: $($_.Exception.Message)"
+ }
+ Continue
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-RegisterOrUnregisterDLL
+Function Invoke-RegisterOrUnregisterDLL {
+<#
+.SYNOPSIS
+ Register or unregister a DLL file.
+.DESCRIPTION
+ Register or unregister a DLL file using regsvr32.exe. Function can be invoked using alias: 'Register-DLL' or 'Unregister-DLL'.
+.PARAMETER FilePath
+ Path to the DLL file.
+.PARAMETER DLLAction
+ Specify whether to register or unregister the DLL. Optional if function is invoked using 'Register-DLL' or 'Unregister-DLL' alias.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Register-DLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll"
+ Register DLL file using the "Register-DLL" alias for this function
+.EXAMPLE
+ UnRegister-DLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll"
+ Unregister DLL file using the "Unregister-DLL" alias for this function
+.EXAMPLE
+ Invoke-RegisterOrUnregisterDLL -FilePath "C:\Test\DcTLSFileToDMSComp.dll" -DLLAction 'Register'
+ Register DLL file using the actual name of this function
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$FilePath,
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Register','Unregister')]
+ [string]$DLLAction,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Get name used to invoke this function in case the 'Register-DLL' or 'Unregister-DLL' alias was used and set the correct DLL action
+ [string]${InvokedCmdletName} = $MyInvocation.InvocationName
+ # Set the correct register/unregister action based on the alias used to invoke this function
+ If (${InvokedCmdletName} -ne ${CmdletName}) {
+ Switch (${InvokedCmdletName}) {
+ 'Register-DLL' { [string]$DLLAction = 'Register' }
+ 'Unregister-DLL' { [string]$DLLAction = 'Unregister' }
+ }
+ }
+ # Set the correct DLL register/unregister action parameters
+ If (-not $DLLAction) { Throw 'Parameter validation failed. Please specify the [-DLLAction] parameter to determine whether to register or unregister the DLL.' }
+ [string]$DLLAction = ((Get-Culture).TextInfo).ToTitleCase($DLLAction.ToLower())
+ Switch ($DLLAction) {
+ 'Register' { [string]$DLLActionParameters = "/s `"$FilePath`"" }
+ 'Unregister' { [string]$DLLActionParameters = "/s /u `"$FilePath`"" }
+ }
+ }
+ Process {
+ Try {
+ Write-Log -Message "$DLLAction DLL file [$filePath]." -Source ${CmdletName}
+ If (-not (Test-Path -LiteralPath $FilePath -PathType 'Leaf')) { Throw "File [$filePath] could not be found." }
+
+ [string]$DLLFileBitness = Get-PEFileArchitecture -FilePath $filePath -ContinueOnError $false -ErrorAction 'Stop'
+ If (($DLLFileBitness -ne '64BIT') -and ($DLLFileBitness -ne '32BIT')) {
+ Throw "File [$filePath] has a detected file architecture of [$DLLFileBitness]. Only 32-bit or 64-bit DLL files can be $($DLLAction.ToLower() + 'ed')."
+ }
+
+ If ($Is64Bit) {
+ If ($DLLFileBitness -eq '64BIT') {
+ If ($Is64BitProcess) {
+ [string]$RegSvr32Path = "$envWinDir\system32\regsvr32.exe"
+ }
+ Else {
+ [string]$RegSvr32Path = "$envWinDir\sysnative\regsvr32.exe"
+ }
+ }
+ ElseIf ($DLLFileBitness -eq '32BIT') {
+ [string]$RegSvr32Path = "$envWinDir\SysWOW64\regsvr32.exe"
+ }
+ }
+ Else {
+ If ($DLLFileBitness -eq '64BIT') {
+ Throw "File [$filePath] cannot be $($DLLAction.ToLower()) because it is a 64-bit file on a 32-bit operating system."
+ }
+ ElseIf ($DLLFileBitness -eq '32BIT') {
+ [string]$RegSvr32Path = "$envWinDir\system32\regsvr32.exe"
+ }
+ }
+
+ [psobject]$ExecuteResult = Execute-Process -Path $RegSvr32Path -Parameters $DLLActionParameters -WindowStyle 'Hidden' -PassThru
+
+ If ($ExecuteResult.ExitCode -ne 0) {
+ If ($ExecuteResult.ExitCode -eq 60002) {
+ Throw "Execute-Process function failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ Else {
+ Throw "regsvr32.exe failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to $($DLLAction.ToLower()) DLL file. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $($DLLAction.ToLower()) DLL file: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+Set-Alias -Name 'Register-DLL' -Value 'Invoke-RegisterOrUnregisterDLL' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+Set-Alias -Name 'Unregister-DLL' -Value 'Invoke-RegisterOrUnregisterDLL' -Scope 'Script' -Force -ErrorAction 'SilentlyContinue'
+#endregion
+
+
+#region Function Invoke-ObjectMethod
+Function Invoke-ObjectMethod {
+<#
+.SYNOPSIS
+ Invoke method on any object.
+.DESCRIPTION
+ Invoke method on any object with or without using named parameters.
+.PARAMETER InputObject
+ Specifies an object which has methods that can be invoked.
+.PARAMETER MethodName
+ Specifies the name of a method to invoke.
+.PARAMETER ArgumentList
+ Argument to pass to the method being executed. Allows execution of method without specifying named parameters.
+.PARAMETER Parameter
+ Argument to pass to the method being executed. Allows execution of method by using named parameters.
+.EXAMPLE
+ $ShellApp = New-Object -ComObject 'Shell.Application'
+ $null = Invoke-ObjectMethod -InputObject $ShellApp -MethodName 'MinimizeAll'
+ Minimizes all windows.
+.EXAMPLE
+ $ShellApp = New-Object -ComObject 'Shell.Application'
+ $null = Invoke-ObjectMethod -InputObject $ShellApp -MethodName 'Explore' -Parameter @{'vDir'='C:\Windows'}
+ Opens the C:\Windows folder in a Windows Explorer window.
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='Positional')]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNull()]
+ [object]$InputObject,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$MethodName,
+ [Parameter(Mandatory=$false,Position=2,ParameterSetName='Positional')]
+ [object[]]$ArgumentList,
+ [Parameter(Mandatory=$true,Position=2,ParameterSetName='Named')]
+ [ValidateNotNull()]
+ [hashtable]$Parameter
+ )
+
+ Begin { }
+ Process {
+ If ($PSCmdlet.ParameterSetName -eq 'Named') {
+ ## Invoke method by using parameter names
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($MethodName, [Reflection.BindingFlags]::InvokeMethod, $null, $InputObject, ([object[]]($Parameter.Values)), $null, $null, ([string[]]($Parameter.Keys)))
+ }
+ Else {
+ ## Invoke method without using parameter names
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($MethodName, [Reflection.BindingFlags]::InvokeMethod, $null, $InputObject, $ArgumentList, $null, $null, $null)
+ }
+ }
+ End { }
+}
+#endregion
+
+
+#region Function Get-ObjectProperty
+Function Get-ObjectProperty {
+<#
+.SYNOPSIS
+ Get a property from any object.
+.DESCRIPTION
+ Get a property from any object.
+.PARAMETER InputObject
+ Specifies an object which has properties that can be retrieved.
+.PARAMETER PropertyName
+ Specifies the name of a property to retrieve.
+.PARAMETER ArgumentList
+ Argument to pass to the property being retrieved.
+.EXAMPLE
+ Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @(1)
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0)]
+ [ValidateNotNull()]
+ [object]$InputObject,
+ [Parameter(Mandatory=$true,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyName,
+ [Parameter(Mandatory=$false,Position=2)]
+ [object[]]$ArgumentList
+ )
+
+ Begin { }
+ Process {
+ ## Retrieve property
+ Write-Output -InputObject $InputObject.GetType().InvokeMember($PropertyName, [Reflection.BindingFlags]::GetProperty, $null, $InputObject, $ArgumentList, $null, $null, $null)
+ }
+ End { }
+}
+#endregion
+
+
+#region Function Get-MsiTableProperty
+Function Get-MsiTableProperty {
+<#
+.SYNOPSIS
+ Get all of the properties from a Windows Installer database table or the Summary Information stream and return as a custom object.
+.DESCRIPTION
+ Use the Windows Installer object to read all of the properties from a Windows Installer database table or the Summary Information stream.
+.PARAMETER Path
+ The fully qualified path to an database file. Supports .msi and .msp files.
+.PARAMETER TransformPath
+ The fully qualified path to a list of MST file(s) which should be applied to the MSI file.
+.PARAMETER Table
+ The name of the the MSI table from which all of the properties must be retrieved. Default is: 'Property'.
+.PARAMETER TablePropertyNameColumnNum
+ Specify the table column number which contains the name of the properties. Default is: 1 for MSIs and 2 for MSPs.
+.PARAMETER TablePropertyValueColumnNum
+ Specify the table column number which contains the value of the properties. Default is: 2 for MSIs and 3 for MSPs.
+.PARAMETER GetSummaryInformation
+ Retrieves the Summary Information for the Windows Installer database.
+ Summary Information property descriptions: https://msdn.microsoft.com/en-us/library/aa372049(v=vs.85).aspx
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -TransformPath 'C:\Package\AppDeploy.mst'
+ Retrieve all of the properties from the default 'Property' table.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -TransformPath 'C:\Package\AppDeploy.mst' -Table 'Property' | Select-Object -ExpandProperty ProductCode
+ Retrieve all of the properties from the 'Property' table and then pipe to Select-Object to select the ProductCode property.
+.EXAMPLE
+ Get-MsiTableProperty -Path 'C:\Package\AppDeploy.msi' -GetSummaryInformation
+ Retrieves the Summary Information for the Windows Installer database.
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding(DefaultParameterSetName='TableInfo')]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$Path,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string[]]$TransformPath,
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullOrEmpty()]
+ [string]$Table = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 'Property' } Else { 'MsiPatchMetadata' }),
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullorEmpty()]
+ [int32]$TablePropertyNameColumnNum = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 1 } Else { 2 }),
+ [Parameter(Mandatory=$false,ParameterSetName='TableInfo')]
+ [ValidateNotNullorEmpty()]
+ [int32]$TablePropertyValueColumnNum = $(If ([IO.Path]::GetExtension($Path) -eq '.msi') { 2 } Else { 3 }),
+ [Parameter(Mandatory=$true,ParameterSetName='SummaryInfo')]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetSummaryInformation = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'TableInfo') {
+ Write-Log -Message "Read data from Windows Installer database file [$Path] in table [$Table]." -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message "Read the Summary Information from the Windows Installer database file [$Path]." -Source ${CmdletName}
+ }
+
+ ## Create a Windows Installer object
+ [__comobject]$Installer = New-Object -ComObject 'WindowsInstaller.Installer' -ErrorAction 'Stop'
+ ## Determine if the database file is a patch (.msp) or not
+ If ([IO.Path]::GetExtension($Path) -eq '.msp') { [boolean]$IsMspFile = $true }
+ ## Define properties for how the MSI database is opened
+ [int32]$msiOpenDatabaseModeReadOnly = 0
+ [int32]$msiSuppressApplyTransformErrors = 63
+ [int32]$msiOpenDatabaseMode = $msiOpenDatabaseModeReadOnly
+ [int32]$msiOpenDatabaseModePatchFile = 32
+ If ($IsMspFile) { [int32]$msiOpenDatabaseMode = $msiOpenDatabaseModePatchFile }
+ ## Open database in read only mode
+ [__comobject]$Database = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($Path, $msiOpenDatabaseMode)
+ ## Apply a list of transform(s) to the database
+ If (($TransformPath) -and (-not $IsMspFile)) {
+ ForEach ($Transform in $TransformPath) {
+ $null = Invoke-ObjectMethod -InputObject $Database -MethodName 'ApplyTransform' -ArgumentList @($Transform, $msiSuppressApplyTransformErrors)
+ }
+ }
+
+ ## Get either the requested windows database table information or summary information
+ If ($PSCmdlet.ParameterSetName -eq 'TableInfo') {
+ ## Open the requested table view from the database
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $Database -MethodName 'OpenView' -ArgumentList @("SELECT * FROM $Table")
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+
+ ## Create an empty object to store properties in
+ [psobject]$TableProperties = New-Object -TypeName 'PSObject'
+
+ ## Retrieve the first row from the requested table. If the first row was successfully retrieved, then save data and loop through the entire table.
+ # https://msdn.microsoft.com/en-us/library/windows/desktop/aa371136(v=vs.85).aspx
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+ While ($Record) {
+ # Read string data from record and add property/value pair to custom object
+ $TableProperties | Add-Member -MemberType 'NoteProperty' -Name (Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @($TablePropertyNameColumnNum)) -Value (Get-ObjectProperty -InputObject $Record -PropertyName 'StringData' -ArgumentList @($TablePropertyValueColumnNum)) -Force
+ # Retrieve the next row in the table
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+ }
+ Write-Output -InputObject $TableProperties
+ }
+ Else {
+ ## Get the SummaryInformation from the windows installer database
+ [__comobject]$SummaryInformation = Get-ObjectProperty -InputObject $Database -PropertyName 'SummaryInformation'
+ [hashtable]$SummaryInfoProperty = @{}
+ ## Summary property descriptions: https://msdn.microsoft.com/en-us/library/aa372049(v=vs.85).aspx
+ $SummaryInfoProperty.Add('CodePage', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(1)))
+ $SummaryInfoProperty.Add('Title', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(2)))
+ $SummaryInfoProperty.Add('Subject', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(3)))
+ $SummaryInfoProperty.Add('Author', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(4)))
+ $SummaryInfoProperty.Add('Keywords', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(5)))
+ $SummaryInfoProperty.Add('Comments', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(6)))
+ $SummaryInfoProperty.Add('Template', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(7)))
+ $SummaryInfoProperty.Add('LastSavedBy', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(8)))
+ $SummaryInfoProperty.Add('RevisionNumber', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(9)))
+ $SummaryInfoProperty.Add('LastPrinted', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(11)))
+ $SummaryInfoProperty.Add('CreateTimeDate', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(12)))
+ $SummaryInfoProperty.Add('LastSaveTimeDate', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(13)))
+ $SummaryInfoProperty.Add('PageCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(14)))
+ $SummaryInfoProperty.Add('WordCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(15)))
+ $SummaryInfoProperty.Add('CharacterCount', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(16)))
+ $SummaryInfoProperty.Add('CreatingApplication', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(18)))
+ $SummaryInfoProperty.Add('Security', (Get-ObjectProperty -InputObject $SummaryInformation -PropertyName 'Property' -ArgumentList @(19)))
+ [psobject]$SummaryInfoProperties = New-Object -TypeName 'PSObject' -Property $SummaryInfoProperty
+ Write-Output -InputObject $SummaryInfoProperties
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to get the MSI table [$Table]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the MSI table [$Table]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try {
+ If ($View) {
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View) } Catch { }
+ }
+ ElseIf($SummaryInformation) {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SummaryInformation) } Catch { }
+ }
+ }
+ Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($DataBase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-MsiProperty
+Function Set-MsiProperty {
+<#
+.SYNOPSIS
+ Set a property in the MSI property table.
+.DESCRIPTION
+ Set a property in the MSI property table.
+.PARAMETER DataBase
+ Specify a ComObject representing an MSI database opened in view/modify/update mode.
+.PARAMETER PropertyName
+ The name of the property to be set/modified.
+.PARAMETER PropertyValue
+ The value of the property to be set/modified.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-MsiProperty -DataBase $TempMsiPathDatabase -PropertyName 'ALLUSERS' -PropertyValue '1'
+.NOTES
+ This is an internal script function and should typically not be called directly.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [__comobject]$DataBase,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyName,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$PropertyValue,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]." -Source ${CmdletName}
+
+ ## Open the requested table view from the database
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("SELECT * FROM Property WHERE Property='$PropertyName'")
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+
+ ## Retrieve the requested property from the requested table.
+ # https://msdn.microsoft.com/en-us/library/windows/desktop/aa371136(v=vs.85).aspx
+ [__comobject]$Record = Invoke-ObjectMethod -InputObject $View -MethodName 'Fetch'
+
+ ## Close the previous view on the MSI database
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View)
+
+ ## Set the MSI property
+ If ($Record) {
+ # If the property already exists, then create the view for updating the property
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("UPDATE Property SET Value='$PropertyValue' WHERE Property='$PropertyName'")
+ }
+ Else {
+ # If property does not exist, then create view for inserting the property
+ [__comobject]$View = Invoke-ObjectMethod -InputObject $DataBase -MethodName 'OpenView' -ArgumentList @("INSERT INTO Property (Property, Value) VALUES ('$PropertyName','$PropertyValue')")
+ }
+ # Execute the view to set the MSI property
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Execute'
+ }
+ Catch {
+ Write-Log -Message "Failed to set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set the MSI Property Name [$PropertyName] with Property Value [$PropertyValue]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try {
+ If ($View) {
+ $null = Invoke-ObjectMethod -InputObject $View -MethodName 'Close' -ArgumentList @()
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($View)
+ }
+ }
+ Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function New-MsiTransform
+Function New-MsiTransform {
+<#
+.SYNOPSIS
+ Create a transform file for an MSI database.
+.DESCRIPTION
+ Create a transform file for an MSI database and create/modify properties in the Properties table.
+.PARAMETER MsiPath
+ Specify the path to an MSI file.
+.PARAMETER ApplyTransformPath
+ Specify the path to a transform which should be applied to the MSI database before any new properties are created or modified.
+.PARAMETER NewTransformPath
+ Specify the path where the new transform file with the desired properties will be created. If a transform file of the same name already exists, it will be deleted before a new one is created.
+ Default is: a) If -ApplyTransformPath was specified but not -NewTransformPath, then .new.mst
+ b) If only -MsiPath was specified, then .mst
+.PARAMETER TransformProperties
+ Hashtable which contains calls to Set-MsiProperty for configuring the desired properties which should be included in new transform file.
+ Example hashtable: [hashtable]$TransformProperties = @{ 'ALLUSERS' = '1' }
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ [hashtable]$TransformProperties = {
+ 'ALLUSERS' = '1'
+ 'AgreeToLicense' = 'Yes'
+ 'REBOOT' = 'ReallySuppress'
+ 'RebootYesNo' = 'No'
+ 'ROOTDRIVE' = 'C:'
+ }
+ New-MsiTransform -MsiPath 'C:\Temp\PSADTInstall.msi' -TransformProperties $TransformProperties
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$MsiPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateScript({ Test-Path -LiteralPath $_ -PathType 'Leaf' })]
+ [string]$ApplyTransformPath,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$NewTransformPath,
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [hashtable]$TransformProperties,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Define properties for how the MSI database is opened
+ [int32]$msiOpenDatabaseModeReadOnly = 0
+ [int32]$msiOpenDatabaseModeTransact = 1
+ [int32]$msiViewModifyUpdate = 2
+ [int32]$msiViewModifyReplace = 4
+ [int32]$msiViewModifyDelete = 6
+ [int32]$msiTransformErrorNone = 0
+ [int32]$msiTransformValidationNone = 0
+ [int32]$msiSuppressApplyTransformErrors = 63
+ }
+ Process {
+ Try {
+ Write-Log -Message "Create a transform file for MSI [$MsiPath]." -Source ${CmdletName}
+
+ ## Discover the parent folder that the MSI file resides in
+ [string]$MsiParentFolder = Split-Path -Path $MsiPath -Parent -ErrorAction 'Stop'
+
+ ## Create a temporary file name for storing a second copy of the MSI database
+ [string]$TempMsiPath = Join-Path -Path $MsiParentFolder -ChildPath ([IO.Path]::GetFileName(([IO.Path]::GetTempFileName()))) -ErrorAction 'Stop'
+
+ ## Create a second copy of the MSI database
+ Write-Log -Message "Copy MSI database in path [$MsiPath] to destination [$TempMsiPath]." -Source ${CmdletName}
+ $null = Copy-Item -LiteralPath $MsiPath -Destination $TempMsiPath -Force -ErrorAction 'Stop'
+
+ ## Create a Windows Installer object
+ [__comobject]$Installer = New-Object -ComObject 'WindowsInstaller.Installer' -ErrorAction 'Stop'
+
+ ## Open both copies of the MSI database
+ # Open the original MSI database in read only mode
+ Write-Log -Message "Open the MSI database [$MsiPath] in read only mode." -Source ${CmdletName}
+ [__comobject]$MsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($MsiPath, $msiOpenDatabaseModeReadOnly)
+ # Open the temporary copy of the MSI database in view/modify/update mode
+ Write-Log -Message "Open the MSI database [$TempMsiPath] in view/modify/update mode." -Source ${CmdletName}
+ [__comobject]$TempMsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($TempMsiPath, $msiViewModifyUpdate)
+
+ ## If a MSI transform file was specified, then apply it to the temporary copy of the MSI database
+ If ($ApplyTransformPath) {
+ Write-Log -Message "Apply transform file [$ApplyTransformPath] to MSI database [$TempMsiPath]." -Source ${CmdletName}
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'ApplyTransform' -ArgumentList @($ApplyTransformPath, $msiSuppressApplyTransformErrors)
+ }
+
+ ## Determine the path for the new transform file that will be generated
+ If (-not $NewTransformPath) {
+ If ($ApplyTransformPath) {
+ [string]$NewTransformFileName = [IO.Path]::GetFileNameWithoutExtension($ApplyTransformPath) + '.new' + [IO.Path]::GetExtension($ApplyTransformPath)
+ }
+ Else {
+ [string]$NewTransformFileName = [IO.Path]::GetFileNameWithoutExtension($MsiPath) + '.mst'
+ }
+ [string]$NewTransformPath = Join-Path -Path $MsiParentFolder -ChildPath $NewTransformFileName -ErrorAction 'Stop'
+ }
+
+ ## Set the MSI properties in the temporary copy of the MSI database
+ $TransformProperties.GetEnumerator() | ForEach-Object { Set-MsiProperty -DataBase $TempMsiPathDatabase -PropertyName $_.Key -PropertyValue $_.Value }
+
+ ## Commit the new properties to the temporary copy of the MSI database
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'Commit'
+
+ ## Reopen the temporary copy of the MSI database in read only mode
+ # Release the database object for the temporary copy of the MSI database
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($TempMsiPathDatabase)
+ # Open the temporary copy of the MSI database in read only mode
+ Write-Log -Message "Re-open the MSI database [$TempMsiPath] in read only mode." -Source ${CmdletName}
+ [__comobject]$TempMsiPathDatabase = Invoke-ObjectMethod -InputObject $Installer -MethodName 'OpenDatabase' -ArgumentList @($TempMsiPath, $msiOpenDatabaseModeReadOnly)
+
+ ## Delete the new transform file path if it already exists
+ If (Test-Path -LiteralPath $NewTransformPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "A transform file of the same name already exists. Deleting transform file [$NewTransformPath]." -Source ${CmdletName}
+ $null = Remove-Item -LiteralPath $NewTransformPath -Force -ErrorAction 'Stop'
+ }
+
+ ## Generate the new transform file by taking the difference between the temporary copy of the MSI database and the original MSI database
+ Write-Log -Message "Generate new transform file [$NewTransformPath]." -Source ${CmdletName}
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'GenerateTransform' -ArgumentList @($MsiPathDatabase, $NewTransformPath)
+ $null = Invoke-ObjectMethod -InputObject $TempMsiPathDatabase -MethodName 'CreateTransformSummaryInfo' -ArgumentList @($MsiPathDatabase, $NewTransformPath, $msiTransformErrorNone, $msiTransformValidationNone)
+
+ If (Test-Path -LiteralPath $NewTransformPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ Write-Log -Message "Successfully created new transform file in path [$NewTransformPath]." -Source ${CmdletName}
+ }
+ Else {
+ Throw "Failed to generate transform file in path [$NewTransformPath]."
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to create new transform file in path [$NewTransformPath]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to create new transform file in path [$NewTransformPath]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($TempMsiPathDatabase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($MsiPathDatabase) } Catch { }
+ Try { $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($Installer) } Catch { }
+ Try {
+ ## Delete the temporary copy of the MSI database
+ If (Test-Path -LiteralPath $TempMsiPath -PathType 'Leaf' -ErrorAction 'Stop') {
+ $null = Remove-Item -LiteralPath $TempMsiPath -Force -ErrorAction 'Stop'
+ }
+ }
+ Catch { }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-MSUpdates
+Function Test-MSUpdates {
+<#
+.SYNOPSIS
+ Test whether a Microsoft Windows update is installed.
+.DESCRIPTION
+ Test whether a Microsoft Windows update is installed.
+.PARAMETER KBNumber
+ KBNumber of the update.
+.PARAMETER ContinueOnError
+ Suppress writing log message to console on failure to write message to log file. Default is: $true.
+.EXAMPLE
+ Test-MSUpdates -KBNumber 'KB2549864'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,Position=0,HelpMessage='Enter the KB Number for the Microsoft Update')]
+ [ValidateNotNullorEmpty()]
+ [string]$KBNumber,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Check if Microsoft Update [$kbNumber] is installed." -Source ${CmdletName}
+
+ ## Default is not found
+ [boolean]$kbFound = $false
+
+ ## Check for update using built in PS cmdlet which uses WMI in the background to gather details
+ Get-Hotfix -Id $kbNumber -ErrorAction 'SilentlyContinue' | ForEach-Object { $kbFound = $true }
+
+ If (-not $kbFound) {
+ Write-Log -Message 'Unable to detect Windows update history via Get-Hotfix cmdlet. Trying via COM object.' -Source ${CmdletName}
+
+ ## Check for update using ComObject method (to catch Office updates)
+ [__comobject]$UpdateSession = New-Object -ComObject "Microsoft.Update.Session"
+ [__comobject]$UpdateSearcher = $UpdateSession.CreateUpdateSearcher()
+ # Indicates whether the search results include updates that are superseded by other updates in the search results
+ $UpdateSearcher.IncludePotentiallySupersededUpdates = $false
+ # Indicates whether the UpdateSearcher goes online to search for updates.
+ $UpdateSearcher.Online = $false
+ [int32]$UpdateHistoryCount = $UpdateSearcher.GetTotalHistoryCount()
+ If ($UpdateHistoryCount -gt 0) {
+ [psobject]$UpdateHistory = $UpdateSearcher.QueryHistory(0, $UpdateHistoryCount) |
+ Select-Object -Property 'Title','Date',
+ @{Name = 'Operation'; Expression = { Switch ($_.Operation) { 1 {'Installation'}; 2 {'Uninstallation'}; 3 {'Other'} } } },
+ @{Name = 'Status'; Expression = { Switch ($_.ResultCode) { 0 {'Not Started'}; 1 {'In Progress'}; 2 {'Successful'}; 3 {'Incomplete'}; 4 {'Failed'}; 5 {'Aborted'} } } },
+ 'Description' |
+ Sort-Object -Property 'Date' -Descending
+ ForEach ($Update in $UpdateHistory) {
+ If (($Update.Operation -ne 'Other') -and ($Update.Title -match "\($KBNumber\)")) {
+ $LatestUpdateHistory = $Update
+ Break
+ }
+ }
+ If (($LatestUpdateHistory.Operation -eq 'Installation') -and ($LatestUpdateHistory.Status -eq 'Successful')) {
+ Write-Log -Message "Discovered the following Microsoft Update: `n$($LatestUpdateHistory | Format-List | Out-String)" -Source ${CmdletName}
+ $kbFound = $true
+ }
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($UpdateSession)
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($UpdateSearcher)
+ }
+ Else {
+ Write-Log -Message 'Unable to detect Windows update history via COM object.' -Source ${CmdletName}
+ }
+ }
+
+ ## Return Result
+ If (-not $kbFound) {
+ Write-Log -Message "Microsoft Update [$kbNumber] is not installed." -Source ${CmdletName}
+ Write-Output -InputObject $false
+ }
+ Else {
+ Write-Log -Message "Microsoft Update [$kbNumber] is installed." -Source ${CmdletName}
+ Write-Output -InputObject $true
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed discovering Microsoft Update [$kbNumber]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed discovering Microsoft Update [$kbNumber]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Install-MSUpdates
+Function Install-MSUpdates {
+<#
+.SYNOPSIS
+ Install all Microsoft Updates in a given directory.
+.DESCRIPTION
+ Install all Microsoft Updates of type ".exe", ".msu", or ".msp" in a given directory (recursively search directory).
+.PARAMETER Directory
+ Directory containing the updates.
+.EXAMPLE
+ Install-MSUpdates -Directory "$dirFiles\MSUpdates"
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$Directory
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message "Recursively install all Microsoft Updates in directory [$Directory]." -Source ${CmdletName}
+
+ ## KB Number pattern match
+ $kbPattern = '(?i)kb\d{6,8}'
+
+ ## Get all hotfixes and install if required
+ [IO.FileInfo[]]$files = Get-ChildItem -LiteralPath $Directory -Recurse -Include ('*.exe','*.msu','*.msp')
+ ForEach ($file in $files) {
+ If ($file.Name -match 'redist') {
+ [version]$redistVersion = [Diagnostics.FileVersionInfo]::GetVersionInfo($file.FullName).ProductVersion
+ [string]$redistDescription = [Diagnostics.FileVersionInfo]::GetVersionInfo($file.FullName).FileDescription
+
+ Write-Log -Message "Install [$redistDescription $redistVersion]..." -Source ${CmdletName}
+ # Handle older redistributables (ie, VC++ 2005)
+ If ($redistDescription -match 'Win32 Cabinet Self-Extractor') {
+ Execute-Process -Path $file.FullName -Parameters '/q' -WindowStyle 'Hidden' -ContinueOnError $true
+ }
+ Else {
+ Execute-Process -Path $file.FullName -Parameters '/quiet /norestart' -WindowStyle 'Hidden' -ContinueOnError $true
+ }
+ }
+ Else {
+ # Get the KB number of the file
+ [string]$kbNumber = [regex]::Match($file.Name, $kbPattern).ToString()
+ If (-not $kbNumber) { Continue }
+
+ # Check to see whether the KB is already installed
+ If (-not (Test-MSUpdates -KBNumber $kbNumber)) {
+ Write-Log -Message "KB Number [$KBNumber] was not detected and will be installed." -Source ${CmdletName}
+ Switch ($file.Extension) {
+ # Installation type for executables (i.e., Microsoft Office Updates)
+ '.exe' { Execute-Process -Path $file.FullName -Parameters '/quiet /norestart' -WindowStyle 'Hidden' -ContinueOnError $true }
+ # Installation type for Windows updates using Windows Update Standalone Installer
+ '.msu' { Execute-Process -Path 'wusa.exe' -Parameters "`"$($file.FullName)`" /quiet /norestart" -WindowStyle 'Hidden' -ContinueOnError $true }
+ # Installation type for Windows Installer Patch
+ '.msp' { Execute-MSI -Action 'Patch' -Path $file.FullName -ContinueOnError $true }
+ }
+ }
+ Else {
+ Write-Log -Message "KB Number [$kbNumber] is already installed. Continue..." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-WindowTitle
+Function Get-WindowTitle {
+<#
+.SYNOPSIS
+ Search for an open window title and return details about the window.
+.DESCRIPTION
+ Search for a window title. If window title searched for returns more than one result, then details for each window will be displayed.
+ Returns the following properties for each window: WindowTitle, WindowHandle, ParentProcess, ParentProcessMainWindowHandle, ParentProcessId.
+ Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER WindowTitle
+ The title of the application window to search for using regex matching.
+.PARAMETER GetAllWindowTitles
+ Get titles for all open windows on the system.
+.PARAMETER DisableFunctionLogging
+ Disables logging messages to the script log file.
+.EXAMPLE
+ Get-WindowTitle -WindowTitle 'Microsoft Word'
+ Gets details for each window that has the words "Microsoft Word" in the title.
+.EXAMPLE
+ Get-WindowTitle -GetAllWindowTitles
+ Gets details for all windows with a title.
+.EXAMPLE
+ Get-WindowTitle -GetAllWindowTitles | Where-Object { $_.ParentProcess -eq 'WINWORD' }
+ Get details for all windows belonging to Microsoft Word process with name "WINWORD".
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='SearchWinTitle')]
+ [AllowEmptyString()]
+ [string]$WindowTitle,
+ [Parameter(Mandatory=$true,ParameterSetName='GetAllWinTitles')]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetAllWindowTitles = $false,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [switch]$DisableFunctionLogging = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ If ($PSCmdlet.ParameterSetName -eq 'SearchWinTitle') {
+ If (-not $DisableFunctionLogging) { Write-Log -Message "Find open window title(s) [$WindowTitle] using regex matching." -Source ${CmdletName} }
+ }
+ ElseIf ($PSCmdlet.ParameterSetName -eq 'GetAllWinTitles') {
+ If (-not $DisableFunctionLogging) { Write-Log -Message 'Find all open window title(s).' -Source ${CmdletName} }
+ }
+
+ ## Get all window handles for visible windows
+ [IntPtr[]]$VisibleWindowHandles = [PSADT.UiAutomation]::EnumWindows() | Where-Object { [PSADT.UiAutomation]::IsWindowVisible($_) }
+
+ ## Discover details about each visible window that was discovered
+ ForEach ($VisibleWindowHandle in $VisibleWindowHandles) {
+ If (-not $VisibleWindowHandle) { Continue }
+ ## Get the window title
+ [string]$VisibleWindowTitle = [PSADT.UiAutomation]::GetWindowText($VisibleWindowHandle)
+ If ($VisibleWindowTitle) {
+ ## Get the process that spawned the window
+ [Diagnostics.Process]$Process = Get-Process -ErrorAction 'Stop' | Where-Object { $_.Id -eq [PSADT.UiAutomation]::GetWindowThreadProcessId($VisibleWindowHandle) }
+ If ($Process) {
+ ## Build custom object with details about the window and the process
+ [psobject]$VisibleWindow = New-Object -TypeName 'PSObject' -Property @{
+ WindowTitle = $VisibleWindowTitle
+ WindowHandle = $VisibleWindowHandle
+ ParentProcess= $Process.Name
+ ParentProcessMainWindowHandle = $Process.MainWindowHandle
+ ParentProcessId = $Process.Id
+ }
+
+ ## Only save/return the window and process details which match the search criteria
+ If ($PSCmdlet.ParameterSetName -eq 'SearchWinTitle') {
+ $MatchResult = $VisibleWindow.WindowTitle -match $WindowTitle
+ If ($MatchResult) {
+ [psobject[]]$VisibleWindows += $VisibleWindow
+ }
+ }
+ ElseIf ($PSCmdlet.ParameterSetName -eq 'GetAllWinTitles') {
+ [psobject[]]$VisibleWindows += $VisibleWindow
+ }
+ }
+ }
+ }
+ }
+ Catch {
+ If (-not $DisableFunctionLogging) { Write-Log -Message "Failed to get requested window title(s). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName} }
+ }
+ }
+ End {
+ Write-Output -InputObject $VisibleWindows
+
+ If ($DisableFunctionLogging) { . $RevertScriptLogging }
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Send-Keys
+Function Send-Keys {
+<#
+.SYNOPSIS
+ Send a sequence of keys to one or more application windows.
+.DESCRIPTION
+ Send a sequence of keys to one or more application window. If window title searched for returns more than one window, then all of them will receive the sent keys.
+ Function does not work in SYSTEM context unless launched with "psexec.exe -s -i" to run it as an interactive process under the SYSTEM account.
+.PARAMETER WindowTitle
+ The title of the application window to search for using regex matching.
+.PARAMETER GetAllWindowTitles
+ Get titles for all open windows on the system.
+.PARAMETER WindowHandle
+ Send keys to a specific window where the Window Handle is already known.
+.PARAMETER Keys
+ The sequence of keys to send. Info on Key input at: http://msdn.microsoft.com/en-us/library/System.Windows.Forms.SendKeys(v=vs.100).aspx
+.PARAMETER WaitSeconds
+ An optional number of seconds to wait after the sending of the keys.
+.EXAMPLE
+ Send-Keys -WindowTitle 'foobar - Notepad' -Key 'Hello world'
+ Send the sequence of keys "Hello world" to the application titled "foobar - Notepad".
+.EXAMPLE
+ Send-Keys -WindowTitle 'foobar - Notepad' -Key 'Hello world' -WaitSeconds 5
+ Send the sequence of keys "Hello world" to the application titled "foobar - Notepad" and wait 5 seconds.
+.EXAMPLE
+ Send-Keys -WindowHandle ([IntPtr]17368294) -Key 'Hello world'
+ Send the sequence of keys "Hello world" to the application with a Window Handle of '17368294'.
+.NOTES
+.LINK
+ http://msdn.microsoft.com/en-us/library/System.Windows.Forms.SendKeys(v=vs.100).aspx
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false,Position=0)]
+ [AllowEmptyString()]
+ [ValidateNotNull()]
+ [string]$WindowTitle,
+ [Parameter(Mandatory=$false,Position=1)]
+ [ValidateNotNullorEmpty()]
+ [switch]$GetAllWindowTitles = $false,
+ [Parameter(Mandatory=$false,Position=2)]
+ [ValidateNotNullorEmpty()]
+ [IntPtr]$WindowHandle,
+ [Parameter(Mandatory=$false,Position=3)]
+ [ValidateNotNullorEmpty()]
+ [string]$Keys,
+ [Parameter(Mandatory=$false,Position=4)]
+ [ValidateNotNullorEmpty()]
+ [int32]$WaitSeconds
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Load assembly containing class System.Windows.Forms.SendKeys
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+
+ [scriptblock]$SendKeys = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [IntPtr]$WindowHandle
+ )
+ Try {
+ ## Bring the window to the foreground
+ [boolean]$IsBringWindowToFrontSuccess = [PSADT.UiAutomation]::BringWindowToFront($WindowHandle)
+ If (-not $IsBringWindowToFrontSuccess) { Throw 'Failed to bring window to foreground.'}
+
+ ## Send the Key sequence
+ If ($Keys) {
+ [boolean]$IsWindowModal = If ([PSADT.UiAutomation]::IsWindowEnabled($WindowHandle)) { $false } Else { $true }
+ If ($IsWindowModal) { Throw 'Unable to send keys to window because it may be disabled due to a modal dialog being shown.' }
+ [Windows.Forms.SendKeys]::SendWait($Keys)
+ Write-Log -Message "Sent key(s) [$Keys] to window title [$($Window.WindowTitle)] with window handle [$WindowHandle]." -Source ${CmdletName}
+
+ If ($WaitSeconds) {
+ Write-Log -Message "Sleeping for [$WaitSeconds] seconds." -Source ${CmdletName}
+ Start-Sleep -Seconds $WaitSeconds
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to send keys to window title [$($Window.WindowTitle)] with window handle [$WindowHandle]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ }
+ Process {
+ Try {
+ If ($WindowHandle) {
+ [psobject]$Window = Get-WindowTitle -GetAllWindowTitles | Where-Object { $_.WindowHandle -eq $WindowHandle }
+ If (-not $Window) {
+ Write-Log -Message "No windows with Window Handle [$WindowHandle] were discovered." -Severity 2 -Source ${CmdletName}
+ Return
+ }
+ & $SendKeys -WindowHandle $Window.WindowHandle
+ }
+ Else {
+ [hashtable]$GetWindowTitleSplat = @{}
+ If ($GetAllWindowTitles) { $GetWindowTitleSplat.Add( 'GetAllWindowTitles', $GetAllWindowTitles) }
+ Else { $GetWindowTitleSplat.Add( 'WindowTitle', $WindowTitle) }
+ [psobject[]]$AllWindows = Get-WindowTitle @GetWindowTitleSplat
+ If (-not $AllWindows) {
+ Write-Log -Message 'No windows with the specified details were discovered.' -Severity 2 -Source ${CmdletName}
+ Return
+ }
+
+ ForEach ($Window in $AllWindows) {
+ & $SendKeys -WindowHandle $Window.WindowHandle
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to send keys to specified window. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-Battery
+Function Test-Battery {
+<#
+.SYNOPSIS
+ Tests whether the local machine is running on AC power or not.
+.DESCRIPTION
+ Tests whether the local machine is running on AC power and returns true/false. For detailed information, use -PassThru option.
+.PARAMETER PassThru
+ Outputs a hashtable containing the following properties:
+ IsLaptop, IsUsingACPower, ACPowerLineStatus, BatteryChargeStatus, BatteryLifePercent, BatteryLifeRemaining, BatteryFullLifetime
+.EXAMPLE
+ Test-Battery
+.EXAMPLE
+ (Test-Battery -PassThru).IsLaptop
+ Determines if the current system is a laptop or not.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru = $false
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## PowerStatus class found in this assembly is more reliable than WMI in cases where the battery is failing.
+ Add-Type -Assembly 'System.Windows.Forms' -ErrorAction 'SilentlyContinue'
+
+ ## Initialize a hashtable to store information about system type and power status
+ [hashtable]$SystemTypePowerStatus = @{ }
+ }
+ Process {
+ Write-Log -Message 'Check if system is using AC power or if it is running on battery...' -Source ${CmdletName}
+
+ [Windows.Forms.PowerStatus]$PowerStatus = [Windows.Forms.SystemInformation]::PowerStatus
+
+ ## Get the system power status. Indicates whether the system is using AC power or if the status is unknown. Possible values:
+ # Offline : The system is not using AC power.
+ # Online : The system is using AC power.
+ # Unknown : The power status of the system is unknown.
+ [string]$PowerLineStatus = $PowerStatus.PowerLineStatus
+ $SystemTypePowerStatus.Add('ACPowerLineStatus', $PowerStatus.PowerLineStatus)
+
+ ## Get the current battery charge status. Possible values: High, Low, Critical, Charging, NoSystemBattery, Unknown.
+ [string]$BatteryChargeStatus = $PowerStatus.BatteryChargeStatus
+ $SystemTypePowerStatus.Add('BatteryChargeStatus', $PowerStatus.BatteryChargeStatus)
+
+ ## Get the approximate amount, from 0.00 to 1.0, of full battery charge remaining.
+ # This property can report 1.0 when the battery is damaged and Windows can't detect a battery.
+ # Therefore, this property is only indicative of battery charge remaining if 'BatteryChargeStatus' property is not reporting 'NoSystemBattery' or 'Unknown'.
+ [single]$BatteryLifePercent = $PowerStatus.BatteryLifePercent
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ [single]$BatteryLifePercent = 0.0
+ }
+ $SystemTypePowerStatus.Add('BatteryLifePercent', $PowerStatus.BatteryLifePercent)
+
+ ## The reported approximate number of seconds of battery life remaining. It will report –1 if the remaining life is unknown because the system is on AC power.
+ [int32]$BatteryLifeRemaining = $PowerStatus.BatteryLifeRemaining
+ $SystemTypePowerStatus.Add('BatteryLifeRemaining', $PowerStatus.BatteryLifeRemaining)
+
+ ## Get the manufacturer reported full charge lifetime of the primary battery power source in seconds.
+ # The reported number of seconds of battery life available when the battery is fully charged, or -1 if it is unknown.
+ # This will only be reported if the battery supports reporting this information. You will most likely get -1, indicating unknown.
+ [int32]$BatteryFullLifetime = $PowerStatus.BatteryFullLifetime
+ $SystemTypePowerStatus.Add('BatteryFullLifetime', $PowerStatus.BatteryFullLifetime)
+
+ ## Determine if the system is using AC power
+ [boolean]$OnACPower = $false
+ If ($PowerLineStatus -eq 'Online') {
+ Write-Log -Message 'System is using AC power.' -Source ${CmdletName}
+ $OnACPower = $true
+ }
+ ElseIf ($PowerLineStatus -eq 'Offline') {
+ Write-Log -Message 'System is using battery power.' -Source ${CmdletName}
+ }
+ ElseIf ($PowerLineStatus -eq 'Unknown') {
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ Write-Log -Message "System power status is [$PowerLineStatus] and battery charge status is [$BatteryChargeStatus]. This is most likely due to a damaged battery so we will report system is using AC power." -Source ${CmdletName}
+ $OnACPower = $true
+ }
+ Else {
+ Write-Log -Message "System power status is [$PowerLineStatus] and battery charge status is [$BatteryChargeStatus]. Therefore, we will report system is using battery power." -Source ${CmdletName}
+ }
+ }
+ $SystemTypePowerStatus.Add('IsUsingACPower', $OnACPower)
+
+ ## Determine if the system is a laptop
+ [boolean]$IsLaptop = $false
+ If (($BatteryChargeStatus -eq 'NoSystemBattery') -or ($BatteryChargeStatus -eq 'Unknown')) {
+ $IsLaptop = $false
+ }
+ Else {
+ $IsLaptop = $true
+ }
+ # Chassis Types
+ [int32[]]$ChassisTypes = Get-WmiObject -Class 'Win32_SystemEnclosure' | Where-Object { $_.ChassisTypes } | Select-Object -ExpandProperty 'ChassisTypes'
+ Write-Log -Message "The following system chassis types were detected [$($ChassisTypes -join ',')]." -Source ${CmdletName}
+ ForEach ($ChassisType in $ChassisTypes) {
+ Switch ($ChassisType) {
+ { $_ -eq 9 -or $_ -eq 10 -or $_ -eq 14 } { $IsLaptop = $true } # 9=Laptop, 10=Notebook, 14=Sub Notebook
+ { $_ -eq 3 } { $IsLaptop = $false } # 3=Desktop
+ }
+ }
+ # Add IsLaptop property to hashtable
+ $SystemTypePowerStatus.Add('IsLaptop', $IsLaptop)
+
+ If ($PassThru) {
+ Write-Output -InputObject $SystemTypePowerStatus
+ }
+ Else {
+ Write-Output -InputObject $OnACPower
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-NetworkConnection
+Function Test-NetworkConnection {
+<#
+.SYNOPSIS
+ Tests for an active local network connection, excluding wireless and virtual network adapters.
+.DESCRIPTION
+ Tests for an active local network connection, excluding wireless and virtual network adapters, by querying the Win32_NetworkAdapter WMI class.
+.EXAMPLE
+ Test-NetworkConnection
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Write-Log -Message 'Check if system is using a wired network connection...' -Source ${CmdletName}
+
+ [psobject[]]$networkConnected = Get-WmiObject -Class 'Win32_NetworkAdapter' | Where-Object { ($_.NetConnectionStatus -eq 2) -and ($_.NetConnectionID -match 'Local') -and ($_.NetConnectionID -notmatch 'Wireless') -and ($_.Name -notmatch 'Virtual') } -ErrorAction 'SilentlyContinue'
+ [boolean]$onNetwork = $false
+ If ($networkConnected) {
+ Write-Log -Message 'Wired network connection found.' -Source ${CmdletName}
+ [boolean]$onNetwork = $true
+ }
+ Else {
+ Write-Log -Message 'Wired network connection not found.' -Source ${CmdletName}
+ }
+
+ Write-Output -InputObject $onNetwork
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-PowerPoint
+Function Test-PowerPoint {
+<#
+.SYNOPSIS
+ Tests whether PowerPoint is running in either fullscreen slideshow mode or presentation mode.
+.DESCRIPTION
+ Tests whether someone is presenting using PowerPoint in either fullscreen slideshow mode or presentation mode.
+.EXAMPLE
+ Test-PowerPoint
+.NOTES
+ This function can only execute detection logic if the process is in interactive mode.
+ There is a possiblity of a false positive if the PowerPoint filename starts with "PowerPoint Slide Show".
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Check if PowerPoint is in either fullscreen slideshow mode or presentation mode...' -Source ${CmdletName}
+ Try {
+ [Diagnostics.Process[]]$PowerPointProcess = Get-Process -ErrorAction 'Stop' | Where-Object { $_.ProcessName -eq 'POWERPNT' }
+ If ($PowerPointProcess) {
+ [boolean]$IsPowerPointRunning = $true
+ Write-Log -Message 'PowerPoint application is running.' -Source ${CmdletName}
+ }
+ Else {
+ [boolean]$IsPowerPointRunning = $false
+ Write-Log -Message 'PowerPoint application is not running.' -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Throw
+ }
+
+ [nullable[boolean]]$IsPowerPointFullScreen = $false
+ If ($IsPowerPointRunning) {
+ ## Detect if PowerPoint is in fullscreen mode or Presentation Mode, detection method only works if process is interactive
+ If ([Environment]::UserInteractive) {
+ # Check if "POWERPNT" process has a window with a title that begins with "PowerPoint Slide Show" or "Powerpoint-" for non-English language systems.
+ # There is a possiblity of a false positive if the PowerPoint filename starts with "PowerPoint Slide Show"
+ [psobject]$PowerPointWindow = Get-WindowTitle -GetAllWindowTitles | Where { $_.WindowTitle -match '^PowerPoint Slide Show' -or $_.WindowTitle -match '^PowerPoint-' } | Where-Object { $_.ParentProcess -eq 'POWERPNT'} | Select-Object -First 1
+ If ($PowerPointWindow) {
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ Write-Log -Message 'Detected that PowerPoint process [POWERPNT] has a window with a title that beings with [PowerPoint Slide Show] or [PowerPoint-].' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message 'Detected that PowerPoint process [POWERPNT] does not have a window with a title that beings with [PowerPoint Slide Show] or [PowerPoint-].' -Source ${CmdletName}
+ Try {
+ [int32[]]$PowerPointProcessIDs = $PowerPointProcess | Select-Object -ExpandProperty 'Id' -ErrorAction 'Stop'
+ Write-Log -Message "PowerPoint process [POWERPNT] has process id(s) [$($PowerPointProcessIDs -join ', ')]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Unable to retrieve process id(s) for [POWERPNT] process. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ }
+ }
+
+ ## If previous detection method did not detect PowerPoint in fullscreen mode, then check if PowerPoint is in Presentation Mode (check only works on Windows Vista or higher)
+ If ((-not $IsPowerPointFullScreen) -and (([version]$envOSVersion).Major -gt 5)) {
+ # Note: below method does not detect PowerPoint presentation mode if the presentation is on a monitor that does not have current mouse input control
+ [string]$UserNotificationState = [PSADT.UiAutomation]::GetUserNotificationState()
+ Write-Log -Message "Detected user notification state [$UserNotificationState]." -Source ${CmdletName}
+ Switch ($UserNotificationState) {
+ 'PresentationMode' {
+ Write-Log -Message "Detected that system is in [Presentation Mode]." -Source ${CmdletName}
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ }
+ 'FullScreenOrPresentationModeOrLoginScreen' {
+ If (([string]$PowerPointProcessIDs) -and ($PowerPointProcessIDs -contains [PSADT.UIAutomation]::GetWindowThreadProcessID([PSADT.UIAutomation]::GetForeGroundWindow()))) {
+ Write-Log -Message "Detected that fullscreen foreground window matches PowerPoint process id." -Source ${CmdletName}
+ [nullable[boolean]]$IsPowerPointFullScreen = $true
+ }
+ }
+ }
+ }
+ }
+ Else {
+ [nullable[boolean]]$IsPowerPointFullScreen = $null
+ Write-Log -Message 'Unable to run check to see if PowerPoint is in fullscreen mode or Presentation Mode because current process is not interactive. Configure script to run in interactive mode in your deployment tool. If using SCCM Application Model, then make sure "Allow users to view and interact with the program installation" is selected. If using SCCM Package Model, then make sure "Allow users to interact with this program" is selected.' -Severity 2 -Source ${CmdletName}
+ }
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsPowerPointFullScreen = $null
+ Write-Log -Message "Failed check to see if PowerPoint is running in fullscreen slideshow mode. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-Log -Message "PowerPoint is running in fullscreen mode [$IsPowerPointFullScreen]." -Source ${CmdletName}
+ Write-Output -InputObject $IsPowerPointFullScreen
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Invoke-SCCMTask
+Function Invoke-SCCMTask {
+<#
+.SYNOPSIS
+ Triggers SCCM to invoke the requested schedule task id.
+.DESCRIPTION
+ Triggers SCCM to invoke the requested schedule task id.
+.PARAMETER ScheduleId
+ Name of the schedule id to trigger.
+ Options: HardwareInventory, SoftwareInventory, HeartbeatDiscovery, SoftwareInventoryFileCollection, RequestMachinePolicy, EvaluateMachinePolicy,
+ LocationServicesCleanup, SoftwareMeteringReport, SourceUpdate, PolicyAgentCleanup, RequestMachinePolicy2, CertificateMaintenance, PeerDistributionPointStatus,
+ PeerDistributionPointProvisioning, ComplianceIntervalEnforcement, SoftwareUpdatesAgentAssignmentEvaluation, UploadStateMessage, StateMessageManager,
+ SoftwareUpdatesScan, AMTProvisionCycle, UpdateStorePolicy, StateSystemBulkSend, ApplicationManagerPolicyAction, PowerManagementStartSummarizer
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Invoke-SCCMTask 'SoftwareUpdatesScan'
+.EXAMPLE
+ Invoke-SCCMTask
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('HardwareInventory','SoftwareInventory','HeartbeatDiscovery','SoftwareInventoryFileCollection','RequestMachinePolicy','EvaluateMachinePolicy','LocationServicesCleanup','SoftwareMeteringReport','SourceUpdate','PolicyAgentCleanup','RequestMachinePolicy2','CertificateMaintenance','PeerDistributionPointStatus','PeerDistributionPointProvisioning','ComplianceIntervalEnforcement','SoftwareUpdatesAgentAssignmentEvaluation','UploadStateMessage','StateMessageManager','SoftwareUpdatesScan','AMTProvisionCycle','UpdateStorePolicy','StateSystemBulkSend','ApplicationManagerPolicyAction','PowerManagementStartSummarizer')]
+ [string]$ScheduleID,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Invoke SCCM Schedule Task ID [$ScheduleId]..." -Source ${CmdletName}
+
+ ## Make sure SCCM client is installed and running
+ Write-Log -Message 'Check to see if SCCM Client service [ccmexec] is installed and running.' -Source ${CmdletName}
+ If (Test-ServiceExists -Name 'ccmexec') {
+ If ($(Get-Service -Name 'ccmexec' -ErrorAction 'SilentlyContinue').Status -ne 'Running') {
+ Throw "SCCM Client Service [ccmexec] exists but it is not in a 'Running' state."
+ }
+ } Else {
+ Throw 'SCCM Client Service [ccmexec] does not exist. The SCCM Client may not be installed.'
+ }
+
+ ## Determine the SCCM Client Version
+ Try {
+ [version]$SCCMClientVersion = Get-WmiObject -Namespace 'ROOT\CCM' -Class 'CCM_InstalledComponent' -ErrorAction 'Stop' | Where-Object { $_.Name -eq 'SmsClient' } | Select-Object -ExpandProperty 'Version' -ErrorAction 'Stop'
+ Write-Log -Message "Installed SCCM Client Version Number [$SCCMClientVersion]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to determine the SCCM client version number. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to determine the SCCM client version number.'
+ }
+
+ ## Create a hashtable of Schedule IDs compatible with SCCM Client 2007
+ [hashtable]$ScheduleIds = @{
+ HardwareInventory = '{00000000-0000-0000-0000-000000000001}'; # Hardware Inventory Collection Task
+ SoftwareInventory = '{00000000-0000-0000-0000-000000000002}'; # Software Inventory Collection Task
+ HeartbeatDiscovery = '{00000000-0000-0000-0000-000000000003}'; # Heartbeat Discovery Cycle
+ SoftwareInventoryFileCollection = '{00000000-0000-0000-0000-000000000010}'; # Software Inventory File Collection Task
+ RequestMachinePolicy = '{00000000-0000-0000-0000-000000000021}'; # Request Machine Policy Assignments
+ EvaluateMachinePolicy = '{00000000-0000-0000-0000-000000000022}'; # Evaluate Machine Policy Assignments
+ RefreshDefaultMp = '{00000000-0000-0000-0000-000000000023}'; # Refresh Default MP Task
+ RefreshLocationServices = '{00000000-0000-0000-0000-000000000024}'; # Refresh Location Services Task
+ LocationServicesCleanup = '{00000000-0000-0000-0000-000000000025}'; # Location Services Cleanup Task
+ SoftwareMeteringReport = '{00000000-0000-0000-0000-000000000031}'; # Software Metering Report Cycle
+ SourceUpdate = '{00000000-0000-0000-0000-000000000032}'; # Source Update Manage Update Cycle
+ PolicyAgentCleanup = '{00000000-0000-0000-0000-000000000040}'; # Policy Agent Cleanup Cycle
+ RequestMachinePolicy2 = '{00000000-0000-0000-0000-000000000042}'; # Request Machine Policy Assignments
+ CertificateMaintenance = '{00000000-0000-0000-0000-000000000051}'; # Certificate Maintenance Cycle
+ PeerDistributionPointStatus = '{00000000-0000-0000-0000-000000000061}'; # Peer Distribution Point Status Task
+ PeerDistributionPointProvisioning = '{00000000-0000-0000-0000-000000000062}'; # Peer Distribution Point Provisioning Status Task
+ ComplianceIntervalEnforcement = '{00000000-0000-0000-0000-000000000071}'; # Compliance Interval Enforcement
+ SoftwareUpdatesAgentAssignmentEvaluation = '{00000000-0000-0000-0000-000000000108}'; # Software Updates Agent Assignment Evaluation Cycle
+ UploadStateMessage = '{00000000-0000-0000-0000-000000000111}'; # Send Unsent State Messages
+ StateMessageManager = '{00000000-0000-0000-0000-000000000112}'; # State Message Manager Task
+ SoftwareUpdatesScan = '{00000000-0000-0000-0000-000000000113}'; # Force Update Scan
+ AMTProvisionCycle = '{00000000-0000-0000-0000-000000000120}'; # AMT Provision Cycle
+ }
+
+ ## If SCCM 2012 Client or higher, modify hashtabe containing Schedule IDs so that it only has the ones compatible with this version of the SCCM client
+ If ($SCCMClientVersion.Major -ge 5) {
+ $ScheduleIds.Remove('PeerDistributionPointStatus')
+ $ScheduleIds.Remove('PeerDistributionPointProvisioning')
+ $ScheduleIds.Remove('ComplianceIntervalEnforcement')
+ $ScheduleIds.Add('UpdateStorePolicy','{00000000-0000-0000-0000-000000000114}') # Update Store Policy
+ $ScheduleIds.Add('StateSystemBulkSend','{00000000-0000-0000-0000-000000000116}') # State System Policy Bulk Send Low
+ $ScheduleIds.Add('ApplicationManagerPolicyAction','{00000000-0000-0000-0000-000000000121}') # Application Manager Policy Action
+ $ScheduleIds.Add('PowerManagementStartSummarizer','{00000000-0000-0000-0000-000000000131}') # Power Management Start Summarizer
+ }
+
+ ## Determine if the requested Schedule ID is available on this version of the SCCM Client
+ If (-not ($ScheduleIds.ContainsKey($ScheduleId))) {
+ Throw "The requested ScheduleId [$ScheduleId] is not available with this version of the SCCM Client [$SCCMClientVersion]."
+ }
+
+ ## Trigger SCCM task
+ Write-Log -Message "Trigger SCCM Task ID [$ScheduleId]." -Source ${CmdletName}
+ [Management.ManagementClass]$SmsClient = [WMIClass]'ROOT\CCM:SMS_Client'
+ $null = $SmsClient.TriggerSchedule($ScheduleIds.$ScheduleID)
+ }
+ Catch {
+ Write-Log -Message "Failed to trigger SCCM Schedule Task ID [$($ScheduleIds.$ScheduleId)]. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger SCCM Schedule Task ID [$($ScheduleIds.$ScheduleId)]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Install-SCCMSoftwareUpdates
+Function Install-SCCMSoftwareUpdates {
+<#
+.SYNOPSIS
+ Scans for outstanding SCCM updates to be installed and installs the pending updates.
+.DESCRIPTION
+ Scans for outstanding SCCM updates to be installed and installs the pending updates.
+ Only compatible with SCCM 2012 Client or higher. This function can take several minutes to run.
+.PARAMETER SoftwareUpdatesScanWaitInSeconds
+ The amount of time to wait in seconds for the software updates scan to complete. Default is: 180 seconds.
+.PARAMETER WaitForPendingUpdatesTimeout
+ The amount of time to wait for missing and pending updates to install before exiting the function. Default is: 45 minutes.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Install-SCCMSoftwareUpdates
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [int32]$SoftwareUpdatesScanWaitInSeconds = 180,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [timespan]$WaitForPendingUpdatesTimeout = $(New-TimeSpan -Minutes 45),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Scan for and install pending SCCM software updates.' -Source ${CmdletName}
+
+ ## Make sure SCCM client is installed and running
+ Write-Log -Message 'Check to see if SCCM Client service [ccmexec] is installed and running.' -Source ${CmdletName}
+ If (Test-ServiceExists -Name 'ccmexec') {
+ If ($(Get-Service -Name 'ccmexec' -ErrorAction 'SilentlyContinue').Status -ne 'Running') {
+ Throw "SCCM Client Service [ccmexec] exists but it is not in a 'Running' state."
+ }
+ } Else {
+ Throw 'SCCM Client Service [ccmexec] does not exist. The SCCM Client may not be installed.'
+ }
+
+ ## Determine the SCCM Client Version
+ Try {
+ [version]$SCCMClientVersion = Get-WmiObject -Namespace 'ROOT\CCM' -Class 'CCM_InstalledComponent' -ErrorAction 'Stop' | Where-Object { $_.Name -eq 'SmsClient' } | Select-Object -ExpandProperty 'Version' -ErrorAction 'Stop'
+ Write-Log -Message "Installed SCCM Client Version Number [$SCCMClientVersion]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to determine the SCCM client version number. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to determine the SCCM client version number.'
+ }
+ # If SCCM 2007 Client or lower, exit function
+ If ($SCCMClientVersion.Major -le 4) {
+ Throw 'SCCM 2007 or lower, which is incompatible with this function, was detected on this system.'
+ }
+
+ $StartTime = Get-Date
+ ## Trigger SCCM client scan for Software Updates
+ Write-Log -Message 'Trigger SCCM client scan for Software Updates...' -Source ${CmdletName}
+ Invoke-SCCMTask -ScheduleId 'SoftwareUpdatesScan'
+
+ Write-Log -Message "The SCCM client scan for Software Updates has been triggered. The script is suspended for [$SoftwareUpdatesScanWaitInSeconds] seconds to let the update scan finish." -Source ${CmdletName}
+ Start-Sleep -Seconds $SoftwareUpdatesScanWaitInSeconds
+
+ ## Find the number of missing updates
+ Try {
+ [Management.ManagementObject[]]$CMMissingUpdates = @(Get-WmiObject -Namespace 'ROOT\CCM\ClientSDK' -Query "SELECT * FROM CCM_SoftwareUpdate WHERE ComplianceState = '0'" -ErrorAction 'Stop')
+ }
+ Catch {
+ Write-Log -Message "Failed to find the number of missing software updates. `n$(Resolve-Error)" -Severity 2 -Source ${CmdletName}
+ Throw 'Failed to find the number of missing software updates.'
+ }
+
+ ## Install missing updates and wait for pending updates to finish installing
+ If ($CMMissingUpdates.Count) {
+ # Install missing updates
+ Write-Log -Message "Install missing updates. The number of missing updates is [$($CMMissingUpdates.Count)]." -Source ${CmdletName}
+ $CMInstallMissingUpdates = (Get-WmiObject -Namespace 'ROOT\CCM\ClientSDK' -Class 'CCM_SoftwareUpdatesManager' -List).InstallUpdates($CMMissingUpdates)
+
+ # Wait for pending updates to finish installing or the timeout value to expire
+ Do {
+ Start-Sleep -Seconds 60
+ [array]$CMInstallPendingUpdates = @(Get-WmiObject -Namespace "ROOT\CCM\ClientSDK" -Query "SELECT * FROM CCM_SoftwareUpdate WHERE EvaluationState = 6 or EvaluationState = 7")
+ Write-Log -Message "The number of updates pending installation is [$($CMInstallPendingUpdates.Count)]." -Source ${CmdletName}
+ } While (($CMInstallPendingUpdates.Count -ne 0) -and ((New-TimeSpan -Start $StartTime -End $(Get-Date)) -lt $WaitForPendingUpdatesTimeout))
+ }
+ Else {
+ Write-Log -Message 'There are no missing updates.' -Source ${CmdletName}
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to trigger installation of missing software updates. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to trigger installation of missing software updates: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Update-GroupPolicy
+Function Update-GroupPolicy {
+<#
+.SYNOPSIS
+ Performs a gpupdate command to refresh Group Policies on the local machine.
+.DESCRIPTION
+ Performs a gpupdate command to refresh Group Policies on the local machine.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Update-GroupPolicy
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ [string[]]$GPUpdateCmds = '/C echo N | gpupdate.exe /Target:Computer /Force', '/C echo N | gpupdate.exe /Target:User /Force'
+ [int32]$InstallCount = 0
+ ForEach ($GPUpdateCmd in $GPUpdateCmds) {
+ Try {
+ If ($InstallCount -eq 0) {
+ [string]$InstallMsg = 'Update Group Policies for the Machine'
+ Write-Log -Message "$($InstallMsg)..." -Source ${CmdletName}
+ }
+ Else {
+ [string]$InstallMsg = 'Update Group Policies for the User'
+ Write-Log -Message "$($InstallMsg)..." -Source ${CmdletName}
+ }
+ [psobject]$ExecuteResult = Execute-Process -Path "$envWindir\system32\cmd.exe" -Parameters $GPUpdateCmd -WindowStyle 'Hidden' -PassThru
+
+ If ($ExecuteResult.ExitCode -ne 0) {
+ If ($ExecuteResult.ExitCode -eq 60002) {
+ Throw "Execute-Process function failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ Else {
+ Throw "gpupdate.exe failed with exit code [$($ExecuteResult.ExitCode)]."
+ }
+ }
+ $InstallCount++
+ }
+ Catch {
+ Write-Log -Message "Failed to $($InstallMsg). `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to $($InstallMsg): $($_.Exception.Message)"
+ }
+ Continue
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Enable-TerminalServerInstallMode
+Function Enable-TerminalServerInstallMode {
+<#
+.SYNOPSIS
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.DESCRIPTION
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Enable-TerminalServerInstall
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Change terminal server into user install mode...' -Source ${CmdletName}
+ $terminalServerResult = & change.exe User /Install
+
+ If ($global:LastExitCode -ne 1) { Throw $terminalServerResult }
+ }
+ Catch {
+ Write-Log -Message "Failed to change terminal server into user install mode. `n$(Resolve-Error) " -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to change terminal server into user install mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Disable-TerminalServerInstallMode
+Function Disable-TerminalServerInstallMode {
+<#
+.SYNOPSIS
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.DESCRIPTION
+ Changes to user install mode for Remote Desktop Session Host/Citrix servers.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Disable-TerminalServerInstall
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Change terminal server into user execute mode...' -Source ${CmdletName}
+ $terminalServerResult = & change.exe User /Execute
+
+ If ($global:LastExitCode -ne 1) { Throw $terminalServerResult }
+ }
+ Catch {
+ Write-Log -Message "Failed to change terminal server into user execute mode. `n$(Resolve-Error) " -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to change terminal server into user execute mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-ActiveSetup
+Function Set-ActiveSetup {
+<#
+.SYNOPSIS
+ Creates an Active Setup entry in the registry to execute a file for each user upon login.
+.DESCRIPTION
+ Active Setup allows handling of per-user changes registry/file changes upon login.
+ A registry key is created in the HKLM registry hive which gets replicated to the HKCU hive when a user logs in.
+ If the "Version" value of the Active Setup entry in HKLM is higher than the version value in HKCU, the file referenced in "StubPath" is executed.
+ This Function:
+ - Creates the registry entries in HKLM:SOFTWARE\Microsoft\Active Setup\Installed Components\$installName.
+ - Creates StubPath value depending on the file extension of the $StubExePath parameter.
+ - Handles Version value with YYYYMMDDHHMMSS granularity to permit re-installs on the same day and still trigger Active Setup after Version increase.
+ - Copies/overwrites the StubPath file to $StubExePath destination path if file exists in 'Files' subdirectory of script directory.
+ - Executes the StubPath file for the current user as long as not in Session 0 (no need to logout/login to trigger Active Setup).
+.PARAMETER StubExePath
+ Full destination path to the file that will be executed for each user that logs in.
+ If this file exists in the 'Files' subdirectory of the script directory, it will be copied to the destination path.
+.PARAMETER Arguments
+ Arguments to pass to the file being executed.
+.PARAMETER Description
+ Description for the Active Setup. Users will see "Setting up personalized settings for: $Description" at logon. Default is: $installName.
+.PARAMETER Key
+ Name of the registry key for the Active Setup entry. Default is: $installName.
+.PARAMETER Version
+ Optional. Specify version for Active setup entry. Active Setup is not triggered if Version value has more than 8 consecutive digits. Use commas to get around this limitation.
+.PARAMETER Locale
+ Optional. Arbitrary string used to specify the installation language of the file being executed. Not replicated to HKCU.
+.PARAMETER PurgeActiveSetupKey
+ Remove Active Setup entry from HKLM registry hive. Will also load each logon user's HKCU registry hive to remove Active Setup entry.
+.PARAMETER DisableActiveSetup
+ Disables the Active Setup entry so that the StubPath file will not be executed.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-ActiveSetup -StubExePath 'C:\Users\Public\Company\ProgramUserConfig.vbs' -Arguments '/Silent' -Description 'Program User Config' -Key 'ProgramUserConfig' -Locale 'en'
+.EXAMPLE
+ Set-ActiveSetup -StubExePath "$envWinDir\regedit.exe" -Arguments "/S `"%SystemDrive%\Program Files (x86)\PS App Deploy\PSAppDeployHKCUSettings.reg`"" -Description 'PS App Deploy Config' -Key 'PS_App_Deploy_Config' -ContinueOnError $true
+.EXAMPLE
+ Set-ActiveSetup -Key 'ProgramUserConfig' -PurgeActiveSetupKey
+ Deletes "ProgramUserConfig" active setup entry from all registry hives.
+.NOTES
+ Original code borrowed from: Denis St-Pierre (Ottawa, Canada), Todd MacNaught (Ottawa, Canada)
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$StubExePath,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Arguments,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Description = $installName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$Key = $installName,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Version = ((Get-Date -Format 'yyMM,ddHH,mmss').ToString()), # Ex: 1405,1515,0522
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [string]$Locale,
+ [Parameter(Mandatory=$false,ParameterSetName='Create')]
+ [ValidateNotNullorEmpty()]
+ [switch]$DisableActiveSetup = $false,
+ [Parameter(Mandatory=$true,ParameterSetName='Purge')]
+ [switch]$PurgeActiveSetupKey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ [string]$ActiveSetupKey = "HKLM:SOFTWARE\Microsoft\Active Setup\Installed Components\$Key"
+ [string]$HKCUActiveSetupKey = "HKCU:Software\Microsoft\Active Setup\Installed Components\$Key"
+
+ ## Delete Active Setup registry entry from the HKLM hive and for all logon user registry hives on the system
+ If ($PurgeActiveSetupKey) {
+ Write-Log -Message "Remove Active Setup entry [$ActiveSetupKey]." -Source ${CmdletName}
+ Remove-RegistryKey -Key $ActiveSetupKey -Recurse
+
+ Write-Log -Message "Remove Active Setup entry [$HKCUActiveSetupKey] for all log on user registry hives on the system." -Source ${CmdletName}
+ [scriptblock]$RemoveHKCUActiveSetupKey = { Remove-RegistryKey -Key $HKCUActiveSetupKey -SID $UserProfile.SID -Recurse }
+ Invoke-HKCURegistrySettingsForAllUsers -RegistrySettings $RemoveHKCUActiveSetupKey -UserProfiles (Get-UserProfiles -ExcludeDefaultUser)
+ Return
+ }
+
+ ## Verify a file with a supported file extension was specified in $StubExePath
+ [string[]]$StubExePathFileExtensions = '.exe', '.vbs', '.cmd', '.ps1', '.js'
+ [string]$StubExeExt = [IO.Path]::GetExtension($StubExePath)
+ If ($StubExePathFileExtensions -notcontains $StubExeExt) {
+ Throw "Unsupported Active Setup StubPath file extension [$StubExeExt]."
+ }
+
+ ## Copy file to $StubExePath from the 'Files' subdirectory of the script directory (if it exists there)
+ [string]$StubExePath = [Environment]::ExpandEnvironmentVariables($StubExePath)
+ [string]$ActiveSetupFileName = [IO.Path]::GetFileName($StubExePath)
+ [string]$StubExeFile = Join-Path -Path $dirFiles -ChildPath $ActiveSetupFileName
+ If (Test-Path -LiteralPath $StubExeFile -PathType 'Leaf') {
+ # This will overwrite the StubPath file if $StubExePath already exists on target
+ Copy-File -Path $StubExeFile -Destination $StubExePath -ContinueOnError $false
+ }
+
+ ## Check if the $StubExePath file exists
+ If (-not (Test-Path -LiteralPath $StubExePath -PathType 'Leaf')) { Throw "Active Setup StubPath file [$ActiveSetupFileName] is missing." }
+
+ ## Define Active Setup StubPath according to file extension of $StubExePath
+ Switch ($StubExeExt) {
+ '.exe' {
+ [string]$CUStubExePath = $StubExePath
+ [string]$CUArguments = $Arguments
+ [string]$StubPath = "$CUStubExePath"
+ }
+ {'.vbs','.js' -contains $StubExeExt} {
+ [string]$CUStubExePath = "$envWinDir\system32\cscript.exe"
+ [string]$CUArguments = "//nologo `"$StubExePath`""
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ '.cmd' {
+ [string]$CUStubExePath = "$envWinDir\system32\CMD.exe"
+ [string]$CUArguments = "/C `"$StubExePath`""
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ '.ps1' {
+ [string]$CUStubExePath = "$PSHOME\powershell.exe"
+ [string]$CUArguments = "-ExecutionPolicy Bypass -NoProfile -NoLogo -WindowStyle Hidden -Command & { & `\`"$StubExePath`\`"}"
+ [string]$StubPath = "$CUStubExePath $CUArguments"
+ }
+ }
+ If ($Arguments) {
+ [string]$StubPath = "$StubPath $Arguments"
+ If ($StubExeExt -ne '.exe') { [string]$CUArguments = "$CUArguments $Arguments" }
+ }
+
+ ## Create the Active Setup entry in the registry
+ [scriptblock]$SetActiveSetupRegKeys = {
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullorEmpty()]
+ [string]$ActiveSetupRegKey,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullorEmpty()]
+ [string]$SID
+ )
+ If ($SID) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name '(Default)' -Value $Description -SID $SID -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'StubPath' -Value $StubPath -Type 'String' -SID $SID -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Version' -Value $Version -SID $SID -ContinueOnError $false
+ If ($Locale) { Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Locale' -Value $Locale -SID $SID -ContinueOnError $false }
+ If ($DisableActiveSetup) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 0 -Type 'DWord' -SID $SID -ContinueOnError $false
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 1 -Type 'DWord' -SID $SID -ContinueOnError $false
+ }
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name '(Default)' -Value $Description -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'StubPath' -Value $StubPath -Type 'String' -ContinueOnError $false
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Version' -Value $Version -ContinueOnError $false
+ If ($Locale) { Set-RegistryKey -Key $ActiveSetupRegKey -Name 'Locale' -Value $Locale -ContinueOnError $false }
+ If ($DisableActiveSetup) {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 0 -Type 'DWord' -ContinueOnError $false
+ }
+ Else {
+ Set-RegistryKey -Key $ActiveSetupRegKey -Name 'IsInstalled' -Value 1 -Type 'DWord' -ContinueOnError $false
+ }
+ }
+
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $ActiveSetupKey
+
+ ## Execute the StubPath file for the current user as long as not in Session 0
+ If ($SessionZero) {
+ If ($RunAsActiveUser) {
+ Write-Log -Message "Session 0 detected: Execute Active Setup StubPath file for currently logged in user [$($RunAsActiveUser.NTAccount)]." -Source ${CmdletName}
+ If ($CUArguments) {
+ Execute-ProcessAsUser -Path $CUStubExePath -Parameters $CUArguments -Wait -ContinueOnError $true
+ }
+ Else {
+ Execute-ProcessAsUser -Path $CUStubExePath -Wait -ContinueOnError $true
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $HKCUActiveSetupKey -SID $RunAsActiveUser.SID
+ }
+ Else {
+ Write-Log -Message 'Session 0 detected: No logged in users detected. Active Setup StubPath file will execute when users first log into their account.' -Source ${CmdletName}
+ }
+ }
+ Else {
+ Write-Log -Message 'Execute Active Setup StubPath file for the current user.' -Source ${CmdletName}
+ If ($CUArguments) {
+ $ExecuteResults = Execute-Process -FilePath $CUStubExePath -Parameters $CUArguments -PassThru
+ }
+ Else {
+ $ExecuteResults = Execute-Process -FilePath $CUStubExePath -PassThru
+ }
+ & $SetActiveSetupRegKeys -ActiveSetupRegKey $HKCUActiveSetupKey
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to set Active Setup registry entry. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed to set Active Setup registry entry: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Test-ServiceExists
+Function Test-ServiceExists {
+<#
+.SYNOPSIS
+ Check to see if a service exists.
+.DESCRIPTION
+ Check to see if a service exists (using WMI method because Get-Service will generate ErrorRecord if service doesn't exist).
+.PARAMETER Name
+ Specify the name of the service.
+ Note: Service name can be found by executing "Get-Service | Format-Table -AutoSize -Wrap" or by using the properties screen of a service in services.msc.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER PassThru
+ Return the WMI service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Test-ServiceExists -Name 'wuauserv'
+.EXAMPLE
+ Test-ServiceExists -Name 'testservice' -PassThru | Where-Object { $_ } | ForEach-Object { $_.Delete() }
+ Check if a service exists and then delete it by using the -PassThru parameter.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ $ServiceObject = Get-WmiObject -ComputerName $ComputerName -Class 'Win32_Service' -Filter "Name='$Name'" -ErrorAction 'Stop'
+ # If nothing is returned from Win32_Service, check Win32_BaseService
+ If (-not ($ServiceObject) ) {
+ $ServiceObject = Get-WmiObject -ComputerName $ComputerName -Class 'Win32_BaseService' -Filter "Name='$Name'" -ErrorAction 'Stop'
+ }
+
+ If ($ServiceObject) {
+ Write-Log -Message "Service [$Name] exists." -Source ${CmdletName}
+ If ($PassThru) { Write-Output -InputObject $ServiceObject } Else { Write-Output -InputObject $true }
+ }
+ Else {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName}
+ If ($PassThru) { Write-Output -InputObject $ServiceObject } Else { Write-Output -InputObject $false }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed check to see if service [$Name] exists." -Severity 3 -Source ${CmdletName}
+ If (-not $ContinueOnError) {
+ Throw "Failed check to see if service [$Name] exists: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Stop-ServiceAndDependencies
+Function Stop-ServiceAndDependencies {
+<#
+.SYNOPSIS
+ Stop Windows service and its dependencies.
+.DESCRIPTION
+ Stop Windows service and its dependencies.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER SkipServiceExistsTest
+ Choose to skip the test to check whether or not the service exists if it was already done outside of this function.
+.PARAMETER SkipDependentServices
+ Choose to skip checking for and stopping dependent services. Default is: $false.
+.PARAMETER PendingStatusWait
+ The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.
+.PARAMETER PassThru
+ Return the System.ServiceProcess.ServiceController service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Stop-ServiceAndDependencies -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipServiceExistsTest,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipDependentServices,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [timespan]$PendingStatusWait = (New-TimeSpan -Seconds 60),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Check to see if the service exists
+ If ((-not $SkipServiceExistsTest) -and (-not (Test-ServiceExists -ComputerName $ComputerName -Name $Name -ContinueOnError $false))) {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName} -Severity 2
+ Throw "Service [$Name] does not exist."
+ }
+
+ ## Get the service object
+ Write-Log -Message "Get the service object for service [$Name]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction 'Stop'
+ ## Wait up to 60 seconds if service is in a pending state
+ [string[]]$PendingStatus = 'ContinuePending', 'PausePending', 'StartPending', 'StopPending'
+ If ($PendingStatus -contains $Service.Status) {
+ Switch ($Service.Status) {
+ 'ContinuePending' { $DesiredStatus = 'Running' }
+ 'PausePending' { $DesiredStatus = 'Paused' }
+ 'StartPending' { $DesiredStatus = 'Running' }
+ 'StopPending' { $DesiredStatus = 'Stopped' }
+ }
+ Write-Log -Message "Waiting for up to [$($PendingStatusWait.TotalSeconds)] seconds to allow service pending status [$($Service.Status)] to reach desired status [$DesiredStatus]." -Source ${CmdletName}
+ $Service.WaitForStatus([ServiceProcess.ServiceControllerStatus]$DesiredStatus, $PendingStatusWait)
+ $Service.Refresh()
+ }
+ ## Discover if the service is currently running
+ Write-Log -Message "Service [$($Service.ServiceName)] with display name [$($Service.DisplayName)] has a status of [$($Service.Status)]." -Source ${CmdletName}
+ If ($Service.Status -ne 'Stopped') {
+ # Discover all dependent services that are running and stop them
+ If (-not $SkipDependentServices) {
+ Write-Log -Message "Discover all dependent service(s) for service [$Name] which are not 'Stopped'." -Source ${CmdletName}
+ [ServiceProcess.ServiceController[]]$DependentServices = Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -DependentServices -ErrorAction 'Stop' | Where-Object { $_.Status -ne 'Stopped' }
+ If ($DependentServices) {
+ ForEach ($DependentService in $DependentServices) {
+ Write-Log -Message "Stop dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]." -Source ${CmdletName}
+ Try {
+ Stop-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $DependentService.ServiceName -ErrorAction 'Stop') -Force -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]. Continue..." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Dependent service(s) were not discovered for service [$Name]." -Source ${CmdletName}
+ }
+ }
+ # Stop the parent service
+ Write-Log -Message "Stop parent service [$($Service.ServiceName)] with display name [$($Service.DisplayName)]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Stop-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -ErrorAction 'Stop') -Force -PassThru -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to stop the service [$Name]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to stop the service [$Name]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ # Return the service object if option selected
+ If ($PassThru -and $Service) { Write-Output -InputObject $Service }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Start-ServiceAndDependencies
+Function Start-ServiceAndDependencies {
+<#
+.SYNOPSIS
+ Start Windows service and its dependencies.
+.DESCRIPTION
+ Start Windows service and its dependencies.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER SkipServiceExistsTest
+ Choose to skip the test to check whether or not the service exists if it was already done outside of this function.
+.PARAMETER SkipDependentServices
+ Choose to skip checking for and starting dependent services. Default is: $false.
+.PARAMETER PendingStatusWait
+ The amount of time to wait for a service to get out of a pending state before continuing. Default is 60 seconds.
+.PARAMETER PassThru
+ Return the System.ServiceProcess.ServiceController service object.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Start-ServiceAndDependencies -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipServiceExistsTest,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$SkipDependentServices,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [timespan]$PendingStatusWait = (New-TimeSpan -Seconds 60),
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [switch]$PassThru,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## Check to see if the service exists
+ If ((-not $SkipServiceExistsTest) -and (-not (Test-ServiceExists -ComputerName $ComputerName -Name $Name -ContinueOnError $false))) {
+ Write-Log -Message "Service [$Name] does not exist." -Source ${CmdletName} -Severity 2
+ Throw "Service [$Name] does not exist."
+ }
+
+ ## Get the service object
+ Write-Log -Message "Get the service object for service [$Name]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Get-Service -ComputerName $ComputerName -Name $Name -ErrorAction 'Stop'
+ ## Wait up to 60 seconds if service is in a pending state
+ [string[]]$PendingStatus = 'ContinuePending', 'PausePending', 'StartPending', 'StopPending'
+ If ($PendingStatus -contains $Service.Status) {
+ Switch ($Service.Status) {
+ 'ContinuePending' { $DesiredStatus = 'Running' }
+ 'PausePending' { $DesiredStatus = 'Paused' }
+ 'StartPending' { $DesiredStatus = 'Running' }
+ 'StopPending' { $DesiredStatus = 'Stopped' }
+ }
+ Write-Log -Message "Waiting for up to [$($PendingStatusWait.TotalSeconds)] seconds to allow service pending status [$($Service.Status)] to reach desired status [$DesiredStatus]." -Source ${CmdletName}
+ $Service.WaitForStatus([ServiceProcess.ServiceControllerStatus]$DesiredStatus, $PendingStatusWait)
+ $Service.Refresh()
+ }
+ ## Discover if the service is currently stopped
+ Write-Log -Message "Service [$($Service.ServiceName)] with display name [$($Service.DisplayName)] has a status of [$($Service.Status)]." -Source ${CmdletName}
+ If ($Service.Status -ne 'Running') {
+ # Start the parent service
+ Write-Log -Message "Start parent service [$($Service.ServiceName)] with display name [$($Service.DisplayName)]." -Source ${CmdletName}
+ [ServiceProcess.ServiceController]$Service = Start-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -ErrorAction 'Stop') -PassThru -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+
+ # Discover all dependent services that are stopped and start them
+ If (-not $SkipDependentServices) {
+ Write-Log -Message "Discover all dependent service(s) for service [$Name] which are not 'Running'." -Source ${CmdletName}
+ [ServiceProcess.ServiceController[]]$DependentServices = Get-Service -ComputerName $ComputerName -Name $Service.ServiceName -DependentServices -ErrorAction 'Stop' | Where-Object { $_.Status -ne 'Running' }
+ If ($DependentServices) {
+ ForEach ($DependentService in $DependentServices) {
+ Write-Log -Message "Start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]." -Source ${CmdletName}
+ Try {
+ Start-Service -InputObject (Get-Service -ComputerName $ComputerName -Name $DependentService.ServiceName -ErrorAction 'Stop') -WarningAction 'SilentlyContinue' -ErrorAction 'Stop'
+ }
+ Catch {
+ Write-Log -Message "Failed to start dependent service [$($DependentService.ServiceName)] with display name [$($DependentService.DisplayName)] and a status of [$($DependentService.Status)]. Continue..." -Severity 2 -Source ${CmdletName}
+ Continue
+ }
+ }
+ }
+ Else {
+ Write-Log -Message "Dependent service(s) were not discovered for service [$Name]." -Source ${CmdletName}
+ }
+ }
+ }
+ }
+ Catch {
+ Write-Log -Message "Failed to start the service [$Name]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to start the service [$Name]: $($_.Exception.Message)"
+ }
+ }
+ Finally {
+ # Return the service object if option selected
+ If ($PassThru -and $Service) { Write-Output -InputObject $Service }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-ServiceStartMode
+Function Get-ServiceStartMode
+{
+<#
+.SYNOPSIS
+ Get the service startup mode.
+.DESCRIPTION
+ Get the service startup mode.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Get-ServiceStartMode -Name 'wuauserv'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdLetBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message "Get the service [$Name] startup mode." -Source ${CmdletName}
+ [string]$ServiceStartMode = (Get-WmiObject -ComputerName $ComputerName -Class 'Win32_Service' -Filter "Name='$Name'" -Property 'StartMode' -ErrorAction 'Stop').StartMode
+ ## If service start mode is set to 'Auto', change value to 'Automatic' to be consistent with 'Set-ServiceStartMode' function
+ If ($ServiceStartMode -eq 'Auto') { $ServiceStartMode = 'Automatic'}
+
+ ## If on Windows Vista or higher, check to see if service is set to Automatic (Delayed Start)
+ If (($ServiceStartMode -eq 'Automatic') -and (([version]$envOSVersion).Major -gt 5)) {
+ Try {
+ [string]$ServiceRegistryPath = "HKLM:SYSTEM\CurrentControlSet\Services\$Name"
+ [int32]$DelayedAutoStart = Get-ItemProperty -LiteralPath $ServiceRegistryPath -ErrorAction 'Stop' | Select-Object -ExpandProperty 'DelayedAutoStart' -ErrorAction 'Stop'
+ If ($DelayedAutoStart -eq 1) { $ServiceStartMode = 'Automatic (Delayed Start)' }
+ }
+ Catch { }
+ }
+
+ Write-Log -Message "Service [$Name] startup mode is set to [$ServiceStartMode]." -Source ${CmdletName}
+ Write-Output -InputObject $ServiceStartMode
+ }
+ Catch {
+ Write-Log -Message "Failed to get the service [$Name] startup mode. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to get the service [$Name] startup mode: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Set-ServiceStartMode
+Function Set-ServiceStartMode
+{
+<#
+.SYNOPSIS
+ Set the service startup mode.
+.DESCRIPTION
+ Set the service startup mode.
+.PARAMETER Name
+ Specify the name of the service.
+.PARAMETER ComputerName
+ Specify the name of the computer. Default is: the local computer.
+.PARAMETER StartMode
+ Specify startup mode for the service. Options: Automatic, Automatic (Delayed Start), Manual, Disabled, Boot, System.
+.PARAMETER ContinueOnError
+ Continue if an error is encountered. Default is: $true.
+.EXAMPLE
+ Set-ServiceStartMode -Name 'wuauserv' -StartMode 'Automatic (Delayed Start)'
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdLetBinding()]
+ Param (
+ [Parameter(Mandatory=$true)]
+ [ValidateNotNullOrEmpty()]
+ [string]$Name,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [string]$ComputerName = $env:ComputerName,
+ [Parameter(Mandatory=$true)]
+ [ValidateSet('Automatic','Automatic (Delayed Start)','Manual','Disabled','Boot','System')]
+ [string]$StartMode,
+ [Parameter(Mandatory=$false)]
+ [ValidateNotNullOrEmpty()]
+ [boolean]$ContinueOnError = $true
+ )
+ Begin {
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ ## If on lower than Windows Vista and 'Automatic (Delayed Start)' selected, then change to 'Automatic' because 'Delayed Start' is not supported.
+ If (($StartMode -eq 'Automatic (Delayed Start)') -and (([version]$envOSVersion).Major -lt 6)) { $StartMode = 'Automatic' }
+
+ Write-Log -Message "Set service [$Name] startup mode to [$StartMode]." -Source ${CmdletName}
+
+ ## Set the name of the start up mode that will be passed to sc.exe
+ [string]$ScExeStartMode = $StartMode
+ If ($StartMode -eq 'Automatic') { $ScExeStartMode = 'Auto' }
+ If ($StartMode -eq 'Automatic (Delayed Start)') { $ScExeStartMode = 'Delayed-Auto' }
+ If ($StartMode -eq 'Manual') { $ScExeStartMode = 'Demand' }
+
+ ## Set the start up mode using sc.exe. Note: we found that the ChangeStartMode method in the Win32_Service WMI class set services to 'Automatic (Delayed Start)' even when you specified 'Automatic' on Win7, Win8, and Win10.
+ $ChangeStartMode = & sc.exe config $Name start= $ScExeStartMode
+
+ If ($global:LastExitCode -ne 0) {
+ Throw "sc.exe failed with exit code [$($global:LastExitCode)] and message [$ChangeStartMode]."
+ }
+
+ Write-Log -Message "Successfully set service [$Name] startup mode to [$StartMode]." -Source ${CmdletName}
+ }
+ Catch {
+ Write-Log -Message "Failed to set service [$Name] startup mode to [$StartMode]. `n$(Resolve-Error)" -Source ${CmdletName} -Severity 3
+ If (-not $ContinueOnError) {
+ Throw "Failed to set service [$Name] startup mode to [$StartMode]: $($_.Exception.Message)"
+ }
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-LoggedOnUser
+Function Get-LoggedOnUser {
+<#
+.SYNOPSIS
+ Get session details for all local and RDP logged on users.
+.DESCRIPTION
+ Get session details for all local and RDP logged on users using Win32 APIs. Get the following session details:
+ NTAccount, SID, UserName, DomainName, SessionId, SessionName, ConnectState, IsCurrentSession, IsConsoleSession, IsUserSession, IsActiveUserSession
+ IsRdpSession, IsLocalAdmin, LogonTime, IdleTime, DisconnectTime, ClientName, ClientProtocolType, ClientDirectory, ClientBuildNumber
+.EXAMPLE
+ Get-LoggedOnUser
+.NOTES
+ Description of ConnectState property:
+ Value Description
+ ----- -----------
+ Active A user is logged on to the session.
+ ConnectQuery The session is in the process of connecting to a client.
+ Connected A client is connected to the session.
+ Disconnected The session is active, but the client has disconnected from it.
+ Down The session is down due to an error.
+ Idle The session is waiting for a client to connect.
+ Initializing The session is initializing.
+ Listening The session is listening for connections.
+ Reset The session is being reset.
+ Shadowing This session is shadowing another session.
+
+ Description of IsActiveUserSession property:
+ If a console user exists, then that will be the active user session.
+ If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user that is either 'Active' or 'Connected' is the active user.
+
+ Description of IsRdpSession property:
+ Gets a value indicating whether the user is associated with an RDP client session.
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+ }
+ Process {
+ Try {
+ Write-Log -Message 'Get session information for all logged on users.' -Source ${CmdletName}
+ Write-Output -InputObject ([PSADT.QueryUser]::GetUserSessionInfo("$env:ComputerName"))
+ }
+ Catch {
+ Write-Log -Message "Failed to get session information for all logged on users. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+ End {
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#region Function Get-PendingReboot
+Function Get-PendingReboot {
+<#
+.SYNOPSIS
+ Get the pending reboot status on a local computer.
+.DESCRIPTION
+ Check WMI and the registry to determine if the system has a pending reboot operation from any of the following:
+ a) Component Based Servicing (Vista, Windows 2008)
+ b) Windows Update / Auto Update (XP, Windows 2003 / 2008)
+ c) SCCM 2012 Clients (DetermineIfRebootPending WMI method)
+ d) App-V Pending Tasks (global based Appv 5.0 SP2)
+ e) Pending File Rename Operations (XP, Windows 2003 / 2008)
+.EXAMPLE
+ Get-PendingReboot
+
+ Returns custom object with following properties:
+ ComputerName, LastBootUpTime, IsSystemRebootPending, IsCBServicingRebootPending, IsWindowsUpdateRebootPending, IsSCCMClientRebootPending, IsFileRenameRebootPending, PendingFileRenameOperations, ErrorMsg
+
+ *Notes: ErrorMsg only contains something if an error occurred
+.EXAMPLE
+ (Get-PendingReboot).IsSystemRebootPending
+ Returns boolean value determining whether or not there is a pending reboot operation.
+.NOTES
+.LINK
+ http://psappdeploytoolkit.com
+#>
+ [CmdletBinding()]
+ Param (
+ )
+
+ Begin {
+ ## Get the name of this function and write header
+ [string]${CmdletName} = $PSCmdlet.MyInvocation.MyCommand.Name
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -CmdletBoundParameters $PSBoundParameters -Header
+
+ ## Initialize variables
+ [string]$private:ComputerName = ([Net.Dns]::GetHostEntry('')).HostName
+ $PendRebootErrorMsg = $null
+ }
+ Process {
+ Write-Log -Message "Get the pending reboot status on the local computer [$ComputerName]." -Source ${CmdletName}
+
+ ## Get the date/time that the system last booted up
+ Try {
+ [nullable[datetime]]$LastBootUpTime = (Get-Date -ErrorAction 'Stop') - ([timespan]::FromMilliseconds([math]::Abs([Environment]::TickCount)))
+ }
+ Catch {
+ [nullable[datetime]]$LastBootUpTime = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get LastBootUpTime: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get LastBootUpTime. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if a Windows Vista/Server 2008 and above machine has a pending reboot from a Component Based Servicing (CBS) operation
+ Try {
+ If (([version]$envOSVersion).Major -ge 5) {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\Component Based Servicing\RebootPending' -ErrorAction 'Stop') {
+ [nullable[boolean]]$IsCBServicingRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsCBServicingRebootPending = $false
+ }
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsCBServicingRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsCBServicingRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsCBServicingRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from a Windows Update
+ Try {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Microsoft\Windows\CurrentVersion\WindowsUpdate\Auto Update\RebootRequired' -ErrorAction 'Stop') {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $false
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsWindowsUpdateRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsWindowsUpdateRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsWindowsUpdateRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from a pending file rename operation
+ [boolean]$IsFileRenameRebootPending = $false
+ $PendingFileRenameOperations = $null
+ If (Test-RegistryValue -Key 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -Value 'PendingFileRenameOperations') {
+ # If PendingFileRenameOperations value exists, set $IsFileRenameRebootPending variable to $true
+ [boolean]$IsFileRenameRebootPending = $true
+ # Get the value of PendingFileRenameOperations
+ Try {
+ [string[]]$PendingFileRenameOperations = Get-ItemProperty -LiteralPath 'HKLM:SYSTEM\CurrentControlSet\Control\Session Manager' -ErrorAction 'Stop' | Select-Object -ExpandProperty 'PendingFileRenameOperations' -ErrorAction 'Stop'
+ }
+ Catch {
+ [string[]]$PendRebootErrorMsg += "Failed to get PendingFileRenameOperations: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get PendingFileRenameOperations. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+ }
+
+ ## Determine SCCM 2012 Client reboot pending status
+ Try {
+ [boolean]$IsSccmClientNamespaceExists = $false
+ [psobject]$SCCMClientRebootStatus = Invoke-WmiMethod -ComputerName $ComputerName -NameSpace 'ROOT\CCM\ClientSDK' -Class 'CCM_ClientUtilities' -Name 'DetermineIfRebootPending' -ErrorAction 'Stop'
+ [boolean]$IsSccmClientNamespaceExists = $true
+ If ($SCCMClientRebootStatus.ReturnValue -ne 0) {
+ Throw "'DetermineIfRebootPending' method of 'ROOT\CCM\ClientSDK\CCM_ClientUtilities' class returned error code [$($SCCMClientRebootStatus.ReturnValue)]"
+ }
+ Else {
+ Write-Log -Message 'Successfully queried SCCM client for reboot status.' -Source ${CmdletName}
+ [nullable[boolean]]$IsSCCMClientRebootPending = $false
+ If ($SCCMClientRebootStatus.IsHardRebootPending -or $SCCMClientRebootStatus.RebootPending) {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $true
+ Write-Log -Message 'Pending SCCM reboot detected.' -Source ${CmdletName}
+ }
+ Else {
+ Write-Log -Message 'Pending SCCM reboot not detected.' -Source ${CmdletName}
+ }
+ }
+ }
+ Catch [System.Management.ManagementException] {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $null
+ [boolean]$IsSccmClientNamespaceExists = $false
+ Write-Log -Message "Failed to get IsSCCMClientRebootPending. Failed to detect the SCCM client WMI class." -Severity 3 -Source ${CmdletName}
+ }
+ Catch {
+ [nullable[boolean]]$IsSCCMClientRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsSCCMClientRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsSCCMClientRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot from an App-V global Pending Task. (User profile based tasks will complete on logoff/logon)
+ Try {
+ If (Test-Path -LiteralPath 'HKLM:SOFTWARE\Software\Microsoft\AppV\Client\PendingTasks' -ErrorAction 'Stop') {
+
+ [nullable[boolean]]$IsAppVRebootPending = $true
+ }
+ Else {
+ [nullable[boolean]]$IsAppVRebootPending = $false
+ }
+ }
+ Catch {
+ [nullable[boolean]]$IsAppVRebootPending = $null
+ [string[]]$PendRebootErrorMsg += "Failed to get IsAppVRebootPending: $($_.Exception.Message)"
+ Write-Log -Message "Failed to get IsAppVRebootPending. `n$(Resolve-Error)" -Severity 3 -Source ${CmdletName}
+ }
+
+ ## Determine if there is a pending reboot for the system
+ [boolean]$IsSystemRebootPending = $false
+ If ($IsCBServicingRebootPending -or $IsWindowsUpdateRebootPending -or $IsSCCMClientRebootPending -or $IsFileRenameRebootPending) {
+ [boolean]$IsSystemRebootPending = $true
+ }
+
+ ## Create a custom object containing pending reboot information for the system
+ [psobject]$PendingRebootInfo = New-Object -TypeName 'PSObject' -Property @{
+ ComputerName = $ComputerName
+ LastBootUpTime = $LastBootUpTime
+ IsSystemRebootPending = $IsSystemRebootPending
+ IsCBServicingRebootPending = $IsCBServicingRebootPending
+ IsWindowsUpdateRebootPending = $IsWindowsUpdateRebootPending
+ IsSCCMClientRebootPending = $IsSCCMClientRebootPending
+ IsAppVRebootPending = $IsAppVRebootPending
+ IsFileRenameRebootPending = $IsFileRenameRebootPending
+ PendingFileRenameOperations = $PendingFileRenameOperations
+ ErrorMsg = $PendRebootErrorMsg
+ }
+ Write-Log -Message "Pending reboot status on the local computer [$ComputerName]: `n$($PendingRebootInfo | Format-List | Out-String)" -Source ${CmdletName}
+ }
+ End {
+ Write-Output -InputObject ($PendingRebootInfo | Select-Object -Property 'ComputerName','LastBootUpTime','IsSystemRebootPending','IsCBServicingRebootPending','IsWindowsUpdateRebootPending','IsSCCMClientRebootPending','IsAppVRebootPending','IsFileRenameRebootPending','PendingFileRenameOperations','ErrorMsg')
+
+ Write-FunctionHeaderOrFooter -CmdletName ${CmdletName} -Footer
+ }
+}
+#endregion
+
+
+#endregion
+##*=============================================
+##* END FUNCTION LISTINGS
+##*=============================================
+
+##*=============================================
+##* SCRIPT BODY
+##*=============================================
+#region ScriptBody
+
+## If the script was invoked by the Help Console, exit the script now
+If ($invokingScript) {
+ If ((Split-Path -Path $invokingScript -Leaf) -eq 'AppDeployToolkitHelp.ps1') { Return }
+}
+
+## Add the custom types required for the toolkit
+If (-not ([Management.Automation.PSTypeName]'PSADT.UiAutomation').Type) {
+ [string[]]$ReferencedAssemblies = 'System.Drawing', 'System.Windows.Forms', 'System.DirectoryServices'
+ Add-Type -Path $appDeployCustomTypesSourceCode -ReferencedAssemblies $ReferencedAssemblies -IgnoreWarnings -ErrorAction 'Stop'
+}
+
+## Define ScriptBlocks to disable/revert script logging
+[scriptblock]$DisableScriptLogging = { $OldDisableLoggingValue = $DisableLogging ; $DisableLogging = $true }
+[scriptblock]$RevertScriptLogging = { $DisableLogging = $OldDisableLoggingValue }
+
+## Define ScriptBlock for getting details for all logged on users
+[scriptblock]$GetLoggedOnUserDetails = {
+ [psobject[]]$LoggedOnUserSessions = Get-LoggedOnUser
+ [string[]]$usersLoggedOn = $LoggedOnUserSessions | ForEach-Object { $_.NTAccount }
+
+ If ($usersLoggedOn) {
+ # Get account and session details for the logged on user session that the current process is running under. Note that the account used to execute the current process may be different than the account that is logged into the session (i.e. you can use "RunAs" to launch with different credentials when logged into an account).
+ [psobject]$CurrentLoggedOnUserSession = $LoggedOnUserSessions | Where-Object { $_.IsCurrentSession }
+
+ # Get account and session details for the account running as the console user (user with control of the physical monitor, keyboard, and mouse)
+ [psobject]$CurrentConsoleUserSession = $LoggedOnUserSessions | Where-Object { $_.IsConsoleSession }
+
+ ## Determine the account that will be used to execute commands in the user session when toolkit is running under the SYSTEM account
+ # If a console user exists, then that will be the active user session.
+ # If no console user exists but users are logged in, such as on terminal servers, then the first logged-in non-console user that is either 'Active' or 'Connected' is the active user.
+ [psobject]$RunAsActiveUser = $LoggedOnUserSessions | Where-Object { $_.IsActiveUserSession }
+ }
+}
+
+## Define ScriptBlock to test for and attempt to make a service healthy by checking if it exists, is currently running, and has the specified start mode.
+[scriptblock]$TestServiceHealth = {
+ Param (
+ [string]$ServiceName,
+ [string]$ServiceStartMode = 'Automatic'
+ )
+ Try {
+ [boolean]$IsServiceHealthy = $true
+ If (Test-ServiceExists -Name $ServiceName -ContinueOnError $false) {
+ If ((Get-ServiceStartMode -Name $ServiceName -ContinueOnError $false) -ne $ServiceStartMode) {
+ Set-ServiceStartMode -Name $ServiceName -StartMode $ServiceStartMode -ContinueOnError $false
+ }
+ Start-ServiceAndDependencies -Name $ServiceName -SkipServiceExistsTest -ContinueOnError $false
+ }
+ Else {
+ [boolean]$IsServiceHealthy = $false
+ }
+ }
+ Catch {
+ [boolean]$IsServiceHealthy = $false
+ }
+ Write-Output -InputObject $IsServiceHealthy
+}
+
+## Disable logging until log file details are available
+. $DisableScriptLogging
+
+## If the default Deploy-Application.ps1 hasn't been modified, and the main script was not called by a referring script, check for MSI / MST and modify the install accordingly
+If ((-not $appName) -and (-not $ReferredInstallName)){
+ # Find the first MSI file in the Files folder and use that as our install
+ [string]$defaultMsiFile = Get-ChildItem -LiteralPath $dirFiles -ErrorAction 'SilentlyContinue' | Where-Object { (-not $_.PsIsContainer) -and ([IO.Path]::GetExtension($_.Name) -eq '.msi') } | Select-Object -ExpandProperty 'FullName' -First 1
+ If ($defaultMsiFile) {
+ Try {
+ [boolean]$useDefaultMsi = $true
+ Write-Log -Message "Discovered Zero-Config MSI installation file [$defaultMsiFile]." -Source $appDeployToolkitName
+ # Discover if there is a zero-config MST file
+ [string]$defaultMstFile = [IO.Path]::ChangeExtension($defaultMsiFile, 'mst')
+ If (Test-Path -LiteralPath $defaultMstFile -PathType 'Leaf') {
+ Write-Log -Message "Discovered Zero-Config MST installation file [$defaultMstFile]." -Source $appDeployToolkitName
+ }
+ Else {
+ [string]$defaultMstFile = ''
+ }
+ # Discover if there are zero-config MSP files. Name multiple MSP files in alphabetical order to control order in which they are installed.
+ [string[]]$defaultMspFiles = Get-ChildItem -LiteralPath $dirFiles -ErrorAction 'SilentlyContinue' | Where-Object { (-not $_.PsIsContainer) -and ([IO.Path]::GetExtension($_.Name) -eq '.msp') } | Select-Object -ExpandProperty 'FullName'
+ If ($defaultMspFiles) {
+ Write-Log -Message "Discovered Zero-Config MSP installation file(s) [$($defaultMspFiles -join ',')]." -Source $appDeployToolkitName
+ }
+
+ ## Read the MSI and get the installation details
+ [hashtable]$GetDefaultMsiTablePropertySplat = @{ Path = $defaultMsiFile; Table = 'Property'; ContinueOnError = $false; ErrorAction = 'Stop' }
+ If ($defaultMstFile) { $GetDefaultMsiTablePropertySplat.Add('TransformPath', $defaultMstFile) }
+ [psobject]$defaultMsiPropertyList = Get-MsiTableProperty @GetDefaultMsiTablePropertySplat
+ [string]$appVendor = $defaultMsiPropertyList.Manufacturer
+ [string]$appName = $defaultMsiPropertyList.ProductName
+ [string]$appVersion = $defaultMsiPropertyList.ProductVersion
+ $GetDefaultMsiTablePropertySplat.Set_Item('Table', 'File')
+ [psobject]$defaultMsiFileList = Get-MsiTableProperty @GetDefaultMsiTablePropertySplat
+ [string[]]$defaultMsiExecutables = Get-Member -InputObject $defaultMsiFileList -ErrorAction 'Stop' | Select-Object -ExpandProperty 'Name' -ErrorAction 'Stop' | Where-Object { [IO.Path]::GetExtension($_) -eq '.exe' } | ForEach-Object { [IO.Path]::GetFileNameWithoutExtension($_) }
+ [string]$defaultMsiExecutablesList = $defaultMsiExecutables -join ','
+ Write-Log -Message "App Vendor [$appVendor]." -Source $appDeployToolkitName
+ Write-Log -Message "App Name [$appName]." -Source $appDeployToolkitName
+ Write-Log -Message "App Version [$appVersion]." -Source $appDeployToolkitName
+ Write-Log -Message "MSI Executable List [$defaultMsiExecutablesList]." -Source $appDeployToolkitName
+ }
+ Catch {
+ Write-Log -Message "Failed to process Zero-Config MSI Deployment. `n$(Resolve-Error)" -Source $appDeployToolkitName
+ $useDefaultMsi = $false ; $appVendor = '' ; $appName = '' ; $appVersion = ''
+ }
+ }
+}
+
+## Set up sample variables if Dot Sourcing the script, app details have not been specified, or InstallName not passed as parameter to the script
+If (-not $appName) {
+ [string]$appName = $appDeployMainScriptFriendlyName
+ If (-not $appVendor) { [string]$appVendor = 'PS' }
+ If (-not $appVersion) { [string]$appVersion = $appDeployMainScriptVersion }
+ If (-not $appLang) { [string]$appLang = $currentLanguage }
+ If (-not $appRevision) { [string]$appRevision = '01' }
+ If (-not $appArch) { [string]$appArch = '' }
+}
+If ($ReferredInstallTitle) { [string]$installTitle = $ReferredInstallTitle }
+If (-not $installTitle) {
+ [string]$installTitle = ("$appVendor $appName $appVersion").Trim()
+}
+
+## Sanitize the application details, as they can cause issues in the script
+[char[]]$invalidFileNameChars = [IO.Path]::GetInvalidFileNameChars()
+[string]$appVendor = $appVendor -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appName = $appName -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appVersion = $appVersion -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appArch = $appArch -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appLang = $appLang -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$appRevision = $appRevision -replace "[$invalidFileNameChars]",'' -replace ' ',''
+
+## Build the Installation Name
+If ($ReferredInstallName) { [string]$installName = $ReferredInstallName }
+If (-not $installName) {
+ If ($appArch) {
+ [string]$installName = $appVendor + '_' + $appName + '_' + $appVersion + '_' + $appArch + '_' + $appLang + '_' + $appRevision
+ }
+ Else {
+ [string]$installName = $appVendor + '_' + $appName + '_' + $appVersion + '_' + $appLang + '_' + $appRevision
+ }
+}
+[string]$installName = $installName -replace "[$invalidFileNameChars]",'' -replace ' ',''
+[string]$installName = $installName.Trim('_') -replace '[_]+','_'
+
+## Set the Defer History registry path
+[string]$regKeyDeferHistory = "$configToolkitRegPath\$appDeployToolkitName\DeferHistory\$installName"
+
+## Variables: Log Files
+If ($ReferredLogName) { [string]$logName = $ReferredLogName }
+If (-not $logName) { [string]$logName = $installName + '_' + $appDeployToolkitName + '_' + $deploymentType + '.log' }
+# If option to compress logs is selected, then log will be created in temp log folder ($logTempFolder) and then copied to actual log folder ($configToolkitLogDir) after being zipped.
+[string]$logTempFolder = Join-Path -Path $envTemp -ChildPath "${installName}_$deploymentType"
+If ($configToolkitCompressLogs) {
+ # If the temp log folder already exists from a previous ZIP operation, then delete all files in it to avoid issues
+ If (Test-Path -LiteralPath $logTempFolder -PathType 'Container' -ErrorAction 'SilentlyContinue') {
+ $null = Remove-Item -LiteralPath $logTempFolder -Recurse -Force -ErrorAction 'SilentlyContinue'
+ }
+}
+
+## Revert script logging to original setting
+. $RevertScriptLogging
+
+## Initialize Logging
+$installPhase = 'Initialization'
+$scriptSeparator = '*' * 79
+Write-Log -Message ($scriptSeparator,$scriptSeparator) -Source $appDeployToolkitName
+Write-Log -Message "[$installName] setup started." -Source $appDeployToolkitName
+
+## Assemblies: Load
+Try {
+ Add-Type -AssemblyName 'System.Windows.Forms' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'PresentationFramework' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'Microsoft.VisualBasic' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'System.Drawing' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'PresentationCore' -ErrorAction 'Stop'
+ Add-Type -AssemblyName 'WindowsBase' -ErrorAction 'Stop'
+}
+Catch {
+ Write-Log -Message "Failed to load assembly. `n$(Resolve-Error)" -Severity 3 -Source $appDeployToolkitName
+ If ($deployModeNonInteractive) {
+ Write-Log -Message "Continue despite assembly load error since deployment mode is [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ Exit-Script -ExitCode 60004
+ }
+}
+
+## Check how the script was invoked
+If ($invokingScript) {
+ Write-Log -Message "Script [$scriptPath] dot-source invoked by [$invokingScript]" -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "Script [$scriptPath] invoked directly" -Source $appDeployToolkitName
+}
+
+## Dot Source script extensions
+If (Test-Path -LiteralPath "$scriptRoot\$appDeployToolkitDotSourceExtensions" -PathType 'Leaf') {
+ . "$scriptRoot\$appDeployToolkitDotSourceExtensions"
+}
+
+## Evaluate non-default parameters passed to the scripts
+If ($deployAppScriptParameters) { [string]$deployAppScriptParameters = ($deployAppScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+# Save main script parameters hashtable for async execution of the toolkit
+[hashtable]$appDeployMainScriptAsyncParameters = $appDeployMainScriptParameters
+If ($appDeployMainScriptParameters) { [string]$appDeployMainScriptParameters = ($appDeployMainScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+If ($appDeployExtScriptParameters) { [string]$appDeployExtScriptParameters = ($appDeployExtScriptParameters.GetEnumerator() | ForEach-Object { If ($_.Value.GetType().Name -eq 'SwitchParameter') { "-$($_.Key):`$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Boolean') { "-$($_.Key) `$" + "$($_.Value)".ToLower() } ElseIf ($_.Value.GetType().Name -eq 'Int32') { "-$($_.Key) $($_.Value)" } Else { "-$($_.Key) `"$($_.Value)`"" } }) -join ' ' }
+
+## Check the XML config file version
+If ($configConfigVersion -lt $appDeployMainScriptMinimumConfigVersion) {
+ [string]$XMLConfigVersionErr = "The XML configuration file version [$configConfigVersion] is lower than the supported version required by the Toolkit [$appDeployMainScriptMinimumConfigVersion]. Please upgrade the configuration file."
+ Write-Log -Message $XMLConfigVersionErr -Severity 3 -Source $appDeployToolkitName
+ Throw $XMLConfigVersionErr
+}
+
+## Log system/script information
+If ($appScriptVersion) { Write-Log -Message "[$installName] script version is [$appScriptVersion]" -Source $appDeployToolkitName }
+If ($deployAppScriptFriendlyName) { Write-Log -Message "[$deployAppScriptFriendlyName] script version is [$deployAppScriptVersion]" -Source $appDeployToolkitName }
+If ($deployAppScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$deployAppScriptFriendlyName]: [$deployAppScriptParameters]" -Source $appDeployToolkitName }
+If ($appDeployMainScriptFriendlyName) { Write-Log -Message "[$appDeployMainScriptFriendlyName] script version is [$appDeployMainScriptVersion]" -Source $appDeployToolkitName }
+If ($appDeployMainScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$appDeployMainScriptFriendlyName]: [$appDeployMainScriptParameters]" -Source $appDeployToolkitName }
+If ($appDeployExtScriptFriendlyName) { Write-Log -Message "[$appDeployExtScriptFriendlyName] version is [$appDeployExtScriptVersion]" -Source $appDeployToolkitName }
+If ($appDeployExtScriptParameters) { Write-Log -Message "The following non-default parameters were passed to [$appDeployExtScriptFriendlyName]: [$appDeployExtScriptParameters]" -Source $appDeployToolkitName }
+Write-Log -Message "Computer Name is [$envComputerNameFQDN]" -Source $appDeployToolkitName
+Write-Log -Message "Current User is [$ProcessNTAccount]" -Source $appDeployToolkitName
+If ($envOSServicePack) {
+ Write-Log -Message "OS Version is [$envOSName $envOSServicePack $envOSArchitecture $envOSVersion]" -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "OS Version is [$envOSName $envOSArchitecture $envOSVersion]" -Source $appDeployToolkitName
+}
+Write-Log -Message "OS Type is [$envOSProductTypeName]" -Source $appDeployToolkitName
+Write-Log -Message "Current Culture is [$($culture.Name)], language is [$currentLanguage] and UI language is [$currentUILanguage]" -Source $appDeployToolkitName
+Write-Log -Message "Hardware Platform is [$(. $DisableScriptLogging; Get-HardwarePlatform; . $RevertScriptLogging)]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell Host is [$($envHost.Name)] with version [$($envHost.Version)]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell Version is [$envPSVersion $psArchitecture]" -Source $appDeployToolkitName
+Write-Log -Message "PowerShell CLR (.NET) version is [$envCLRVersion]" -Source $appDeployToolkitName
+Write-Log -Message $scriptSeparator -Source $appDeployToolkitName
+
+## Disable logging
+. $DisableScriptLogging
+
+## Dot source ScriptBlock to get a list of all users logged on to the system (both local and RDP users), and discover session details for account executing script
+. $GetLoggedOnUserDetails
+
+## Dot source ScriptBlock to load localized UI messages from config XML
+. $xmlLoadLocalizedUIMessages
+
+## Dot source ScriptBlock to get system DPI scale factor
+. $GetDisplayScaleFactor
+
+## Revert script logging to original setting
+. $RevertScriptLogging
+
+## Set the install phase to asynchronous if the script was not dot sourced, i.e. called with parameters
+If ($AsyncToolkitLaunch) {
+ $installPhase = 'Asynchronous'
+}
+
+## If the ShowInstallationPrompt Parameter is specified, only call that function.
+If ($showInstallationPrompt) {
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowInstallationPrompt]." -Source $appDeployToolkitName
+ $appDeployMainScriptAsyncParameters.Remove('ShowInstallationPrompt')
+ $appDeployMainScriptAsyncParameters.Remove('AsyncToolkitLaunch')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallName')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallTitle')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredLogName')
+ Show-InstallationPrompt @appDeployMainScriptAsyncParameters
+ Exit 0
+}
+
+## If the ShowInstallationRestartPrompt Parameter is specified, only call that function.
+If ($showInstallationRestartPrompt) {
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowInstallationRestartPrompt]." -Source $appDeployToolkitName
+ $appDeployMainScriptAsyncParameters.Remove('ShowInstallationRestartPrompt')
+ $appDeployMainScriptAsyncParameters.Remove('AsyncToolkitLaunch')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallName')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredInstallTitle')
+ $appDeployMainScriptAsyncParameters.Remove('ReferredLogName')
+ Show-InstallationRestartPrompt @appDeployMainScriptAsyncParameters
+ Exit 0
+}
+
+## If the CleanupBlockedApps Parameter is specified, only call that function.
+If ($cleanupBlockedApps) {
+ $deployModeSilent = $true
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-CleanupBlockedApps]." -Source $appDeployToolkitName
+ Unblock-AppExecution
+ Exit 0
+}
+
+## If the ShowBlockedAppDialog Parameter is specified, only call that function.
+If ($showBlockedAppDialog) {
+ Try {
+ . $DisableScriptLogging
+ Write-Log -Message "[$appDeployMainScriptFriendlyName] called with switch [-ShowBlockedAppDialog]." -Source $appDeployToolkitName
+ # Create a mutex and specify a name without acquiring a lock on the mutex
+ [boolean]$showBlockedAppDialogMutexLocked = $false
+ [string]$showBlockedAppDialogMutexName = 'Global\PSADT_ShowBlockedAppDialog_Message'
+ [Threading.Mutex]$showBlockedAppDialogMutex = New-Object -TypeName 'System.Threading.Mutex' -ArgumentList ($false, $showBlockedAppDialogMutexName)
+ # Attempt to acquire an exclusive lock on the mutex, attempt will fail after 1 millisecond if unable to acquire exclusive lock
+ If ((Test-IsMutexAvailable -MutexName $showBlockedAppDialogMutexName -MutexWaitTimeInMilliseconds 1) -and ($showBlockedAppDialogMutex.WaitOne(1))) {
+ [boolean]$showBlockedAppDialogMutexLocked = $true
+ Show-InstallationPrompt -Title $installTitle -Message $configBlockExecutionMessage -Icon 'Warning' -ButtonRightText 'OK'
+ Exit 0
+ }
+ Else {
+ # If attempt to acquire an exclusive lock on the mutex failed, then exit script as another blocked app dialog window is already open
+ Write-Log -Message "Unable to acquire an exclusive lock on mutex [$showBlockedAppDialogMutexName] because another blocked application dialog window is already open. Exiting script..." -Severity 2 -Source $appDeployToolkitName
+ Exit 0
+ }
+ }
+ Catch {
+ Write-Log -Message "There was an error in displaying the Installation Prompt. `n$(Resolve-Error)" -Severity 3 -Source $appDeployToolkitName
+ Exit 60005
+ }
+ Finally {
+ If ($showBlockedAppDialogMutexLocked) { $null = $showBlockedAppDialogMutex.ReleaseMutex() }
+ If ($showBlockedAppDialogMutex) { $showBlockedAppDialogMutex.Close() }
+ }
+}
+
+## Log details for all currently logged in users
+Write-Log -Message "Display session information for all logged on users: `n$($LoggedOnUserSessions | Format-List | Out-String)" -Source $appDeployToolkitName
+If ($usersLoggedOn) {
+ Write-Log -Message "The following users are logged on to the system: [$($usersLoggedOn -join ', ')]." -Source $appDeployToolkitName
+
+ # Check if the current process is running in the context of one of the logged in users
+ If ($CurrentLoggedOnUserSession) {
+ Write-Log -Message "Current process is running with user account [$ProcessNTAccount] under logged in user session for [$($CurrentLoggedOnUserSession.NTAccount)]." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message "Current process is running under a system account [$ProcessNTAccount]." -Source $appDeployToolkitName
+ }
+
+ # Display account and session details for the account running as the console user (user with control of the physical monitor, keyboard, and mouse)
+ If ($CurrentConsoleUserSession) {
+ Write-Log -Message "The following user is the console user [$($CurrentConsoleUserSession.NTAccount)] (user with control of physical monitor, keyboard, and mouse)." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message 'There is no console user logged in (user with control of physical monitor, keyboard, and mouse).' -Source $appDeployToolkitName
+ }
+
+ # Display the account that will be used to execute commands in the user session when toolkit is running under the SYSTEM account
+ If ($RunAsActiveUser) {
+ Write-Log -Message "The active logged on user is [$($RunAsActiveUser.NTAccount)]." -Source $appDeployToolkitName
+ }
+}
+Else {
+ Write-Log -Message 'No users are logged on to the system.' -Source $appDeployToolkitName
+}
+
+## Log which language's UI messages are loaded from the config XML file
+If ($HKUPrimaryLanguageShort) {
+ Write-Log -Message "The active logged on user [$($RunAsActiveUser.NTAccount)] has a primary UI language of [$HKUPrimaryLanguageShort]." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "The current system account [$ProcessNTAccount] has a primary UI language of [$currentLanguage]." -Source $appDeployToolkitName
+}
+If ($configInstallationUILanguageOverride) { Write-Log -Message "The config XML file was configured to override the detected primary UI language with the following UI language: [$configInstallationUILanguageOverride]." -Source $appDeployToolkitName }
+Write-Log -Message "The following UI messages were imported from the config XML file: [$xmlUIMessageLanguage]." -Source $appDeployToolkitName
+
+## Log system DPI scale factor of active logged on user
+If ($UserDisplayScaleFactor) {
+ Write-Log -Message "The active logged on user [$($RunAsActiveUser.NTAccount)] has a DPI scale factor of [$dpiScale] with DPI pixels [$dpiPixels]." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "The system has a DPI scale factor of [$dpiScale] with DPI pixels [$dpiPixels]." -Source $appDeployToolkitName
+}
+
+## Check if script is running from a SCCM Task Sequence
+Try {
+ [__comobject]$SMSTSEnvironment = New-Object -ComObject 'Microsoft.SMS.TSEnvironment' -ErrorAction 'Stop'
+ Write-Log -Message 'Successfully loaded COM Object [Microsoft.SMS.TSEnvironment]. Therefore, script is currently running from a SCCM Task Sequence.' -Source $appDeployToolkitName
+ $null = [Runtime.Interopservices.Marshal]::ReleaseComObject($SMSTSEnvironment)
+ $runningTaskSequence = $true
+}
+Catch {
+ Write-Log -Message 'Unable to load COM Object [Microsoft.SMS.TSEnvironment]. Therefore, script is not currently running from a SCCM Task Sequence.' -Source $appDeployToolkitName
+ $runningTaskSequence = $false
+}
+
+
+## Check to see if the Task Scheduler service is in a healthy state by checking its services to see if they exist, are currently running, and have a start mode of 'Automatic'.
+## The task scheduler service and the services it is dependent on can/should only be started/stopped/modified when running in the SYSTEM context.
+[boolean]$IsTaskSchedulerHealthy = $true
+If ($IsLocalSystemAccount) {
+ # Check the health of the 'COM+ Event System' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'EventSystem'
+ # Check the health of the 'Remote Procedure Call (RPC)' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'RpcSs'
+ # Check the health of the 'Windows Event Log' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'EventLog'
+ # Check the health of the 'Task Scheduler' service
+ [boolean]$IsTaskSchedulerHealthy = & $TestServiceHealth -ServiceName 'Schedule'
+
+ Write-Log -Message "The task scheduler service is in a healthy state: $IsTaskSchedulerHealthy." -Source $appDeployToolkitName
+}
+Else {
+ Write-Log -Message "Skipping attempt to check for and make the task scheduler services healthy because the App Deployment Toolkit is not running under the [$LocalSystemNTAccount] account." -Source $appDeployToolkitName
+}
+
+## If script is running in session zero
+If ($SessionZero) {
+ ## If the script was launched with deployment mode set to NonInteractive, then continue
+ If ($deployMode -eq 'NonInteractive') {
+ Write-Log -Message "Session 0 detected but deployment mode was manually set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ ## If the process is not able to display a UI, enable NonInteractive mode
+ If (-not $IsProcessUserInteractive) {
+ $deployMode = 'NonInteractive'
+ Write-Log -Message "Session 0 detected, process not running in user interactive mode; deployment mode set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ If (-not $usersLoggedOn) {
+ $deployMode = 'NonInteractive'
+ Write-Log -Message "Session 0 detected, process running in user interactive mode, no users logged in; deployment mode set to [$deployMode]." -Source $appDeployToolkitName
+ }
+ Else {
+ Write-Log -Message 'Session 0 detected, process running in user interactive mode, user(s) logged in.' -Source $appDeployToolkitName
+ }
+ }
+ }
+}
+Else {
+ Write-Log -Message 'Session 0 not detected.' -Source $appDeployToolkitName
+}
+
+## Set Deploy Mode switches
+If ($deployMode) {
+ Write-Log -Message "Installation is running in [$deployMode] mode." -Source $appDeployToolkitName
+}
+Switch ($deployMode) {
+ 'Silent' { $deployModeSilent = $true }
+ 'NonInteractive' { $deployModeNonInteractive = $true; $deployModeSilent = $true }
+ Default { $deployModeNonInteractive = $false; $deployModeSilent = $false }
+}
+
+## Check deployment type (install/uninstall)
+Switch ($deploymentType) {
+ 'Install' { $deploymentTypeName = $configDeploymentTypeInstall }
+ 'Uninstall' { $deploymentTypeName = $configDeploymentTypeUnInstall }
+ Default { $deploymentTypeName = $configDeploymentTypeInstall }
+}
+If ($deploymentTypeName) { Write-Log -Message "Deployment type is [$deploymentTypeName]." -Source $appDeployToolkitName }
+
+If ($useDefaultMsi) { Write-Log -Message "Discovered Zero-Config MSI installation file [$defaultMsiFile]." -Source $appDeployToolkitName }
+
+## Check current permissions and exit if not running with Administrator rights
+If ($configToolkitRequireAdmin) {
+ # Check if the current process is running with elevated administrator permissions
+ If ((-not $IsAdmin) -and (-not $ShowBlockedAppDialog)) {
+ [string]$AdminPermissionErr = "[$appDeployToolkitName] has an XML config file option [Toolkit_RequireAdmin] set to [True] so as to require Administrator rights for the toolkit to function. Please re-run the deployment script as an Administrator or change the option in the XML config file to not require Administrator rights."
+ Write-Log -Message $AdminPermissionErr -Severity 3 -Source $appDeployToolkitName
+ Show-DialogBox -Text $AdminPermissionErr -Icon 'Stop'
+ Throw $AdminPermissionErr
+ }
+}
+
+## If terminal server mode was specified, change the installation mode to support it
+If ($terminalServerMode) { Enable-TerminalServerInstallMode }
+
+#endregion
+##*=============================================
+##* END SCRIPT BODY
+##*=============================================
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/Thumbs.db b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/Thumbs.db
new file mode 100644
index 0000000..3c1f662
Binary files /dev/null and b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkit/Thumbs.db differ
diff --git a/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkitConfig.xml b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkitConfig.xml
new file mode 100644
index 0000000..8ca907e
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/AppDeployToolkitConfig.xml
@@ -0,0 +1,1300 @@
+
+
+
+
+
+ 3.9.3
+ 02/05/2023
+
+
+
+
+ True
+
+ $envTemp
+
+ HKLM:\SOFTWARE
+
+ $envWinDir\Logs\Software
+
+ $envTemp
+
+ HKCU:\SOFTWARE
+
+ $envProgramData\Logs\Software
+
+ False
+
+ CMTrace
+
+ False
+
+ 10
+
+ True
+
+
+
+
+
+
+ True
+ PSAppDeployToolkit
+
+
+
+
+
+ AppDeployToolkitLogo.ico
+
+ AppDeployToolkitLogo.png
+
+ AppDeployToolkitBanner.png
+
+ 150
+
+
+
+
+
+
+ /L*v
+
+ $envWinDir\Logs\Software
+
+ $envProgramData\Logs\Software
+
+ REBOOT=ReallySuppress /QB-!
+
+ REBOOT=ReallySuppress /QN
+
+ REBOOT=ReallySuppress /QN
+
+ 600
+
+
+
+
+
+
+
+
+ True
+
+ 6900
+
+ 1618
+
+ 60012
+
+ 60
+
+ 600
+
+ 120
+
+ True
+
+
+
+
+ 2
+
+
+
+
+
+
+
+ You do not have enough disk space to complete the installation of:
+ {0}
+
+ Space required: {1}MB
+ Space available: {2}MB
+
+ Please free up enough disk space in order to proceed with the installation.
+ Continue
+
+ Only select "Continue" after closing the above listed application(s).
+
+ Close Programs
+
+ Defer
+
+ The following programs must be closed before the installation can proceed.
+
+ Please save your work, close the programs, and then continue.
+ Alternatively, save your work and click "Close Programs".
+
+ NOTE: The program(s) will be automatically closed in:
+
+ The following application is about to be installed:
+
+ You can choose to defer the installation until the deferral expires:
+
+ Once the deferral has expired, you will no longer have the option to defer.
+
+ Remaining Deferrals:
+
+ Deadline:
+
+
+ The {0} will automatically continue in:
+
+
+
+
+ Installation
+
+ Uninstallation
+
+ Repairing
+
+
+
+ started.
+
+ complete.
+
+ complete. A reboot is required.
+
+ failed.
+
+ not complete.
+
+
+ Installation in progress. Please wait...
+
+ Uninstallation in progress. Please wait...
+
+ Repair in progress. Please wait...
+
+ Launching this application has been temporarily blocked so that an installation operation can complete.
+
+ Restart Required
+
+ In order for the installation to complete, you must restart your computer.
+ Please save your work and restart within the allotted time.
+ Your computer will be automatically restarted at the end of the countdown.
+
+ Time remaining:
+ Minimize
+ Restart Now
+
+
+
+
+ Du har ikke plads nok til at færdiggøre installationen af:
+ {0}
+
+ Plads krævet: {1}MB
+ Plads tilgængelig: {2}MB
+
+ Vær venlig at frigøre nok diskplads før du fortsætter installationen.
+ Fortsæt
+ Vælg kun "Fortsæt" efter at du har afsluttet de ovenfor nævnte programmer.
+ Luk Programmer
+ Udsæt
+ Følgende programmer skal lukkes før installationen kan fortsætte.
+
+ Gem dit arbejde, luk programmerne og fortsæt.
+ Alternativt kan du gemme dit arbejde og trykke på "Luk Programmer".
+ BEMÆRK: Programmet/Programmerne vil automatisk blive lukket om:
+ Følgende applikation vil nu blive installeret:
+ Du kan vælge at udsætte installationen indtil udsættelsesperioden udløber:
+ Når udsættelsesperioden udløber kan du ikke længere udsætte installationen.
+ Udsættelser tilbage:
+ Deadline:
+
+ The {0} will automatically continue in:
+
+
+ Installation
+ Afinstallation
+ Reparere
+
+ startet.
+ færdig.
+ færdig. En genstart er nødvendig.
+ fejlet.
+ ikke færdig.
+ Installation i gang. Vent venligst...
+ Afinstallation i gang. Vent venligst...
+ Reparere i gang. Vent venligst...
+ Opstart af denne applikation er midlertidigt blokeret da en installationsproces er under afvikling.
+ Genstart Nødvendig
+ For at færdiggøre installationen skal du genstarte din computer.
+ Du bør venligst gemme dit arbejde og genstarte indenfor det givne tidsrum.
+ Din computer vil automatisk blive genstartet når nedtællingen er færdig.
+ Tid tilbage:
+ Minimere
+ Genstart Nu
+
+
+
+
+ Vous n’avez pas assez d’espace sur le disque pour compléter l’installation de:
+ {0}
+
+ Espace requis: {1}MB
+ Espace disponible: {2}MB
+
+ Merci de vous assurez d’avoir assez d’espace libre pour pouvoir continuer l’installation.
+ Poursuivre
+ Veuillez cliquer sur « Poursuivre » uniquement après avoir fermé la ou les application(s) ci-dessus.
+ Fermer Programmes
+ Reporter l'installation
+ Les programmes suivants doivent être fermés afin que l'installation s'initialise.
+
+ Merci de sauvegarder votre travail, fermer tous les programmes, et continuer.
+ Vous pouvez aussi sauvegarder votre travail puis cliquez sur « Fermer Programmes ».
+ REMARQUE: Les programmes seront automatiquement fermés dans:
+ L'application suivante est sur le point d'être installée:
+ Vous pouvez choisir de reporter l'installation:
+ Quand le temps aura expiré, vous n'aurez plus la possibilité de reporter.
+ Nombre(s) de report restant(s):
+ Temps limite:
+
+ Le {0} va continuer automatiquement:
+
+
+ Installation
+ Désinstallation
+ Réparation
+ en cours.
+ réussie.
+ réussie. Un redémarrage est requis.
+ en échec.
+ incomplète.
+ Installation en cours, merci de patienter...
+ Désinstallation en cours, merci de patienter...
+ Réparation en cours, merci de patienter...
+ Le lancement de cette application a été temporairement bloqué afin qu'une autre installation puisse se terminer.
+ Redémarrage Requis
+ Pour que l'installation soit compléte, vous devez redémarrer votre ordinateur.
+ Merci de sauvegarder votre travail et de redémarrer avant que le temps spécifié ne soit écoulé.
+ Votre ordinateur sera automatiquement redémarré à la fin du décompte.
+ Temps restant:
+ Minimiser
+ Redémarrer Maintenant
+
+
+
+
+ Sie haben nicht genug freien Speicherplatz um die Installation abzuschließen:
+ {0}
+
+ Platzbedarf: {1}MB
+ Freier Speicherplatz: {2}MB
+
+ Bitte geben Sie ausreichend Speicherplatz frei, um mit der Installation fortzufahren.
+ Weiter
+ Klicken Sie erst auf „Weiter“, nachdem Sie die obigen Anwendung(en) geschlossen haben.
+ Programme Schließen
+ Aufschieben
+ Die folgenden Programme müssen geschlossen werden, bevor die Installation fortgesetzt werden kann.
+
+ Bitte speichern Sie Ihre Arbeit, schließen Sie die Programme und fahren Sie dann fort.
+ Alternativ können Sie Ihre Arbeit speichern und dann auf „Programme Schließen“ klicken.
+ HINWEIS: Diese Programme werden automatisch geschlossen:
+ Die folgende Anwendung soll installiert werden:
+ Sie können die Installation verzögern, bis die Rückstellung abläuft:
+ Sobald die Rückstellung abgelaufen ist, werden Sie keine Möglichkeit mehr haben die Installation zu verschieben.
+ Verbleibende Rückstellungen:
+ Termin:
+
+ Die {0} wird automatisch fortgesetzt in:
+
+
+ Installation
+ Deinstallation
+ Reparatur
+ gestartet.
+ abgeschlossen.
+ abgeschlossen. Ein Neustart ist erforderlich.
+ ist fehlgeschlagen.
+ nicht abgeschlossen werden.
+ Installation wird durchgeführt. Bitte warten...
+ Deinstallation wird durchgeführt. Bitte warten...
+ Reparatur wird durchgeführt. Bitte warten...
+ Das Starten dieser Anwendung(en) wurde vorübergehend blockiert, damit der Installationsvorgang erfolgreich durchgeführt werden kann.
+ Neustart Erforderlich
+ Zum Abschluss der Installation müssen Sie Ihren Computer neu starten.
+ Bitte speichern Sie Ihre Arbeit und starten Sie den Computer innerhalb der vorgegebenen Zeit neu.
+ Am Ende des Countdowns wird Ihr Computer automatisch neu gestartet.
+ Verbleibende Zeit:
+ Minimieren
+ Jetzt Neustarten
+
+
+
+
+ Non si dispone di spazio su disco sufficiente per completare l' installazione di:
+ {0}
+
+ Spazio necessario: {1}MB
+ Spazio disponibile: {2}MB
+
+ Si prega di spazio libero su disco sufficiente per procedere con l'installazione.
+ Continua
+ Seleziona "Continua" solo dopo la chiusura della(e) applicazione(i) elencate sopra.
+ Chiudi Programmi
+ Rimanda
+ I seguenti programmi devono essere chiusi prima che l'installazione possa procedere.
+
+ Salvare il lavoro , chiudere i programmi, e poi continuare.
+ In alternativa, salvare il lavoro e fare clic su "Chiudi Programmi".
+ NOTA: il programma(s) sarà chiuso automaticamente in:
+ La seguente applicazione sta per essere installata:
+ Si può decidere di posticipare l'installazione fino alla prossima richiesta automatica:
+ Una volta che le richieste rimanenti saranno scadute, non sarà più possibile posticipare l'installazione.
+ Posticipi rimanenti:
+ Scadenza:
+
+ The {0} will automatically continue in:
+
+
+ Installazione
+ Disinstallazione
+ Riparazione
+ Iniziata.
+ Completata.
+ Completata. È necessario riavviare il computer.
+ Fallita.
+ Non completata.
+ Installazione in corso. Attendere prego...
+ Disinstallazione in corso. Attendere prego...
+ Riparazione in corso. Attendere prego...
+ L'esecuzione di questa applicazione è stata temporaneamente bloccata in modo che l'operazione di installazione possa essere completata.
+ Riavvio Richiesto
+ Per completare l'installazione, è necessario riavviare il computer.
+ Salvare il lavoro e riavviare entro il tempo assegnato.
+ Il computer verrà riavviato automaticamente al termine del conto alla rovescia.
+ Tempo rimanente:
+ Minimizzare
+ Riavvia Ora
+
+
+
+
+ ディスクの空き容量が不足しているため、インストールを完了できません：
+ {0}
+
+ 必要な容量: {1}MB
+ 現在の空き容量: {2}MB
+
+ インストールを実行するために、容量を確保してください
+ 続行
+ 上記に記載されているアプリケーションを終了してから「続ける」を選択してください。
+ プログラムを強制終了
+ 後で
+ インストールを実行するために、下記のプログラムを閉じる必要があります。
+
+ 実行中のアプリケーションを保存し、閉じてから続行してください。
+ または、実行中のアプリケーションを保存し、プログラムを強制終了ボタンをクリックしてくだい
+ 注意: これらのプログラムは自動的に閉じられます:
+ このアプリケーションはこれからインストールされます。
+ 再試行可能回数が0になるまでは、都合の良い時にインストール可能です。
+ 再試行可能回数が0になった場合、システムで強制インストールをします。
+ 再試行可能回数:
+ デッドライン:
+
+ The {0} will automatically continue in:
+
+
+ インストール
+ アンインストール
+ 修復
+ 開始
+ 完了です
+ 完了。再起動が必要です。
+ 失敗。
+ 未完了。
+ インストール中です。 少々お待ちください。
+ アンインストール中です。 少々お待ちください。
+ 修復中です。 少々お待ちください。
+ アプリケーションインストールが完了するまで、このアプリケーションの起動を一時的にブロックしています。
+ 再起動が必要です
+ インストールを完了するために、再起動が必要です。
+ 実行中のアプリケーションを保存し、再起動してください。
+ カウントダウン後にコンピュータが再起動します。
+ 残時間：
+ 最小 化
+ 今すぐ再起動
+
+
+
+
+ Du har ikke nok diskplass for å fullføre installasjonen av:
+ {0}
+
+ Ledig plass påkrevd: {1}MB
+ Ledig plass tilgjengelig: {2}MB
+
+ Frigjør diskplass for å fortsette installasjonen.
+ Fortsett
+ Velg kun "Fortsett" etter du har lukket applikasjonen(e) oppført over.
+ Lukk Programmer
+ Utsett
+ Følgende programmer må lukkes før installasjonen kan fortsette.
+
+ Lagre arbeidet, lukk programmene og velg "Fortsett"
+ Eller velg "Lukk Programmer" uten å lagre.
+ OBS: Programmet vil automatisk lukkes om:
+ Følgende program vil bli installert:
+ Du kan velge å utsette installasjonen et begrenset antall ganger inntil fristen utløper:
+ Når fristen har utløpt kan du ikke lenger utsette installasjonen.
+ Gjenstående utsettelser:
+ Frist:
+
+ The {0} will automatically continue in:
+
+
+ Installasjon
+ Avinstallasjon
+ Reparasjon
+ startet.
+ fullført.
+ ferdig. En omstart er nødvendig.
+ mislyktes.
+ ikke fullført.
+ Programvareinstallasjon pågår. Vennligst vent..
+ ProgramvareAvinstallasjon pågår. Vennligst vent..
+ ProgramvareReparasjon pågår. Vennligst vent..
+ Start av dette programmet er midlertidig blokkert til programvareinstallasjon er ferdig.
+ Omstart Kreves
+ En omstart av pcen er nødvendig for å fullføre installasjonen.
+ Lagre arbeidet ditt og gjør en omstart av pc innen fristen.
+ Pcen vil automatisk starte på nytt, når nedtellingen er slutt.
+ Tid som gjenstår:
+ Minimere
+ Omstart Nå
+
+
+
+
+ Er is onvoldoende schijfruimte voor de installatie van:
+ {0}
+
+ Ruimte nodig: {1}MB
+ Ruimte beschikbaar: {2}MB
+
+ Gelieve voldoende schijfruimte vrij te maken om de installatie te starten.
+ Doorgaan
+ Selecteer alleen 'Doorgaan' na het sluiten van de bovenstaande toepassing(en).
+ Sluit Applicaties
+ Uitstel
+ De volgende applicaties moeten afgesloten worden om de installatie te voltooien.
+
+ Sla je werk op, sluit de applicaties, en ga verder.
+ Of, sla je werk op en klik op 'Sluit Applicaties'.
+ LET OP: De applicatie(s) worden afgesloten over:
+ De volgende applicatie wordt zometeen geïnstalleerd:
+ Je kan de installatie uitstellen tot de maximale uitsteltermijn is verstreken:
+ Na verstrijken van de uitsteltermijn is deze optie niet langer beschikbaar.
+ Aantal keer uitstellen:
+ Deadline:
+
+ De {0} gaat automatisch door over:
+
+
+ Installatie
+ Verwijderen
+ Reparatie
+ gestart
+ voltooid
+ voltooid. Een herstart is nodig
+ gefaald
+ onvolledig
+ Installatie bezig. Even geduld...
+ Verwijderen bezig. Even geduld...
+ Reparatie bezig. Even geduld...
+ Het opstarten van deze applicatie werd tijdelijk geblokkeerd om een installatie uit te voeren.
+ Herstart nodig
+ Om de installatie te voltooien is een herstart nodig.
+ Gelieve je werk op te slaan en binnen de toegestane termijn de computer herstarten
+ De computer zal herstarten als de teller op nul staat
+ Resterende tijd:
+ Minimaliseren
+ Herstart Nu
+
+
+
+
+ Brak miejsca na dysku:
+ {0}
+
+ Potrzeba: {1}MB
+ Obecnie wolnego miejsca: {2}MB
+
+ Proszę zwiększyć ilość miejsca usuwając zbędne pliki.
+ Kontynuuj
+ Tylko wybrać „Kontynuuj” po zamknięciu wyżej wymienione aplikacje.
+ Zamknij Programy
+ Odłóż
+ Następujące programy muszą zostać zamknięte przed rozpoczęciem instalacji.
+
+ Proszę zapisać wszystkie dokumenty i zamknąć programy, a następnie kliknąć przycisk „Kontynuuj”.
+ Alternatywnie zapisz wszystkie dokumenty i kliknij przycisk „Zamknij Programy”.
+ UWAGA: Programy zostaną automatycznie zamknięte za:
+ Zostanie zainstalowana następująca aplikacja:
+ Instalacja może zostać przełożona na późniejszy termin.
+ Jeżeli zostanie przekroczona możliwa ilość przełożeń, opcja „Odłóż” będzie niedostępna.
+ Pozostała ilość przełożeń instalacji:
+ Ostateczny termin instalacji:
+
+ The {0} will automatically continue in:
+
+
+ Instalacja
+ Deinstalacja
+ Naprawa
+ rozpoczęta.
+ zakończona.
+ zakończona. Wymagany jest restart komputera.
+ nie powiodła się.
+ nieukończona.
+ Trwa instalacja. Proszę czekać...
+ Trwa deinstalacja. Proszę czekać...
+ Trwa naprawa. Proszę czekać...
+ Uruchomienie tej aplikacji zostało zablokowane na okres instalacji.
+ Wymagany Restart
+ Aby instalacja została poprawnie ukończona wymagany jest restart komputera.
+ Proszę zapisać wszystkie dokumenty i zrestartować komputer w wyznaczonym czasie.
+ Komputer zostanie automatycznie zrestartowany po upływie wyznaczonego czasu.
+ Pozostały czas do restartu automatycznego:
+ Zminimalizować
+ Restartuj Teraz
+
+
+
+
+ Você não tem espaço em disco suficiente para concluir a instalação de:
+ {0}
+
+ Espaço necessário: {1}MB
+ Espaço disponível: {2}MB
+
+ Por favor, espaço livre em disco suficiente, a fim de prosseguir com a instalação.
+ Continuar
+ Selecione "Continuar" somente após fechar a(s) aplicação(ões) listada(s) abaixo.
+ Fechar Programas
+ Adiar
+ Programas de seguir devem ser fechados antes que a instalação possa prosseguir.
+
+ Por favor, guarde o seu trabalho, feche os programas e em seguida continuar.
+ Como alternativa, salve seu trabalho e clique em "Fechar Programas".
+ NOTA: O programa será fechado automaticamente em:
+ O seguinte aplicativo está prestes a ser instalado:
+ Você pode optar por adiar a instalação até que expire o diferimento:
+ Uma vez que o diferimento expirou, você já não terá a opção de adiar a.
+ Restantes diferimentos:
+ Prazo:
+
+ The {0} will automatically continue in:
+
+
+ Instalação
+ Desinstalação
+ Reparação
+ começou a.
+ completo.
+ completa. Uma reinicialização é necessária.
+ falhou.
+ não completar.
+ Instalação em andamento. Por favor aguarde...
+ Desinstalação em andamento. Por favor aguarde...
+ Reparação em andamento. Por favor aguarde...
+ Lançar este aplicativo está temporariamente bloqueado para que possa concluir uma operação de instalação.
+ Reinicialização Necessária
+ Em ordem para completar a instalação, você deve reiniciar seu computador.
+ Por favor, salve o trabalho e reiniciar no tempo alocado.
+ Seu computador será reiniciado automaticamente no final da contagem regressiva.
+ Tempo restante:
+ Minimizar
+ Reinicie Agora
+
+
+
+
+ Você não tem espaço em disco suficiente para concluir a instalação de:
+ {0}
+
+ Espaço necessário: {1}MB
+ Espaço disponível: {2}MB
+
+ Libere espaço em disco suficiente para prosseguir com a instalação.
+ Continuar
+ Apenas selecione "Continuar" depois de fechar aplicativo(s) acima.
+ Fechar Programas
+ Adiar
+ Os seguintes programas precisam ser fechados antes que a instalação possa prosseguir.
+
+ Salve seu trabalho, feche os programas e depois continue.
+ Como alternativa, salve seu trabalho e clique em "Fechar Programas".
+ OBSERVAÇÃO: O(s) programa(s) será(ão) automaticamente fechado(s) em:
+ O seguinte aplicativo está prestes a ser instalado:
+ Você pode optar por adiar a instalação até que o adiamento expire:
+ Depois que o adiamento expirar, você não terá mais a opção de adiar.
+ Adiamentos Restantes:
+ Prazo:
+
+ The {0} will automatically continue in:
+
+
+ Instalação
+ Desinstalação
+ Reparação
+ iniciada.
+ concluída.
+ concluída. É necessário reiniciar.
+ falhou.
+ não concluída.
+ Instalação em andamento. Aguarde...
+ Desinstalação em andamento. Aguarde...
+ Reparação em andamento. Aguarde...
+ A execução deste aplicativo foi temporariamente bloqueada para que uma operação de instalação seja concluída.
+ Reinicialização Necessária
+ Para que a instalação seja concluída, é necessário reiniciar o computador.
+ Salve seu trabalho e reinicie dentro do prazo estipulado.
+ Seu computador será reiniciado automaticamente no final da contagem regressiva.
+ Tempo restante:
+ Minimizar
+ Reiniciar Agora
+
+
+
+
+ Usted no tiene suficiente espacio en disco para completar la instalación de:
+ {0}
+
+ Espacio requerido: {1}MB
+ Espacio disponible: {2}MB
+
+ Por favor, espacio en disco libre suficiente para proceder con la instalación.
+ Continuar
+ Seleccione "Continuar" después de cerrar la(s) aplicacion(es) de la lista arriba.
+ Cerrar Programas
+ Aplazar
+ Los siguientes programas deben cerrarse antes de la instalación puede proceder.
+
+ Por favor, guarde el trabajo, cerrar los programas y luego continuar.
+ Alternativamente, guarde su trabajo y haga clic en "Cerrar Programas".
+ NOTA: El programa se cerrará automáticamente en:
+ La siguiente aplicación está a punto de instalarse:
+ Puede decidir aplazar la instalación hasta que expire el aplazamiento:
+ Una vez vencido el aplazamiento, ya no tendrá la opción de aplazar.
+ Restante aplazamientos:
+ Plazo:
+
+ The {0} will automatically continue in:
+
+
+ Instalación
+ Desinstalación
+ Reparación
+ comenzó a.
+ completa.
+ completa. Se requiere un reinicio.
+ failed.
+ no.
+ Instalación en curso. Por favor, espere...
+ Desinstalación en curso. Por favor, espere...
+ Reparación en curso. Por favor, espere...
+ Lanzar esta aplicación ha sido bloqueado temporalmente para que pueda completar una operación de instalación.
+ Reiniciar Requerido
+ En orden para completar la instalación, debe reiniciar su computadora.
+ Por favor guarde su trabajo y reinicie dentro del tiempo asignado.
+ El ordenador se reiniciará automáticamente al final de la cuenta regresiva de.
+ Tiempo restante:
+ Minimizar
+ Reiniciar Ahora
+
+
+
+
+ Du har inte tillräckligt med ledigt diskutrymme för att kunna installera:
+ {0}
+
+ Diskutrymme som krävs: {1}MB
+ Ledigt diskutrymme: {2}MB
+
+ Frigör utrymme på hårddisken och försök igen.
+ Fortsätt
+ Välj "Fortsätt" endast efter att ha stängt applikation(er) i ovanstående lista.
+ Stäng Program
+ Skjut upp
+ Följande program måste stängas innan installationen kan fortsätta.
+
+ Se till att spara ditt arbete, stäng de öppna programmen och klicka sen på "Fortsätt".
+ Alternativt, spara ditt arbete och klicka på "Stäng Program".
+ OBS: Programmen kommer automatiskt att avslutas om:
+ Följande applikation kommer att installeras:
+ Du kan välja att fördröja installationen ett begränsat antal gånger under en begränsad tid:
+ När antalet fördröjningar är slut eller deadlinen inträffar är detta alternativ inte längre tillgängligt.
+ Antal återstående fördröjningar:
+ Deadline:
+
+ The {0} will automatically continue in:
+
+
+ Installation
+ Avinstallation
+ Reparation
+ startad.
+ slutförd.
+ slutförd. En omstart av datorn är nödvändig.
+ misslyckades.
+ ej slutförd.
+ Installation pågår. Var god vänta...
+ Avinstallation pågår. Var god vänta...
+ Reparation pågår. Var god vänta...
+ Den här applikationen har temporärt blockerats så att installationen kan slutföras.
+ Omstart Krävs
+ För att installationen ska kunna slutföras måste din dator startas om.
+ Se till att spara ditt arbete innan tiden går ut och en automatisk omstart sker.
+ Din dator kommer automatiskt att starta om när nedräkningen är slut.
+ Återstående tid:
+ Minimera
+ Starta Om Nu
+
+
+
+
+ ليس لديك مساحة كافية في القرص لإتمام عملية تثبيت:
+ {0}
+
+ المساحة اللازمة: {1} م ب
+ المساحة المتاحة: {2} م ب
+
+ يرجى تحرير مساحة قرص كافية كي تتم متابعة عملية التثبيت.
+ متابعة
+ قم باختيار "متابعة" فقط بعد إغلاق التطبيق/التطبيقات المدرجة أعلاه.
+ إغلاق البرامج
+ تأجيل
+ يجب إغلاق البرامج التالية قبل التمكن من متابعة عملية التثبيت.
+
+ يرجى حفظ عملك، وإغلاق البرامج، ومن ثم المتابعة.
+ يمكنك بدلا من ذلك، حفظ عملك والنقر فوق "إغلاق البرامج".
+ ملاحظة: سيتم إغلاق البرنامج/البرامج بشكل تلقائي خلال:
+ التطبيق التالي على وشك التثبيت:
+ بإمكانك اختيار تأجيل التثبيت إلى حين انتهاء صلاحية التأجيل:
+ بمجرد انتهاء صلاحية التأجيل، لن يكون لديك خيار التأجيل بعد الآن.
+ التأجيلات المتبقية:
+ الموعد النهائي:
+
+ The {0} will automatically continue in:
+
+
+ تثبيت
+ إزالة التثبيت
+ إصلاح
+ بدأ.
+ تم.
+ تم. يجب إعادة تشغيل النظام.
+ فشل.
+ غير مكتمل.
+ جاري التثبيت. يرجى الانتظار...
+ جارٍ إزالة التثبيت. يرجى الانتظار...
+ جارٍ إصلاح. يرجى الانتظار...
+ تم تعطيل تشغيل هذا التطبيق مؤقتًا بحيث يمكن إكمال عملية التثبيت.
+ مطلوب إعادة التشغيل
+ كي تكتمل عملية التثبيت، يجب عليك إعادة تشغيل حاسوبك.
+ يرجى حفظ عملك وإعادة التشغيل خلال الوقت المخصص.
+ ستتم إعادة تشغيل حاسوبك بشكل تلقائي عند نهاية العد التنازلي.
+ الزمن المتبقي:
+ تقليل
+ إعادة التشغيل الآن
+
+
+
+
+ :אין לך מספיק מקום בכונן כדי להשלים את ההתקנה של:
+ {0}
+
+ מקום נדרש: {1}מ"ב
+ מקום זמין: {2}מ"ב
+
+ אנא שחרר מספיק מקום בכונן כדי להתחיל בהתקנה.
+ המשך
+ בחר "המשך" רק לאחר שסגרת את היישום(ים) הרשומים לעיל.
+ סגור תכניות
+ דחה
+ יש לסגור את התכנות הבאות בטרם ההתקנה תוכל להתחיל.
+
+ אנא שמור על העבודה שלך, סגור את התכניות, ואז המשך.
+ לחילופין, שמור על העבודה שלך והקלק על "סגור תכניות".
+ שים לב: התכנית(ות) תסגרנה באופן אוטומטי תוך:
+ היישום הבא עומד להיות מותקן:
+ אתה יכול לבחור לדחות את ההתקנה עד שמשך זמן הדחיה יפוג.
+ לאחר שמשך זמן הדחיה יפוג, לא תהיה לך עוד אפשרות לדחות.
+ מספר הדחיות שנותרו:
+ תאריך יעד:
+
+ The {0} will automatically continue in:
+
+
+ התקנה
+ הסרה
+ תיקון
+ התחילה.
+ הושלמה.
+ הושלמה. נדרש אתחול המחשב.
+ נכשלה.
+ לא הושלמה.
+ מבצע התקנה. נא להמתין.
+ מבצע הסרה. נא להמתין.
+ מבצע תיקון. נא להמתין.
+ הרצת היישום הזה נחסמה זמנית כדי שפעולת התקנה תוכל להסתיים.
+ נדרש אתחול המחשב
+ כדי להשלים את ההתקנה, עליך לאתחל את המחשב שלך מחדש.
+ אנא שמור על העבודה שלך ואתחל במסגרת הזמן המוקצב.
+ המחשב שלך יאותחל באופן אוטומטי בסיום הספירה לאחור.
+ הזמן הנותר:
+ מזער את
+ אתחל עכשיו
+
+
+
+
+ 다음의 설치 완료를 위해 필요한 디스크 공간이 충분하지 않습니다:
+ {0}
+
+ 필요한 공간: {1}MB
+ 사용 가능한 공간: {2}MB
+
+ 설치를 계속하려면 디스크 공간을 충분하게 확보하세요.
+ 계속
+ 위에 표시된 응용 프로그램을 종료한 후에만 "계속"을 선택하세요.
+ 프로그램 종료
+ 연기
+ 설치를 계속하려면 다음의 프로그램을 종료해야 합니다.
+
+ 사용자 작업을 저장하고 프로그램을 종료한 후 계속하세요.
+ 다른 방법으로는 사용자 작업을 저장하고 "프로그램 종료"를 클릭하세요.
+ 참고: 프로그램이 자동으로 종료되는 경우:
+ 다음의 응용 프로그램을 설치합니다:
+ 지연 기간이 만료될 때까지 설치를 연기할 수 있습니다:
+ 일단 지연 기간이 만료되면 더 이상 연기할 수 있는 옵션은 없습니다.
+ 남은 지연 기간:
+ 마감:
+
+ The {0} will automatically continue in:
+
+
+ 설치
+ 제거
+ 수리
+ 시작되었습니다.
+ 완료되었습니다.
+ 완료되었습니다. 재부팅이 필요합니다.
+ 실패했습니다.
+ 완료되지 않았습니다.
+ 설치 중입니다. 기다리세요...
+ 제거 중입니다. 기다리세요...
+ 수리 중입니다. 기다리세요...
+ 설치 작업을 완료할 수 있도록 응용 프로그램의 시작을 잠시 차단했습니다.
+ 다시 시작해야 합니다
+ 설치를 완료하려면 컴퓨터를 다시 시작해야 합니다.
+ 사용자 작업을 저장하고 지정된 시간 이내에 다시 시작하세요.
+ 카운트다운이 종료되면 컴퓨터는 자동으로 다시 시작합니다.
+ 남은 시간:
+ 최소화
+ 지금 다시 시작
+
+
+
+
+ У вас недостаточно пространства на диске для выполнения установки:
+ {0}
+
+ Необходимое пространство на диске: {1}МБ
+ Доступное пространство на диске: {2}МБ
+
+ Для продолжения установки, пожалуйста, освободите достаточно пространства на диске.
+ Продолжить
+ Выберите "Продолжить" только после закрытия вышеперечисленных приложений.
+ Закрыть программы
+ Отложить
+ Перед продолжением установки необходимо закрыть следующие программы.
+
+ Пожалуйста, сохраните вашу работу и закройте программы, а затем продолжите установку.
+ Также вы можете сохранить вашу работу и нажать "Закрыть программы".
+ ПРИМЕЧАНИЕ: Эти программы будут автоматически закрыты через:
+ Планируется установка следующего приложения:
+ Вы можете отложить установку приложения до тех пор, пока не истечет срок действия этой отсрочки:
+ После истечения срока действия отсрочки вы больше не сможете отложить установку.
+ Оставшиеся отсрочки:
+ Дата истечения:
+
+ {0} начнется автоматически через:
+
+
+ Установка
+ Удаление
+ Восстановление
+ начата(о).
+ выполнена(о).
+ выполнена(о). Требуется перезагрузка.
+ не выполнена(о).
+ не завершена(о).
+ Идет установка. Пожалуйста, подождите...
+ Идет удаление. Пожалуйста, подождите...
+ Идет ремонт. Пожалуйста, подождите...
+ Запуск этого приложения временно заблокирован для завершения процесса установки.
+ Требуется перезагрузка
+ Для завершения установки необходимо перезагрузить ваш компьютер.
+ Пожалуйста, сохраните вашу работу и выполните перезагрузку в отведенное время.
+ Ваш компьютер будет автоматически перезагружен по завершению обратного отсчета.
+ Оставшееся время:
+ Минимизировать
+ Перезагрузить сейчас
+
+
+
+
+ 没有足够的磁盘空间来完成下列安装：
+ {0}
+
+ 所需空间：{1}MB
+ 可用空间：{2}MB
+
+ 请释放足够的磁盘空间以继续安装。
+ 继续
+ 在关闭上列应用程式后才选择"继续"。
+ 关闭程序
+ 延迟
+ 为继续安装，必须关闭下列程序。
+
+ 请保存您的工作，关闭程序，然后继续。
+ 或者保存您的工作，点击"关闭程序"。
+ 注：下列程序将自动关闭：
+ 即将安装下列应用程式：
+ 在延期失效前，可选择延迟安装：
+ 延期失效后，再也无法延迟安装。
+ 所剩延期：
+ 最后期限：
+
+ The {0} will automatically continue in:
+
+
+ 安装
+ 卸载
+ 修复
+ 已启动。
+ 完成。
+ 完成。必须重新启动。
+ 失败。
+ 未完成。
+ 安装中。请稍等。。。
+ 卸载中。请稍等。。。
+ 修复中。请稍等。。。
+ 为完成安装过程，暂时禁止启动这款应用程式。
+ 需重启
+ 为完成安装过程，需重启计算机。
+ 请保存您的工作，并在容许时间重启计算机。
+ 倒计时结束后，计算机将自动重启。
+ 剩余时间：
+ 最小化
+ 现在重启
+
+
+
+
+ 沒有足夠的磁盤空間來完成下列安裝：
+ {0}
+
+ 所需空間： {1}MB
+ 可用空間： {2}MB
+
+ 請釋放足夠的磁盤空間以繼續安裝。
+ 繼續
+ 關閉上列應用程式後才選擇"繼續"。
+ 關閉程序
+ 延遲
+ 在繼續安裝前必須關閉下列程序。
+
+ 請保存您的工作，關閉程序，然後繼續。
+ 或者保存您的工作，然後點擊"關閉程序"。
+ 注：下列程序將自動關閉：
+ 即將安裝下列應用程式：
+ 在延期失效前，可選擇延遲安裝：
+ 延期失效後，再也無法延遲安裝。
+ 所剩延期：
+ 最後期限：
+
+ The {0} will automatically continue in:
+
+
+ 安裝
+ 卸載
+ 修復
+ 已啟動。
+ 完成。
+ 完成。需重啟。
+ 失敗。
+ 未完成。
+ 安裝中。請稍等。。。
+ 卸載中。請稍等。。。
+ 修復中。請稍等。。。
+ 為完成安裝過程，暫時禁止啟動本款應用程式。
+ 需重啟
+ 未完成安裝過程，需重啟計算機。
+ 請保存您的工作，然後在容許時間重啟計算機。
+ 倒計時結束後，計算機將自動重啟。
+ 剩餘時間：
+ 最小化
+ 現在重啟
+
+
+
+
+ Nemáte dostatok voľného miesta na dokončenie inštalácie:
+ {0}
+
+ Potrebné miesto: {1}MB
+ Voľné miesto: {2}MB
+
+ Prosím, uvoľnite dostatok miesta pre pokračovanie inštalácie.
+ Pokračovať
+ Kliknite na "Pokračovať", keď zavriete vyššie uvedené aplikácie.
+ Ukončiť programy
+ Oddialiť
+ Nasledujúce programy musia byť zatvorené, než bude inštalácia pokračovať.
+
+ Prosím, uložte svoju prácu, zatvorte dané programy a potom kliknite na pokračovať.
+ Prípadne môžete uložiť svoju prácu a potom kliknite na tlačidlo "Ukončiť programy".
+ Poznámka: Programy budú automaticky ukončené za:
+ Nasledujúca aplikácia bude nainštalovaná:
+ Inštaláciu môžete niekoľkokrát odložiť:
+ Akonáhle odklady uplynú, už nebudete mať možnosť odložiť inštaláciu.
+ Zostávajúce odklady:
+ Termín:
+
+ {0} bude automaticky pokračovať za:
+
+
+ Inštalácia
+ Odinštalácia
+ Oprava
+ spustená.
+ ukončená.
+ ukončená. Je nutný reštart.
+ sa nepodarila.
+ nedokončená.
+ Inštalácia sa vykonáva. Prosím čakajte...
+ Prebieha odinštalácia. Prosím čakajte...
+ Vykonáva sa oprava. Prosím čakajte...
+ Spustenie tejto aplikácie bolo dočasne zablokované, aby mohla byť inštalácia dokončená úspešne.
+ Je nutný reštart.
+ Na dokončenie inštalácie musíte váš počítač reštartovať.
+ Prosím, uložte si prácu a reštartujte počítač v stanovenej lehote.
+ Na konci odpočítavania, bude váš počítač automaticky reštartovaný.
+ Zostávajúci čas:
+ Minimalizovať
+ Reštartovať Teraz
+
+
+
+
+ Nemáte dostatek volného místa na instalaci aplikace:
+ {0}
+
+ Potřebné místo na disku: {1}MB
+ Dostupné místo na disku: {2}MB
+
+ Uvolněte prosím dostatek místa k pokračovaní instalace.
+ Pokračovat
+ Klikněte na "Pokračovat", až budete mít výše uvedené aplikace zavřené.
+ Ukončit programy
+ Odložit
+ Následující programy musí být zavřené, aby instalace mohla pokračovat.
+
+ Prosím, uložte svou práci, zavřete program a potom klikněte na "Pokračovat".
+ Případně můžete svou práci uložit a kliknout na tlačítko "Ukončit programy".
+ Upozornění: Programy budou automaticky zavřené za:
+ Nasledující aplikace bude nainstalována:
+ Instalaci můžete několikrát odložit:
+ Jakmile vyčerpáte všechna odložení, už nebudete mít šanci odložit instalaci.
+ Zbývající počet odložení:
+ Termín:
+
+ {0} bude automaticky pokračovat za:
+
+
+ Instalace
+ Odinstalace
+ Oprava
+ zahájena.
+ dokončena.
+ dokončena. Je nutné restartovat počítač.
+ se nepodařila.
+ nedokončena.
+ Instalace právě probíhá. Prosím čekejte...
+ Probíhá odinstalace. Prosím čekejte...
+ Oprava právě probíhá. Prosím čekejte...
+ Spuštění této aplikace bylo dočasně zakázáno, aby mohla proběhnout instalace.
+ Je nutné restartovat počítač.
+ Pro dokončení instalace musíte váš počítač restartovat.
+ Prosím, uložte si práci a restartujte počítač ve stanoveném čase.
+ Na konci odpočítávání, bude váš počítač automaticky restartovaný.
+ Zbývající čas:
+ Minimalizovat
+ Restartovat nyní
+
+
+
+
+ Nincs elég lemezterület a telepítés végrehajtásához:
+ {0}
+ Szükséges lemezterület: {1}MB
+ Szabad lemezterület: {2}MB
+ Kérem szabadítson fel elegendő lemezterületet a telepítés végrehajtásához.
+ Tovább
+ Csak azután kattintson a „Tovább”-ra, ha a fentebb látható alkalmazás(oka)t bezárta.
+ Alkalmazások bezárása
+ Elhalaszt
+ Az alábbi programokat szíveskedjen bezárni, mielőtt a telepítés elkezdődik.
+
+ Kérjük mentse munkáját és a folytatáshoz zárja be a futó alkalmazásokat.
+ Vagy
+ Kérjük mentse munkáját és kattintson a „Programok bezárása”-ra.
+ Megjegyzés: a programok automatikusan bezárásra kerülnek,:
+ A következő alkalmazások telepítésre kerülnek:
+ A telepítést elhalaszthatja amíg a rendelkezésre álló idő lejár:
+ Amennyiben a rendelkezésre álló idő letelik, nem lesz lehetősége a telepítés elhalasztására.
+ Fennmaradó halasztás:
+ Időpont:
+
+ A(z) {0} automatikusan folytatódik:
+
+
+ Telepítés
+ Eltávolítás
+ Javítás
+ elindult.
+ elkészült.
+ elkészült.Újraindítás szükséges.
+ sikertelen.
+ nem lehet befejezni.
+ Telepítés folyamatban. Kérem várjon...
+ Eltávolítás folyamatban. Kérem várjon...
+ Javítás folyamatban. Kérem várjon...
+ A következő alkalmazások blokkolva lesznek, annak érdekében hogy a telepítés problémamentesen végrehajtódjon.
+ Újraindítás szükséges
+ A telepítés befejezéséhez a számítógépet újraindítása szükséges.
+ Kérem mentse munkáját, és a megadott időn belül indítsa újra..
+ A hátralévő idő leteltével a számítógép újraindul.
+ Hátralévő idő:
+ Minimalizál
+ Újraindítás most
+
+
+
+
+
+ Kiintolevyllä ei ole riittävästi tilaa asennusta varten:
+ {0}
+
+ Vaadittu levytila: {1}MB
+ Levytilaa käytettävissä: {2}MB
+
+ Vapauta levytilaa, jotta asennus voi jatkua.
+ Jatka
+
+ Valitse jatka, kun olet sulkenut ohjelmat.
+
+ Sulje ohjelmat
+
+ Myöhemmin
+
+ Seuraavat ohjelmat on suljettava ennen asennusta
+
+ Tallenna työsi ja jatka.
+ Vaihtoehtoisesti voit tallentaa työsi ja valita "Sulje ohjelmat".
+
+
+ HUOMIO: Ohjelma(t) suljetaan automaattisesti:
+
+ Ohjelma joka asennetaan seuraavaksi:
+
+ Voit siirtää asennusta myöhemmäksi:
+
+ Tietyn ajan kuluessa et voi enää siirtää asennusta myöhemmäksi.
+
+ Jäljellä olevia siirtoja myöhempään ajankohtaan:
+
+ Määräaika:
+
+
+ {0} jatkaa automaattisesti:
+
+
+
+
+ Asennus
+
+ Ohjelmiston poisto
+
+
+
+ alkoi.
+
+ valmis.
+
+ valmis. Tietokone on käynnistettävä uudelleen.
+
+ epäonnistui.
+
+ ei ole valmis.
+
+
+ Asentaa. Odota...
+
+ Ohjelmistoa poistetaan. Odota...
+
+ Ohjelmiston käynnistäminen on tilapäisesti estetty, jotta ohjelmisto voi onnistuneesti asentua.
+
+ Tietokone on käynnistettävä uudelleen
+
+ Tietokone on käynnistettävä uudelleen, ennen kuin ohjelmiston asennus on valmis.
+ Tallenna työsi ja käynnistä tietokone uudelleen aikarajan sisällä.
+ Tietokone käynnistyy uudelleen, kun laskuri on saavuttanut nollan.
+
+ Aikaa jäljellä:
+ Käynnistä uudelleen myöhemmin
+ Käynnistä uudelleen heti
+
+
+
+
diff --git a/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.exe b/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.exe
new file mode 100644
index 0000000..4000f07
Binary files /dev/null and b/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.exe differ
diff --git a/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.exe.config b/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.exe.config
new file mode 100644
index 0000000..99844ed
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.exe.config
@@ -0,0 +1,7 @@
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.ps1 b/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.ps1
new file mode 100644
index 0000000..e68330c
--- /dev/null
+++ b/CFX Maestro/2.3/PS_Deployment.old/Deploy-Application.ps1
@@ -0,0 +1,226 @@
+<#
+.SYNOPSIS
+ This script performs the installation or uninstallation of an application(s).
+ # LICENSE #
+ PowerShell App Deployment Toolkit - Provides a set of functions to perform common application deployment tasks on Windows.
+ Copyright (C) 2017 - Sean Lillis, Dan Cunningham, Muhammad Mashwani, Aman Motazedian.
+ This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
+ You should have received a copy of the GNU Lesser General Public License along with this program. If not, see .
+.DESCRIPTION
+ The script is provided as a template to perform an install or uninstall of an application(s).
+ The script either performs an "Install" deployment type or an "Uninstall" deployment type.
+ The install deployment type is broken down into 3 main sections/phases: Pre-Install, Install, and Post-Install.
+ The script dot-sources the AppDeployToolkitMain.ps1 script which contains the logic and functions required to install or uninstall an application.
+.PARAMETER DeploymentType
+ The type of deployment to perform. Default is: Install.
+.PARAMETER DeployMode
+ Specifies whether the installation should be run in Interactive, Silent, or NonInteractive mode. Default is: Interactive. Options: Interactive = Shows dialogs, Silent = No dialogs, NonInteractive = Very silent, i.e. no blocking apps. NonInteractive mode is automatically set if it is detected that the process is not user interactive.
+.PARAMETER AllowRebootPassThru
+ Allows the 3010 return code (requires restart) to be passed back to the parent process (e.g. SCCM) if detected from an installation. If 3010 is passed back to SCCM, a reboot prompt will be triggered.
+.PARAMETER TerminalServerMode
+ Changes to "user install mode" and back to "user execute mode" for installing/uninstalling applications for Remote Destkop Session Hosts/Citrix servers.
+.PARAMETER DisableLogging
+ Disables logging to file for the script. Default is: $false.
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -DeployMode 'Silent'; Exit $LastExitCode }"
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -AllowRebootPassThru; Exit $LastExitCode }"
+.EXAMPLE
+ powershell.exe -Command "& { & '.\Deploy-Application.ps1' -DeploymentType 'Uninstall'; Exit $LastExitCode }"
+.EXAMPLE
+ Deploy-Application.exe -DeploymentType "Install" -DeployMode "Silent"
+.NOTES
+ Toolkit Exit Code Ranges:
+ 60000 - 68999: Reserved for built-in exit codes in Deploy-Application.ps1, Deploy-Application.exe, and AppDeployToolkitMain.ps1
+ 69000 - 69999: Recommended for user customized exit codes in Deploy-Application.ps1
+ 70000 - 79999: Recommended for user customized exit codes in AppDeployToolkitExtensions.ps1
+.LINK
+ http://psappdeploytoolkit.com
+#>
+[CmdletBinding()]
+Param (
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Install','Uninstall')]
+ [string]$DeploymentType = 'Install',
+ [Parameter(Mandatory=$false)]
+ [ValidateSet('Interactive','Silent','NonInteractive')]
+ [string]$DeployMode = 'Interactive',
+ [Parameter(Mandatory=$false)]
+ [switch]$AllowRebootPassThru = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$TerminalServerMode = $false,
+ [Parameter(Mandatory=$false)]
+ [switch]$DisableLogging = $false
+)
+
+Try {
+ ## Set the script execution policy for this process
+ Try { Set-ExecutionPolicy -ExecutionPolicy 'ByPass' -Scope 'Process' -Force -ErrorAction 'Stop' } Catch {}
+
+ ##*===============================================
+ ##* VARIABLE DECLARATION
+ ##*===============================================
+ ## Variables: Application
+ [string]$appVendor = 'Bio-Rad'
+ [string]$appName = 'CFX Maestro'
+ [string]$appVersion = '2.3'
+ [string]$appArch = 'x86_x64'
+ [string]$appLang = 'EN'
+ [string]$appRevision = '01'
+ [string]$appScriptVersion = '1.0.0'
+ [string]$appScriptDate = '11/21/2023'
+ [string]$appScriptAuthor = 'John Palmer'
+ ##*===============================================
+ ## Variables: Install Titles (Only set here to override defaults set by the toolkit)
+ [string]$installName = ''
+ [string]$installTitle = ''
+
+ ##* Do not modify section below
+ #region DoNotModify
+
+ ## Variables: Exit Code
+ [int32]$mainExitCode = 0
+
+ ## Variables: Script
+ [string]$deployAppScriptFriendlyName = 'Deploy Application'
+ [version]$deployAppScriptVersion = [version]'3.7.0'
+ [string]$deployAppScriptDate = '02/13/2018'
+ [hashtable]$deployAppScriptParameters = $psBoundParameters
+
+ ## Variables: Environment
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $InvocationInfo = $HostInvocation } Else { $InvocationInfo = $MyInvocation }
+ [string]$scriptDirectory = Split-Path -Path $InvocationInfo.MyCommand.Definition -Parent
+
+ ## Dot source the required App Deploy Toolkit Functions
+ Try {
+ [string]$moduleAppDeployToolkitMain = "$scriptDirectory\AppDeployToolkit\AppDeployToolkitMain.ps1"
+ If (-not (Test-Path -LiteralPath $moduleAppDeployToolkitMain -PathType 'Leaf')) { Throw "Module does not exist at the specified location [$moduleAppDeployToolkitMain]." }
+ If ($DisableLogging) { . $moduleAppDeployToolkitMain -DisableLogging } Else { . $moduleAppDeployToolkitMain }
+ }
+ Catch {
+ If ($mainExitCode -eq 0){ [int32]$mainExitCode = 60008 }
+ Write-Error -Message "Module [$moduleAppDeployToolkitMain] failed to load: `n$($_.Exception.Message)`n `n$($_.InvocationInfo.PositionMessage)" -ErrorAction 'Continue'
+ ## Exit the script, returning the exit code to SCCM
+ If (Test-Path -LiteralPath 'variable:HostInvocation') { $script:ExitCode = $mainExitCode; Exit } Else { Exit $mainExitCode }
+ }
+
+ #endregion
+ ##* Do not modify section above
+ ##*===============================================
+ ##* END VARIABLE DECLARATION
+ ##*===============================================
+
+ If ($deploymentType -ine 'Uninstall') {
+ ##*===============================================
+ ##* PRE-INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Pre-Installation'
+
+ Write-Log "Closing related processses"
+ Show-InstallationWelcome -CloseApps 'BioRadC1000Server, BioRadCFXManager, BioRADMiniOpticonDiscovery'
+
+ ## Show Progress Message (with the default message)
+ Show-InstallationProgress
+
+ ##
+
+ ## Import the Trusted Certs required for installation. ##
+
+ Copy-File -Path "$dirSupportFiles\*.cer" -Destination 'C:\TEMP\'
+
+ # The following only works on W10, so I left it for futue reference #
+
+ #Import-Certificate "C:\TEMP\BioRad.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher\
+
+ #Import-Certificate "C:\TEMP\Jungo.cer" -CertStoreLocation Cert:\LocalMachine\TrustedPublisher\
+
+ certutil -addstore "TrustedPublisher" C:\TEMP\BioRad.cer
+
+ certutil -addstore "TrustedPublisher" C:\TEMP\Jungo.cer
+
+ ##*===============================================
+ ##* INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Installation'
+
+ ## Handle Zero-Config MSI Installations
+ If ($useDefaultMsi) {
+ [hashtable]$ExecuteDefaultMSISplat = @{ Action = 'Install'; Path = $defaultMsiFile }; If ($defaultMstFile) { $ExecuteDefaultMSISplat.Add('Transform', $defaultMstFile) }
+ Execute-MSI @ExecuteDefaultMSISplat; If ($defaultMspFiles) { $defaultMspFiles | ForEach-Object { Execute-MSI -Action 'Patch' -Path $_ } }
+ }
+
+ ##
+
+ Write-Log "Installing Bio-Rad CFX Maestro 2.3"
+ Execute-Process -Path "$dirFiles\CFX\CFXMaestroSetup.exe" -Parameters '/S /v/qn'
+
+ ##*===============================================
+ ##* POST-INSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Post-Installation'
+
+ ##
+
+ ## Remove the Certificates that were copied locally for import.
+
+ Remove-Item 'C:\TEMP' -Recurse
+
+ }
+ ElseIf ($deploymentType -ieq 'Uninstall')
+ {
+ ##*===============================================
+ ##* PRE-UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Pre-Uninstallation'
+
+ ## Show Welcome Message, close Internet Explorer with a 60 second countdown before automatically closing
+ Show-InstallationWelcome -CloseApps 'BioRadC1000Server, BioRadCFXManager, BioRADMiniOpticonDiscovery' -CloseAppsCountdown 60
+
+ ## Show Progress Message (with the default message)
+ Show-InstallationProgress
+
+ ##
+
+
+ ##*===============================================
+ ##* UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Uninstallation'
+
+ ## Handle Zero-Config MSI Uninstallations
+ If ($useDefaultMsi) {
+ [hashtable]$ExecuteDefaultMSISplat = @{ Action = 'Uninstall'; Path = $defaultMsiFile }; If ($defaultMstFile) { $ExecuteDefaultMSISplat.Add('Transform', $defaultMstFile) }
+ Execute-MSI @ExecuteDefaultMSISplat
+ }
+
+ #
+
+ #Removing CFX Maestro
+ Write-Log "Removing CFX Maestro."
+ Remove-MSIApplications -Name 'Maestro' -FilterApplication (,('Publisher', 'Bio-Rad Laboratories, Inc.', 'Exact'))
+
+
+ ##*===============================================
+ ##* POST-UNINSTALLATION
+ ##*===============================================
+ [string]$installPhase = 'Post-Uninstallation'
+
+ ##