summaryrefslogtreecommitdiff
path: root/lib/ansible/modules/windows/win_disk_image.ps1
blob: 76b04e572e4581ddc1acb56d619fb735fa40479c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
#!powershell

# (c) 2017, Red Hat, Inc.
#
# This file is part of Ansible
#
# Ansible is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation, either version 3 of the License, or
# (at your option) any later version.
#
# Ansible 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 General Public License
# along with Ansible.  If not, see <http://www.gnu.org/licenses/>.

# POWERSHELL_COMMON
# WANT_JSON

$ErrorActionPreference = "Stop"
Set-StrictMode -Version 2

If(-not (Get-Command Get-DiskImage -ErrorAction SilentlyContinue)) {
    Fail-Json -message "win_disk_image requires Windows 8+ or Windows Server 2012+"
}

$parsed_args = Parse-Args $args -supports_check_mode $true

$result = @{changed=$false}

$image_path = Get-AnsibleParam $parsed_args "image_path" -failifempty $result
$state = Get-AnsibleParam $parsed_args "state" -default "present" -validateset "present","absent"
$check_mode = Get-AnsibleParam $parsed_args "_ansible_check_mode" -default $false

$di = Get-DiskImage $image_path

If($state -eq "present") {
    If(-not $di.Attached) {
      $result.changed = $true

      If(-not $check_mode) {
        $di = Mount-DiskImage $image_path -PassThru

        # the actual mount is async, so the CIMInstance result may not immediately contain the data we need
        $retry_count = 0
        While(-not $di.Attached -and $retry_count -lt 5) {
          Sleep -Seconds 1 | Out-Null
          $di = $di | Get-DiskImage
          $retry_count++
        }

        If(-not $di.Attached) {
          Fail-Json $result -message "Timed out waiting for disk to attach"
        }
     }
  }

  # FUTURE: detect/handle "ejected" ISOs
  # FUTURE: support explicit drive letter and NTFS in-volume mountpoints.
  # VHDs don't always auto-assign, and other system settings can prevent automatic assignment

  If($di.Attached) { # only try to get the mount_path if the disk is attached (
    If($di.StorageType -eq 1) { # ISO, we can get the mountpoint directly from Get-Volume
      $drive_letter = ($di | Get-Volume).DriveLetter
    }
    ElseIf($di.StorageType -in @(2,3)) { # VHD/VHDX, need Get-Disk + Get-Partition to discover mountpoint
      # FUTURE: support multi-partition VHDs
      $drive_letter = ($di | Get-Disk | Get-Partition)[0].DriveLetter
    }


    If(-not $drive_letter) {
      Fail-Json -message "Unable to retrieve drive letter from mounted image"
    }

    $result.mount_path = $drive_letter + ":\"
  }
}
ElseIf($state -eq "absent") {
  If($di.Attached) {
    $result.changed = $true
    If(-not $check_mode) {
      Dismount-DiskImage $image_path | Out-Null
    }
  }
}

Exit-Json $result