DSCResources/POSHOrigin_vSphere_VM/POSHOrigin_vSphere_VM.psm1
|
# Load helpers Get-ChildItem -Path "$psscriptroot\Helpers" | ForEach-Object { Write-Debug -Message "Loading helper function $($_.Name)" . $_.FullName } $script:VCConnected = $false function Get-TargetResource { [CmdletBinding()] [OutputType([System.Collections.Hashtable])] param ( [parameter(Mandatory = $true)] [System.String] $Name, [parameter(Mandatory = $true)] [ValidateSet("Present","Absent")] [System.String] $Ensure, [System.Boolean] $PowerOnAfterCreation, [System.Management.Automation.PSCredential] $vCenterCredentials, [System.Int32] $TotalvCPU, [System.Int32] $CoresPerSocket, [System.Int32] $vRAM, [System.String] $Disks, [System.String] $Networks, [System.String] $VMTemplate, [System.String] $CustomizationSpec, [System.Management.Automation.PSCredential] $GuestCredentials, [System.Management.Automation.PSCredential] $IPAMCredentials, [System.Management.Automation.PSCredential] $DomainJoinCredentials, [System.String] $IPAMFqdn, [System.String] $vCenter, [System.String] $Datacenter, [System.String] $InitialDatastore, [System.String] $Cluster, [System.String] $Provisioners ) $returnValue = @{ Name = $Name Ensure = $Ensure PowerOnAfterCreation = $PowerOnAfterCreation vCenterCredentials = $vCenterCredentials TotalvCPU = $TotalvCPU CoresPerSocket = $CoresPerSocket vRAM = $vRAM Disks = $Disks Networks = $Networks VMTemplate = $VMTemplate CustomizationSpec = $CustomizationSpec GuestCredentials = $GuestCredentials IPAMCredentials = $IPAMCredentials IPAMFqdn = $IPAMFqdn vCenter = $vCenter Datacenter =$Datacenter InitialDatastore = $InitialDatastore Cluster = $Cluster Provisioners = $Provisioners } $returnValue } function Set-TargetResource { [CmdletBinding()] param ( [parameter(Mandatory = $true)] [System.String] $Name, [parameter(Mandatory = $true)] [ValidateSet("Present","Absent")] [System.String] $Ensure, [System.Boolean] $PowerOnAfterCreation, [System.Management.Automation.PSCredential] $vCenterCredentials, [System.Int32] $TotalvCPU, [System.Int32] $CoresPerSocket, [System.Int32] $vRAM, [System.String] $Disks, [System.String] $Networks, [System.String] $VMTemplate, [System.String] $CustomizationSpec, [System.Management.Automation.PSCredential] $GuestCredentials, [System.Management.Automation.PSCredential] $IPAMCredentials, [System.Management.Automation.PSCredential] $DomainJoinCredentials, [System.String] $IPAMFqdn, [System.String] $vCenter, [System.String] $Datacenter, [System.String] $InitialDatastore, [System.String] $Cluster, [System.String] $Provisioners ) #Include this line if the resource requires a system reboot. #$global:DSCMachineStatus = 1 try { # Connect to vCenter $script:VCConnected = _ConnectTovCenter -vCenter $vCenter -Credential $vCenterCredentials $newVM = $false $vm = Get-VM -Name $Name -Verbose:$false -ErrorAction SilentlyContinue | Select-Object -First 1 if ($Ensure -eq 'Present') { # Create the VM if needed if ($null -eq $vm) { $diskSpec = ConvertFrom-Json -InputObject $Disks $format = $diskSpec[0].Format $params = @{ Name = $Name VMTemplate = $VMTemplate Cluster = $Cluster InitialDatastore = $InitialDatastore DiskFormat = $format NICSpec = $Networks CustomizationSpec = $CustomizationSpec #IPAMFqdn = $IPAMFqdn #IPAMCredentials = $IPAMCredentials } $vm = _CreateVM @params if ($null -ne $vm) { Write-Verbose -Message 'VM created successfully' $newVm = $true } # Set NICs $setNICResult = $false $setNICResult = _SetVMNICs -vm $vm -NICSpec $Networks -CustomizationSpec $CustomizationSpec -IPAMFqdn $IPAMFqdn -IPAMCredentials $IPAMCredentials if ($setNICResult -eq $false) { throw 'Failed to set NICs after VM creation. Aborting...' } } # Set RAM if (-not (_TestVMRAM -vm $vm -RAM $vRAM)) { _SetVMRAM -vm $vm -RAM $vRAM } # Set vCPU if (-not (_TestVMCPU -vm $vm -TotalvCPU $TotalvCPU -CoresPerSocket $CoresPerSocket)) { _SetVMCPU -vm $vm -TotalvCPU $TotalvCPU -CoresPerSocket $CoresPerSocket } # Set disks if (-not (_TestVMDisks -vm $vm -DiskSpec $Disks)) { $updatedVMDisks = _SetVMDisks -vm $vm -DiskSpec $Disks } # Power on VM and wait for OS customization to complete if (-not (_TestVMPowerState -vm $vm -PowerOnAfterCreation $PowerOnAfterCreation)) { _SetVMPowerState -vm $vm # Wait for OS customization to complete if this is a newly created VM if ($newVM -eq $true) { _WaitForGuestCustomization -vm $vm } _WaitForVMTools -vm $vm -Credential $GuestCredentials } if ($updatedVMDisks -eq $true) { _refreshHostStorageCache -vm $vm -Credential $GuestCredentials } # Set guest disks if (-not (_TestGuestDisks -vm $vm -DiskSpec $Disks -Credential $GuestCredentials)) { _SetGuestDisks -vm $vm -DiskSpec $Disks -Credential $GuestCredentials } # Run any provisioners if ($Provisioners -ne [string]::Empty) { foreach ($p in (ConvertFrom-Json -InputObject $Provisioners)) { $testPath = "$PSScriptRoot\Provisioners\$($p.name)\Test.ps1" if (Test-Path -Path $testPath) { $params = $PSBoundParameters $params.vm = $vm $provisionerResult = (& $testPath $params) if ($provisionerResult -ne $true) { $provPath = "$PSScriptRoot\Provisioners\$($p.name)\Provision.ps1" if (Test-Path -Path $testPath) { $params = $PSBoundParameters $params.vm = $vm (& $provPath $params) } } } } } } else { Write-Verbose '[Ensure == Absent] Beginning deprovisioning process' # Run through any provisioners we have defined and execute the 'deprovision' script if ($Provisioners -ne [string]::Empty) { foreach ($p in (ConvertFrom-Json -InputObject $Provisioners)) { $testPath = "$PSScriptRoot\Provisioners\$($p.name)\Test.ps1" if (Test-Path -Path $testPath) { $params = $PSBoundParameters $params.vm = $vm $provisionerResult = (& $testPath $params) if ($provisionerResult -eq $true) { $provPath = "$PSScriptRoot\Provisioners\$($p.name)\Deprovision.ps1" if (Test-Path -Path $testPath) { $params = $PSBoundParameters $params.vm = $vm (& $provPath $params) } } } } } # Connect to vCenter $script:VCConnected = _ConnectTovCenter -vCenter $vCenter -Credential $vCenterCredentials # Stop and delete VM $vm = Get-VM -Name $Name -Verbose:$false -ErrorAction SilentlyContinue | Select-Object -First 1 if ($null -ne $vm) { try { Write-Verbose -Message 'Stopping VM' $stopResult = $vm | Stop-VM -Confirm:$false -Verbose:$false Write-Verbose -Message 'VM stopped' if ($stopResult.PowerState -eq 'PoweredOff') { $delResult = $stopResult | Remove-VM -DeletePermanently -Confirm:$false -Verbose:$false Write-Verbose -Message 'VM deleted' } else { throw 'Unable to stop VM' } } catch { throw $_ } } } } catch { Write-Error 'There was a problem setting the resource' Write-Error "$($_.InvocationInfo.ScriptName)($($_.InvocationInfo.ScriptLineNumber)): $($_.InvocationInfo.Line)" Write-Error $_ } } function Test-TargetResource { [CmdletBinding()] [OutputType([System.Boolean])] param ( [parameter(Mandatory = $true)] [System.String] $Name, [parameter(Mandatory = $true)] [ValidateSet("Present","Absent")] [System.String] $Ensure, [System.Boolean] $PowerOnAfterCreation, [System.Management.Automation.PSCredential] $vCenterCredentials, [System.Int32] $TotalvCPU, [System.Int32] $CoresPerSocket, [System.Int32] $vRAM, [System.String] $Disks, [System.String] $Networks, [System.String] $VMTemplate, [System.String] $CustomizationSpec, [System.Management.Automation.PSCredential] $GuestCredentials, [System.Management.Automation.PSCredential] $IPAMCredentials, [System.Management.Automation.PSCredential] $DomainJoinCredentials, [System.String] $IPAMFqdn, [System.String] $vCenter, [System.String] $Datacenter, [System.String] $InitialDatastore, [System.String] $Cluster, [System.String] $Provisioners ) # Connect to vCenter $script:VCConnected = _ConnectTovCenter -vCenter $vCenter -Credential $vCenterCredentials $result = $true # Check if VM exists $vm = Get-VM -Name $Name -verbose:$false -ErrorAction SilentlyContinue | select -First 1 if ($vm -ne $null) { Write-Verbose -Message "VM exists" } else { Write-Verbose -Message "VM does not exist" } # If VM exists, is it supposed to? if ($Ensure -eq 'Present') { if (-Not $vm) { Write-Information -Message "$Name should exist but doesn't" return $false } } else { if (-Not $vm) { Write-Information -Message "$Name doesn't exist and should not" return $true } else { Write-Information -Message "$Name shouldn't exist but does" return $false } } #region Run through tests # RAM $ramResult = _TestVMRAM -VM $vm -RAM $vRAM $match = if ( $ramResult) { 'MATCH' } else { 'MISMATCH' } Write-Verbose -Message "RAM: $match" # CPU $cpuResult = _TestVMCPU -vm $vm -TotalvCPU $TotalvCPU -CoresPerSocket $CoresPerSocket $match = if ( $cpuResult) { 'MATCH' } else { 'MISMATCH' } Write-Verbose -Message "vCPU: $match" # Disks $vmDiskResult = _TestVMDisks -vm $vm -DiskSpec $Disks $match = if ( $vmDiskResult) { 'MATCH' } else { 'MISMATCH' } Write-Verbose -Message "VM Disks: $match" # Guest disks _refreshHostStorageCache -vm $vm -Credential $GuestCredentials $guestDiskResult = _TestGuestDisks -vm $vm -DiskSpec $Disks -Credential $GuestCredentials $match = if ( $guestDiskResult) { 'MATCH' } else { 'MISMATCH' } Write-Verbose -Message "Guest disks: $match" # NICs # TODO # Power state $powerResult = _TestVMPowerState -vm $vm -PowerOnAfterCreation $PowerOnAfterCreation $match = if ( $powerResult) { 'MATCH' } else { 'MISMATCH' } Write-Verbose -Message "Power state: $match" #endregion # Test provisioners if ($Provisioners -ne [string]::Empty) { foreach ($p in (ConvertFrom-Json -InputObject $Provisioners)) { $provPath = "$PSScriptRoot\Provisioners\$($p.name)\Test.ps1" if (Test-Path -Path $provPath) { $params = $PSBoundParameters $params.vm = $vm $provisionerPassed = (& $provPath $params) if (-not $provisionerPassed) { return $false } } } } return $true } Export-ModuleMember -Function *-TargetResource |