Added VMsStatusReport file (#465)
* Added VMsStatusReport file * fixed typo and added space before and after | * Modified script to fuction with VIServerFilePath and OutPath parameters * Refined help section * Changed name from VMsStatusReport.ps1 to Get-VMSnapshotReport.ps1 * help documentation refined * commit * fomating corrections using prettier extension * cmdletbinding correction * added example and fixed parameter issue
This commit is contained in:
Jimit G
GitHub
171
Scripts/Get-VMSnapshotReport.ps1
Normal file
171
Scripts/Get-VMSnapshotReport.ps1
Normal file
@@ -0,0 +1,171 @@
|
||||
<#
|
||||
.SYNOPSIS
|
||||
Creates HTML report of snapshots , Poweroff and PoweredOn VMS
|
||||
|
||||
.DESCRIPTION
|
||||
The purpose of the script is to get a list of all VM Snaphots, Powered On VMs and Powered Off VMs. Utilises css and converts to a good looking html report. HTML format highlights large/old snapshots. This can be scheduled via taks scheduler and emailed to administrators or uplaoded to an IIS web location.
|
||||
|
||||
.NOTES
|
||||
Script name: VMsStatusReport.ps1
|
||||
Created on: 20/06/2021
|
||||
Author: Jimit Gohel, @PsJimKG
|
||||
Dependencies: Along with PowerCli, this script also requires Don Jones EnhancedHTML2 module. https://www.powershellgallery.com/packages/EnhancedHTML2/2.1.0.1
|
||||
===Tested Against Environment====
|
||||
vSphere Version: 6.7
|
||||
PowerCLI Version: PowerCLI 11.5.0
|
||||
PowerShell Version: 5.1
|
||||
OS Version: Windows 10
|
||||
|
||||
.INPUTS
|
||||
VIServerFilePath
|
||||
|
||||
.OUTPUTS
|
||||
html file named VMStatusReport.html
|
||||
|
||||
.PARAMETER VIServerFilePath
|
||||
csv file path to list of viservers
|
||||
|
||||
.PARAMETER Outpath
|
||||
Output path to html report.
|
||||
|
||||
.EXAMPLE
|
||||
PS> Get-VMSnapshotReport -VIServerFilePath "C:\Temp\viservers.csv" -OutPath "C:\MyReports"
|
||||
|
||||
.EXAMPLE
|
||||
PS> Get-VMSnapshotReport "C:\temp\viserverslist.csv" C:\VMReports"
|
||||
|
||||
#>
|
||||
function Get-VMSnapshotReport {
|
||||
|
||||
[CmdletBinding()]
|
||||
Param(
|
||||
[Parameter(Mandatory = $True, Position = 1, ValueFromPipeline = $True)]
|
||||
[ValidateNotNullOrEmpty()]
|
||||
[string]$VIServerFilePath,
|
||||
|
||||
[Parameter(Mandatory = $True, Position = 2)]
|
||||
[string]$OutPath
|
||||
)
|
||||
# path to CSV list of viservers
|
||||
|
||||
$viservers = (Get-Content "$VIServerFilePath")
|
||||
|
||||
Connect-VIServer $viservers
|
||||
|
||||
$CSS2 = "body {
|
||||
color: #333333;
|
||||
font-family: Tahoma;
|
||||
font-size: 10pt;
|
||||
}
|
||||
h1 {
|
||||
text-align: center;
|
||||
}
|
||||
h2 {
|
||||
border-top: 1px solid #666666;
|
||||
}
|
||||
th {
|
||||
font-weight: bold;
|
||||
color: #eeeeee;
|
||||
background-color: #333333;
|
||||
cursor: pointer;
|
||||
}
|
||||
.odd {
|
||||
background-color: #ffffff;
|
||||
}
|
||||
.even {
|
||||
background-color: #bfbfbf;
|
||||
}
|
||||
|
||||
.paginate_enabled_next,
|
||||
.paginate_enabled_previous {
|
||||
cursor: pointer;
|
||||
border: 1px solid #222222;
|
||||
background-color: #dddddd;
|
||||
padding: 2px;
|
||||
margin: 4px;
|
||||
border-radius: 2px;
|
||||
}
|
||||
.paginate_disabled_previous,
|
||||
.paginate_disabled_next {
|
||||
color: #666666;
|
||||
cursor: pointer;
|
||||
background-color: #dddddd;
|
||||
padding: 2px;
|
||||
margin: 4px;
|
||||
border-radius: 2px;
|
||||
}
|
||||
.dataTables_info {
|
||||
margin-bottom: 4px;
|
||||
}
|
||||
.sectionheader {
|
||||
cursor: pointer;
|
||||
}
|
||||
.sectionheader:hover {
|
||||
color: red;
|
||||
}
|
||||
.grid {
|
||||
width: 100%;
|
||||
}
|
||||
.smallgrid {
|
||||
width: 50%;
|
||||
}
|
||||
.red {
|
||||
color: #ff3333;
|
||||
font-weight: bold;
|
||||
}
|
||||
.green {
|
||||
background-color: #00cc44;
|
||||
font-weight: bold;
|
||||
}
|
||||
"
|
||||
|
||||
#Capturing VMs data
|
||||
$vms = Get-VM
|
||||
|
||||
#reportgeneratedtag
|
||||
$reportgeneratedtag = (Get-Date -Format "dd MMMM yyyy HH:mm:ss")
|
||||
|
||||
#Capturing data for snapshots
|
||||
|
||||
$paramsSnapshotFragment = @{'As' = 'Table';
|
||||
'PreContent' = '<h2>VM Snapshots</h2>';
|
||||
'MakeTableDynamic' = $true;
|
||||
'TableCssClass' = 'grid';
|
||||
'Properties' = 'VM', @{Name = 'SnapshotName'; Expression = { $_.Name } }, 'Created', @{Name = 'AgeDays'; Expression = { ((New-TimeSpan -Start $_.Created -End (get-date)).Days) }; css = { if (((New-TimeSpan -Start $_.Created -End (get-date)).Days) -gt 120) { 'red' } } }, 'Description', @{name = 'SizeGB'; expression = { [math]::Round($_.sizegb, 2) }; css = { if ($_.sizegb -gt 100) { 'red' } } }, 'PowerState', 'IsCurrent', 'ParentSnapshot', 'Children'
|
||||
}
|
||||
$snapshots = $vms | Get-Snapshot | ConvertTo-EnhancedHTMLFragment @paramsSnapshotFragment
|
||||
|
||||
#PoweredOff
|
||||
|
||||
$paramsPoweredoff = @{'As' = 'Table';
|
||||
'PreContent' = '<h2>Powered Off VMs</h2>';
|
||||
'MakeTableDynamic' = $true;
|
||||
'TableCssClass' = 'grid';
|
||||
'Properties' = 'Name', 'PowerState', 'Notes' , 'Folder'
|
||||
}
|
||||
$poweredoffvms = $vms | Where-Object { $_.PowerState -ne 'PoweredOn' } | ConvertTo-EnhancedHTMLFragment @paramsPoweredoff
|
||||
|
||||
#PoweredOn
|
||||
|
||||
$paramsPoweredon = @{'As' = 'Table';
|
||||
'PreContent' = '<h2>Powered On VMs</h2>';
|
||||
'MakeTableDynamic' = $true;
|
||||
'TableCssClass' = 'grid';
|
||||
'Properties' = 'Name', 'PowerState', 'Notes' , 'Folder'
|
||||
}
|
||||
$poweredonvms = $vms | Where-Object { $_.PowerState -eq 'PoweredOn' } | ConvertTo-EnhancedHTMLFragment @paramsPoweredon
|
||||
|
||||
|
||||
# Finalising main html report
|
||||
$paramsMainHTML = @{
|
||||
'HTMLFragments' = $reportgeneratedtag, $snapshots, $poweredoffvms, $poweredonvms
|
||||
'CssStyleSheet' = $CSS2;
|
||||
'Title' = 'VM Status Report';
|
||||
'PreContent' = "<h1>VM Status Report</h1>"
|
||||
}
|
||||
ConvertTo-EnhancedHTML @paramsMainHTML | Out-File "$OutPath\VMStatusReport.html" -Encoding utf8
|
||||
|
||||
|
||||
Disconnect-VIServer -Server $viservers -Force -Confirm:$false
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user