ansible/lib/ansible/modules/windows/win_initialize_disk.ps1

#!powershell

# Copyright: (c) 2019, Brant Evans <bevans@redhat.com>
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)

#AnsibleRequires -CSharpUtil Ansible.Basic
#AnsibleRequires -OSVersion 6.2

Set-StrictMode -Version 2

$spec = @{
    options = @{
        disk_number = @{ type = "int" }
        uniqueid = @{ type = "str" }
        path = @{ type = "str" }
        style = @{ type = "str"; choices = "gpt", "mbr"; default = "gpt" }
        online = @{ type = "bool"; default = $true }
        force = @{ type = "bool"; default = $false }
    }
    mutually_exclusive = @(
        ,@('disk_number', 'uniqueid', 'path')
    )
    required_one_of = @(
        ,@('disk_number', 'uniqueid', 'path')
    )
    supports_check_mode = $true
}

$module = [Ansible.Basic.AnsibleModule]::Create($args, $spec)

$disk_number = $module.Params.disk_number
$uniqueid = $module.Params.uniqueid
$path = $module.Params.path
$partition_style = $module.Params.style
$bring_online = $module.Params.online
$force_init = $module.Params.force

function Get-AnsibleDisk {
    param(
        $DiskNumber,
        $UniqueId,
        $Path
    )

    if ($null -ne $DiskNumber) {
        try {
            $disk = Get-Disk -Number $DiskNumber
        } catch {
            $module.FailJson("There was an error retrieving the disk using disk_number $($DiskNumber): $($_.Exception.Message)")
        }
    } elseif ($null -ne $UniqueId) {
        try {
            $disk = Get-Disk -UniqueId $UniqueId
        } catch {
            $module.FailJson("There was an error retrieving the disk using id $($UniqueId): $($_.Exception.Message)")
        }
    } elseif ($null -ne $Path) {
        try {
            $disk = Get-Disk -Path $Path
        } catch {
            $module.FailJson("There was an error retrieving the disk using path $($Path): $($_.Exception.Message)")
        }
    } else {
        $module.FailJson("Unable to retrieve disk: disk_number, id, or path was not specified")
    }

    return $disk
}

function Initialize-AnsibleDisk {
    param(
        $AnsibleDisk,
        $PartitionStyle
    )

    if ($AnsibleDisk.IsReadOnly) {
        $module.FailJson("Unable to initialize disk as it is read-only")
    }

    $parameters = @{
        Number = $AnsibleDisk.Number
        PartitionStyle = $PartitionStyle
    }

    if (-Not $module.CheckMode) {
        Initialize-Disk @parameters -Confirm:$false
    }

    $module.Result.changed = $true
}

function Clear-AnsibleDisk {
    param(
        $AnsibleDisk
    )

    $parameters = @{
        Number = $AnsibleDisk.Number
    }

    if (-Not $module.CheckMode) {
        Clear-Disk @parameters -RemoveData -RemoveOEM -Confirm:$false
    }
}

function Set-AnsibleDisk {
    param(
        $AnsibleDisk,
        $BringOnline
    )

    $refresh_disk_status = $false

    if ($BringOnline) {
        if (-Not $module.CheckMode) {
            if ($AnsibleDisk.IsOffline) {
                Set-Disk -Number $AnsibleDisk.Number -IsOffline:$false
                $refresh_disk_status = $true
            }

            if ($AnsibleDisk.IsReadOnly) {
                Set-Disk -Number $AnsibleDisk.Number -IsReadOnly:$false
                $refresh_disk_status = $true
            }
        }
    }

    if ($refresh_disk_status) {
        $AnsibleDisk = Get-AnsibleDisk -DiskNumber $AnsibleDisk.Number
    }

    return $AnsibleDisk
}

$ansible_disk = Get-AnsibleDisk -DiskNumber $disk_number -UniqueId $uniqueid -Path $path
$ansible_part_style = $ansible_disk.PartitionStyle

if ("RAW" -eq $ansible_part_style) {
    $ansible_disk = Set-AnsibleDisk -AnsibleDisk $ansible_disk -BringOnline $bring_online
    Initialize-AnsibleDisk -AnsibleDisk $ansible_disk -PartitionStyle $partition_style
} else {
    if (($ansible_part_style -ne $partition_style.ToUpper()) -And -Not $force_init) {
        $module.FailJson("Force initialization must be specified since the target partition style: $($partition_style.ToLower()) is different from the current partition style: $($ansible_part_style.ToLower())")
    } elseif ($force_init) {
        $ansible_disk = Set-AnsibleDisk -AnsibleDisk $ansible_disk -BringOnline $bring_online
        Clear-AnsibleDisk -AnsibleDisk $ansible_disk
        Initialize-AnsibleDisk -AnsibleDisk $ansible_disk -PartitionStyle $partition_style
    }
}

$module.ExitJson()