PureStorage.CBS.AVS.VMFS.ps1

. $PSScriptRoot/PureStorage.CommonUtil.ps1
function Get-PfaVolumeFromVMFSDataStore {
    Param(
        [Parameter(mandatory=$true)]
        $FlashArray,

        [Parameter(mandatory=$true)]
        $DataStore
    )
    $Lun = $Datastore.ExtensionData.Info.Vmfs.Extent.DiskName |select-object -unique
    if ($Lun -like 'naa.624a9370*')
    {
        $VolSerial = ($lun.ToUpper()).substring(12)
        $PureVol = Get-Pfa2Volume -Array $FlashArray -Filter "Serial='$VolSerial'"
    }
    else
    {
        throw "This VMFS is not hosted on Pure Cloud Block Store."
    }

    return $PureVol
}

function Remove-PfaVmfsDatastore {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)]
        $Cluster,

        [Parameter(Mandatory=$true)]
        $Datastore,

        [Parameter(ValueFromPipeline=$True)]
        $FlashArray,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )


    $PureVol = Get-PfaVolumeFromVMFSDataStore -FlashArray $FlashArray -Datastore $Datastore

    Write-Progress -Activity "Dismounting datastore" -Status "25% Complete:" -PercentComplete 25
    $params = @{
        ClusterName = $Cluster.Name;
        DatastoreName = $Datastore.Name
    }
    # Question: We just do unmount/detach at VMWare side. Do we need to run Remove-Datastore to clean the datastore?
    Invoke-RunScript -RunCommandName "Dismount-VmfsDatastore" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

    Write-Progress -Activity "Removing volume" -Status "50% Complete:" -PercentComplete 50
    # Remove volume from array hostgroup if available
    $FaHg = Get-PfaHostGroupfromVcCluster -Flasharray $Flasharray -Cluster $Cluster -Logger $Logger
    $HgConnection = Get-Pfa2Connection -Array $FlashArray -VolumeNames $PureVol.Name -HostGroupNames $FaHg.Name -ErrorAction SilentlyContinue
    if ($HgConnection) {
        $Logger.LogInfo("Removing volume $($PureVol.Name) from host group $($FaHg.Name)...")
        Remove-Pfa2Connection -Array $FlashArray -VolumeNames $PureVol.Name -HostGroupNames $FaHg.Name
    }

    # Destroy volume if there is no host/hg connections for the volume
    $Connections = Get-Pfa2Connection -Array $FlashArray -VolumeNames $PureVol.Name
    if (-not $Connections) {
        $Logger.LogInfo("Destroying volume $($PureVol.Name)...")
        Remove-Pfa2Volume -Array $FlashArray -Name $PureVol.Name -Confirm:$false
    }

    Write-Progress -Activity "Rescanning storage" -Status "75% Complete:" -PercentComplete 75
    $params = @{
        ClusterName = $Cluster.Name;
    }
    Invoke-RunScript -RunCommandName "Sync-ClusterVMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger
}

function New-VolumeFromSnapshot {
    [CmdletBinding()]
    Param(
        [Parameter(ValueFromPipeline=$True)]
        $FlashArray,

        [Parameter(Mandatory=$true)]
        [String]$SnapshotName,

        [Parameter(Mandatory=$true)]
        $Logger
    )

    $VolumeSnapshot = Get-Pfa2VolumeSnapshot -Array $FlashArray -Name $SnapshotName -ErrorAction Ignore
    if (-not $VolumeSnapshot) {
        throw "Could not find snapshot '$SnapshotName'."
    }

    if ($VolumeSnapshot.Source.Name) {
        # If the original volume still exist
        $VolumeName = $volumeSnapshot.Source.Name + "-"+ (Get-Random -Minimum 10000000 -Maximum 99999999)
    } else {
        # If the original volume is missing, get volume name from snapshot name
        # Get Alphanumeric string from snapshot
        $FilteredSnapshotName = $SnapshotName -replace "[^a-zA-Z0-9]"
        $VolumeName = $FilteredSnapshotName + "-volcopy-"+ (Get-Random -Minimum 10000000 -Maximum 99999999)
    }
    $newVol = New-PfaVolumeByPrefix -FlashArray $FlashArray -Name $VolumeName -SourceName $SnapshotName -Logger $Logger

    return $newVol
}

function Restore-PfaVmfsFromProtectionGroupSnapshot {
    <#
    .SYNOPSIS
      Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store protection groupsnapshot.
    .DESCRIPTION
      Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted.
    .INPUTS
      Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster.
    .OUTPUTS
      Returns the new datastore.
    #>

    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]
        $Cluster,

        [Parameter(ValueFromPipeline=$True)]
        $FlashArray,

        [Parameter(Mandatory=$true)]
        [String]$ProtectionGroupSnapshotName,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,


        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )

    $NewDatastore = @()
    # Verify snapshot exist
    $ProtectionGroupSnapshot = Get-Pfa2ProtectionGroupSnapshot -Array $FlashArray -Name $ProtectionGroupSnapshotName -ErrorAction Ignore
    if (-not $ProtectionGroupSnapshot) {
        throw "Protection group snapshot $ProtectionGroupSnapshotName does not exist."
    }
    $VolumeSnapshots = Get-Pfa2VolumeSnapshot -Array $FlashArray -Filter "Name='$($ProtectionGroupSnapshotName).*'"
    foreach ($VolumeSnapshot in $VolumeSnapshots) {
        try {
            $NewDatastore += Restore-PfaVmfsFromVolumeSnapshot -FlashArray $FlashArray -Cluster $Cluster -VolumeSnapshotName $VolumeSnapshot.Name `
                                -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger
        } catch {
            $Logger.LogError("Failed to restore datastore from protection group $ProtectionGroupSnapshotName using volume snapshot $($VolumeSnapshot.Name)")
            $Logger.LogError($_.Exception.Message)
        }
    }

    if (-not $NewDatastore) {
        throw "No datastore was restored from protection group snapshot $ProtectionGroupSnapshotName."
    }

    return $NewDatastore
}

function Restore-PfaVmfsFromPod {
    <#
    .SYNOPSIS
      Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store protection groupsnapshot.
    .DESCRIPTION
      Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted.
    .INPUTS
      Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster.
    .OUTPUTS
      Returns the new datastore.
    #>

    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]
        $Cluster,

        [Parameter(ValueFromPipeline=$True)]
        $FlashArray,

        [Parameter(Mandatory=$true)]
        [String]$PodName,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,


        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )

    $NewDatastore = @()
    # Verify the pod exists
    $Pod = Get-Pfa2Pod -Array $FlashArray -Name $PodName -ErrorAction Ignore
    if (-not $Pod) {
        throw "Pod $PodName does not exist."
    }
    $Volumes = Get-Pfa2Volume -Array $FlashArray -Filter "Name='$($PodName)::*'"
    foreach ($Volume in $Volumes) {
        try {
            $NewDatastore += Restore-PfaVmfsFromVolume -FlashArray $FlashArray -Cluster $Cluster -VolumeName $Volume.Name `
                                -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger
        } catch {
            $Logger.LogError("Failed to restore datastore from pod $PodName using volume $($Volume.Name)")
            $Logger.LogError($_.Exception.Message)
        }
    }

    if (-not $NewDatastore) {
        throw "No datastore was restored from pod $PodName."
    }

    return $NewDatastore
}

