Has anyone been able to create a scripted action to make this conversion?
Convert Fslogix VHD to VHDX
1
Hey Phil Hurley,
I've had a few customers ask about this, but I'm not sure that anyone has done it. One of the complications of this is there is no way to do this via Azure PowerShell, and, if doing this on a VM, you need a tooling such as Hyper-V installed to do the conversion. I have put together this script which can be run as an Azure runbook. I 'borrowed' logic and code from the FSLogix Shrink runbook and the Delete Old Profiles script to get this done. It creates a temporary VM in Azure, installs the Hyper-V Windows Feature, and utilizes the Hyper-V module in PowerShell on the machine to do the conversion of VHDs to VHDXs.
Disclaimer: The following code provided in this forum post is intended for educational and informational purposes only. While efforts have been made to ensure its accuracy and reliability, it is important to understand that using the code in a production environment or for any critical application without thorough testing and understanding of its implications is not recommended. The author and the forum platform cannot be held responsible for any damages or losses incurred as a result of using or misusing the code. It is strongly advised to review and modify the code to suit your specific requirements and to seek professional guidance if needed. Use the code at your own risk.
#description: Creates a temp vm which is used to convert FSLogix profiles from VHD to VHDX
<#
Notes:
This script creates a temporary VM, installs the Hyper-V module, then converts VHDs to VHDXs. After completing, the temporary VM is deleted.
This script should be run directly from the Scripted Actions->Azure Runbooks screen in Nerdio manager,
not assigned to a host pool or host.
You must provide some variables to this script to determine where the temporary VM is created, and
how it will access the fileshare. You can provide these variables as parameters when running the
script, or as Secure Variables created in Nerdio Manager under Settings->Nerdio Integrations.
If Secure Variables are specified, they will override the parameters passed at runtime. This is
to ensure backward compatibility with previous versions of the script.
This script requires credentials to acccess the fileshare. These can be passed as AD credentials
when running the script (check the "Pass AD credentials" box when running the script), or as
Secure Variables. You must ensure the user has been granted access to the fileshare. Alternately,
if using Azure Files you may use the storage account user and key
If using Secure Variables, the variables to create in Nerdio Manager are:
FslResourceGroup - the resource group in which the temp vm will be created.
FslTempVmVnet - the vnet in which the temp vm will be created
FslTempVmSubnet - the subnet in which the temp vm will be created
FslStorageUser - Storage account key user, or AD user with access to fileshare
FslStorageKey - Storage account key, or AD password
FslFileshare - UNC path to the fslogix profiles share
This script uses https://github.com/Get-Nerdio/NMW/blob/main/scripted-actions/azure-runbooks/Shrink%20FSLogix%20Profiles.ps1 as the base for connection and code with additional modifications.
#>
<# Variables:
{
"VNetName": {
"Description": "VNet in which to create the temp VM. Must be able to access the fslogix fileshare.",
"IsRequired": false
},
"SubnetName": {
"Description": "Subnet in which to create the temp VM.",
"IsRequired": false
},
"FileSharePath": {
"Description": "UNC path e.g. \\\\storageaccount.file.core.windows.net\\premiumfslogix01",
"IsRequired": false
},
"TempVmSize": {
"Description": "Size of the temporary VM from which the shrink script will be run.",
"IsRequired": false,
"DefaultValue": "Standard_D16s_v4"
},
"TempVmResourceGroup": {
"Description": "Resource group in which to create the temp vm. If not supplied, resource group of vnet will be used.",
"IsRequired": false
}
}
#>
# Adjust Variables below to alter to your preference:
$ErrorActionPreference = 'Stop'
##### Required Variables #####
$AzureRegionName = $SecureVars.FslRegion
$AzureVMName = "vhdconvert-tempvm"
$azureVmSize = 'Standard_D16s_v4'
$azureVnetName = $SecureVars.FslTempVmVnet
$azureVnetSubnetName = $SecureVars.FslTempVmSubnet
$AzureResourceGroup = $SecureVars.FslResourceGroup
#Define the storage account for the fslogix share
$StorageAccountUser = $SecureVars.FslStorageUser # Storage account key user, usually same as storage account name
$StorageAccountKey = $SecureVars.FslStorageKey # Storage account key
$FSLogixFileShare = $SecureVars.FslFileShare # in UNC path e.g. \\storageaccount.file.core.windows.net\premiumfslogix01
# Override SecureVars values with parameters supplied at runtime, if specified
if ($VNetName) {
$azureVnetName = $VNetName
}
if ($SubnetName) {
$azureVnetSubnetName = $SubnetName
}
if ($FileSharePath) {
$FSLogixFileShare = $FileSharePath
}
if ($ADUsername) {
$StorageAccountUser = $ADUsername
}
if ($ADPassword) {
$StorageAccountKey = $ADPassword
}
if ($TempVmResourceGroup) {
$azureResourceGroup = $TempVmResourceGroup
}
if ($TempVmSize) {
$azureVmSize = $TempVmSize
}
Write-Output "Variables set:
VNet for temp vm is $azureVnetName
Subnet is $azureVnetSubnetName
Path to fslogix share is $FSLogixFileShare
User account to access share is $StorageAccountUser
Resource Group for temp vm is $azureResourceGroup
Temp VM size is $azureVmSize"
##### Optional Variables #####
#Define the following parameters for the temp vm
$vmAdminUsername = "LocalAdminUser"
$Guid = (new-guid).Guid
$vmAdminPassword = ConvertTo-SecureString "$Guid" -AsPlainText -Force
$vmComputerName = "vhdconvert-tmp"
#Define the parameters for the Azure resources.
$azureVmOsDiskName = "$AzureVMName-os"
#Define the networking information.
$azureNicName = "$azureVmName-NIC"
$azurePublicIpName = "$azureVmName-IP"
#Define the VM marketplace image details.
$azureVmPublisherName = "MicrosoftWindowsServer"
$azureVmOffer = "WindowsServer"
$azureVmSkus = "2019-datacenter-core-g2"
##### Script Logic #####
# Check for essential variables
if ([string]::IsNullOrEmpty($azureVnetName)){
Throw "Missing vnet name. Either provide the VNetName parameter at runtime, or create the FslTempVmVnet secure variable in Nerdio Settings"
}
if ([string]::IsNullOrEmpty($azureVnetSubnetName)) {
Throw "Missing subnet name. Either provide the SubnetName parameter at runtime, or create the FslTempVmSubnet secure variable in Nerdio Settings."
}
if ([string]::IsNullOrEmpty($FSLogixFileShare)) {
Throw "Missing the FSLogix Fileshare. Either provide the FileSharePath parameter at runtime, or create the FslFileshare secure variable in Nerdio Settings."
}
if ([string]::IsNullOrEmpty($StorageAccountUser) -or [string]::IsNullOrEmpty($StorageAccountKey)) {
Throw "Missing credentials. Please pass AD credentials when running this scripted action, or create FslStorageUser and FslStorageKey secure variables in Nerdio Manager"
}
#Get the subnet details for the specified virtual network + subnet combination.
Write-Output "Getting vnet details"
$Vnet=Get-AzVirtualNetwork-Name $azureVnetName
if (!$vnet) {
Throw "Unable to get virtual network $AzureVnetName. Please check the name."
}
# use resource group of vnet if not specified in parameters or securevars
if ([string]::IsNullOrEmpty($AzureResourceGroup)) {
$AzureResourceGroup = $Vnet.ResourceGroupName
}
$AzureRegionName = $vnet.Location
$azureVnetSubnet = $Vnet.Subnets | Where-Object {$_.Name -eq $azureVnetSubnetName}
Write-Output "Region is $($vnet.Location)"
Try {
#Create the public IP address.
Write-Output "Creating public ip"
$azurePublicIp = New-AzPublicIpAddress -Name $azurePublicIpName -ResourceGroupName $azureResourceGroup -Location $AzureRegionName -AllocationMethod Static -Sku Standard -Force
#Create the NIC and associate the public IpAddress.
Write-Output "Creating NIC"
$azureNIC = New-AzNetworkInterface -Name $azureNicName -ResourceGroupName $azureResourceGroup -Location $AzureRegionName -SubnetId $azureVnetSubnet.Id -PublicIpAddressId $azurePublicIp.Id -Force
#Store the credentials for the local admin account.
Write-Output "Creating VM credentials"
$vmCredential = New-Object System.Management.Automation.PSCredential ($vmAdminUsername, $vmAdminPassword)
#Define the parameters for the new virtual machine.
Write-Output "Creating VM config"
$VirtualMachine = New-AzVMConfig -VMName $azureVmName -VMSize $azureVmSize
$VirtualMachine = Set-AzVMOperatingSystem -VM $VirtualMachine -Windows -ComputerName $vmComputerName -Credential $vmCredential -ProvisionVMAgent -EnableAutoUpdate
$VirtualMachine = Add-AzVMNetworkInterface -VM $VirtualMachine -Id $azureNIC.Id
$VirtualMachine = Set-AzVMSourceImage -VM $VirtualMachine -PublisherName $azureVmPublisherName -Offer $azureVmOffer -Skus $azureVmSkus -Version "latest"
$VirtualMachine = Set-AzVMBootDiagnostic -VM $VirtualMachine -Disable
$VirtualMachine = Set-AzVMOSDisk -VM $VirtualMachine -StorageAccountType "Premium_LRS" -Caching ReadWrite -Name $azureVmOsDiskName -CreateOption FromImage
#Create the virtual machine.
Write-Output "Creating new VM"
$VM = New-AzVM -ResourceGroupName $azureResourceGroup -Location $AzureRegionName -VM $VirtualMachine -Verbose -ErrorAction stop
$azurePublicIp = Get-AzPublicIpAddress -Name $azurePublicIpName -ResourceGroupName $AzureResourceGroup
$ScriptBlock1 = @"
Try {
Install-WindowsFeature -Name 'Hyper-V' -IncludeManagementTools
}
catch {
"[`$(`$_.Exception.GetType().FullName)]" | Out-File C:\Windows\Temp\ConvertVHD.log -append
# Error MESSAGE
`$_.Exception.Message | Out-File C:\Windows\Temp\ConvertVHD.log -append
Throw `$_
}
"@
#Declare variables for scripblock2
$Dirs = '$Dirs'
$VHDs = '$VHDs'
$dir = '$dir'
$vhd = '$vhd'
$name = '$name'
$newName = '$newName'
$ScriptBlock2 = @"
Try {
Invoke-Expression "net use $FSLogixFileShare /user:$StorageAccountUser $StorageAccountKey"
Import-Module Hyper-V
#Get the list of directories
$Dirs = Get-ChildItem -Path $FSLogixFileShare
#Loop through the directories and find the VHDs
foreach ($dir in $Dirs) {
$VHDs = Get-ChildItem -Path $dir.FullName -Recurse -Include *.vhd
#Loop thro$ugh the VHDs and convert to VHDX
foreach ($vhd in $VHDs) {
$name = $vhd.FullName
$newName = $name + "x"
Write-Host "Converting $name to $newName"
Convert-VHD -Path $name -Destination $newName
}
}
}
catch {
"[`$(`$_.Exception.GetType().FullName)]" | Out-File C:\Windows\Temp\ConvertVHD.log -append
# Error MESSAGE
`$_.Exception.Message | Out-File C:\Windows\Temp\ConvertVHD.log -append
Throw `$_
}
"@
$scriptblock1 > .\scriptblock1.ps1
$scriptblock2 > .\scriptblock2.ps1
try {
Write-Output "Installing Hyper-V Module on VM"
$Time = get-date
$job = Invoke-AzVmRunCommand -ResourceGroupName $azureResourceGroup -VMName $azureVmName -ScriptPath .\scriptblock1.ps1 -CommandId 'RunPowershellScript' -AsJob
While ((get-job $job.id).state -eq 'Running') {
if ((get-date) -gt $time.AddMinutes(26)){
get-job $job.id | Stop-Job -Force
Write-Output "Unable to install module before 30 minute timeout elapsed"
Throw "Unable to install module before 30 minute timeout elapsed"
}
else {
Start-Sleep -Seconds 60
}
}
}
catch {
Write-Output "Error during execution of script on temp VM"
Throw$_
}
try {
Write-Output "Restarting VM"
$Time = get-date
$job = Restart-AzVM -ResourceGroupName $AzureResourceGroup -Name $AzureVMName -AsJob
While ((get-job $job.id).state -eq 'Running') {
if ((get-date) -gt $time.AddMinutes(6)){
get-job $job.id | Stop-Job -Force
Write-Output "Unable to restart VM before 10 minute timeout elapsed"
Throw "Unable to restart VM before 10 minute timeout elapsed"
}
else {
Start-Sleep -Seconds 60
}
}
}
catch {
Write-Output "Error during VM Reboot"
Throw $_
}
Write-Output "Converting VHDs to VHDXs"
$time = Get-Date
$job = Invoke-AzVmRunCommand -ResourceGroupName $azureResourceGroup -VMName $azureVmName -ScriptPath .\scriptblock2.ps1 -CommandId 'RunPowershellScript' -AsJob
While ((get-job $job.id).state -eq 'Running') {
if ((get-date) -gt $time.AddMinutes(86)){
get-job $job.id | Stop-Job -Force
Write-Output "Unable to finish processing profiles before 90 minute timeout elapsed"
Throw "Unable to finish processing profiles before 90 minute timeout elapsed"
}
else {
Start-Sleep -Seconds 60
}
}
$job=Receive-Job-id $job.id
if ($job.value.Message -like '*No files to process*') {
Write-Output"SUCCESS: No files to process"
}
elseif ($job.value.Message -like '*error*') {
Write-Output"Failed. An error occurred: `n$($job.value.Message)"
throw $($job.value.Message)
}
else {
$job | out-string | Write-Output
}
}
Catch {
Write-Output "Error during execution of script on temp VM"
Throw$_
}
Finally {
"Removing temporary VM" | Write-Output
Start-Sleep 180
Remove-AzVM -Name $azureVmName -ResourceGroupName $AzureResourceGroup -Force -ErrorAction Continue
Remove-AzDisk -ResourceGroupName $AzureResourceGroup -DiskName $azureVmOsDiskName -Force -ErrorAction Continue
Remove-AzNetworkInterface -Name $azureNicName -ResourceGroupName $AzureResourceGroup -Force -ErrorAction Continue
Remove-AzPublicIpAddress -Name $azurePublicIpName -ResourceGroupName $AzureResourceGroup -Force -ErrorAction Continue
}
Please sign in to leave a comment.
Comments (1 comment)