Rename Computer operation
The Rename Computer operation renames a physical computer.
The following table describes the elements for the <items> XML element and adapter request for the Rename Computer operation:
Elements for the <items> XML element and adapter request for the Rename Computer operation
The following figure shows a sample adapter request for the Rename Computer operation:
Adapter request for the Rename Computer operation
<active-directory-request>
<target>
<host>vm-w23-rds19</host>
<user-name>administrator</user-name>
<password>bmcAdm1n</password>
</target>
<commands>
<command>
<active-directory-command>Rename Computer</active-directory-command>
<object-class>Computer</object-class>
<object-name>VM-W23-RDS59</object-name>
<parameters>
<new-name>VM-INSTANCE-59</new-name>
<domain>vm-w23-rds19.local</domain>
<domain-user-name>administrator</domain-user-name>
<domain-password>bmcAdm1n</domain-password>
<object-user-name>administrator</object-user-name>
<object-password>bmcAdm1n</object-password>
<reboot />
</parameters>
</command>
</commands>
</active-directory-request>
<target>
<host>vm-w23-rds19</host>
<user-name>administrator</user-name>
<password>bmcAdm1n</password>
</target>
<commands>
<command>
<active-directory-command>Rename Computer</active-directory-command>
<object-class>Computer</object-class>
<object-name>VM-W23-RDS59</object-name>
<parameters>
<new-name>VM-INSTANCE-59</new-name>
<domain>vm-w23-rds19.local</domain>
<domain-user-name>administrator</domain-user-name>
<domain-password>bmcAdm1n</domain-password>
<object-user-name>administrator</object-user-name>
<object-password>bmcAdm1n</object-password>
<reboot />
</parameters>
</command>
</commands>
</active-directory-request>
The following figure shows a sample adapter response for the Rename Computer operation:
Sample adapter response for the Rename Computer operation
<active-directory-response>
<metadata>
<status>success</status>
</metadata>
<target-output host="vm-w23-rds19">
<metadata>
<os-id>Windows 2003</os-id>
<os-version>5.2 Build 3790 Service Pack 2</os-version>
<status>success</status>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>netdom renamecomputer "VM-W23-RDS59" /force
/newname:VM-INSTANCE-59 /ud:vm-w23-rds19.local\administrator /pd:bmcAdm1n
/uo:administrator /po:bmcAdm1n /reboot</command>
<line-count>6</line-count>
<execution-milliseconds>7667</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">Attempting to connect to remote host...</line>
<line index="2">Initialising rctrlx server component...</line>
<line index="3">Executing remote application: cmd
/c netdom renamecomputer "VM-W23-RDS59" /force /newname:VM-INSTANCE-59
/ud:vm-w23-rds19.local\administrator /pd:bmcAdm1n
/uo:administrator /po:bmcAdm1n /reboot</line>
<line index="4">Remote application process ID: 8616</line>
<line index="5">The command completed successfully.</line>
<line index="6">Remote application exited with code: 0</line>
</output>
</command-output>
</commands-output>
</target-output>
</active-directory-response>
<metadata>
<status>success</status>
</metadata>
<target-output host="vm-w23-rds19">
<metadata>
<os-id>Windows 2003</os-id>
<os-version>5.2 Build 3790 Service Pack 2</os-version>
<status>success</status>
</metadata>
<commands-output>
<command-output>
<metadata>
<command>netdom renamecomputer "VM-W23-RDS59" /force
/newname:VM-INSTANCE-59 /ud:vm-w23-rds19.local\administrator /pd:bmcAdm1n
/uo:administrator /po:bmcAdm1n /reboot</command>
<line-count>6</line-count>
<execution-milliseconds>7667</execution-milliseconds>
<exit-code>0</exit-code>
<status>success</status>
</metadata>
<output>
<line index="1">Attempting to connect to remote host...</line>
<line index="2">Initialising rctrlx server component...</line>
<line index="3">Executing remote application: cmd
/c netdom renamecomputer "VM-W23-RDS59" /force /newname:VM-INSTANCE-59
/ud:vm-w23-rds19.local\administrator /pd:bmcAdm1n
/uo:administrator /po:bmcAdm1n /reboot</line>
<line index="4">Remote application process ID: 8616</line>
<line index="5">The command completed successfully.</line>
<line index="6">Remote application exited with code: 0</line>
</output>
</command-output>
</commands-output>
</target-output>
</active-directory-response>
Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*