function Restore-PfaVmfsFromVolumeSnapshot {
    <#
    .SYNOPSIS
      Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store snapshot.
    .DESCRIPTION
      Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted.
    .INPUTS
      Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster.
    .OUTPUTS
      Returns the new datastore.
    #>

    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]
        $Cluster,

        [Parameter(ValueFromPipeline=$True)]
        $FlashArray,

        [Parameter(Mandatory=$true)]
        [String]$VolumeSnapshotName,

        [Parameter(Mandatory=$false)]
        [String]$DatastoreName,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )

    $hostGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -FlashArray $FlashArray -Logger $Logger

    # Create volume from the volume snapshot
    $VolumesForRestore = New-VolumeFromSnapshot -FlashArray $FlashArray -SnapshotName $VolumeSnapshotName -Logger $Logger

    try {
        $NewDatastore = Restore-PfaVmfsFromVolume -FlashArray $FlashArray -Cluster $Cluster -VolumeName $VolumesForRestore.Name ` -DatastoreName $DatastoreName `
                            -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger
    } catch {
        # Clean up created volume if restore failed
        $Logger.LogInfo("Failed to restore datastore from the volume snapshot $($VolumeSnapshotName)...")
        $Logger.LogInfo("Cleaning up the volume $($VolumesForRestore.name) created from $($VolumeSnapshotName)...")
        Remove-Pfa2Connection -Array $FlashArray -HostgroupNames $hostGroup.name -VolumeNames $VolumesForRestore.name -ErrorAction SilentlyContinue
        Remove-Pfa2Volume -Array $FlashArray -Name $VolumesForRestore.name -Confirm:$false -ErrorAction SilentlyContinue
        Remove-Pfa2Volume -Array $FlashArray -Name $VolumesForRestore.name -Eradicate -Confirm:$false -ErrorAction SilentlyContinue
        throw
    }


    return $NewDatastore
}

function Restore-PfaVmfsFromVolume {
    <#
    .SYNOPSIS
      Mounts a copy of a VMFS datastore to a VMware cluster from a Pure Storage Block Store volume.
    .DESCRIPTION
      Takes in a snapshot name, the corresponding Pure Storage Block Store, and a cluster. The VMFS copy will be resignatured and mounted.
    .INPUTS
      Pure Cloud Block Store connection, a VolumeSnapshot, and a cluster.
    .OUTPUTS
      Returns the new datastore.
    #>

    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true,ValueFromPipeline=$True)]
        $Cluster,

        [Parameter(ValueFromPipeline=$True)]
        $FlashArray,

        [Parameter(Mandatory=$true)]
        [String]$VolumeName,

        [Parameter(Mandatory=$false)]
        [String]$DatastoreName,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )

    $Volume = Get-Pfa2Volume -Array $FlashArray -Name $VolumeName -ErrorAction Ignore
    if (-not $Volume) {
        throw "Volume $VolumeName does not exist."
    }

    $newNAA =  "naa.624a9370" + $Volume.serial.toLower()
    $Datastore = Get-Datastore -ErrorAction stop | Where-Object {$_.ExtensionData.Info.Vmfs.Extent.DiskName -eq $newNAA}
    if ($Datastore) {
        throw "Datastore $($Datastore.Name) is using the volume $VolumeName. Please use a different volume. You can manually create a new volume copy from volume $VolumeName and restore the datastore from the new volume."
    }

    $hostGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -FlashArray $FlashArray -Logger $Logger

    Write-Progress -Activity "Connecting volume" -Status "25% Complete:" -PercentComplete 25
    $Logger.LogInfo("Connecting volume $($Volume.Name) to host group $($hostGroup.Name)...")
    $Connection = Get-Pfa2Connection -Array $FlashArray -VolumeName $($Volume.Name) -HostGroupName $hostGroup.name -ErrorAction Ignore

    if ($Connection) {
        $Logger.LogInfo("Volume $($Volume.Name) is already connected to host group $($hostGroup.Name). Using the existing connection...")
    } else {
        New-Pfa2Connection -Array $FlashArray -VolumeName $($Volume.Name) -HostGroupName $hostGroup.name | Out-Null
    }

    $esxi = $cluster | Get-VMHost| where-object {($_.ConnectionState -eq 'Connected')} | Select-Object -last 1
    Write-Progress -Activity "Rescanning storage" -Status "50% Complete:" -PercentComplete 50
    $Logger.LogInfo("Rescanning HBA...")
    $params = @{
        VMHostName = $esxi.Name;
    }
    Invoke-RunScript -RunCommandName "Sync-VMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

    Write-Progress -Activity "Restoring volume" -Status "75% Complete:" -PercentComplete 75
    $params = @{
            ClusterName = $Cluster.Name;
            DeviceNaaId = $newNAA
            DatastoreName = $DatastoreName
    }

    $Logger.LogInfo("Restoring VMFS Datastore $($DatastoreName) from volume $($Volume.Name)...")

    Invoke-RunScript -RunCommandName  "Restore-VmfsVolume" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

    $NewDatastore = Get-Datastore -ErrorAction stop | Where-Object {$_.ExtensionData.Info.Vmfs.Extent.DiskName -eq $newNAA}

    if (-not $NewDatastore) {
        throw "Failed to restore datastore from volume $($Volume.Name)."
    }

    return $NewDatastore
}

