New-LCMClusterRuleWithTransform
Create a new Rule based on the provided parameters.This API takes in a Rule name, a list of Rule.Pattern items and a Lifecycle managed Cluster whch is to be used to retrieve the desired software specification and any Host Profile attached to the target Cluster. This API will also generate and cache a new PxeProfile (if needed) based on the desired software specification retrieved from the Lifecycle managed Cluster. All the resulting items will be populated in the Rule.Spec object associated with the newly created Rule.
Syntax
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
LcmCluster | VIObjectCore | named |
|
A vCenter Cluster managed by Lifecycle to be used as a source for the desired soft specification and Host Profile to be used for the host(s) bootstrap |
| required
|
Name | String | named |
|
Name of the new rule. |
| required
|
NoSignatureCheck | SwitchParameter | named |
|
Indicates if a signature verification of the VIBs to be used for bootstraping should be performed. |
| required
|
Pattern | String[] | named |
|
Set of hosts the new rule should apply to. Pattern strings use the following syntax: <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. <attr>=<Val1 >[,val2,... ,valN] Adds a pattern that matches against the comma-separated list of values. Supported value types are: string Exact string match <ip1>-<ip2> Range of IPv4 addresses. |
| optional | Item | VIObjectCore[] | named |
|
Item the rule should apply to the hosts. Can be an image profile, a script bundle, a host profile, or a folder or cluster on the vCenter Server system to add the host to. |
| optional | ProgressAction | ActionPreference | named |
|
Parameters
| Required | Parameter Name | Type | Position | Features | Description |
|---|---|---|---|---|---|
| required
|
AllHosts | SwitchParameter | named |
|
Specify AllHosts to apply the new rule to all hosts managed by VMware Auto Deploy. Hosts are managed by VMware Auto Deploy if the DHCP server directs them to the Auto Deploy TFTP configuration file. |
| required
|
LcmCluster | VIObjectCore | named |
|
A vCenter Cluster managed by Lifecycle to be used as a source for the desired soft specification and Host Profile to be used for the host(s) bootstrap |
| required
|
Name | String | named |
|
Name of the new rule. |
| required
|
NoSignatureCheck | SwitchParameter | named |
|
Indicates if a signature verification of the VIBs to be used for bootstraping should be performed. |
| optional | Item | VIObjectCore[] | named |
|
Item the rule should apply to the hosts. Can be an image profile, a script bundle, a host profile, or a folder or cluster on the vCenter Server system to add the host to. |
| optional | ProgressAction | ActionPreference | named |
|
Output
Examples
Example 1
New-LCMClusterRuleWithTransform -Name RULE_NAME -AllHosts -LcmCluster LCM_CLUSTER_NAME -NoSignatureCheck
Create a new Rule.It takes in a Rule name, Lifecycle managed Cluster
Example 2
New-LCMClusterRuleWithTransform -Name RULE_NAME -Pattern "vendor=dell","vendor==vmware, Inc." -LcmCluster LCM_CLUSTER_NAME -NoSignatureCheck
Create a new Rule.It takes in a Rule name, Lifecycle managed Cluster, Pattern as set of hosts the new rule should apply to.
Example 3
New-LCMClusterRuleWithTransform -Name RULE_NAME -Pattern "vendor=dell","vendor==vmware, Inc." -Item "scriptbundle" -LcmCluster LCM_CLUSTER_NAME -NoSignatureCheck
Create a new Rule.It takes in a Rule name, Lifecycle managed Cluster, Pattern as set of hosts the new rule should apply to.
Related Commands
LCMClusterRuleWithTransform
Create LCM cluster rule with transform
Update LCM cluster rule with transform
Update LCM cluster rule with transform
LcmClusterCompliance
This cmdlet tests cluster's hosts compliance respective to its target state.
LcmClusterDesiredState
This cmdlet exports the desired state of a vSphere Lifecycle Manager cluster.
This cmdlet imports a specification file to set a desired state of a vSphere Lifecycle Manager cluster.
LcmClusterDesiredStateRecommendation
This cmdlet generates a desired state recommendation of a vSphere Lifecycle Manager cluster.
LcmClusterHealth
This cmdlet tests cluster's hosts health respective to its target state.
LcmHardwareCompatibility
This cmdlet verifies that the components in the base image are compatible with all storage controllers on the hosts in the cluster in accordance with the VMware Compatibility Guide.
LcmImage
This cmdlet retrieves the vSphere Lifecycle Manager images available on a vCenter Server system.
LcmOfflineDepot
This cmdlet creates a new vSphere Lifecycle Manager offline depot.
LcmVMHostDesiredState
This cmdlet exports the desired state of an ESXi host that is managed by vSphere Lifecycle Manager. The desired state consists of the host's base image and the installed software packages.