Test and Repair Rule Compliance

When you add a rule to the vSphere Auto Deploy rule set or make changes to one or more rules, hosts are not updated automatically. vSphere Auto Deploy applies the new rules only when you test their rule compliance and perform remediation.

Prerequisites

Prepare Your System for vSphere Auto Deploy
Verify that your infrastructure includes one or more ESXi hosts provisioned with vSphere Auto Deploy, and that the host on which you installed PowerCLI can access those ESXi hosts.

Procedure

In a PowerCLI session, run the Connect-VIServer cmdlet to connect to the vCenter Server system that vSphere Auto Deploy is registered with.
```
Connect-VIServer ipv4_or_ipv6_address
```
The cmdlet might return a server certificate warning. In a production environment, make sure no server certificate warnings result. In a development environment, you can ignore the warning.
Use PowerCLI to check which vSphere Auto Deploy rules are currently available.
```
Get-DeployRule
```
The system returns the rules and the associated items and patterns.
Make a change to one of the available rules.
For example, you can change the image profile and the name of the rule.
```
Copy-DeployRule -DeployRule testrule -ReplaceItem MyNewProfile 
			 
```
You cannot edit a rule already added to the active rule set. Instead, you can copy the rule and replace the item or pattern you want to change.
Verify that you can access the host for which you want to test rule set compliance.
```
Get-VMHost -Name MyEsxi42
```
Run the cmdlet that tests rule set compliance for the host, and bind the return value to a variable for later use.
```
$tr = Test-DeployRuleSetCompliance MyEsxi42
```
Examine the differences between the contents of the rule set and configuration of the host.
```
$tr.itemlist
```
The system returns a table of current and expected items if the host for which you want to test the new rule set compliance is compliant with the active rule set.
```
CurrentItem                             ExpectedItem
-----------                             ------------   
My Profile 25                           MyNewProfile
```
Remediate the host to use the revised rule set the next time you boot the host.
```
Repair-DeployRuleSetCompliance $tr
```

What to do next

If the rule you changed specified the inventory location, the change takes effect when you repair compliance. For all other changes, reboot your host to have vSphere Auto Deploy apply the new rule and to achieve compliance between the rule set and the host.