function New-PfaVolumeByPrefix {
    Param (
        [Parameter(Mandatory=$true)]
        [string] $Name,


        [ValidateRange(1GB,64TB)] # 1 GB to 64 TB
        [Parameter(Mandatory=$false)]
        [UInt64] $Size,

        [Parameter(Mandatory=$True)]
        $Flasharray,

        [Parameter(Mandatory=$false)]
        [string] $SourceName,

        [Parameter(Mandatory=$false)]
        [string] $PodName,

        [Parameter(Mandatory=$false)]
        [switch] $NoDefaultProtection,

        [Parameter(Mandatory=$true)]
        $Logger
    )
    # Create a volume with the specified name. If the name already exists in the array, use it as a prefix
    $maxTries = 20
    $count = 0
    $existingVolume = $null
    # Get base volume name from source volume reflected in pure snapshot object
    # Source volume name possibility:
    # regular volume snapshot: testvol
    # pod volume snapshot: testpod::testacvol
    # array replicated volume snapshot: msconnect-ff-flasharray-1:testvol
    $BaseName = $Name.split(":")[-1]

    # Truncate the name if it is too large
    if ($BaseName.Length -gt 53) {
        $BaseName = $BaseName.Substring(0,53).TrimEnd("-")
    }

    # If a PodName is specified, verify the pod exists
    if ($PodName) {
        $pod = Get-Pfa2Pod -Array $FlashArray -Name $PodName -ErrorAction Ignore
        if (-not $pod) {
            throw "Pod '$PodName' does not exist."
        }
        $BaseName = "$PodName::$BaseName"
    }
    $volName = $BaseName
    $existingVolume = Get-Pfa2Volume -Array $Flasharray  -Name $volName -ErrorAction SilentlyContinue
    while ($existingVolume -and $count -lt $maxTries) {
        $count = $count + 1
        $volName = "$BaseName-$count"
        $existingVolume = Get-Pfa2Volume -Array $Flasharray  -Name $volName -ErrorAction SilentlyContinue
    }
    if ($existingVolume) {
        # We exhausted the max number of tries
        throw "Could note create a volume based on the Name '$Name', please select a unique volume name"
    }
    $Logger.LogInfo("Creating volume $volName...")
    $UseDefaultProtection = -not $NoDefaultProtection.IsPresent
    if ($SourceName) {
        # Create a volume from a snapshot
        $vol = New-Pfa2Volume -Array $FlashArray -Name $volName -SourceName $SourceName -WithDefaultProtection $UseDefaultProtection -ErrorAction Stop
    }
    else {
        # Create a fresh volume
        $vol = New-Pfa2Volume -Array $FlashArray -Name $volName -Provisioned $Size -WithDefaultProtection $UseDefaultProtection -ErrorAction Stop
    }
    return $vol

}
function New-PfaVmfs {
    <#
    .SYNOPSIS
      Create a new VMFS on a new Pure Cloud Block Store volume
    .DESCRIPTION
      Creates a new VMFS on Pure Cloud Block Store and presents it to a cluster.
    .INPUTS
      FlashArray connection, a vCenter cluster, a volume size, and name.
    .OUTPUTS
      Returns a VMFS object.
    #>


    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)]
        [VMware.VimAutomation.ViCore.Types.V1.Inventory.Cluster]$Cluster,

        [Parameter(Mandatory=$True)]
        $Flasharray,

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

        [Parameter(Mandatory=$true)]
        $vCenterServer,

        [ValidateRange(1GB,64TB)] # 1 GB to 64 TB
        [Parameter(Mandatory=$true)]
        [UInt64]$Size,

        [Parameter(Mandatory=$false)]
        [string] $PodName,

        [Parameter(Mandatory=$false)]
        [switch] $NoDefaultProtection,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )
    Write-Progress -Activity "Creating volume" -Status "25% Complete:" -PercentComplete 25
    $datastore = Get-Datastore -Server $vCenterServer  -Name $Name -ErrorAction Ignore
    if ($Datastore) {
        $Vmhost = $Cluster | Get-VMHost
        $HostDatastoreInfo = $Datastore.ExtensionData.Host
        $HasNotConnectedHost = $HostDatastoreInfo.MountInfo| Where-Object {$_.Accessible -ne $True -or $_.Mounted -ne $True}
        if ($HostDatastoreInfo.Count -ne $Vmhost.Count -or $HasNotConnectedHost) {
            $Logger.LogWarning("Datastore '$Name' already exists but not connected to all hosts in the cluster. Trying to connect the datastore to all hosts in the cluster...")
            $params = @{
                ClusterName = $Cluster.Name;
            }
            Invoke-RunScript -RunCommandName "Sync-ClusterVMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger
            $Logger.LogInfo("Rescanning finished. Datastore '$Name' is now connected to all hosts in the cluster. If not, please check if hosts are in a good state and use the diagnostic tool in this module to test network connection.")
            return
        } else {
            throw "Cannot create the datastore. Datastore '$Name' already exists!"
        }
    }
    $hostGroup = Get-PfaHostGroupfromVcCluster -cluster $cluster -FlashArray $FlashArray -Logger $Logger -ErrorAction Stop

    $newVol = New-PfaVolumeByPrefix -FlashArray $FlashArray -Name $Name -Size $Size -NoDefaultProtection:$NoDefaultProtection.IsPresent -PodName $PodName -Logger $Logger -ErrorAction Stop
    New-Pfa2Connection -Array $FlashArray -HostGroupNames $hostGroup.Name -VolumeNames $newVol.Name | Out-Null
    Write-Progress -Activity "Rescanning storage" -Status "50% Complete:" -PercentComplete 50
    $newNAA = "naa.624a9370" + $newVol.serial.toLower()
    $Logger.LogInfo("Rescanning storage...")
    $params = @{
        ClusterName = $Cluster.Name;
    }
    Invoke-RunScript -RunCommandName "Sync-ClusterVMHostStorage" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

    $Logger.LogDebug("NAA for datastore $Name is $newNAA")
    Write-Progress -Activity "Creating datastore" -Status "75% Complete:" -PercentComplete 75
    try {
        $params = @{
            ClusterName = $Cluster.Name;
            DatastoreName = $Name;
            DeviceNaaId = $newNAA;
            Size = $Size
        }
        Invoke-RunScript -RunCommandName  "New-VmfsDatastore" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
            -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger
    }
    catch {
        # Cleanup
        Remove-Pfa2Connection -Array $Flasharray -HostGroupNames $hostGroup.Name -VolumeNames $newVol.Name
        Remove-Pfa2Volume -Array $Flasharray -Name $newVol.Name -Confirm:$false | Out-Null
        Remove-Pfa2Volume -Array $Flasharray -Name $newVol.Name -Eradicate -Confirm:$false| Out-Null
        throw
    }
}


