Set-HyperVVMAutomaticCriticalError

Hyper-V: Configures VM action on critical error

Script

#Requires -Version 5.1
#Requires -Modules Hyper-V

[CmdletBinding()]
Param (
    [string]$ComputerName = "localhost",

    [PSCredential]$Credential,

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

    [Parameter(Mandatory = $true)]
    [ValidateSet('None', 'Pause')]
    [string]$Action,

    [Parameter(Mandatory = $true)]
    [int]$TimeoutMinutes
)

Process {
    try {
        $params = @{
            'ComputerName' = $ComputerName
            'ErrorAction'  = 'Stop'
        }
        if ($Credential) { $params.Add('Credential', $Credential) }

        $vm = Get-VM @params | Where-Object { $_.Name -eq $Name -or $_.Id -eq $Name }

        if (-not $vm) {
            throw "Virtual machine '$Name' not found on '$ComputerName'."
        }

        Set-VM -VM $vm -AutomaticCriticalErrorAction $Action -AutomaticCriticalErrorActionTimeout $TimeoutMinutes -ErrorAction Stop

        $result = [PSCustomObject]@{
            Name                        = $vm.Name
            AutomaticCriticalErrorAction = $Action
            TimeoutMinutes              = $TimeoutMinutes
            Action                      = "CriticalErrorActionUpdated"
            Status                      = "Success"
            Timestamp                   = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        }

        Write-Output $result
    }
    catch {
        throw
    }
}

Customize

ComputerName string

Specifies the name of the Hyper-V host. Defaults to the local machine.

Credential PSCredential

Specifies the credentials to use for the remote connection.

Name string

Specifies the name or ID of the virtual machine.

Action string

Specifies the action to take (None or Pause).

TimeoutMinutes int

Specifies the timeout duration in minutes before the VM is powered off if it remains in critical pause.