Public/WindowsImage/Dismount-WindowsImageOSD.ps1
|
<#
.SYNOPSIS Dismounts a Windows image from the directory it is mapped to. .DESCRIPTION The Dismount-WindowsImage cmdlet either saves or discards the changes to a Windows image and then dismounts the image. .LINK https://osd.osdeploy.com/module/functions/dismount-windowsimageosd .NOTES 19.11.21 David Segura @SeguraOSD #> function Dismount-WindowsImageOSD { [CmdletBinding(DefaultParameterSetName = 'DismountDiscard')] Param ( #Specifies the full path to the root directory of the offline Windows image that you will service. [Parameter(ValueFromPipelineByPropertyName)] [string[]]$Path, #Discard Changes to the Mounted Windows Image [Parameter(ParameterSetName = 'DismountDiscard', Mandatory = $true)] [switch]$Discard, #Save Changes to the Mounted Windows Image [Parameter(ParameterSetName = 'DismountSave', Mandatory = $true)] [switch]$Save ) Begin { #=================================================================================================== # Require Admin Rights #=================================================================================================== if ((Get-OSDGather -Property IsAdmin) -eq $false) { Write-Warning 'Dismount-WindowsImageOSD: This function requires Admin Rights ELEVATED' Break } #=================================================================================================== # Get-WindowsImage Mounted #=================================================================================================== if ($null -eq $Path) { $Path = (Get-WindowsImage -Mounted | Select-Object -Property Path).Path } } Process { foreach ($Input in $Path) { #=================================================================================================== # Path #=================================================================================================== $MountPath = (Get-Item -Path $Input | Select-Object FullName).FullName Write-Verbose "Path: $MountPath" -Verbose #=================================================================================================== # Validate Mount Path #=================================================================================================== if (-not (Test-Path $Input -ErrorAction SilentlyContinue)) { Write-Warning "Update-WindowsImageOSD: Unable to locate Mounted WindowsImage at $Input" Break } #=================================================================================================== # Dismount-WindowsImage #=================================================================================================== if ($Discard.IsPresent) {Dismount-WindowsImage -Path $Input -Discard | Out-Null} if ($Save.IsPresent) {Dismount-WindowsImage -Path $Input -Save | Out-Null} } } End {} } |