UMN-Virt.psm1
|
#requires -Modules VMware.VimAutomation.Core function Remove-StuckSnapshot { <# .DESCRIPTION This script will remove a stuck snapshot from a VM or list of VMs .PARAMETER Name The name of the VM to remove the snapshot from .PARAMETER VM The VM object to remove the snapshot from .EXAMPLE Remove-StuckSnapshot -Name VM1 This will remove the stuck snapshot from VM1 .EXAMPLE Get-VM | Where-Object { $_.Extensiondata.Runtime.ConsolidationNeeded }| Remove-StuckSnapshot This will remove the stuck snapshot from all VMs #> [CmdletBinding(SupportsShouldProcess = $true)] param( [string[]]$Name, [Parameter(ValueFromPipeline)] [VMware.VimAutomation.ViCore.Types.V1.Inventory.VirtualMachine[]]$VM ) begin { if ($Name) { $VM = Get-VM $Name } } process { if (-not $VM) { Write-Error -ErrorAction Stop "No VMs found" } if ( -not $vm.ExtensionData.Runtime.ConsolidationNeeded) { Write-Warning "No stuck snapshots found, consolidation is not needed" return } foreach ($VMName in $VM) { Write-Warning "Removing stuck snapshot from $VMName" $snapshot = $VM | New-Snapshot -Name "StuckSnapshot removal" -Description "StuckSnapshot removal" $snapshot | Remove-Snapshot -RemoveChildren -Confirm:$false } } end {} } function Set-ClusterSSH { # enables or disables ssh on an entire cluster # can pipe cluster object in, or can pass the cluster name param( [Parameter (Mandatory = $true, ValueFromPipeline = $true)] [String]$ClusterName, [parameter(Mandatory = $true, ParameterSetName = 'enableSet')] [Switch]$Enable, [parameter(Mandatory = $true, ParameterSetName = 'disableSet')] [Switch]$Disable ) $cluster = Get-Cluster $ClusterName if ($cluster) { if ($Enable) { $cluster | Get-VMHost | Get-VMHostService | Where-Object { ($_.Key -eq 'TSM-SSH') } | Start-VMHostService -Confirm:$false } elseif ($Disable) { $cluster | Get-VMHost | Get-VMHostService | Where-Object { ($_.Key -eq 'TSM-SSH') -and ($_.running) } | Stop-VMHostService -Confirm:$false } } } function Get-VGPUVM { Get-VM | Select-Object name, @{n = 'cluster'; e = { $_.vmhost.parent } }, @{n = 'gpu'; e = { $_.ExtensionData.Config.Hardware.Device.Backing.vgpu } } | Where-Object { $_.gpu } } function Get-ActiveMigrations { # get active vmotions based on active tasks $runningTasks = Get-Task -Status Running | Where-Object { $_.Name -eq 'RelocateVM_Task' } $runningTasks | ForEach-Object -Process { $vm = Get-VM -Id $_.ObjectId $runningTasks | Select-Object @{N = 'Name'; E = { $vm.Name } }, @{N = 'Task'; E = { $_.Name } }, @{N = 'Progress'; E = { $_.PercentComplete } }, @{N = 'VMotionTime'; E = { Get-Date -Date $_.StartTime } }, @{N = 'VMotionMinutes'; E = { ((Get-Date) - (Get-Date -Date $_.startTime)).Minutes } } } } function Get-RunningSSH { Get-Cluster | Get-VMHost | Get-VMHostService | Where-Object { ($_.Key -eq 'TSM-SSH') -and ($_.running) } | Format-Table -Property vmhost, label, running } function Stop-AllSSH { Get-Cluster | Get-VMHost | Get-VMHostService | Where-Object { ($_.Key -eq 'TSM-SSH') -and ($_.running) } | Stop-VMHostService } function Get-AllSnapshotsInfo { Get-VM | Get-Snapshot | Select-Object VM, Name, Description, Created, SizeMB } function Get-AllSnapshots { Get-VM | Get-Snapshot } function Get-AssetInfo { param( [Parameter (ValueFromPipeline = $true)] [String]$ClusterName = '*' ) begin {} process { Get-VMHost -Location $ClusterName | Select-Object name, @{n = 'UMN_Asset_Tag'; e = { $_.CustomFields['UMNAssetTag'] } }, @{N = 'Service_Tag'; E = { ($_ | Get-View).Summary.Hardware.OtherIdentifyingInfo[3].IdentifierValue } } } end {} } function Get-ClusterCores { Get-Cluster | Select-Object Name,@{N="TotalSockets";E={($_.ExtensionData.Summary.NumHosts * 2)};},@{N="TotalCores";E={$_.ExtensionData.Summary.NumCpuCores}} } function Get-DeletedVMEvents { Get-VIEventPlus -Start ((Get-Date).adddays(-30)) -EventType 'VmRemovedEvent' | Select-Object @{Name = 'VMName'; Expression = { $_.vm.name } }, CreatedTime, UserName, fullFormattedMessage } function Get-VMByMac { param( [Parameter (Mandatory = $true)] [String]$MacAddress ) (Get-VM | Get-NetworkAdapter | Where-Object {$_.MacAddress -eq $MacAddress }).Parent } Function Get-VMByIP { param( [Parameter (Mandatory = $true)] [String]$IPAddress ) (Get-VM | Where-Object {$_.Guest.IPAddress -contains $IPAddress }) } function Get-OldHardwareVM { <# .DESCRIPTION This script will return a list of VMs with the oldest hardware version .PARAMETER Cluster The cluster/s to search for VMs [default: Hosting-01, XTR] .PARAMETER OldestCount The number of oldest hardware versions to return [default: 2] .PARAMETER Department Limit the search for VMs to a specific department .EXAMPLE Get-OldHardwareVM -Cluster Hosting-01 Department 'Virt' This will return a list of VMs with the 2 oldest hardware versions in the Hosting-01 cluster #> param( [string[]]$Cluster = @('Hosting-01', 'XTR'), [int]$OldestCount = 2, [string]$Department ) if ($Department){ $TagName = Get-Tag -Category 'Department' | Where-Object {$_.name -like $Department} $AllVMs = Get-Cluster $Cluster | Get-VM -Tag $TagName } else { $AllVMs = get-cluster $Cluster | Get-VM } $HardwareVersion = $AllVMs.HardwareVersion | Sort-Object -Unique | Sort-Object -Top $OldestCount $VMs = $AllVMs | Where-Object { $HardwareVersion -contains $_.HardwareVersion } | Sort-Object -Property Name $List = @() Write-Host "Gathering Information for $($VMs.Count) VMs with hardware version $($HardwareVersion -join ', ')" foreach ($VM in $VMs){ Write-Host -NoNewline "." $Cesi = Get-Cesi -VM $VM $Info = [PSCustomObject]@{ Name = $VM.Name HardwareVersion = $VM.HardwareVersion Unit = $Cesi.DepartmentId Contacts = $Cesi.Contacts WinRequestors = $Cesi.WinRequestors LinuxRequestors = $Cesi.LinuxRequestors SMERequestors = $Cesi.SMERequestors } $List += $Info } Write-Host "`nFound $($List.Count) VMs with hardware version $($HardwareVersion -join ', ')" return $List } function Invoke-RemediateCluster { <# .SYNOPSIS Performs parallel updates on a specified VMware cluster. .DESCRIPTION This script stages a specified number of non-compliant hosts in a VMware cluster into maintenance mode and optionally remediates them. It ensures that no more than 20% of the hosts are in maintenance mode at any given time unless the -Force parameter is used. .PARAMETER Cluster The target VMware cluster to update. This can be a cluster name (string) or a ClusterImpl object. .PARAMETER Limit The maximum number of hosts to stage into maintenance mode simultaneously. Default is 5. .PARAMETER Remediate Switch parameter to indicate if the cluster should be remediated after staging the hosts into maintenance mode. .PARAMETER Force Switch parameter to bypass the 20% maintenance mode limit check. .EXAMPLE .\parallel-updates.ps1 -Cluster "MyCluster" -Limit 3 -Remediate This command stages up to 3 non-compliant hosts in the "MyCluster" into maintenance mode and remediates them. .EXAMPLE .\parallel-updates.ps1 -Cluster "MyCluster" -Limit 3 -Remediate -Force This command stages up to 3 non-compliant hosts in the "MyCluster" into maintenance mode and remediates them, bypassing the 20% maintenance mode limit check. .NOTES Author: Justin Keppers Date: 3/2025 #> [CmdletBinding( SupportsShouldProcess )] param ( [Parameter(Mandatory = $true, ValueFromPipeline = $true)] $Cluster, [parameter()] [int]$Limit = 5, [parameter()] [switch]$Remediate, [parameter()] [switch]$Force ) process { $ErrorActionPreference = "Stop" if ($Cluster -is [string]) { $Cluster = Get-Cluster $Cluster } elseif ($cluster -is [VMware.VimAutomation.ViCore.Impl.V1.Inventory.ClusterImpl]) { # do nothing } else { throw "Invalid cluster type" } if ($Remediate) { # enable parallel remediation #$ParallelRemediationSetting = Initialize-SettingsDefaultsClustersPoliciesParallelRemediationAction -Enabled $true -MaxHosts $limit #$PolicySpec = Initialize-SettingsDefaultsClustersPoliciesApplyConfiguredPolicySpec -ParallelRemediationAction $ParallelRemediationSetting #Invoke-SetDefaultsClustersPoliciesApply -Cluster $cluster -SettingsClustersPoliciesApplyConfiguredPolicySpec $PolicySpec } # get hosts requiring updates $updates = $cluster | Test-LcmClusterCompliance $noncompliantHosts = $updates.NonCompliantHosts.vmhost | Sort-Object -Property Name # sanity check: no more than 20% of hosts can be in maintenance mode if (-not ($force)) { $totalHosts = $cluster | Get-VMHost $totalHostsCount = $totalHosts.Count $maintenanceHostsCount = ($totalHosts | Where-Object { $_.ConnectionState -eq 'Maintenance' }).Count $maintenanceHostsLimit = [math]::Ceiling($totalHostsCount * 0.2) if ($maintenanceHostsCount + $limit -gt $maintenanceHostsLimit) { throw "Cannot stage more than $maintenanceHostsLimit hosts (20%) into maintenance mode. If you're sure, use -Force" } } # pick 5 of them $remediateHosts = $noncompliantHosts | Select-Object -First $limit if ($remediateHosts) { # enter maintenance mode and disable alarms $alarmMgr = Get-View AlarmManager foreach ($vmhost in $remediateHosts) { if ($vmhost.ConnectionState -eq 'Connected') { Write-Host "$vmhost Entering Maintence mode" $vmhost | Set-VMHost -State Maintenance } elseif ($vmhost.ConnectionState -eq 'Maintenance') { Write-Host "$vmhost Already in Maintence mode" } Write-Host "$vmhost Disabling alarms" $alarmMgr.EnableAlarmActions($vmhost.ExtensionData.MoRef, $false) } if ($remediate) { #remediate cluster $cluster | Set-Cluster -Remediate -AcceptEULA # exit maintenance mode foreach ($vmhost in $remediateHosts) { if ($vmhost.ConnectionState -eq 'Maintenance') { Write-Host "$vmhost Exiting Maintence mode" $vmhost | Set-VMHost -State Connected } } # disable parallel remediation #$ParallelRemediationSetting = Initialize-SettingsDefaultsClustersPoliciesParallelRemediationAction -Enabled $false -MaxHosts $limit #$PolicySpec = Initialize-SettingsDefaultsClustersPoliciesApplyConfiguredPolicySpec -ParallelRemediationAction $ParallelRemediationSetting #Invoke-SetDefaultsClustersPoliciesApply -Cluster $cluster -SettingsClustersPoliciesApplyConfiguredPolicySpec $PolicySpec } else { Write-Host "Remediation not requested, $($remediateHosts.Count) hosts are staged in maintenance mode" } } else { Write-Host "Cluster $cluster is compliant" } } } |