Automatisierung von Hyper-V-Prüfpunkt-Warnmeldungen mit PowerShell

Die effiziente Verwaltung von Hyper-V-Umgebungen ist eine wichtige Aufgabe für IT-Experten und Managed Service Provider (MSPs). Ein Aspekt des Managements ist die Verfolgung von Prüfpunkten, die für die Aufrechterhaltung des Systemzustands und die Gewährleistung reibungsloser Wiederherstellungsprozesse unerlässlich sind. In diesem Blogbeitrag beschreiben wir ein PowerShell-Skript zur Automatisierung von Hyper-V-Prüfpunkt-Warnmeldungen. Die Prüfpunkte werden überwacht und IT-Administratoren erhalten Informationen über diejenigen, die einen bestimmten Altersschwellenwert überschreiten.

Verständnis des Zwecks und der Bedeutung des Skripts

Das mitgelieferte PowerShell-Skript ist ein wertvolles Tool für IT-Administratoren, die sicherstellen müssen, dass ihre Hyper-V-Umgebungen sauber und effizient bleiben. Prüfpunkte, auch als Snapshots bekannt, erfassen den Zustand einer virtuellen Maschine zu einem bestimmten Zeitpunkt. Sie sind zwar für Backups und Wiederherstellungen nützlich, aber alte Prüfpunkte können viel Speicherplatz verbrauchen und möglicherweise die VM-Leistung beeinträchtigen. Daher ist die regelmäßige Überwachung und Verwaltung davon entscheidend.

Das Skript zur Automatisierung von Hyper-V-Prüfpunkt-Warnmeldungen

#Requires -Version 5.1

<#
.SYNOPSIS
    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.
.DESCRIPTION
    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.

.EXAMPLE 
    (No Parameters)
    WARNING: There are checkpoints older than 04/12/2023 14:01:26!

    VMName              Name                   CreationTime
    ------              ----                   ------------
    SRV16-TEST          Fresh Start            4/12/2023 10:53:14 AM
    SRV16-TEST          Hyper-V Installed      4/12/2023 11:13:09 AM
    SRV19-TEST          Fresh Start            4/12/2023 10:42:44 AM
    SRV22-TEST          Fresh Start            4/12/2023 10:45:02 AM

PARAMETER: -OlderThan "14"
    Alert/Show only vm checkpoints older than x days. 
    ex. "7" will alert/show vm checkpoints older than 7 days.
.EXAMPLE
    -OlderThan "7"
    WARNING: There are checkpoints older than 04/05/2023 14:04:01!
    
    VMName              Name                                                              CreationTime
    ------              ----                                                              ------------
    old WIN10-TEST      Automatic Checkpoint - WIN10-TEST - (3/30/2023 - 3:02:28 PM)      3/30/2023 3:02:28 PM 

PARAMETER: -FromCustomField "ReplaceMeWithAnyIntegerCustomField"
    Name of an integer custom field that contains your desired OlderThan threshold.
    ex. "CheckpointAgeLimit" where you have entered in your desired age limit in the "CheckPointAgeLimit" custom field rather than in a parameter.
.EXAMPLE
    -FromCustomField "ReplaceMeWithAnyIntegerCustomField"
    WARNING: There are checkpoints older than 04/05/2023 14:04:01!
    
    VMName              Name                                                              CreationTime
    ------              ----                                                              ------------
    old WIN10-TEST      Automatic Checkpoint - WIN10-TEST - (3/30/2023 - 3:02:28 PM)      3/30/2023 3:02:28 PM

.OUTPUTS
    
.NOTES
    Minimum OS Architecture Supported: Windows 10, Server 2016
    Release Notes: Renamed script and added Script Variable support
By 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.
    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. 
    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. 
    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. 
    Warranty Disclaimer: The script is provided “as is” and “as available”, 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. 
    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. 
    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. 
    EULA: If you are a NinjaOne customer, your use of the script is subject to the End User License Agreement applicable to you (EULA).
.COMPONENT
    ManageUsers
#>

