<#
    .DESCRIPTION
        This configuration will create a dynamically sized virtual hard disk that has a max size of 80Gb and will format a
        RefS volume named 'new volume 2' that uses the drive letter F, onto the newly created virtual hard disk. If the
        folder path in the FilePath property does not exist, it will be created.
#>
Configuration VirtualHardDisk_CreateDynamicallyExpandingVirtualDisk
{
    Import-DSCResource -ModuleName StorageDsc

    Node localhost
    {
          # Create new virtual disk
          VirtualHardDisk newVhd2
          {
            FilePath = 'C:\myVhds\virtDisk2.vhdx'
            DiskSize = 80Gb
            DiskFormat = 'Vhdx'
            DiskType = 'Dynamic'
            Ensure = 'Present'
          }

          # Create new volume onto the new virtual disk
          Disk Volume1
          {
            DiskId = 'C:\myVhds\virtDisk2.vhdx'
            DiskIdType = 'Location'
            DriveLetter = 'F'
            FSLabel = 'new volume 2'
            FSFormat = 'ReFS'
            Size = 20Gb
            DependsOn = '[VirtualHardDisk]newVhd2'
          }
    }
}


#pseudocode
function Get-TargetResource
{
       1. Use Get-DiskImage to get the disk
       2. If disk doesn't exist and Ensure set to 'Present', then we make Ensure set to 'Absent'
       3. If disk does exist then we make Ensure set to 'Present' if it isn't already
       4. return the image path, attach statue, size of disk, disk number and ensure state
}

function Test-TargetResource
{
	1. Get current state via Get-targetResource
	2. Check Ensure parameter
	3. if Ensure set to Present 
	    3.a. Check if virtual hard disk exists via current state from step 1
            3.b. if it does we return true
            3.c. if it does not we return false
     	4. if Ensure set to Absent
	    4.a. Check if virtual hard disk is attached. This is retrieved from step 1 where we get the state. 
            4.b. if it is attached we return false
            4.c. if it is not  attached or doesn't exist we return true
}

function Set-TargetResource
{
	1.Get current state via Get-targetResource
	2. Check Ensure parameter
	3. if Ensure set to Present 
	    3.a. we check if virtual hard disk exists via current state from step 1
            3.b. if the disk does exist we then check if it is not attached to the system.
                3.b.a if its attached we do nothing
                3.b.b if its not attached we attach it to the system
            3.c If the disk does not exist
                3.c.a We create the folder in the file path the user expects the virtual hard disk file to be created in. (if it doesn't exist)
                3.c.b if the folder now exists we create the virtual hard disk using the win32 apis
     	4. if Ensure set to Absent
	    4.a. we check if virtual hard disk is attached. This is retrieved from step 1 where we get the state. 
            4.b. if it is attached we detach it from the system
            4.c. if it is not  attached we do nothing
}