## PowerCLI Reference

# Test-VMHostProfileCompliance

## Synopsis

This cmdlet tests hosts for profile compliance.

Syntax

Test-VMHostProfileCompliance [-VMHost] <VMHost[]> [-UseCache] [[-Server] <VIServer[]>] [<CommonParameters>]
Test-VMHostProfileCompliance [-Profile] <VMHostProfile[]> [-UseCache] [[-Server] <VIServer[]>] [<CommonParameters>]

Related Commands

Online version
Invoke-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
New-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile

Detailed Description

This cmdlet tests hosts for profile compliance. The Profile and VMHost parameters cannot be set at the same time. If the Profile parameter is set, the specified host profile is tested for compliance with the hosts, to which it is associated. If the VMHost parameter is specified, the host is tested for compliance with the profiles associated with it. If no profiles are associated with the host, then the profile associated with the cluster is applied.

Parameters

Name | Type | Description | Required? | Pipeline Input | Default Value
--- | --- | --- | --- | --- | ---
Profile | VMHostProfile[] | Specifies a host profile against which to test the specified host for compliance with the host to which it is associated. Do not set this parameter if the VMHost parameter is set. | true | true (ByValue)
VMHost | VMHost[] | Specifies the host you want to test for profile compliance with the profile associated with it. If no profile is associated with it, the host is tested for compliance with the profile associated with the cluster, to which the host belongs. Do not set this parameter if the Profile parameter is set. | true | true (ByValue)
Server | VIServer[] | Specifies the vCenter Server systems on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of Connect-VIServer. | false | false
UseCache | SwitchParameter | Indicates that you want the vCenter Server to return cached information. If vCenter Server does not have cached information, a compliance scanning is performed. | false | false

Return Type

Zero or more VMHostProfileIncompliance objects

Notes

Examples

-------------- Example 2 --------------

    Test-VMHostProfileCompliance -VMHost Host

Tests the specified host for compliance with the profiles associated with it.

-------------- Example 3 --------------

    $profile = Get-VMHostProfile -Name Profile

    Apply-VMHostProfile -AssociateOnly -Profile $profile -Entity 10.0.0.126

    Test-VMHostProfileCompliance -VMHost 10.0.0.126 | fl *

Test the profile compliance of a non-compliant virtual machine host associated with the profile.

-------------- Example 4 --------------

    Test-VMHostProfileCompliance -Profile $profile | fl *

Test the profile compliance of a virtual machine host profile with the hosts it is associated with.

Copyright © VMware, Inc. All rights reserved.