[CmdletBinding()]
param (
    [Parameter()]
    [int]$OlderThan = "0",
    [Parameter()]
    [String]$FromCustomField
)
begin {
    if ($env:ageLimit -and $env:ageLimit -notlike "null") { $OlderThan = $env:ageLimit }
    if ($env:retrieveAgeLimitFromCustomField -and $env:retrieveAgeLimitFromCustomField -notlike "null") { $FromCustomField = $env:retrieveAgeLimitFromCustomField }

    function Test-IsElevated {
        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
        $p = New-Object System.Security.Principal.WindowsPrincipal($id)
        $p.IsInRole([System.Security.Principal.WindowsBuiltInRole]::Administrator)
    }

    function Test-IsSystem {
        $id = [System.Security.Principal.WindowsIdentity]::GetCurrent()
        return $id.Name -like "NT AUTHORITY*" -or $id.IsSystem
    }

    if (!(Test-IsElevated) -and !(Test-IsSystem)) {
        Write-Error -Message "Access Denied. Please run with Administrator privileges."
        exit 1
    }
}
process {

    $Threshold = (Get-Date).AddDays(-$OlderThan)

    if ($FromCustomField) {
        $Threshold = (Get-Date).AddDays( - (Ninja-Property-Get $FromCustomField))
    }
    
    $CheckPoints = Get-VM | Get-VMSnapshot | Where-Object { $_.CreationTime -lt $Threshold }

    if (!$CheckPoints) {
        Write-Host "There are no checkpoints older than $Threshold!"
        exit 0
    }
    else {
        Write-Warning "There are checkpoints older than $Threshold!"
        $Checkpoints | Format-Table -Property VMName, Name, CreationTime | Out-String | Write-Host
        exit 1
    }
}end {
    
    
    
}

 

Greifen Sie auf über 300 Skripte im NinjaOne Dojo zu.

Zugang erhalten

Detaillierte Aufschlüsselung des Skripts

Das Skript beginnt mit der Angabe, dass es PowerShell Version 5.1 benötigt. Es enthält einen SYNOPSIS-Abschnitt, der seinen Zweck erklärt: Informationen über Hyper-V-Prüfpunkte auf einer bestimmten Maschine zu sammeln, mit einem optionalen Schwellenwert-Parameter, um Prüfpunkte herauszufiltern, die älter als eine bestimmte Anzahl von Tagen sind. Das Skript akzeptiert auch ein ganzzahliges benutzerdefiniertes Feld, um diesen Schwellenwert zu bestimmen.

Beispiel für die Verwendung:

  • Ohne Parameter: Zeigt alle Prüfpunkte an, die älter als ein Standardschwellenwert sind.
  • Mit dem Parameter -OlderThan: Filtert Prüfpunkte, die älter als die angegebene Anzahl von Tagen sind.
  • Mit dem Parameter -FromCustomField: Verwendet ein benutzerdefiniertes Feld zur Bestimmung des Schwellenwerts.

Parameter-Definitionen

Das Skript akzeptiert zwei Parameter:

  • -OlderThan [int]: Gibt die Anzahl der Tage an, die als Schwellenwert verwendet werden sollen.
  • -FromCustomField [string]: Gibt den Namen eines benutzerdefinierten Feldes an, das den Schwellenwert enthält.

Anfangsphase: Umgebungsüberprüfungen:

Der Begin-Block des Skripts richtet Umgebungsüberprüfungen und Funktionen ein, um festzustellen, ob das Skript mit erhöhten Rechten oder unter dem Systemkonto ausgeführt wird. Dadurch wird sichergestellt, dass das Skript auf die erforderlichen Ressourcen zugreifen und seine Aufgaben ohne Probleme mit den Berechtigungen ausführen kann.

Definierte Funktionen:

  • Test-IsElevated: Überprüft, ob das Skript mit Administratorrechten ausgeführt wird.
  • Test-IsSystem: Verifiziert, ob das Skript unter dem Systemkonto ausgeführt wird.

Wenn keine der beiden Bedingungen erfüllt ist, wird das Skript mit einer Fehlermeldung beendet, um sicherzustellen, dass es in einem sicheren Kontext ausgeführt wird.

Verarbeitungsphase: Prüfpunkt-Filterung

