PowerCLI Reference

vSphere Auto Deploy Reference

Remove-DeployRule

Synopsis

Removes a rule from the working rule set.

Syntax

Remove-DeployRule [-DeployRule] <DeployRule[]> [-Delete] [-NoActivate] [<CommonParameters>]
Remove-DeployRule [-At] <UInt32> [-Delete] [-NoActivate] [<CommonParameters>]

Related Commands

Add-DeployRule

Detailed Description

Removes a rule from the working rule set. By default, the working rule set is then activated. Use the "-Delete" parameter to permanently delete the rule from the Auto Deploy server.

You must have the "AutoDeploy.RuleSet.Edit" privilege on the root folder of vCenter Server to remove a rule from the rule set and the "AutoDeploy.Rule.Delete" privilege to delete the rule.

Parameters

Name Type Description Required? Pipeline Input Default Value
At UInt32 Index in the rule set that you want to remove. true false
DeployRule DeployRule[] Rule to remove from the working rule set. true true (ByValue)
Delete Delete the rule object. This flag will permanently delete the rule from the AutoDeploy server and remove it from any RuleSets that it was in. false false
NoActivate SwitchParameter Specify this parameter to only remove the rule to the working rule set. By default, the working rule set is activated after the change. false false

Return Type

Notes

Examples

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

C:\PS> Get-DeployRule "testrule" | Remove-DeployRule


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