{"id":353660,"date":"2024-08-27T10:02:02","date_gmt":"2024-08-27T10:02:02","guid":{"rendered":"https:\/\/www.ninjaone.com\/script-hub\/automatiser-les-alertes-de-points-de-controle-hyper-v-powershell\/"},"modified":"2024-10-13T19:08:55","modified_gmt":"2024-10-13T19:08:55","slug":"automatiser-les-alertes-de-points-de-controle-hyper-v-powershell","status":"publish","type":"script_hub","link":"https:\/\/www.ninjaone.com\/fr\/script-hub\/automatiser-les-alertes-de-points-de-controle-hyper-v-powershell\/","title":{"rendered":"Comment automatiser les alertes de points de contr\u00f4le Hyper-V avec PowerShell ?"},"content":{"rendered":"

La gestion efficace des environnements Hyper-V est une t\u00e2che essentielle pour les professionnels de l’informatique et les fournisseurs de services g\u00e9r\u00e9s (MSP)<\/a>. L’un des aspects de cette gestion consiste \u00e0 assurer le suivi des points de contr\u00f4le, qui sont essentiels pour maintenir l’\u00e9tat du syst\u00e8me et garantir le bon d\u00e9roulement des processus de r\u00e9cup\u00e9ration. Ce article explore un script PowerShell con\u00e7u pour automatiser le processus de surveillance et d’alerte des administrateurs concernant les points de contr\u00f4le Hyper-V<\/strong> qui d\u00e9passent un certain seuil d’\u00e2ge.<\/p>\n

Comprendre l’objectif et l’importance du script<\/h2>\n

Le script PowerShell fourni est un outil pr\u00e9cieux pour les administrateurs informatiques qui doivent s’assurer que leurs environnements Hyper-V restent propres et efficaces. Les points de contr\u00f4le, \u00e9galement connus sous le nom d’instantan\u00e9s ou snapshots, capturent l’\u00e9tat d’une machine virtuelle \u00e0 un moment pr\u00e9cis. Bien qu’ils soient utiles pour les sauvegardes et la restauration, les anciens points de contr\u00f4le peuvent consommer beaucoup d’espace de stockage et affecter les performances des machines virtuelles. Il est donc essentiel de surveiller et de g\u00e9rer r\u00e9guli\u00e8rement ces points de contr\u00f4le.<\/p>\n

Le script<\/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
<\/div>\n
Description d\u00e9taill\u00e9e du script<\/h2>\n
Le script commence par pr\u00e9ciser qu’il n\u00e9cessite la version 5.1 de PowerShell. Il comprend une section .SYNOPSIS expliquant son objectif : rassembler des informations sur les points de contr\u00f4le Hyper-V sur une machine donn\u00e9e, avec un param\u00e8tre de seuil optionnel pour filtrer les points de contr\u00f4le plus anciens qu’un nombre de jours sp\u00e9cifi\u00e9. Le script accepte \u00e9galement un champ personnalis\u00e9 de nombre entier pour d\u00e9terminer ce seuil.<\/p>\n
Exemple d’utilisation :<\/h2>\n