PowerCLI Reference

vSphere Auto Deploy Reference

Set-DeployRule

Synopsis

Updates an existing rule.

Syntax

Set-DeployRule [-DeployRule] <DeployRule> [-Name <String>] [-Pattern <String[]>] [-AllHosts] [-Item <VIObjectCore[]>] [<CommonParameters>]

Related Commands

Copy-DeployRule
New-DeployRule

Detailed Description

Updates an existing rule with the specified items, patterns, or both. Rules cannot be changed once they have been used in the active rule set. Use Copy-DeployRule to make a copy of a rule with any desired changes.^M
^M
You must have the "AutoDeploy.Rule.Edit" privilege on the root folder of vCenter Server to use this cmdlet.

Parameters

< td>false
Name Type Description Required? Pipeline Input Default Value
DeployRule DeployRule The rule to be changed. Use the DeployRule or the Name parameter to specify the rule. true false
AllHosts SwitchParameter Specify AllHosts to apply the changed rule to all hosts. Specify either AllHosts or Pattern. false false
Item VIObjectCore[] Item to apply to the specified hosts. The item can be an image profile, a script bundle, a host profile, or a cluster or folder in a vCenter Server system. This parameter supports object-by-name, so you can pass the name of the item. false true (ByValue)
Name String Name of the rule to apply changes to. Use the DeployRule or the Name parameter to specify the rule. false
Pattern String[] Pattern that identifies the hosts to apply the rule to. Specify either AllHosts or Pattern. ^M
^M
Pattern strings use the following syntax: ^M
^M
<attr>==<value> Adds a pattern that exactly matches the specified value against the specified attribute. Use this syntax if you need to match a string that contains a comma.^M
^M
<attr>=<Val1 >[,val2,... ,valN] Adds a pattern that matches against the comma-separated list of values. ^M
^M
Supported value types are: ^M
^M
string Exact string match^M
<ip1>-<ip2> Range of IPv4 addresses.
false false

Return Type

VMware.DeployAutomation.Types.DeployRule 2

Notes

Examples

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

C:\PS> Set-DeployRule $rule -Pattern "ipv4=192.168.1.10-192.168.1.20"

Updates the rule to apply to the hosts with IPv4 addresses in the specified range.


Copyright © 1998 - 2011 VMware, Inc.&nbs p;All rights reserved.