Im Prozessblock berechnet das Skript das Schwellwertdatum auf der Grundlage des Parameters OlderThan oder des Wertes aus dem benutzerdefinierten Feld. Es ruft alle Hyper-V-Prüfpunkte ab und filtert sie basierend auf ihrer Erstellungszeit, die mit dem Schwellenwertdatum verglichen wird.

Wichtige Operationen:

  • Get-VM | Get-VMSnapshot | Where-Object { $_.CreationTime -lt $Threshold }: Ruft Prüfpunkte ab, die älter als das Schwellendatum sind, und filtert sie.
  • Zeigt eine Warnmeldung an, wenn ältere Prüfpunkte gefunden werden, und listet deren Details auf (VM-Name, Prüfpunkt-Name, Erstellungszeit).
  • Beendet sich mit einem Statuscode, der angibt, ob alte Prüfpunkte gefunden wurden.

Potenzielle Anwendungsfälle

Stellen Sie sich vor, ein IT-Experte verwaltet eine große Hyper-V-Umgebung mit mehreren virtuellen Maschinen. Er muss sicherstellen, dass die Prüfpunkte, die älter als 30 Tage sind, überprüft und gelöscht werden, um eine optimale Leistung und Speichernutzung zu gewährleisten. Wenn er dieses Skript mit dem Parameter -OlderThan 30 ausführt, kann er veraltete Prüfpunkte schnell erkennen und beheben und so potenzielle Probleme verhindern, bevor sie eskalieren.

Vergleiche mit anderen Methoden

Bei herkömmlichen Methoden zur Verwaltung von Hyper-V-Prüfpunkten wird jede virtuelle Maschine manuell überprüft, was zeitaufwändig und fehleranfällig ist. Im Gegensatz dazu automatisiert dieses PowerShell-Skript den Prozess und bietet eine schnelle und zuverlässige Methode zur Überwachung von Prüfpunkten. Andere Lösungen bestehen beispielsweise in Management-Tools von Drittanbietern, die jedoch kostspielig sein können und zusätzliche Schulungen erfordern.

Häufig gestellte Fragen

F: Kann dieses Skript auf jedem Windows-Betriebssystem ausgeführt werden?

A: Das Skript unterstützt Windows 10 und Server 2016 oder höher.

F: Was passiert, wenn das Skript keine alten Prüfpunkte findet?

A: Es zeigt eine Meldung an, die besagt, dass keine Prüfpunkte älter als der angegebene Schwellenwert sind, und beendet sich mit dem Statuscode 0.

F: Wie kann ich ein benutzerdefiniertes Feld für den Schwellenwert verwenden?

A: Geben Sie den Namen des benutzerdefinierten Feldes mit dem Parameter -FromCustomField an. Stellen Sie sicher, dass das Feld den gewünschten Schwellenwert in Tagen enthält.

Auswirkungen auf die IT-Sicherheit und -Effizienz

Die regelmäßige Überwachung und Verwaltung von Hyper-V-Prüfpunkten kann die Systemleistung und -sicherheit erheblich verbessern. Durch die Identifizierung und Beseitigung veralteter Prüfpunkte können IT-Experten Speicherplatzmangel und mögliche Leistungseinbußen verhindern. Skripte wie dieses zur Automatisierung von Hyper-V-Prüfpunkt-Warnmeldungen gewährleisten ein konsistentes und effizientes Prüfpunkt-Management, sodass sich IT-Administratoren auf wichtigere Aufgaben konzentrieren können.

Best Practices für die Verwendung des Skripts

  • Führen Sie das Skript mit Administratorrechten aus, um einen ordnungsgemäßen Zugriff auf alle erforderlichen Ressourcen zu gewährleisten.
  • Planen Sie die Ausführung des Skripts in regelmäßigen Abständen mithilfe des Task-Planers, um für eine kontinuierliche Überwachung zu sorgen.
  • Überprüfen Sie den Schwellenwert vom Parameter OlderThan und passen Sie ihn an die spezifischen Anforderungen Ihrer Umgebung an.

Abschließende Überlegungen

