Test-HostProfileCompliance

VMware: Tests hosts for profile compliance

Script

#Requires -Version 5.1
#Requires -Modules VMware.VimAutomation.Core
[CmdletBinding(DefaultParameterSetName = "Host")]
Param(
    [Parameter(Mandatory = $true, ParameterSetName = "Host")]
    [Parameter(Mandatory = $true, ParameterSetName = "Profile")]
    [string]$VIServer,
    [Parameter(Mandatory = $true, ParameterSetName = "Host")]
    [Parameter(Mandatory = $true, ParameterSetName = "Profile")]
    [pscredential]$VICredential,
    [Parameter(Mandatory = $true, ParameterSetName = "Profile")]
    [string]$ProfileName,
    [Parameter(Mandatory = $true, ParameterSetName = "Host")]
    [string]$HostName,
    [Parameter(ParameterSetName = "Host")]
    [Parameter(ParameterSetName = "Profile")]
    [switch]$UseCache
)
Process {
    $vmServer = $null
    try {
        $vmServer = Connect-VIServer -Server $VIServer -Credential $VICredential -ErrorAction Stop
        $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
        if ($PSCmdlet.ParameterSetName -eq "Profile") {
            $profile = Get-VMHostProfile -Server $vmServer -Name $ProfileName -ErrorAction Stop
            $result = Test-VMHostProfileCompliance -Server $vmServer -Profile $profile -UseCache:$UseCache -ErrorAction Stop | Select-Object *
        }
        else {
            $vmHost = Get-VMHost -Server $vmServer -Name $HostName -ErrorAction Stop
            $result = Test-VMHostProfileCompliance -Server $vmServer -VMHost $vmHost -UseCache:$UseCache -ErrorAction Stop | Select-Object *
        }
        foreach ($item in $result) {
            $item | Add-Member -NotePropertyName 'Timestamp' -NotePropertyValue $timestamp -Force
            Write-Output $item
        }
    }
    catch { throw }
    finally { if ($null -ne $vmServer) { Disconnect-VIServer -Server $vmServer -Force -Confirm:$false -ErrorAction SilentlyContinue } }
}

Customize

VIServer string

IP address or DNS name of the vSphere server

VICredential pscredential

PSCredential object for authenticating with the server

ProfileName string

Host profile against which to test compliance

HostName string

Host to test for profile compliance

UseCache switch

Off

Use cached vCenter Server information