Set-CBT.psm1

function Set-CBT {
<#	
    .NOTES
    ===========================================================================
    Created by: Markus Kraus
    Twitter: @VMarkus_K
    Private Blog: mycloudrevolution.com
    ===========================================================================
    Changelog:  
    2016.11 ver 1.0 Base Release 
    ===========================================================================
    External Code Sources:  
    http://wahlnetwork.com/2015/12/01/change-block-tracking-cbt-powercli/
    ===========================================================================
    Tested Against Environment:
    vSphere Version: 5.5 U2
    PowerCLI Version: PowerCLI 6.3 R1
    PowerShell Version: 4.0
    OS Version: Windows Server 2012 R2
    ===========================================================================
    Keywords vSphere, ESXi, VM, Storage, CBT, Backup
    ===========================================================================

    .DESCRIPTION
    This Function enables or disables CBT.       

    .Example
    Get-VN TST* | Set-CBT -DisableCBT  

    .Example
    Get-VN TST* | Set-CBT -EnableCBT  

    .PARAMETER DisableCBT
    Disables CBT for any VMs found with it enabled

    .PARAMETER EnableCBT
    Enables CBT for any VMs found with it disabled

#Requires PS -Version 4.0
#>

  [CmdletBinding()]
    param( 
        [Parameter(Mandatory=$True, ValueFromPipeline=$True, Position=0, HelpMessage = "VMs to process")]
        [ValidateNotNullorEmpty()]
        	[VMware.VimAutomation.ViCore.Impl.V1.Inventory.InventoryItemImpl[]] $myVMs,
        [Parameter(Mandatory = $False,ValueFromPipeline=$False, Position = 1, HelpMessage = "Enables CBT for any VMs found with it disabled", ParameterSetName = "EnableCBT")]
        [ValidateNotNullorEmpty()]
            [Switch]$EnableCBT,
        [Parameter(Mandatory = $False,ValueFromPipeline=$False, Position = 1, HelpMessage = "Disables CBT for any VMs found with it enabled", ParameterSetName = "DisableCBT")]
        [ValidateNotNullorEmpty()]
            [Switch]$DisableCBT
    )
Process { 

	    $vmconfigspec = New-Object -TypeName VMware.Vim.VirtualMachineConfigSpec
        Write-Verbose -Message "Walking through given VMs"
        foreach($myVM in $myVMs)
        {
            if ($DisableCBT -and $myVM.ExtensionData.Config.ChangeTrackingEnabled -eq $true -and $myVM.ExtensionData.Snapshot -eq $null)
            {
                try 
                {
                    Write-Verbose -Message "Reconfiguring $($myVM.name) to disable CBT" -Verbose
                    $vmconfigspec.ChangeTrackingEnabled = $false
                    $myVM.ExtensionData.ReconfigVM($vmconfigspec)

                    if ($myVM.PowerState -eq "PoweredOn" ) {
                        Write-Verbose -Message "Creating a snapshot on $($myVM.name) to clear CBT file" -Verbose
                        $SnapShot = New-Snapshot -VM $myVM -Name "CBT Cleanup"

                        Write-Verbose -Message "Removing snapshot on $($myVM.name)" -Verbose
                        $SnapShot|  Remove-Snapshot -Confirm:$false
                    }

                }
                catch 
                {
                    throw $myVM
                }
            }
            elseif ($EnableCBT -and $myVM.ExtensionData.Config.ChangeTrackingEnabled -eq $false -and $myVM.ExtensionData.Snapshot -eq $null)
            {
                Write-Verbose -Message "Reconfiguring $($myVM.name) to enable CBT" -Verbose
                $vmconfigspec.ChangeTrackingEnabled = $true
                $myVM.ExtensionData.ReconfigVM($vmconfigspec)

                if ($myVM.PowerState -eq "PoweredOn" ) {
                    Write-Verbose -Message "Creating a snapshot on $($myVM.name) to Create CBT file" -Verbose
                    $SnapShot = New-Snapshot -VM $myVM -Name "CBT Cleanup"

                    Write-Verbose -Message "Removing snapshot on $($myVM.name)" -Verbose
                    $SnapShot |  Remove-Snapshot -Confirm:$false
                }
            }
            else 
            {
                if ($myVM.ExtensionData.Snapshot -ne $null -and $EnableCBT) 
                {
                    Write-Warning -Message "Skipping $($myVM.name) - Snapshots found"
                }
                elseif ($myVM.ExtensionData.Snapshot -ne $null -and $DisableCBT) 
                {
                    Write-Warning -Message "Skipping $($myVM.name) - Snapshots found"
                }
            }
        }

	}
}


# Thanks to Luc's article: http://www.lucd.info/viproperties/
# Usage: Get-VM -Name TST* | select Name, CBTEnabled

#Requires -Modules VMware.VimAutomation.Core, @{ModuleName="VMware.VimAutomation.Core";ModuleVersion="6.3.0.0"}
New-VIProperty -Name CBTEnabled -ObjectType VirtualMachine -ValueFromExtensionProperty "Config.ChangeTrackingEnabled" -Force