5.5.1 DRS automation level setting for the DRS clusters
Function
In the VMware vSphere environment, specifies the DRS automation level setting for the virtual server belonging to the vSphere DRS cluster.
The following servers are the prerequisites for this plug-in:
- vCenter server
Server where VMware vCenter Server is installed.
- vCenter control server (execution target server)
Server where VMware vSphere PowerCLI is installed. Plug-ins are transferred to this server and executed by JP1/AO.
- DRS cluster
Server that configures the vSphere DRS cluster or the vSphere DRS cluster.
- Virtual server
Virtual server that is managed by the vCenter server and VMware vSphere ESXi.
The scripts in this plug-in perform the following processes:
- Execute the following commandlet:
Set-VM -VM VirtualMachine object#1
-DrsAutomationLevel "the-value-set-for-the-DRS-automation-level-(VMware.drsAutomationLevel-property)"
-Confirm:$false
#1: Object obtained from the value of the virtual server name (VMware.vmName property)
For details about the Set-VM commandlet, see Cmdlet Reference in the vSphere PowerCLI Documentation.
You can set the DRS automation level (VMware.drsAutomationLevel property) as follows:
- Specify the DRS automation level to be set for the virtual server.
- You can specify the following values:
Setting Definition
FullyAutomated Complete automation
PartiallyAutomated Partial automation
Manual Manual
AsSpecifiedByCluster As per the cluster setting
Disabled Disabled
Use situation
This plug-in is used to set the DRS automation level for the virtual server that has been added to the already constructed DRS cluster.
Prerequisites
For the most recent information about the prerequisite products for the execution-target system, the prerequisite products for the execution-target server, and the supported OSs for the prerequisite products for the execution-target server, see the Release Notes.
In addition, the following OS and products use abbreviations. For the abbreviations of OS and products, see the "Preface".
Prerequisite products for the execution-target system:
(1) Prerequisite products for the vCenter server
- VMware vCenter Server
(2) VMware vSphere ESXi instance that manages the virtual server
Conditions for using the prerequisite products for the execution-target system:
(1) VMware vSphere ESXi must be managed by VMware vCenter Server.
(2) Conditions related to the settings on VMware vCenter Server
- Virtual servers must have a unique name.
- The VMware-related name shown below is case-sensitive in VMware. However, it is not case-sensitive in a vSphere PowerCLI instance that is executed from this plug-in.
For this reason, you cannot use this plug-in in an environment where some of the VMware-related names being used are identical to each other except for case differences.
- Virtual server name
(3) The virtual server must belong to the vSphere DRS cluster.
Prerequisite products for the execution-target server:
- VMware PowerCLI
Supported OSs for the prerequisite products for the execution-target server:
- Windows Server
Cautions
(1) Do not specify a string containing a double quotation mark (") or a single quotation mark (') in a property of this plug-in.
Execution privilege
(1) Users who access VMware vCenter Server must have permission for the system administrator role.
Version
02.11.00
Plug-in tags
Modify VM,VMware vSphere
Plug-in name displayed in the task log
vsphereSetDRSAutomationLevel
Return code
0: Normal
12: Error (Mistake by user) Invalid property
27: Error (Check the error details by using the task log.) Unidentified error
41: Error (An error has been detected in the component.) Property not entered (An error has been detected in the component script.)
Property list
The following table lists the properties:
Property key |
Property name |
Description |
Default value |
I/O type |
Required |
---|---|---|---|---|---|
plugin.destinationHost |
Host name of the execution target server |
Specify the host name or IP address of the server on which this plugin will be executed. IPv6 addresses are not supported. |
-- |
Input |
R |
VMware.vCenterServerName |
Host name of the vCenter server |
Specify the host name or IP address of the destination vCenter server. IPv6 addresses are not supported. |
-- |
Input |
R |
VMware.userName |
User name for connecting to the VMware vCenter Server |
Specify the user name for connecting to the VMware vCenter Server. |
-- |
Input |
R |
VMware.password |
Password for connecting to the VMware vCenter Server |
Specify the password for connecting to the VMware vCenter Server. |
-- |
Input |
R |
VMware.portNumber |
Port number for connecting to the VMware vCenter server |
Specify the number of the port for connecting to VMware vCenter Server (for the VMware vCenter Server Web service). |
443 |
Input |
O |
VMware.protocol |
Protocol for connecting to the VMware vCenter server |
Specify either HTTP or HTTPS as the protocol for connecting to VMware vCenter Server. |
https |
Input |
R |
VMware.vmName |
Virtual server name |
Specify the name of the virtual server. (This is the virtual server name in VMware vCenter Server. Do not specify a host name.) |
-- |
Input |
R |
VMware.drsAutomationLevel |
DRS automation level |
Specify the DRS automation level to be set for a virtual server. You can specify FullyAutomated, PartiallyAutomated, Manual, AsSpecifiedByCluster, or Disabled. |
-- |
Input |
R |
common.returnValue |
Return value for the plugin |
The return value of this plugin stored. |
-- |
Output |
O |