Previous Topic: dpmrm createfromtemplate Command--Create ReservationNext Topic: dpmrm listtemplates Command--Display List Reservation Templates


dpmrm extend Command--Extend a Reservation

The extend command extends a reservation after the original expiration date.

This command has the following format:

dpmrm extend -resid reservationid -newdate newdate -newtime newtime [-sc sc_url] [-ws_user username -ws_password password] [-prompt yes|no] [-pre] [-post]
-resid reservationid

Defines the reservation identification number. Valid entry: positive integer.

-newdate newdate

Defines the new date for extending the reservation. Valid entry: mm/dd/yyyy

-newtime newtime

Defines the new time for extending the reservation. Valid entry: 0-23.

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

-prompt yes|no

Defines whether to prompt the user for username and password.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

Example: Extend a Reservation

In this example, the reservation 4321 is extended until March 10, 2010 at 10:00 a.m.

dpmrm extend -resid 4321 -newdate 02/10/2010 -newtime 10

dpmrm importvirtualmachines Command

The importvirtualmachines command imports the existing VMware virtual machines to the Reservation Manager so that you can extend, cancel, and return the virtual machine using the Reservation ID.

This command has the following format:

dpmrm importvirtualmachines [-sc sc_url] -vcenter vcenter name -datacenter datacenter name -vm vm name[|vm name...] -enddate MM/DD/YYYY -endtime 0-23 -tenent tenent -orgunit org unit [-reservation_user reservationusername] [-email_address emailaddress] [-ws_user security username] [-ws_password security password] [-prompt yes|no] [-pre] [-post] [-locale is0639value]
-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80
-vcenter vcenter name

Specifies the vCenter server host name.

-datacenter datacenter name

Specifies the vCenter datacenter name.

-vm vm name[|vm name...]

Specifies the virtual machine names to add to the Reservation manager.

-enddate enddate

Defines the end date for the reservation. Valid entry format is mm/dd/yyyy.

-endtime endtime

Defines the end time for the reservation. Valid entry is 0-23.

-tenant tenent

Defines the name of the tenent.

-orgunit orgunit

Defines the organizational unit for the reservation. Not required if the user is a member of only one organizational unit. Valid entry: 1-256 alphanumeric characters.

-reservation_user reservationusername

(Optional) Defines the user name for self-service reservation manager.

-emailaddress emailaddress

(Optional) Defines the user email address for the reservation.

-ws_user username -ws_password password

(Optional) Specifies the credentials to use for the web service security check. If you do not include credentials, you are prompted to enter them. Avoid the prompt for credentials by setting up your own session using caaipsecurity.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

-prompt yes|no

(Optional) Defines whether to prompt the user for username and password.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

Example: Import a virtual machine to the Reservation manager.

For example, the following command imports the SA128–SA1 virtual machine to SWAT Reservation manager:

dpmrm importvirtualmachines -vcenter VC.org.com -datacenter SWAT -vm "SA128-SA1" -enddate 08/05/2013 -endtime 5 -orgunit SWAT -ws_user admin -ws_password demo123

dpmrm listsoftwaregroups Command

The listsoftwaregroups command provides a list of software groups that are available to the specific organization unit.

dpmrm listsoftwaregroups -orgunit orgunit [-sc sc_url] [-ws_user username] [-ws_password password] [-prompt yes|no] [-pre] [-post] [-locale iso639value]
-orgunit orgunit

Identifies the organizational unit that can access the software group.

-sc sc_url

(Optional) Defines the URL for the service controller host.

Example: https://hostname:port/...

hostname

Defines the fully qualified host where the service controller is installed.

Example: localhost.ca.com

port

Defines the listening port for the service controller server.

Example: 80

-ws_user username

(Optional) Identifies the security user name.

-ws_password password

(Optional) Identifies the security user password.

-prompt yes | no

(Optional) Indicates prompt for username and password. The default is yes.

-pre

(Optional) Specifies whether to generate an event before the operation is performed.

-post

(Optional) Specifies whether to generate an event after the operation is performed.

-locale iso639value

(Optional) Specifies an IS0 639_3166 combination to override the default English output, for example, fr_FR for French. To use the locale of the command prompt, specify "native".

Examples

dpmrm listsoftwaregroups -orgunit public -ws_user testadmin -ws_password testadmin

The list shows each package group with an identifier (0-n) and each package:procedure combination with a unique identifier (0-n) similar to the following:

Software Group 0: name = Windows Utilities
Software Group 0:Package 0 = SQL Server 2005
Software Group 0:Procedure 0 = Install
Software Group 0:Package 1 = Putty
Software Group 0:Procedure 1 = Install
Software Group 0:Package 2 = WinSCP
Software Group 0:Procedure 2 = Install
Software Group 1: name = Backup Software
Software Group 1:Package 0 = Fast Backup
Software Group 1:Procedure 0 = Install