Disable Computer operation

The Disable Computer operation disables a computer. You must use the <object-distinguished-name> element to disable a computer.

The following table describes the elements for the <items> XML element and adapter request for the Disable Computer operation:

Elements for the <items> XML element and adapter request for the Disable Computer operation

Element	Definition	Required
<target>	Specifies the target for the request If this element is not specified, the adapter uses the default target specified in the configuration.	No
<host>	Specifies the host name or IP address of the remote computer To specify a dynamic target, you must use this element.	No
<user-name>	Specifies the user name for remote host authentication To specify a dynamic target, you must use this element.	No
<password>	Specifies the password that corresponds to the user name To specify a dynamic target, you must use this element.	No
<commands>	Indicates the beginning of the <commands> element, which contains the individual <command> elements	Yes
<command>	Indicates the beginning of a <command> element, which contains the elements that specify the operation to execute and its elements.	Yes
<active-directory-command>	Specifies the operation to execute Default Vale: Disable Computer	Yes
<object-class>	Specifies the type of object on which to perform the operation Valid value: computer	Yes
<object-distinguished-name>	Specifies the distinguished name of the object	Yes
<server>	Specifies the remote server for the connection If the object belongs to an Active Directory service hosted on a remote server, you must use this element.	Conditional
<domain>	Specifies the remote domain for the connection If the object belongs to an Active Directory service hosted on a remote server, you must use this element.	Conditional
<user-name>	Specifies the logon user name for the remote server	Conditional
<password>	Specifies the password associated with the user name	Conditional

The following figure shows a sample adapter request for the Disable Computer operation:

Adapter request for the Disable 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>Disable Computer</active-directory-command>
       <object-class>Computer</object-class>
       <object-distinguished-name>CN=JYounge-pun-01,CN=Computers,DC=vm-w23-rds19,
    DC=local</object-distinguished-name>
       <parameters>
         <server>vm-w23-rds19</server>
         <user-name>administrator</user-name>
         <password>bmcAdm1n</password>
       </parameters>
     </command>
   </commands>
</active-directory-request>

Disable Computer operation

On this page