vSphere PowerCLI Reference

Test-VMHostProfileCompliance

Synopsis

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
Apply-VMHostProfile
Export-VMHostProfile
Get-VMHostProfile
Import-VMHostProfile
New-VMHostProfile
Remove-VMHostProfile
Set-VMHostProfile

Detailed Description

Tests hosts for profile compliance. The Profile and VMHost parameters cannot be set at one and 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 to the host, then the profile associated with the cluster is applied.

Parameters

NameTypeDescriptionRequired?Pipeline InputDefault Value
ProfileVMHostProfile[]Specify 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.truetrue (ByValue)
VMHostVMHost[]Specify 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.truetrue (ByValue)
ServerVIServer[]Specify the vSphere servers 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.falsefalse
UseCacheSwitchParameterIndicate that you want the vCenter Server to return cached information. If vCenter Server does not have cashed information, a compliance scanning is performed.falsefalse

Return Type

VMHostProfileIncompliance

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 © 1998 - 2012 VMware, Inc. All rights reserved.