ⓘ Dikkat: Bu araç uzun süre önce sonlanmıştır / This script is no longer available
Standalone veya Clustered Hyper-V ortamlarını raporlamak ve belirli açılardan izlemek için kullanabileceğiniz Get-HyperVReport.ps1 raporlama script’inin 1.5 sürümü indirmek için hazır! Her zamanki gibi TechNet Gallery bağlantısını ziyaret ederek yeni sürümü edinebilirsiniz. Bu arada blog üzerinde bahsetme fırsatım olmadı ama geçen ay ufak bir bakım sürümü de yayınlamıştım (v1.1). Bir güncelleme var mı diye TehNet Gallery’i ziyaret edenler fark etmiş olabilirler. Şimdi gelelim yeni sürüme.
Get-HyperVReport.ps1 v1.5
Bu sürümde yer alan tüm yenilikleri ve bu yeni özellikler hakkında bazı ilave bilgileri aşağıda listeledim.
Cluster Overview bölümü
Cluster içerisinde kaç adet node var ve bunlardan kaçı up durumda? Ortamda kaç adet kullanılabilir logical processor var ve bunlar üzerinde kaç adat virtual processor çalışıyor? Cluster’ın toplam bellek ve depolama alanı kapasiteleri ne durumda? Cluster’a üye kaç VM var ve kaçı çalışır durumda? Veya bu VM’ler cluster’ın bellek ve depolama kaynaklarının toplamda ne kadarını tüketiyor? gibi soruların yanıtlarını bu bölümde bulabilirsiniz. Cluster Overview bölümünü sadece -Cluster
parametresiyle raporlama yaparken görebileceğinizi unutmayın.
Storage Overcommitment (Active VHD) sütunu
Script, raporladığı herhangi bir depolama alanı içerisindeki aktif VHD’leri tespit ediyor ve bu VHD’lerin maximum genişleme kapasitelerini hesaplayıp o fiizksel depolama alanının maximum size’ı ile karşılaştırıyor. Söz konusu VHD’lere eğer mevcut kapasitenin üzerinde atama yapılmışsa, ileride oluşabilecek taşma durumuna karşı önceden uyarı oluşturuyor. Özellikle dinamik VHD’lerle çalışan ortamlar için günde 1 doz öneririm :)
Extended Replica için raporlama desteği
Artık aynı rapor içerisinde -extended dahil- her üç replication mode’u da izleyip o anki durumları hakkında bilgiler alabilirsiniz. Mesela aşağıdaki VM, node14.ipw.corp isimli Primary Server’dan bu sunucuya Replica olarak gelmiş ve buradan da external.inprowise.com isimli bir başka Hyper-V sunucusuna Extended Replica ile çoğaltılmış durumda. Son replikasyon ne zaman gerçekleşmiş, replikasyon sıklığı, replikasyon durumu gibi ek bilgiler de izlerken işinizi kolaylaştıracaktır.
Hyper-V Host’lar için bazı yeni bilgiler
Aşağıdaki bilgileri her bir Hyper-V Host için raporda görmeniz mümkün. Diğer birçok ilave bilgi gibi tamamı tooltip’ler içerisinde sağlanıyor.
- Logical Processor başına düşen Virtual Processors oranı. (ratio)
- Host Computer Manufacturer, Model.
- Processor Manufacturer, Model, Ghz.
- Çalışır durumdaki VM’ler için Clustered ve non-clustered dağılımı.
VM Virtual Network bilgileri
VM’lere bağlı network adapter’ler üzerinde yer alan ağıdaki bilgileri yine VM bazlı olarak raporda görmeniz mümkün.
- Network adapter device type (Synthetic/Legacy)
- Connection status (Connected/Not-connected)
- Virtual switch name (Eğer bağlıysa)
- IP address (v4/v6)
- VLAN ID (Eğer atanmışsa)
- Advanced – MAC Address, MAC Type, DHCP Guard, Raouter Guard, Port Mirroring, Protected Network
Yeni $ReportFileNameTimeStamp parametresi
Varsayılan olarak $true’dur. Script’i çalıştırırken bu parametreyi $false yaparsanız çalışma sonunda oluşan rapor dosyası ismine tarih/saat bilgisi eklenmez ve her zaman aynı isme sahip bir html dosyası oluşur. Mesela bu parametreyle ve belirli periyotlarda çalışmak üzere zamanlanmış bir Windows görevinin çıktısını doğrudan bir web server dizinine yazdırarak raporu daha kolay takip etmek mümkün olabilir. Hatta zamanlanmış görevin çalışma periyotlarını ve web sayfasının yenileme sıklığını düzenleyerek belki basit bir monitoring ekranı bile oluşturabilirsiniz.
$ReportIsBodyHTML parametresi artık yok
Bu parametreyi 1.1 sürümünde eklemiştim ve HTML raporu doğrudan e-mail message body olarak gönderiyordu. Böylece gelen mail’de her seferinde dosyayı açmak yerine doğrudan mail body alanında rapor sonucuna bakabiliyordunuz. Ancak Outlook gibi mail istemcilerin HTML/CSS yorumlamadaki farklı yaklaşımları nedeniyle uyumlu görünümü koruma noktasında sorunlar yaşadım. Farklı browser’lar için görünüm standardını korumak nispeten kolay ama mail istemciler tam bir baş belası. Geldiğim noktada bununla daha fazla uğraşmak istemediğim için kaldırdım. Zaten rapor da bir mail istemcide okumak için fazla geniş.
Runtime environment olarak Windows 8 ve Windows 8.1 desteği
Artık Get-HypervReport.ps1’i domain member istemciler üzerinden de çalıştırabilirsiniz. Öncesinde Hyper-V ve Clustering PowerShell module’lerinin aktif edilmiş olması gerektiğini unutmayın.
Şimdilik böyle.
05.03.2015 - 15:24
Merhaba Serhat Hocam,
Yine eline, fikrine, emeğine sağlık.
05.03.2015 - 16:37
Kullanıyoruz, mükemmel :)
29.06.2016 - 11:47
Merhaba Serhat Bey,
Bu güzel çalışma için çok teşekkürler.
Scripti çalıştırdığımda çalıştırdığım makine üzerinde sanal makine olmadığına dair hata veriyor.
[DEBUG] – 29.Jun.2016 11:38:14 – —– Start —–
[INFO] – 29.Jun.2016 11:38:14 – Logging started: C:\Users\emre\ScriptLog.txt
[INFO] – 29.Jun.2016 11:38:17 – Checking prerequisites to run script on the NODE3…
[DEBUG] – 29.Jun.2016 11:38:17 – NODE3: Operating system is supported as script runtime environment.
[DEBUG] – 29.Jun.2016 11:38:18 – NODE3: Hyper-V PowerShell Module is OK.
[DEBUG] – 29.Jun.2016 11:38:18 – NODE3: Failover Clustering PowerShell Module is OK.
[INFO] – 29.Jun.2016 11:38:18 – NODECLS is accessible. Gathering Node information…
[INFO] – 29.Jun.2016 11:38:21 – Checking prerequisites for Hyper-V Cluster reporting…
[DEBUG] – 29.Jun.2016 11:38:26 – Operating system version and Hyper-V role on the cluster owner node is OK.
[INFO] – 29.Jun.2016 11:38:27 – Available Hyper-V Cluster Node(s) for reporting: NODE1 NODE2 NODE3
[INFO] – 29.Jun.2016 11:38:30 – Gathering Hyper-V Host information…
[INFO] – 29.Jun.2016 11:38:45 – Gathering Virtual Machine information…
[WARNING] – 29.Jun.2016 11:43:18 – NODE3: Does not have Virtual Machine.
[INFO] – 29.Jun.2016 11:43:21 – Gathering Disk/Volume information…
[INFO] – 29.Jun.2016 11:43:24 – Writing output to file C:\Users\emre\HyperVReport-29Jun16-113814AM.html
[INFO] – 29.Jun.2016 11:43:24 – Report created successfully.
[INFO] – 29.Jun.2016 11:43:24 – Completed!
[DEBUG] – 29.Jun.2016 11:43:24 – —– End —–
Bu konuda bir yorumunuz olur mu acaba?
17.04.2017 - 13:22
HI!
I found your very good script here: https://gallery.technet.microsoft.com/scriptcenter/Hyper-V-Reporting-Script-4adaf5d0
Do you have a updated version for this script? Every integration versin is marked update needed.
Br Andras
30.11.2017 - 15:56
Merhaba Serhat Hocam ,
Windows Server 2016 işletim sistemleri HYPER-V raporu almayı çalışıyorum. https://gallery.technet.microsoft.com/Hyper-V-Reporting-Script-4adaf5d0/view/Discussions/1 linki konuda dediğimiz yapmıştık. Ama Script Terminated olarak görünüyor.
Bu konuda yardımcın olur musun?
30.11.2017 - 16:03
PS C:\Script> .\Get-HyperVReport.ps1 -Cluster ClusterName
[INFO] – 16:00:38 – Started! Hyper-V Reporting Script (Version 1.5)
[INFO] – 16:00:41 – Logging started: C:\Script\ScriptLog.txt
[INFO] – 16:00:44 – Checking prerequisites to run script on the OCTISTHYP02…
[INFO] – 16:00:46 – OCTISTHYPCLS is accessible. Gathering Node information…
[INFO] – 16:00:49 – Checking prerequisites for Hyper-V Cluster reporting…
[WARNING] – 16:00:52 – OCTISTHYPCLS: Incompatible operating system version detected. Supported operating systems are Win
dows Server 2012 and Windows Server 2012 R2.
[ERROR] – 16:00:52 – Script terminated!
24.09.2019 - 14:54
Hi Serhat,
Could you help me with the script. The script gives an error! please help me with it.
PS C:\Windows\system32> cd C:\Get-HyperVReport_Copy
PS C:\Get-HyperVReport_Copy> .\Get-HyperVReport.ps1
[INFO] – 13:51:21 – Started! Hyper-V Reporting Script (Version 1.6)
[INFO] – 13:51:24 – Logging started: C:\Get-HyperVReport_Copy\ScriptLog.txt
[ERROR] – 13:51:27 – Hyper-V target parameter is missing. Use -Cluster or -VMHost parameter to define target.
[WARNING] – 13:51:27 – For technical information, type: Get-Help .\Get-HyperVReport.ps1 -examples
[ERROR] – 13:51:27 – Script terminated!
14.02.2024 - 15:59
could you help me with the script run in windows 2022 hyper-v …it gives error in 2022.
your great help would be highly Appreciated….thanks