Die effiziente Verwaltung von Hyper-V-Prüfpunkten ist entscheidend für die Aufrechterhaltung einer optimalen Leistung und Sicherheit in virtualisierten Umgebungen. Dieses PowerShell-Skript bietet eine leistungsstarke, automatisierte Lösung für die Überwachung und Benachrichtigung von Administratoren über veraltete Prüfpunkte. Durch die Integration solcher Tools in ihre Arbeitsabläufe können IT-Experten sicherstellen, dass ihre Systeme sauber, effizient und sicher bleiben.

NinjaOne bietet eine Reihe von Tools und Funktionen, die Ihre IT-Management-Prozesse weiter verbessern und eine umfassende Lösung für Überwachungs-, Automatisierungs- und Wartungsaufgaben bieten. Die Integration von NinjaOne mit Skripten wie diesem kann Ihre Abläufe rationalisieren und die Gesamteffizienz verbessern.

Nächste Schritte

Der Aufbau eines effizienten und effektiven IT-Teams erfordert eine zentralisierte Lösung, die als einheitliches Tool zur Bereitstellung von IT-Dienstleistungen fungiert. NinjaOne ermöglicht es IT-Teams, alle Geräte zu überwachen, zu verwalten, zu sichern und zu unterstützen, unabhängig vom Standort, ohne dass eine komplexe Infrastruktur vor Ort erforderlich ist.

Erfahren Sie mehr über NinjaOne Remote Script Deployment, sehen Sie sich eine Live-Tour an oder starten Sie Ihre kostenlose Testversion unserer NinjaOne Plattform.

Kategorien:

Das könnte Sie auch interessieren

×

Sehen Sie NinjaOne in Aktion!

Mit dem Absenden dieses Formulars akzeptiere ich die Datenschutzerklärung von NinjaOne.

NinjaOne Allgemeine Geschäftsbedingungen für Skripte

Indem Sie unten auf die Schaltfläche “Ich akzeptiere” klicken, erklären Sie Ihr Einverständnis mit den folgenden rechtlichen Bedingungen sowie mit unseren Nutzungsbedingungen:

  • Eigentumsrechte: NinjaOne besitzt und wird weiterhin alle Rechte, Titel und Interessen an dem Skript (einschließlich des Urheberrechts) behalten. NinjaOne gewährt Ihnen eine eingeschränkte Lizenz zur Nutzung des Skripts in Übereinstimmung mit diesen rechtlichen Bedingungen.
  • Einschränkung der Nutzung: Sie dürfen das Skript nur für Ihre legitimen persönlichen oder internen Geschäftszwecke verwenden und es nicht an Dritte weitergeben.
  • Verbot der Wiederveröffentlichung: Sie sind unter keinen Umständen berechtigt, das Skript in einer Skriptbibliothek, die einem anderen Softwareanbieter gehört oder von diesem kontrolliert wird, erneut zu veröffentlichen.
  • Gewährleistungsausschluss: Das Skript wird “wie gesehen” und “wie verfügbar” bereitgestellt, ohne jegliche Garantie. NinjaOne gibt keine Versprechen oder Garantien, dass das Skript frei von Fehlern ist oder dass es Ihre speziellen Bedürfnisse oder Erwartungen erfüllt.
  • Risikoübernahme: Die Verwendung des Skripts erfolgt auf eigene Gefahr. Sie erkennen an, dass die Nutzung des Skripts mit bestimmten Risiken verbunden ist, und Sie verstehen und übernehmen jedes dieser Risiken.
  • Verzicht und Freigabe: Sie machen NinjaOne nicht für nachteilige oder unbeabsichtigte Folgen verantwortlich, die sich aus Ihrer Nutzung des Skripts ergeben, und Sie verzichten auf alle gesetzlichen oder billigkeitsrechtlichen Rechte oder Rechtsmittel, die Sie gegen NinjaOne im Zusammenhang mit Ihrer Nutzung des Skripts haben könnten.
  • EULA: Wenn Sie ein NinjaOne-Kunde sind, unterliegt Ihre Nutzung des Skripts dem für Sie geltenden Endbenutzer-Lizenzvertrag (EULA).