vSphere PowerCLI Reference



Checks whether hosts are compliant with rules.


Test-DeployRuleSetCompliance [-DeployRuleSet <DeployRuleSet>] [-VMHost] <VMHost[]> [<CommonParameters>]

Related Commands


Detailed Description

Checks whether the specified hosts are compliant with a specified rule set. If not rule set is specified, the currently active rule set is used.

For example, if a rule specifies a particular host profile should be attached to a host, and a different host profile is actually attached to that host, the host is out of compliance.

The output of this cmdlet is a TestResult object that contains the VMHost object and a list containing the current item associated with the host and the expected item, according to the rules. If the list of items is empty, the host is in compliance with the rule set.


NameTypeDescriptionRequired?Pipeline InputDefault Value
VMHostVMHostHost to check for compliance.truetrue (ByValue)
DeployRuleSetDeployRuleSetRule set to use for checking compliance. The active rule set is used by default.falsefalse

Return Type




-------------- Example 1 --------------

C:\PS> Test-DeployRuleSetCompliance h1

Check the compliance of ESXi host "h1" against the active rule set.

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

C:\PS> Get-VMHost h1 | Test-DeployRuleSetCompliance

Check the compliance of ESXi host "h1" against the active rule set.

Copyright © 1998 - 2014 VMware, Inc. All rights reserved.