{"id":353765,"date":"2024-08-30T11:41:28","date_gmt":"2024-08-30T11:41:28","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/automatizar-las-alertas-de-puntos-de-control-de-hyper-v\/"},"modified":"2024-10-13T19:08:55","modified_gmt":"2024-10-13T19:08:55","slug":"automatizar-las-alertas-de-puntos-de-control-de-hyper-v","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/es\/script-hub\/automatizar-las-alertas-de-puntos-de-control-de-hyper-v\/","title":{"rendered":"C\u00f3mo automatizar las alertas de puntos de control de Hyper-V mediante PowerShell"},"content":{"rendered":"

La gesti\u00f3n eficiente de entornos Hyper-V es una tarea cr\u00edtica para los profesionales de TI y los proveedores de servicios gestionados (MSP)<\/a>. Uno de los aspectos de esta gesti\u00f3n es el seguimiento de los puntos de control, esenciales para mantener los estados del sistema y garantizar procesos de recuperaci\u00f3n fluidos. Este post explorar\u00e1 un script de PowerShell dise\u00f1ado para automatizar el proceso de supervisi\u00f3n y alerta a los administradores sobre los puntos de control de Hyper-V<\/strong> que superan un determinado umbral de antig\u00fcedad.<\/p>\n

Comprender la finalidad y la importancia del script<\/h2>\n

El script PowerShell para automatizar las alertas de puntos de control de Hyper-V es una herramienta valiosa para los administradores de TI que necesitan asegurarse de que sus entornos Hyper-V permanecen limpios y eficientes. Los puntos de control, tambi\u00e9n conocidos como instant\u00e1neas o snapshots, capturan el estado de una m\u00e1quina virtual en un momento determinado. Aunque son \u00fatiles para las copias de seguridad y la recuperaci\u00f3n, los puntos de control antiguos pueden consumir mucho espacio de almacenamiento y afectar potencialmente al rendimiento de las m\u00e1quinas virtuales. Por lo tanto, es crucial supervisar y gestionar regularmente estos puntos de control.<\/p>\n

El script para automatizar las alertas de puntos de control de Hyper-V<\/h2>\n
#Requires -Version 5.1\r\n\r\n<#\r\n.SYNOPSIS\r\n    This will get information about the current number of Hyper-V checkpoints there are on a given machine. Can be given a threshold in days to report on, can also get this threshold from an integer custom field.\r\n.DESCRIPTION\r\n    This will get information about the current number of Hyper-V checkpoints there are on a given machine. \r\n    Can be given a threshold in days to report on, can also get this threshold from an integer custom field.\r\n\r\n.EXAMPLE \r\n    (No Parameters)\r\n    WARNING: There are checkpoints older than 04\/12\/2023 14:01:26!\r\n\r\n    VMName              Name                   CreationTime\r\n    ------              ----                   ------------\r\n    SRV16-TEST          Fresh Start            4\/12\/2023 10:53:14 AM\r\n    SRV16-TEST          Hyper-V Installed      4\/12\/2023 11:13:09 AM\r\n    SRV19-TEST          Fresh Start            4\/12\/2023 10:42:44 AM\r\n    SRV22-TEST          Fresh Start            4\/12\/2023 10:45:02 AM\r\n\r\nPARAMETER: -OlderThan \"14\"\r\n    Alert\/Show only vm checkpoints older than x days. \r\n    ex. \"7\" will alert\/show vm checkpoints older than 7 days.\r\n.EXAMPLE\r\n    -OlderThan \"7\"\r\n    WARNING: There are checkpoints older than 04\/05\/2023 14:04:01!\r\n    \r\n    VMName              Name                                                              CreationTime\r\n    ------              ----                                                              ------------\r\n    old WIN10-TEST      Automatic Checkpoint - WIN10-TEST - (3\/30\/2023 - 3:02:28 PM)      3\/30\/2023 3:02:28 PM \r\n\r\nPARAMETER: -FromCustomField \"ReplaceMeWithAnyIntegerCustomField\"\r\n    Name of an integer custom field that contains your desired OlderThan threshold.\r\n    ex. \"CheckpointAgeLimit\" where you have entered in your desired age limit in the \"CheckPointAgeLimit\" custom field rather than in a parameter.\r\n.EXAMPLE\r\n    -FromCustomField \"ReplaceMeWithAnyIntegerCustomField\"\r\n    WARNING: There are checkpoints older than 04\/05\/2023 14:04:01!\r\n    \r\n    VMName              Name                                                              CreationTime\r\n    ------              ----                                                              ------------\r\n    old WIN10-TEST      Automatic Checkpoint - WIN10-TEST - (3\/30\/2023 - 3:02:28 PM)      3\/30\/2023 3:02:28 PM\r\n\r\n.OUTPUTS\r\n    \r\n.NOTES\r\n    Minimum OS Architecture Supported: Windows 10, Server 2016\r\n    Release Notes: Renamed script and added Script Variable support\r\nBy using this script, you indicate your acceptance of the following legal terms as well as our Terms of Use at https:\/\/www.ninjaone.com\/terms-of-use.\r\n    Ownership Rights: NinjaOne owns and will continue to own all right, title, and interest in and to the script (including the copyright). NinjaOne is giving you a limited license to use the script in accordance with these legal terms. \r\n    Use Limitation: You may only use the script for your legitimate personal or internal business purposes, and you may not share the script with another party. \r\n    Republication Prohibition: Under no circumstances are you permitted to re-publish the script in any script library or website belonging to or under the control of any other software provider. \r\n    Warranty Disclaimer: The script is provided \u201cas is\u201d and \u201cas available\u201d, without warranty of any kind. NinjaOne makes no promise or guarantee that the script will be free from defects or that it will meet your specific needs or expectations. \r\n    Assumption of Risk: Your use of the script is at your own risk. You acknowledge that there are certain inherent risks in using the script, and you understand and assume each of those risks. \r\n    Waiver and Release: You will not hold NinjaOne responsible for any adverse or unintended consequences resulting from your use of the script, and you waive any legal or equitable rights or remedies you may have against NinjaOne relating to your use of the script. \r\n    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).\r\n.COMPONENT\r\n    ManageUsers\r\n#>\r\n\r\n[CmdletBinding()]\r\nparam (\r\n    [Parameter()]\r\n    [int]$OlderThan = \"0\",\r\n    [Parameter()]\r\n    [String]$FromCustomField\r\n)\r\nbegin {\r\n    if ($env:ageLimit -and $env:ageLimit -notlike \"null\") { $OlderThan = $env:ageLimit }\r\n    if ($env:retrieveAgeLimitFromCustomField -and $env:retrieveAgeLimitFromCustomField -notlike \"null\") { $FromCustomField = $env:retrieveAgeLimitFromCustomField }\r\n\r\n    function Test-IsElevated {\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n        $p = New-Object System.Security.Principal.WindowsPrincipal($id)\r\n        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)\r\n    }\r\n\r\n    function Test-IsSystem {\r\n        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()\r\n        return $id.Name -like \"NT AUTHORITY*\" -or $id.IsSystem\r\n    }\r\n\r\n    if (!(Test-IsElevated) -and !(Test-IsSystem)) {\r\n        Write-Error -Message \"Access Denied. Please run with Administrator privileges.\"\r\n        exit 1\r\n    }\r\n}\r\nprocess {\r\n\r\n    $Threshold = (Get-Date).AddDays(-$OlderThan)\r\n\r\n    if ($FromCustomField) {\r\n        $Threshold = (Get-Date).AddDays( - (Ninja-Property-Get $FromCustomField))\r\n    }\r\n    \r\n    $CheckPoints = Get-VM | Get-VMSnapshot | Where-Object { $_.CreationTime -lt $Threshold }\r\n\r\n    if (!$CheckPoints) {\r\n        Write-Host \"There are no checkpoints older than $Threshold!\"\r\n        exit 0\r\n    }\r\n    else {\r\n        Write-Warning \"There are checkpoints older than $Threshold!\"\r\n        $Checkpoints | Format-Table -Property VMName, Name, CreationTime | Out-String | Write-Host\r\n        exit 1\r\n    }\r\n}end {\r\n    \r\n    \r\n    \r\n}<\/pre>\n
 <\/p>\n\n
<\/h2>
<\/p><\/div>
<\/a><\/div><\/div>\n
Desglose detallado del script<\/h2>\n
El script para automatizar las alertas de puntos de control de Hyper-V comienza especificando que requiere PowerShell versi\u00f3n 5.1. Incluye una secci\u00f3n .SYNOPSIS que explica su prop\u00f3sito: recopilar informaci\u00f3n sobre los puntos de control de Hyper-V en una m\u00e1quina determinada, con un par\u00e1metro de umbral opcional para filtrar los puntos de control con una antig\u00fcedad superior a un n\u00famero especificado de d\u00edas. El script tambi\u00e9n acepta un campo personalizado entero para determinar este umbral.<\/p>\n
Ejemplo de uso:<\/h2>\n