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

This task assumes that your infrastructure includes one or more ESXi hosts provisioned with Auto Deploy, and that the host on which you installed vSphere PowerCLI can access those ESXi hosts.

Install vSphere PowerCLI and all prerequisite software.

If you encounter problems running PowerCLI cmdlets, consider changing the execution policy. See the information about using Auto Deploy Cmdlets in the vSphere Installation and Setup documentation.

1

Use PowerCLI to check which Auto Deploy rules are currently available.

Get-DeployRule

The system returns the rules and the associated items and patterns.

2

Make a change to one of the available rules, for example, you might change the image profile and the name of the rule.

Copy-DeployRule -DeployRule testrule -ReplaceItem MyNewProfile

You cannot edit a rule already added to a rule set. Instead, you copy the rule and replace the item or pattern you want to change. By default, PowerCLI uses the old name for the copy and hides the old rule.

3

Verify that the host that you want to test rule set compliance for is accessible.

Get-VMHost -Name MyEsxi42

4

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

5

Examine the differences between what is in the rule set and what the host is currently using.

$tr.itemlist

The system returns a table of current and expected items.


CurrentItem                             ExpectedItem
-----------                             ------------   
My Profile 25                           MyProfileUpdate
6

Remediate the host to use the revised rule set the next time you boot the host.

Repair-DeployRuleSetCompliance $tr

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