NTS-ConfigMgrTools.psm1

function New-VMVolume {
    param (
        # Driveletter
        [Parameter(Mandatory = $true)]
        [char]
        $VMDriveLetter,

        # StoragePool Name
        [Parameter(Mandatory = $true)]
        [string]
        $StoragePoolName,

        # VirtualDisk Name
        [Parameter(Mandatory = $true)]
        [string]
        $VirtualDiskName,

        # VMVolume Name
        [Parameter(Mandatory = $true)]
        [string]
        $VMVolumeName
    )

    try {
        if($null -eq (Get-StoragePool -FriendlyName $StoragePoolName -ErrorAction SilentlyContinue)){
            $PhysicalDisks = Get-PhysicalDisk -CanPool $true | Where-Object -FilterScript { $PSitem.Bustype -ne "USB" }
            $NVMe_Devices = $PhysicalDisks | Where-Object -FilterScript { $PSItem.Bustype -eq "NVMe" -and $PSitem.Size -gt 256GB }
            $Non_NVMe_Devices = $PhysicalDisks | Where-Object -FilterScript { $PSItem.Bustype -ne "NVMe" }
            if ($null -ne $NVMe_Devices) {
                $SelectedDisks = $NVMe_Devices
            }
            else {
                $SelectedDisks = $Non_NVMe_Devices
            }
            $StorageSubSystemFriendlyName = (Get-StorageSubSystem -FriendlyName "*Windows*").FriendlyName
            Write-Host "Create storage pool '$($StoragePoolName)'"
            New-StoragePool -StorageSubSystemFriendlyName $StorageSubSystemFriendlyName -FriendlyName $StoragePoolName -PhysicalDisks $SelectedDisks | Out-Null
            if($null -ne (Get-VirtualDisk -FriendlyName $VirtualDiskName -ErrorAction SilentlyContinue)){
                Write-Host "Create vdisk '$($VirtualDiskName)'"
                New-VirtualDisk -StoragePoolFriendlyName $StoragePoolName -FriendlyName $VirtualDiskName -UseMaximumSize -ProvisioningType Fixed -ResiliencySettingName Simple | Out-Null
                Initialize-Disk -FriendlyName $VirtualDiskName -PartitionStyle GPT | Out-Null
                $VDiskNumber = (Get-Disk -FriendlyName $VirtualDiskName).Number
                Write-Host "Create volume '$($VMVolumeName)'"
                New-Volume -DiskNumber $VDiskNumber -FriendlyName $VMVolumeName -FileSystem ReFS -DriveLetter $VMDriveLetter | Out-Null
            }
            else{
                Write-Host "Virtual disk '$($VirtualDiskName)' already exists"
            }
        }
        else{
            Write-Host "Pool '$($StoragePoolName)' already exists"
        }
    }
    catch {
        throw "something went wrong while creating storage pool, vdisk or volume"
    }
}
Export-ModuleMember -Function New-VMVolume
function New-VMVSwitch {
    param (
        # Course Shortcut
        [Parameter(Mandatory = $true)]
        [string]
        $Course_Shortcut
    )
    
    try {
        if($null -eq (Get-VMSwitch -Name $Course_Shortcut -ErrorAction SilentlyContinue)){
            $pNICs = Get-NetAdapter -Physical | Where-Object -Property Status -eq "UP"
            $10G_NICs = $pNICs | Where-Object -Property LinkSpeed -EQ "10 Gbps"
            $1G_NICs = $pNICs | Where-Object -Property LinkSpeed -EQ "1 Gbps"
    
            if($10G_NICs){
                $Selected_NIC = $10G_NICs[0]
            }
            elseif($1G_NICs){
                $Selected_NIC = $1G_NICs[0]
            }
            else {
                (Get-NetAdapter -Physical | Where-Object -Property Status -eq "UP")[0]
            }
    
            Write-Host "create vswitch '$($Course_Shortcut)'"
            New-VMSwitch -Name $Course_Shortcut -NetAdapterName $Selected_NIC.Name -AllowManagementOS $false | Out-Null
            Add-VMNetworkAdapter -ManagementOS -SwitchName $Course_Shortcut -Name "vNIC-$($Course_Shortcut)"
            Rename-NetAdapter -Name $Selected_NIC.Name -NewName "pNIC-$($Course_Shortcut)"
        }
        else{
            Write-Host "Virtual vswitch '$($Course_Shortcut)' already exists"
        }
    }
    catch {
        throw "something went wrong during creation of virtual switch"
    }
}
Export-ModuleMember -Function New-VMVSwitch
function Register-VM_in_CM {
    [CmdletBinding()]
    param (
        # VM Object
        [Parameter()]
        [hashtable]
        $VM_Config_Obj,

        # ConfigMgr SMS Provider NetBIOS Name
        [Parameter()]
        [string]
        $CM_Siteserver_NetBIOS,

        # ConfigMgr SMS Provider FQDN
        [Parameter()]
        [string]
        $CM_Siteserver_FQDN,

        # Credentials for PSRemoting to SMS Provider and permissions to configmgr
        [Parameter()]
        [PSCredential]
        $CM_Credentials
    )

    try {
        Invoke-Command -ComputerName $CM_Siteserver_NetBIOS -Credential $CM_Credentials -ScriptBlock {
            $PSDriveName = "CM-PB2"
            $VM_Config_Obj = $using:VM_Config_Obj

            Import-Module -Name ConfigurationManager
            New-PSDrive -Name $PSDriveName -PSProvider "CMSite" -Root $using:CM_Siteserver_FQDN -Description "Primary site" | Out-Null
            Set-Location -Path "$($PSDriveName):\"

            foreach ($VM in $VM_Config_Obj.Keys | Sort-Object){
                # check destination collection existance
                if ($null -eq (Get-CMCollection -Name $VM_Config_Obj.$VM.CM_Collection_Name)) {
                    Get-CMDevice -Name $VM | Remove-CMDevice -Force -Confirm:$false
                    throw "collection '$($VM_Config_Obj.$VM.CM_Collection_Name)' does not existing, device infos for '$($VM)' was removed"
                }
            }
            
            # create vm info
            foreach ($VM in $VM_Config_Obj.Keys | Sort-Object){
                Write-Host "'$($VM)': creating vm computer info in configmgr - macaddress '$($VM_Config_Obj.$VM.MAC)'"
                Get-CMDevice -Name $VM | Remove-CMDevice -Force -Confirm:$false
            }
            Start-Sleep -Seconds 5
            foreach ($VM in $VM_Config_Obj.Keys | Sort-Object){
                Import-CMComputerInformation -CollectionName "All Systems" -ComputerName $VM -MacAddress $VM_Config_Obj.$VM.MAC
            }
            Start-Sleep -Seconds 5
            Get-CMCollection -Name "All Systems" | Invoke-CMCollectionUpdate

            # check vm collection membership
            foreach ($VM in $VM_Config_Obj.Keys | Sort-Object){
                #region all systems collection
                $Device_Exists_In_AllDevices = $false
                $All_Devices_Counter = 0
                while ($Device_Exists_In_AllDevices -eq $false -and $All_Devices_Counter -lt 25) {
                    Write-Host "'$($VM)': waiting for vm in collection 'All Devices'"
                    $CMDevice = Get-CMDevice -Name $VM
                    if ($CMDevice.Name -eq $VM) {
                        $Device_Exists_In_AllDevices = $true
                    }
                    else{
                        Start-Sleep -Seconds 10
                        $All_Devices_Counter++
                    }
                }
                #endregion
            
                # create vm membership rule
                Add-CMDeviceCollectionDirectMembershipRule -CollectionName $VM_Config_Obj.$VM.CM_Collection_Name -ResourceID $CMDevice.ResourceID

                #region destination collection
                $Device_Exists_In_Specified_Collection = $false
                $Specified_Collection_Counter = 0
                while ($Device_Exists_In_Specified_Collection -eq $false -and $Specified_Collection_Counter -lt 30) {
                    Write-Host "'$($VM)': waiting for vm in Collection '$($VM_Config_Obj.$VM.CM_Collection_Name)'"
                    $Collection_Direct_Members = Get-CMDeviceCollectionDirectMembershipRule -CollectionName $VM_Config_Obj.$VM.CM_Collection_Name | Where-Object RuleName -eq $VM
                    if ($null -ne $Collection_Direct_Members) {
                        $Device_Exists_In_Specified_Collection = $true
                    }
                    else{
                        Start-Sleep -Seconds 5
                        $Specified_Collection_Counter++
                    }
                    if ($Specified_Collection_Counter -eq 20) {
                        Write-Host "'$($VM)': triggering membership update in Collection '$($CM_Collection_Name)'"
                        Get-CMCollection -Name $VM_Config_Obj.$VM.CM_Collection_Name | Invoke-CMCollectionUpdate
                    }
                }
                #endregion
            }
            Start-Sleep -Seconds 60
            Set-Location -Path $env:SystemDrive
            Remove-PSDrive -Name $PSDriveName
        }
    }
    catch {
        throw "something went wrong during registration of device infos in configmgr"
    }

}
Export-ModuleMember -Function Register-VM_in_CM
function Start-VM_Deployment {
    [CmdletBinding()]
    param (
        [Parameter(Mandatory = $true)]
        [hashtable]
        $VM_Config_Obj
    )

    try {
        foreach ($VM in $VM_Config_Obj.Keys | Sort-Object) {
            Write-Host "'$($VM)': starting deployment"
            Start-Sleep -Seconds 2
            Start-VM -VMName $VM
        }
    }
    catch {
        throw "something went wrong while starting vms"
    }
}
Export-ModuleMember -Function Start-VM_Deployment
function Confirm-VM_Deployment {
    [CmdletBinding()]
    param (
        # VM Object
        [Parameter(Mandatory = $true)]
        [hashtable]
        $VM_Config_Obj,

        # ConfigMgr SMS Provider NetBIOS Name
        [Parameter()]
        [string]
        $CM_Siteserver_NetBIOS,

        # ConfigMgr SMS Provider FQDN
        [Parameter()]
        [string]
        $CM_Siteserver_FQDN,

        # Credentials for PSRemoting to SMS Provider and permissions to configmgr
        [Parameter()]
        [PSCredential]
        $CM_Credentials
    )

    try {
        Invoke-Command -ComputerName $CM_Siteserver_NetBIOS -Credential $CM_Credentials -ScriptBlock {
            $PSDriveName = "CM-PB2"

            Import-Module -Name ConfigurationManager
            New-PSDrive -Name $PSDriveName -PSProvider "CMSite" -Root $using:CM_Siteserver_FQDN -Description "Primary site" | Out-Null
            Set-Location -Path "$($PSDriveName):\"
    
            $Deployment_Finished = $false
            $CM_Deployment_Running = @{}
            foreach ($VM in $using:VM_Config_Obj.keys | Sort-Object) {
                $CM_Deployment_Running.Add($VM,$true)
            }
    
            do {
                $CM_All_Deployments = Get-CMDeploymentStatus | Get-CMDeploymentStatusDetails | `
                                        Where-Object -FilterScript { $using:VM_Config_Obj.keys -contains $PSItem.Devicename } | `
                                        Sort-Object -Property DeviceName
    
                foreach($VM_Deployment in $CM_All_Deployments){
                    if($VM_Deployment.StatusDescription -notlike "*The task sequence manager successfully completed execution of the task sequence*"){
                        Write-Host "'$($VM_Deployment.DeviceName)': still running - $($VM_Deployment.StatusDescription)"
                        $CM_Deployment_Running.$($VM_Deployment.Devicename) = $true
                    }
                    else {
                        Write-Host "'$($VM_Deployment.Devicename)': finished - $($VM_Deployment.StatusDescription)"
                        $CM_Deployment_Running.$($VM_Deployment.Devicename) = $false
                    }               
                }
                Write-Host "------"
    
                if($CM_Deployment_Running.Values -notcontains $true){
                    $Deployment_Finished = $true
                }
                else {
                    Start-Sleep -Seconds 15
                }
    
            } while ($Deployment_Finished -eq $false)
    
            Write-Host "vm os deployment completed"
            Set-Location -Path $env:SystemDrive
            Remove-PSDrive -Name $PSDriveName
        }    
    }
    catch {
        throw "something went wrong while checking deployment status"
    }
}
Export-ModuleMember -Function Confirm-VM_Deployment
function Deploy-VMBasedOnObject {
    param (
        # VM Object
        [Parameter(Mandatory = $true)]
        [System.Object]
        $VM_Config,

        # Course Shortcut
        [Parameter(Mandatory = $true)]
        [string]
        $Course_Shortcut,

        # ConfigMgr SMS Provider NetBIOS Name
        [Parameter()]
        [string]
        $CM_Siteserver_NetBIOS,

        # ConfigMgr SMS Provider FQDN
        [Parameter()]
        [string]
        $CM_Siteserver_FQDN,

        # Credentials for PSRemoting to SMS Provider and permissions to configmgr
        [Parameter()]
        [PSCredential]
        $CM_Credentials
    )
    
    # VM Creation
    $VM_Deployment_Start = Get-Date
    try {
        $VM_Base_Path = $VMDriveLetter + ":\VMs"
        Write-Host "`nstarting vm creation"
        Write-Host "------"
        foreach($VM in $VM_Config.Keys | Sort-Object){
            $VMVHDXPath = ($VM_Base_Path + "\" + $VM_Config.$VM.Name + "\" + $VM_Config.$VM.Name + ".vhdx")
            Write-Host "'$($VM_Config.$VM.Name)': creating vm"
            try {
                New-VHD -Path $VMVHDXPath -SizeBytes $VM_Config.$VM.DiskSize -Dynamic | Out-Null
                New-VM -Name $VM_Config.$VM.Name -MemoryStartupBytes $VM_Config.$VM.RAM -Path $VM_Base_Path -Generation 2 -VHDPath $VMVHDXPath -BootDevice NetworkAdapter -SwitchName $Course_Shortcut | Out-Null
            }
            catch {
                throw "error during creation of vhdx or vm '$($VM_Config.$VM.Name)'"
            }
            try {
                Set-VMProcessor -VMName $VM_Config.$VM.Name -Count $VM_Config.$VM.CPU
                Set-VMKeyProtector -VMName $VM_Config.$VM.Name -NewLocalKeyProtector
                Enable-VMTPM -VMName $VM_Config.$VM.Name
                Set-VM -AutomaticStartAction Nothing -VMName $VM_Config.$VM.Name
                Set-VM -AutomaticStopAction ShutDown -VMName $VM_Config.$VM.Name
                Get-VMIntegrationService -VMName $VM_Config.$VM.Name | Where-Object -Property Enabled -EQ $false | Enable-VMIntegrationService
            }
            catch {
                throw "error while setting properties of vm '$($VM_Config.$VM.Name)'"
            }
            Start-VM -Name $VM_Config.$VM.Name
            Start-Sleep -Seconds 2
            Stop-VM -Name $VM_Config.$VM.Name -Force -TurnOff
            Start-Sleep -Seconds 1
        }
        foreach($VM in $VM_Config.Keys | Sort-Object){
            $VM_Config.$VM.MAC = (Get-VM -Name $VM_Config.$VM.Name | Get-VMNetworkAdapter).MacAddress
            Set-VMNetworkAdapter -VMName $VM_Config.$VM.Name -StaticMacAddress $VM_Config.$VM.MAC
        }
    }
    catch {
        throw "something went wrong durch creation of vms"
    }

    # ConfigMgr / Deployment
    try {
        Write-Host "`nstarting configmgr preparation"
        Write-Host "------"
        Register-VM_in_CM -VM_Config_Obj $VM_Config `
                        -CM_Siteserver_NetBIOS $CM_Siteserver_NetBIOS `
                        -CM_Siteserver_FQDN $CM_Siteserver_FQDN `
                        -CM_Credentials $CM_Credentials
        Write-Host "finished configmgr preparation, now waiting 90 seconds for the configmgr database updates and stabilization"
        Start-Sleep -Seconds 90
        Write-Host "`nstarting vm deployments"
        Write-Host "------"
        Start-VM_Deployment -VM_Config_Obj $VM_Config
        
        Write-Host "`nchecking vm os deployment status"
        Write-Host "------"
        Confirm-VM_Deployment -VM_Config_Obj $VM_Config `
                            -CM_Siteserver_FQDN $CM_Siteserver_FQDN `
                            -CM_Siteserver_NetBIOS $CM_Siteserver_NetBIOS `
                            -CM_Credentials $CM_Credentials
        Write-Host "finished vm deployments"
        Write-Host "------"
    }
    catch {
        throw "something went wrong durch vm deployment"
    }
    $VM_Deployment_Duration = (Get-Date) - $VM_Deployment_Start
    Write-Host "vm deployment took $($VM_Deployment_Duration.Hours)h $($VM_Deployment_Duration.Minutes)m $($VM_Deployment_Duration.Seconds)s"
}
Export-ModuleMember -Function Deploy-VMBasedOnObject