function Set-PfaVmfsCapacity {
    [CmdletBinding()]
    Param(
        [Parameter(Mandatory=$true)]
        $Cluster,

        [Parameter(Position=0,ValueFromPipeline=$True)]
        $Flasharray,

        [Parameter(Position=1,mandatory=$true,ValueFromPipeline=$True)]
        $Datastore,

        [Parameter(mandatory=$false)]
        [UInt64]$SizeInByte,

        [Parameter(Mandatory=$false)]
        [String]$AVSCloudName,

        [Parameter(Mandatory=$false)]
        [String]$AVSResourceGroup,

        [Parameter(Mandatory=$false)]
        [int]$TimeoutInMinutes = 10,

        [Parameter(Mandatory=$true)]
        $Logger
    )

    Write-Progress -Activity "Resizing volume" -Status "25% Complete:" -PercentComplete 25


    $pureVol = Get-PfaVolumeFromVMFSDataStore -Flasharray $FlashArray -Datastore $Datastore
    $Size = Get-FriendlySize -SizeInByte $SizeInByte
    $CurrentSize = Get-FriendlySize -SizeInByte $pureVol.Provisioned
    if ($SizeInByte -lt $pureVol.Provisioned)
    {
        throw "The new specified size '$Size' is not larger than the current size '$CurrentSize'. ESXi does not permit VMFS volumes to be shrunk--please specify a size larger than the existing."
    }
    elseif ($SizeInByte -eq $pureVol.Provisioned) {
        # Resize operation might not have been completed in the past, try again

        # Check if the datastore was already resizes
        $CapacityDiff = ($SizeInByte - $Datastore.CapacityGB * 1GB) / 1GB
        if ($CapacityDiff -lt 0) {
            throw "Cannot resize datastore to lower capacity than $($Datastore.CapacityGB)GB"
        }
        if ($CapacityDiff -le 1) {
            # Difference is negligible. Might be due to VMWare reserved capacity
            $Logger.LogWarning("Datastore '$Datastore.Name' is already set to requested capacity.")
            return
        }
        $Logger.LogWarning("Volume $($pureVol.Name) is already set at the requested capacity. Refreshing datastore object on AVS..")
    }
    else {
        $Logger.LogInfo("Increasing the size of the volume $($pureVol.Name) to $Size on Pure Cloud Block Store...")

        # FlashArray only accept byte that is multiple of 512. If not, we round up by 512
        $SizeInByte = [math]::ceiling($SizeInByte/512) * 512

        Update-Pfa2Volume -Array $FlashArray -Name $pureVol.Name -Provisioned $SizeInByte | Out-Null
    }

    Write-Progress -Activity "Resizing datastore" -Status "50% Complete:" -PercentComplete 50
    $params = @{
        ClusterName = $Cluster.Name;
        DeviceNaaId = $Datastore.ExtensionData.Info.Vmfs.Extent.DiskName
    }
    Invoke-RunScript -RunCommandName "Resize-VmfsVolume" -RunCommandModule "Microsoft.AVS.VMFS" -Parameters $params `
        -AVSCloudName $AVSCloudName -AVSResourceGroup $AVSResourceGroup -TimeoutInMinutes $TimeoutInMinutes -Logger $Logger

}

function Get-FriendlySize {
    [CmdletBinding()]
    Param(
        [Parameter(mandatory=$false)]
        [UInt64]$SizeInByte
    )

    $SizeInGB = $SizeInByte / 1024 / 1024 / 1024

    if ($SizeInGB -ge 1024) {
        $SizeInTB = $SizeInGB/1024
        return "$([math]::Round($SizeInTB, 2)) TB"
    } else {
        return "$([math]::Round($SizeInGB, 2)) GB"
    }
}


# SIG # Begin signature block
# MIIpRQYJKoZIhvcNAQcCoIIpNjCCKTICAQExDzANBglghkgBZQMEAgEFADB5Bgor
# BgEEAYI3AgEEoGswaTA0BgorBgEEAYI3AgEeMCYCAwEAAAQQH8w7YFlLCE63JNLG
# KX7zUQIBAAIBAAIBAAIBAAIBADAxMA0GCWCGSAFlAwQCAQUABCDRmdLQBLXUq5sd
# qkYbljzCN/CL4tt4Ny//O4vAyKlR0qCCDfIwggbmMIIEzqADAgECAhB3vQ4DobcI
# +FSrBnIQ2QRHMA0GCSqGSIb3DQEBCwUAMFMxCzAJBgNVBAYTAkJFMRkwFwYDVQQK
# ExBHbG9iYWxTaWduIG52LXNhMSkwJwYDVQQDEyBHbG9iYWxTaWduIENvZGUgU2ln
# bmluZyBSb290IFI0NTAeFw0yMDA3MjgwMDAwMDBaFw0zMDA3MjgwMDAwMDBaMFkx
# CzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52LXNhMS8wLQYDVQQD
# EyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0EgMjAyMDCCAiIwDQYJ
# KoZIhvcNAQEBBQADggIPADCCAgoCggIBANZCTfnjT8Yj9GwdgaYw90g9z9DljeUg
# IpYHRDVdBs8PHXBg5iZU+lMjYAKoXwIC947Jbj2peAW9jvVPGSSZfM8RFpsfe2vS
# o3toZXer2LEsP9NyBjJcW6xQZywlTVYGNvzBYkx9fYYWlZpdVLpQ0LB/okQZ6dZu
# bD4Twp8R1F80W1FoMWMK+FvQ3rpZXzGviWg4QD4I6FNnTmO2IY7v3Y2FQVWeHLw3
# 3JWgxHGnHxulSW4KIFl+iaNYFZcAJWnf3sJqUGVOU/troZ8YHooOX1ReveBbz/IM
# BNLeCKEQJvey83ouwo6WwT/Opdr0WSiMN2WhMZYLjqR2dxVJhGaCJedDCndSsZlR
# Qv+hst2c0twY2cGGqUAdQZdihryo/6LHYxcG/WZ6NpQBIIl4H5D0e6lSTmpPVAYq
# gK+ex1BC+mUK4wH0sW6sDqjjgRmoOMieAyiGpHSnR5V+cloqexVqHMRp5rC+QBmZ
# y9J9VU4inBDgoVvDsy56i8Te8UsfjCh5MEV/bBO2PSz/LUqKKuwoDy3K1JyYikpt
# WjYsL9+6y+JBSgh3GIitNWGUEvOkcuvuNp6nUSeRPPeiGsz8h+WX4VGHaekizIPA
# tw9FbAfhQ0/UjErOz2OxtaQQevkNDCiwazT+IWgnb+z4+iaEW3VCzYkmeVmda6tj
# cWKQJQ0IIPH/AgMBAAGjggGuMIIBqjAOBgNVHQ8BAf8EBAMCAYYwEwYDVR0lBAww
# CgYIKwYBBQUHAwMwEgYDVR0TAQH/BAgwBgEB/wIBADAdBgNVHQ4EFgQU2rONwCSQ
# o2t30wygWd0hZ2R2C3gwHwYDVR0jBBgwFoAUHwC/RoAK/Hg5t6W0Q9lWULvOljsw
# gZMGCCsGAQUFBwEBBIGGMIGDMDkGCCsGAQUFBzABhi1odHRwOi8vb2NzcC5nbG9i
# YWxzaWduLmNvbS9jb2Rlc2lnbmluZ3Jvb3RyNDUwRgYIKwYBBQUHMAKGOmh0dHA6
# Ly9zZWN1cmUuZ2xvYmFsc2lnbi5jb20vY2FjZXJ0L2NvZGVzaWduaW5ncm9vdHI0
# NS5jcnQwQQYDVR0fBDowODA2oDSgMoYwaHR0cDovL2NybC5nbG9iYWxzaWduLmNv
# bS9jb2Rlc2lnbmluZ3Jvb3RyNDUuY3JsMFYGA1UdIARPME0wQQYJKwYBBAGgMgEy
# MDQwMgYIKwYBBQUHAgEWJmh0dHBzOi8vd3d3Lmdsb2JhbHNpZ24uY29tL3JlcG9z
# aXRvcnkvMAgGBmeBDAEEATANBgkqhkiG9w0BAQsFAAOCAgEACIhyJsav+qxfBsCq
# jJDa0LLAopf/bhMyFlT9PvQwEZ+PmPmbUt3yohbu2XiVppp8YbgEtfjry/RhETP2
# ZSW3EUKL2Glux/+VtIFDqX6uv4LWTcwRo4NxahBeGQWn52x/VvSoXMNOCa1Za7j5
# fqUuuPzeDsKg+7AE1BMbxyepuaotMTvPRkyd60zsvC6c8YejfzhpX0FAZ/ZTfepB
# 7449+6nUEThG3zzr9s0ivRPN8OHm5TOgvjzkeNUbzCDyMHOwIhz2hNabXAAC4ShS
# S/8SS0Dq7rAaBgaehObn8NuERvtz2StCtslXNMcWwKbrIbmqDvf+28rrvBfLuGfr
# 4z5P26mUhmRVyQkKwNkEcUoRS1pkw7x4eK1MRyZlB5nVzTZgoTNTs/Z7KtWJQDxx
# pav4mVn945uSS90FvQsMeAYrz1PYvRKaWyeGhT+RvuB4gHNU36cdZytqtq5NiYAk
# CFJwUPMB/0SuL5rg4UkI4eFb1zjRngqKnZQnm8qjudviNmrjb7lYYuA2eDYB+sGn
# iXomU6Ncu9Ky64rLYwgv/h7zViniNZvY/+mlvW1LWSyJLC9Su7UpkNpDR7xy3bzZ
# v4DB3LCrtEsdWDY3ZOub4YUXmimi/eYI0pL/oPh84emn0TCOXyZQK8ei4pd3iu/Y
# TT4m65lAYPM8Zwy2CHIpNVOBNNwwggcEMIIE7KADAgECAgxcuW61kTkv+4t8zgQw
# DQYJKoZIhvcNAQELBQAwWTELMAkGA1UEBhMCQkUxGTAXBgNVBAoTEEdsb2JhbFNp
# Z24gbnYtc2ExLzAtBgNVBAMTJkdsb2JhbFNpZ24gR0NDIFI0NSBDb2RlU2lnbmlu
# ZyBDQSAyMDIwMB4XDTI0MDMxMTE0MDQxMloXDTI3MDMxMjE0MDQxMlowcjELMAkG
# A1UEBhMCVVMxEzARBgNVBAgTCkNhbGlmb3JuaWExFDASBgNVBAcTC1NhbnRhIENs
# YXJhMRswGQYDVQQKExJQdXJlIFN0b3JhZ2UsIEluYy4xGzAZBgNVBAMTElB1cmUg
# U3RvcmFnZSwgSW5jLjCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAMCQ
# rioSn48IvHpTg5dofsUYj/pNTDidwjYUrcxVu78NoyhSweG8FhcxDi/SI40+8Fcc
# l3D5ZoqpjkFnGhzSwmpxU3J4AP7+fdTZht9eWD1I5qKY07esYwdPDV4yg+csPfdG
# PqI2XjRfT5UC3YkXQeUrX8KQZldD4KqvgxzpYcuBwsgHbTb/eArpi68YgFR2jgZG
# yZigfy8RuJMrL1thcBOe/VWjUyK21wVT8cuunBYFaStLHhsRBRMDcZBDuTSGC4ev
# E6oaCqlQbdMl9YFJ64mDQsKlCxrr7rmLVtcVzKGwmjp4b2xRwE+RmTh6JtrUL9Wx
# /3a3UzgAnDNimfwp85zoL48kyLtHqQ3FI8tVKGm+aBOgBZfmURoy7fbp4zKhGgqF
# bpOmILO16i4f999YsEEJQgIF3CtyH1R60/ZZWlDmoeeEgjAGrnd14muU5Hk3Cksr
# 43uPUAg+fV78Y0fDV85ibm42ZwwPuz6MI4HhYNUlGzRwIQ31vjaGuAMWHNqFKkcO
# 0JuIeHQ/gFKPnYIxnGC9H9R4Kw/uMezqtnYJwGU2epB/ABl/w7U4NgU2ZOxWB5BF
# y4frZ3f+hNgbjFUjMaXnVFotOJxXntzjdSl4znw8DaKiC5ooChteZMITG9p078p/
# TUsOJQbUtFADSY1hsfCfB7t+gJSNt5peS9GOZIMVAgMBAAGjggGxMIIBrTAOBgNV
# HQ8BAf8EBAMCB4AwgZsGCCsGAQUFBwEBBIGOMIGLMEoGCCsGAQUFBzAChj5odHRw
# Oi8vc2VjdXJlLmdsb2JhbHNpZ24uY29tL2NhY2VydC9nc2djY3I0NWNvZGVzaWdu
# Y2EyMDIwLmNydDA9BggrBgEFBQcwAYYxaHR0cDovL29jc3AuZ2xvYmFsc2lnbi5j
# b20vZ3NnY2NyNDVjb2Rlc2lnbmNhMjAyMDBWBgNVHSAETzBNMEEGCSsGAQQBoDIB
# MjA0MDIGCCsGAQUFBwIBFiZodHRwczovL3d3dy5nbG9iYWxzaWduLmNvbS9yZXBv
# c2l0b3J5LzAIBgZngQwBBAEwCQYDVR0TBAIwADBFBgNVHR8EPjA8MDqgOKA2hjRo
# dHRwOi8vY3JsLmdsb2JhbHNpZ24uY29tL2dzZ2NjcjQ1Y29kZXNpZ25jYTIwMjAu
# Y3JsMBMGA1UdJQQMMAoGCCsGAQUFBwMDMB8GA1UdIwQYMBaAFNqzjcAkkKNrd9MM
# oFndIWdkdgt4MB0GA1UdDgQWBBSzJ9KiDCa3UBiAajy+Iioj5kQjzDANBgkqhkiG
# 9w0BAQsFAAOCAgEAHsFQixeQEcoHurq9NWSUt4S39Q+UGP6crmVq3Wwy9g23YbdW
# g+SgMxoLUqdoDfA4k4B6Dyoo0jEQzn2kxnsnT9lNHKrcZHH88dv0hjfiH2qAiQWa
# zPjS3LhK2J6nhpyipJPpyRaSQG4x4aG0NB2D4WUfUz9CGAYsERJGww/wkTaaxMip
# ttKDTaI1C49u1igDfRzIO+Q8vuyyBFLiYTno/df97xtjNC+KxxFhDhl/4tawK6kw
# xaVzCMAfj48I67Wbo4DMH6pM1s19as7c3qp92i3MylGKsB6+u+o7UkbSdLNkS4AL
# I33CJOUc+GoK3Nt5IXXCFJTQFHBXkBdAur3gmlXEm8vlNG/1Sbxr0H7T1e7ABGH/
# 48o/+PeMLuCc72EeK5dJ4cX9NEQ3QnTsZHwGnYzjEOvOvP0s1c7yNsDbcUHoIqQv
# b5xS5aqMU5G+8sdPQ1nwpPf7gGaEEbAVW4w51Pam42qeN9HIPa+ZinXnsN02Kk1Q
# w0QwUqzaQy9W/gIquI0KOjw0LmoW9M/8S0lrjpEq2eEeUw9WQLhhUEIirFxGPtjq
# iCLiiS9CZ+kf2vWLJKUspkYv+OHT3q805Zg1dJsBFAzEYUFLb1mhmigDEO9bsMor
# jECIL2ijE5zHtbGkalrrsPWu8tiDT/B7P9GSYzKfOOy4PoOIfWSK0IxlS7Ixghqp
# MIIapQIBATBpMFkxCzAJBgNVBAYTAkJFMRkwFwYDVQQKExBHbG9iYWxTaWduIG52
# LXNhMS8wLQYDVQQDEyZHbG9iYWxTaWduIEdDQyBSNDUgQ29kZVNpZ25pbmcgQ0Eg
# MjAyMAIMXLlutZE5L/uLfM4EMA0GCWCGSAFlAwQCAQUAoIGXMBkGCSqGSIb3DQEJ
# AzEMBgorBgEEAYI3AgEEMBwGCisGAQQBgjcCAQsxDjAMBgorBgEEAYI3AgEVMCsG
# CisGAQQBgjcCAQwxHTAboRmAF2h0dHBzOi8vcHVyZXN0b3JhZ2UuY29tMC8GCSqG
# SIb3DQEJBDEiBCBh0/LifMCnRlIaaYB0Ac7Yjv4TtKlzA9s+0Q0KEt9WkTANBgkq
# hkiG9w0BAQEFAASCAgAwND2jOVcakvIq/MqGbnAkJzSmcclJDLQNBtMBVeOFQg4n
# /lepvtnCQ1hMTDOj851IaJXmHOs/rsS+ct7o6X0Lw3OSEIiWemAw6ItBRa8OXwLb
# jZms2GJ2H33OyohGu/eNhf2xXcv6vNK57KZqImBzRikVMUSpCpPQHbbuPb7GNyPg
# 0g8tHiJcsA6yoXcBhWfTC2N/Ux00bRdZNK9yI4ms1wDoi/DP1sr8IDk9n912AFB2
# vKCVrYsYv+64QMngHOgqvhYzN2EgEoXt5qLIjylazjH3vI4CPUyyMYf691HYSBff
# WCgjVYYGSNILuAyNpHFXi7KwFTwaT5xtzA7LnAKrOkwEN2gq6Hfr8PDjve3ozvtX
# HNWDzXIaBX7tQ4afT6jgXFh4wgAlTOnSj3nJfGy3C5gjoXYPj+Vde3lN+NfyuSu9
# j4nOlArzvOuiEjg8PMwiop4xp88v+l10fOp6R+XL7mcg8LmVh2GOoH1j1sDgI5W5
# c24p2bWZ68XCQEDwvHR1nk20lsOXj/7Qt+/L/W7vVC94AcQosXXl9IkYrwuHACPC
# sVPG7s7fK9P6p7eyf5NGzHUVUXQrOCq88a+9e1KB9MhjCdpysoL7pcpSJDmR08wL
# V5qFht069NHL7qKRK6NWuaiHuvqG2/DglmE9jLCRV63mL3ekdN+t/ByDBHCv1aGC
# F3cwghdzBgorBgEEAYI3AwMBMYIXYzCCF18GCSqGSIb3DQEHAqCCF1AwghdMAgED
# MQ8wDQYJYIZIAWUDBAIBBQAweAYLKoZIhvcNAQkQAQSgaQRnMGUCAQEGCWCGSAGG
# /WwHATAxMA0GCWCGSAFlAwQCAQUABCBmcsfA4UD26LO9FE9HrJyydUDqq3+7RvgW
# lBNuU0b8pAIRAIV5AyFv+5Kxei2aT7kk4IIYDzIwMjYwOTMwMTM0NTI5WqCCEzow
# ggbtMIIE1aADAgECAhAIT9wzT35FTtvDD4/5khg1MA0GCSqGSIb3DQEBCwUAMGkx
# CzAJBgNVBAYTAlVTMRcwFQYDVQQKEw5EaWdpQ2VydCwgSW5jLjFBMD8GA1UEAxM4
# RGlnaUNlcnQgVHJ1c3RlZCBHNCBUaW1lU3RhbXBpbmcgUlNBNDA5NiBTSEEyNTYg
# MjAyNSBDQTEwHhcNMjYwODA1MDAwMDAwWhcNMzcxMTA0MjM1OTU5WjBjMQswCQYD
# VQQGEwJVUzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xOzA5BgNVBAMTMkRpZ2lD
# ZXJ0IFNIQTI1NiBSU0E0MDk2IFRpbWVzdGFtcCBSZXNwb25kZXIgMjAyNiAxMIIC
# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtnum8sn+zUr41JtMZbP9OMYw
# +HwJDpG5xkIu/lqcfNYmMX81YmsUiHLbh9ykpeWBGKTLhYBrAN9Tdg/QEzG32XcO
# bmgIblnr0CoQ3WSAeDZ6nH6X6VkFyYkJw3QBJREwvm4UhLzSxmwPA7cFKRTEOMsm
# EEj6qJk/dqLEAL+oQYuOwE2UuiX1Vnul8YReIyWd4kgLn9gq6LNXM0UplkR6jL/Q
# Hxmb6fMoGBJYbnaUI7XD6cKDpekK2SVMld4iDbzeHDtOaaxldH5IxuNusQ69nd8/
# ZXEiB5Hbxj3RlK13cX1W4DlFXKdv/CEhM8Cj1vvlmvhNroyPdRGbbpBlgyf8Wdu5
# N6ByhFwURn0U6ozlPoxN22v+fviUhP+6DR547OZnpBMWDfei1f5sVGwiiW/KQTWO
# K97g+4RJpPzPNV4VYMAwO2jM2Aty2QYPVmOQTJm0msuXnJrSbl2gf9JylpkJlWXq
# k1Q4LJsxz+TELoQCZIljbgvTJgoPU2R12ydv8i1UqL/adelA0y7U9Pmmtbze9Xx3
# rtajC5SzQd1jgfwAwsa90v9YcSPdmeoyoBBA/27cCL237l5DTYYPDLQ4ON3OLTGW
# nvRb6jDrf/T75gMRfUzSLCBQfBusm9+mSWRlC/Df6S/e9Q8i13CuhzOT2Jx+V/nl
# bXM4QoBwlUAhelwwJT0CAwEAAaOCAZUwggGRMAwGA1UdEwEB/wQCMAAwHQYDVR0O
# BBYEFBTJY4owLtRK+26U8+bjQH717M3iMB8GA1UdIwQYMBaAFO9vU0rp5AZ8esri
# kFb2L9RJ7MtOMA4GA1UdDwEB/wQEAwIHgDAWBgNVHSUBAf8EDDAKBggrBgEFBQcD
# CDCBlQYIKwYBBQUHAQEEgYgwgYUwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp
# Z2ljZXJ0LmNvbTBdBggrBgEFBQcwAoZRaHR0cDovL2NhY2VydHMuZGlnaWNlcnQu
# Y29tL0RpZ2lDZXJ0VHJ1c3RlZEc0VGltZVN0YW1waW5nUlNBNDA5NlNIQTI1NjIw
# MjVDQTEuY3J0MF8GA1UdHwRYMFYwVKBSoFCGTmh0dHA6Ly9jcmwzLmRpZ2ljZXJ0
# LmNvbS9EaWdpQ2VydFRydXN0ZWRHNFRpbWVTdGFtcGluZ1JTQTQwOTZTSEEyNTYy
# MDI1Q0ExLmNybDAgBgNVHSAEGTAXMAgGBmeBDAEEAjALBglghkgBhv1sBwEwDQYJ
# KoZIhvcNAQELBQADggIBAI3FOmEenVIK35msCYB+fShAsWvSYvLBItoNdAgQ2jIq
# rGsVsluXMJU/+mRebBc52s6lbKAvOVPXaizmKkMLLflEEKDZQx4CkS2t8aHPjkXh
# a3hYZ010htFa3dhNgmalH5vuWvh3tTCf4frTS7gPtGc4Z/xaPhQ2AB1mR8eEe/Wb
# H0RWHvVIl6VwQ3+g5FKNfN2N/DWJkf13w2H+2GfqEfbd35Ww8CvoYBjLNIDTadcP
# WdgsjsiOaK/7EsKJgLjUNIVgvcaFOLLQ/GlrA+0ZHJoFUbOr5SJN8zykPspXIXlp
# DJY/gqFUZRROeab9GVgmhbdOJcD/63RhxPahFUGbckRONqMe6DYAv6/mOG0pWd3c
# PStsdcS7buj5DyniwRY8yooMH6ptx5vpP/pZzBPBeZD2U4IsthyxB5Jaa8qrOkB5
# z160TXiM5ADMspZ0TfD9MJoq0tFpFPssKRFhWeEDYPvcUuN7U7lvcdHl4ezQ3NT/
# 7Ffs1sR1yh/LRbdZ3B3Vc6q2WmD8mDC0p9kzl2o73iVtS946IkEj7FkRsZGww1te
# YxERROC745xrtjvcw9ZyyUjHZWGRIpJeMNsPquCDf0fkyHtB+J4AiNZqCQk23rxh
# +KbpyMTNVKItJ5l92Svl20U9NbqMBOVYl1h54NEYLJq1/xHWFKPNK903zJZA9P2D
# MIIGtDCCBJygAwIBAgIQDcesVwX/IZkuQEMiDDpJhjANBgkqhkiG9w0BAQsFADBi
# MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
# d3cuZGlnaWNlcnQuY29tMSEwHwYDVQQDExhEaWdpQ2VydCBUcnVzdGVkIFJvb3Qg
# RzQwHhcNMjUwNTA3MDAwMDAwWhcNMzgwMTE0MjM1OTU5WjBpMQswCQYDVQQGEwJV
# UzEXMBUGA1UEChMORGlnaUNlcnQsIEluYy4xQTA/BgNVBAMTOERpZ2lDZXJ0IFRy
# dXN0ZWQgRzQgVGltZVN0YW1waW5nIFJTQTQwOTYgU0hBMjU2IDIwMjUgQ0ExMIIC
# IjANBgkqhkiG9w0BAQEFAAOCAg8AMIICCgKCAgEAtHgx0wqYQXK+PEbAHKx126NG
# aHS0URedTa2NDZS1mZaDLFTtQ2oRjzUXMmxCqvkbsDpz4aH+qbxeLho8I6jY3xL1
# IusLopuW2qftJYJaDNs1+JH7Z+QdSKWM06qchUP+AbdJgMQB3h2DZ0Mal5kYp77j
# YMVQXSZH++0trj6Ao+xh/AS7sQRuQL37QXbDhAktVJMQbzIBHYJBYgzWIjk8eDrY
# hXDEpKk7RdoX0M980EpLtlrNyHw0Xm+nt5pnYJU3Gmq6bNMI1I7Gb5IBZK4ivbVC
# iZv7PNBYqHEpNVWC2ZQ8BbfnFRQVESYOszFI2Wv82wnJRfN20VRS3hpLgIR4hjzL
# 0hpoYGk81coWJ+KdPvMvaB0WkE/2qHxJ0ucS638ZxqU14lDnki7CcoKCz6eum5A1
# 9WZQHkqUJfdkDjHkccpL6uoG8pbF0LJAQQZxst7VvwDDjAmSFTUms+wV/FbWBqi7
# fTJnjq3hj0XbQcd8hjj/q8d6ylgxCZSKi17yVp2NL+cnT6Toy+rN+nM8M7LnLqCr
# O2JP3oW//1sfuZDKiDEb1AQ8es9Xr/u6bDTnYCTKIsDq1BtmXUqEG1NqzJKS4kOm
# xkYp2WyODi7vQTCBZtVFJfVZ3j7OgWmnhFr4yUozZtqgPrHRVHhGNKlYzyjlroPx
# ul+bgIspzOwbtmsgY1MCAwEAAaOCAV0wggFZMBIGA1UdEwEB/wQIMAYBAf8CAQAw
# HQYDVR0OBBYEFO9vU0rp5AZ8esrikFb2L9RJ7MtOMB8GA1UdIwQYMBaAFOzX44LS
# cV1kTN8uZz/nupiuHA9PMA4GA1UdDwEB/wQEAwIBhjATBgNVHSUEDDAKBggrBgEF
# BQcDCDB3BggrBgEFBQcBAQRrMGkwJAYIKwYBBQUHMAGGGGh0dHA6Ly9vY3NwLmRp
# Z2ljZXJ0LmNvbTBBBggrBgEFBQcwAoY1aHR0cDovL2NhY2VydHMuZGlnaWNlcnQu
# Y29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5jcnQwQwYDVR0fBDwwOjA4oDagNIYy
# aHR0cDovL2NybDMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0VHJ1c3RlZFJvb3RHNC5j
# cmwwIAYDVR0gBBkwFzAIBgZngQwBBAIwCwYJYIZIAYb9bAcBMA0GCSqGSIb3DQEB
# CwUAA4ICAQAXzvsWgBz+Bz0RdnEwvb4LyLU0pn/N0IfFiBowf0/Dm1wGc/Do7oVM
# Y2mhXZXjDNJQa8j00DNqhCT3t+s8G0iP5kvN2n7Jd2E4/iEIUBO41P5F448rSYJ5
# 9Ib61eoalhnd6ywFLerycvZTAz40y8S4F3/a+Z1jEMK/DMm/axFSgoR8n6c3nuZB
# 9BfBwAQYK9FHaoq2e26MHvVY9gCDA/JYsq7pGdogP8HRtrYfctSLANEBfHU16r3J
# 05qX3kId+ZOczgj5kjatVB+NdADVZKON/gnZruMvNYY2o1f4MXRJDMdTSlOLh0HC
# n2cQLwQCqjFbqrXuvTPSegOOzr4EWj7PtspIHBldNE2K9i697cvaiIo2p61Ed2p8
# xMJb82Yosn0z4y25xUbI7GIN/TpVfHIqQ6Ku/qjTY6hc3hsXMrS+U0yy+GWqAXam
# 4ToWd2UQ1KYT70kZjE4YtL8Pbzg0c1ugMZyZZd/BdHLiRu7hAWE6bTEm4XYRkA6T
# l4KSFLFk43esaUeqGkH/wyW4N7OigizwJWeukcyIPbAvjSabnf7+Pu0VrFgoiovR
# Diyx3zEdmcif/sYQsfch28bZeUz2rtY/9TCA6TD8dC3JE3rYkrhLULy7Dc90G6e8
# BlqmyIjlgp2+VqsS9/wQD7yFylIz0scmbKvFoW2jNrbM1pD2T7m3XDCCBY0wggR1
# oAMCAQICEA6bGI750C3n79tQ4ghAGFowDQYJKoZIhvcNAQEMBQAwZTELMAkGA1UE
# BhMCVVMxFTATBgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2lj
# ZXJ0LmNvbTEkMCIGA1UEAxMbRGlnaUNlcnQgQXNzdXJlZCBJRCBSb290IENBMB4X
# DTIyMDgwMTAwMDAwMFoXDTMxMTEwOTIzNTk1OVowYjELMAkGA1UEBhMCVVMxFTAT
# BgNVBAoTDERpZ2lDZXJ0IEluYzEZMBcGA1UECxMQd3d3LmRpZ2ljZXJ0LmNvbTEh
# MB8GA1UEAxMYRGlnaUNlcnQgVHJ1c3RlZCBSb290IEc0MIICIjANBgkqhkiG9w0B
# AQEFAAOCAg8AMIICCgKCAgEAv+aQc2jeu+RdSjwwIjBpM+zCpyUuySE98orYWcLh
# Kac9WKt2ms2uexuEDcQwH/MbpDgW61bGl20dq7J58soR0uRf1gU8Ug9SH8aeFaV+
# vp+pVxZZVXKvaJNwwrK6dZlqczKU0RBEEC7fgvMHhOZ0O21x4i0MG+4g1ckgHWMp
# Lc7sXk7Ik/ghYZs06wXGXuxbGrzryc/NrDRAX7F6Zu53yEioZldXn1RYjgwrt0+n
# MNlW7sp7XeOtyU9e5TXnMcvak17cjo+A2raRmECQecN4x7axxLVqGDgDEI3Y1Dek
# LgV9iPWCPhCRcKtVgkEy19sEcypukQF8IUzUvK4bA3VdeGbZOjFEmjNAvwjXWkmk
# wuapoGfdpCe8oU85tRFYF/ckXEaPZPfBaYh2mHY9WV1CdoeJl2l6SPDgohIbZpp0
# yt5LHucOY67m1O+SkjqePdwA5EUlibaaRBkrfsCUtNJhbesz2cXfSwQAzH0clcOP
# 9yGyshG3u3/y1YxwLEFgqrFjGESVGnZifvaAsPvoZKYz0YkH4b235kOkGLimdwHh
# D5QMIR2yVCkliWzlDlJRR3S+Jqy2QXXeeqxfjT/JvNNBERJb5RBQ6zHFynIWIgnf
# fEx1P2PsIV/EIFFrb7GrhotPwtZFX50g/KEexcCPorF+CiaZ9eRpL5gdLfXZqbId
# 5RsCAwEAAaOCATowggE2MA8GA1UdEwEB/wQFMAMBAf8wHQYDVR0OBBYEFOzX44LS
# cV1kTN8uZz/nupiuHA9PMB8GA1UdIwQYMBaAFEXroq/0ksuCMS1Ri6enIZ3zbcgP
# MA4GA1UdDwEB/wQEAwIBhjB5BggrBgEFBQcBAQRtMGswJAYIKwYBBQUHMAGGGGh0
# dHA6Ly9vY3NwLmRpZ2ljZXJ0LmNvbTBDBggrBgEFBQcwAoY3aHR0cDovL2NhY2Vy
# dHMuZGlnaWNlcnQuY29tL0RpZ2lDZXJ0QXNzdXJlZElEUm9vdENBLmNydDBFBgNV
# HR8EPjA8MDqgOKA2hjRodHRwOi8vY3JsMy5kaWdpY2VydC5jb20vRGlnaUNlcnRB
# c3N1cmVkSURSb290Q0EuY3JsMBEGA1UdIAQKMAgwBgYEVR0gADANBgkqhkiG9w0B
# AQwFAAOCAQEAcKC/Q1xV5zhfoKN0Gz22Ftf3v1cHvZqsoYcs7IVeqRq7IviHGmlU
# Iu2kiHdtvRoU9BNKei8ttzjv9P+Aufih9/Jy3iS8UgPITtAq3votVs/59PesMHqa
# i7Je1M/RQ0SbQyHrlnKhSLSZy51PpwYDE3cnRNTnf+hZqPC/Lwum6fI0POz3A8eH
# qNJMQBk1RmppVLC4oVaO7KTVPeix3P0c2PR3WlxUjG/voVA9/HYJaISfb8rbII01
# YBwCA8sgsKxYoA5AY8WYIsGyWfVVa88nq2x2zm8jLfR+cWojayL/ErhULSd+2DrZ
# 8LaHlv1b0VysGMNNn3O3AamfV6peKOK5lDGCA3wwggN4AgEBMH0waTELMAkGA1UE
# BhMCVVMxFzAVBgNVBAoTDkRpZ2lDZXJ0LCBJbmMuMUEwPwYDVQQDEzhEaWdpQ2Vy
# dCBUcnVzdGVkIEc0IFRpbWVTdGFtcGluZyBSU0E0MDk2IFNIQTI1NiAyMDI1IENB
# MQIQCE/cM09+RU7bww+P+ZIYNTANBglghkgBZQMEAgEFAKCB0TAaBgkqhkiG9w0B
# CQMxDQYLKoZIhvcNAQkQAQQwHAYJKoZIhvcNAQkFMQ8XDTI2MDkzMDEzNDUyOVow
# KwYLKoZIhvcNAQkQAgwxHDAaMBgwFgQUUdmr2gNJc9hPQmaspIJI5rNpxDkwLwYJ
# KoZIhvcNAQkEMSIEINfG3PgsDS/ThSI1rGb+zDrhwNFIZppd8OqJqIYRJTmaMDcG
# CyqGSIb3DQEJEAIvMSgwJjAkMCIEIC2gnaf0Ex+f5y22xebpyWVnVa8EPx6nQswN
# ISDhQev8MA0GCSqGSIb3DQEBAQUABIICAED4PZ74QEraecF4/rlwpvPqwNEGUUuG
# 9NaBFne8H3LS6Kd1bBpKbj1Am2gr3DiptEDIY24HLVudGN7SRQ+d45HZKttkRIq/
# z/0QnTilG9sqEtJrEyh0X2rc1GV1dQOURdDZ4Iamu4CMX/0Kzyzq7MwN7O+dgg6O
# eiE+lVXMEoNYHiINnD8AaFh41//dexHTdtO6mxIyzgZoxqQPy6YTRLNNzetbghX1
# xL9WXXLTJYM66X65DYvzgy6cElbHcm7pxi+XSmUz4LspJAyGrq1qhG5kmEpQulis
# Bg5JWvX+8nf5/TFtW5KLVl8GHx/ZUSXQMiavAarz+0UyuC0LfOfOc56PhoWiO3rT
# sSNoBcnsajrI9eKjKmzdWe0JQLJFcnk9UjFEr8htZIMrjcf9/g5o6jqImex4GU5H
# aSoJWVowHprl8b9X8+bUQPcdIRQyYIgjJi9i5qMdv/t08JQSbFaCd13a8g1rAEQ4
# 54uOD1etLRRBNqXhG//+FLdLYLha9jznr/JDt6OQrGd2pchsgsjIgom4GeEkdWh2
# NHEp1FgTlyoEEMfN3oKwfV7rdaswVACPGLLMU9HScLCgA0YHUNFtl3WtSmxvNkAR
# IPM1/bMlDGwsbsyxjIA+jV2WNFtCUpUwfqI7k+keRs0HQ/57A6GGXz16HXXt5bgW
# eK64BbXWrWT6
# SIG # End signature block