Syntax
Test-VMHostProfileCompliance [-VMHost] <VMHost[]> [-UseCache] [[-Server] <VIServer[]>] [<CommonParameters>]Related Commands
Online versionDetailed 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 objectsNotes
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.