Device operation - Find Computers By Name
The Find Computers By Name operation retrieves details about a computer by specifying a computer name.
Use the <items> element when you call an adapter from an out-of-the-box process in TrueSight Orchestration Development Studio. Use the adapter request XML when you create a custom process by using the Call Adapter activity in TrueSight Orchestration Development Studio.
The following table describes the <items> XML elements for the Find Computers By Name operation.
Elements for the Find Computers By Name operation
Element | Description | Required |
|---|---|---|
<operation-name> | Specifies the name of the operation: find-computers-by-name | Yes |
<target> | Specifies the connection information for the Microsoft System Center Configuration Manager application | No |
<computer-name> | Specifies the full or partial name of the computer whose details are to be retrieved All computers with the matching the name are displayed. | Yes |
The following figure shows the <items> XML for the Find Computers By Name operation.
Sample <items> XML for the Find Computers By Name operation
<item>
<target>config2</target>
<computer-name>VW-PUN</computer-name>
</item>
</items>
The following figure shows the sample XML adapter request for the Find Computers By Name operation.
Sample XML adapter request for the Find Computers By Name operation
<mssccm-request>
<operation-name>find-computers-by-name</operation-name>
<arguments>
<target>Config1</target>
<computer-name>VW-PUN</computer-name>
</arguments>
</mssccm-request>
</request-data>
The following figure shows the adapter response for the Find Computers By Name operation.
Adapter response for the Find Computers By Name operation
<metadata>
<status>success</status>
<response-count>1</response-count>
</metadata>
<responses>
<response>
<metadata>
<target>Config1</target>
<status>success</status>
<count>2</count>
</metadata>
<output>
<active />
<ad-site-name>Default-First-Site-Name</ad-site-name>
<agents>
<agent-name>SMS_WINNT_SERVER_DISCOVERY_AGENT</agent-name>
<agent-name>SMS_AD_SYSTEM_DISCOVERY_AGENT</agent-name>
</agents>
<agent-sites>
<agent-site>001</agent-site>
<agent-site>001</agent-site>
</agent-sites>
<agent-times>
<agent-time>20170615121201.000000+***</agent-time>
<agent-time>20170616113001.000000+***</agent-time>
</agent-times>
<always-internet />
<amt-full-version />
<amt-status />
<client />
<client-type />
<client-version />
<cpu-type />
<creation-date>20170522213102.000000+***</creation-date>
<decommissioned>0</decommissioned>
<distinguished-name>CN=VW-PUN-BAO-DV07,CN=Computers,DC=baodv06,DC=local</distinguished-name>
<eas-device-id />
<hardware-id />
<internet-enabled />
<ip-addresses>
<ip-address>10.129.96.14</ip-address>
</ip-addresses>
<ip-subnets>
<ip-subnet>10.129.96.0</ip-subnet>
</ip-subnets>
<ipv6-addresses>
<ipv6-address>0000:0000:0000:0000:0000:0000:0000:0001</ipv6-address>
</ipv6-addresses>
<ipv6-prefixes>
<ipv6-prefix>0000:0000:0000:0000</ipv6-prefix>
</ipv6-prefixes>
<is-assigned-to-user />
<is-client-amt30-compatible />
<is-machine-changes-persisted />
<is-virtual-machine>False</is-virtual-machine>
<last-logon-user-domain />
<last-logon-user-name />
<last-logon-timestamp>20170609185844.000000+***</last-logon-timestamp>
<mac-addresses />
<name>VW-PUN-BAO-DV07</name>
<netbios-name>VW-PUN-BAO-DV07</netbios-name>
<obsolete />
<operating-system-name-and-version>Microsoft Windows NT Server 6.3</operating-system-name-and-version>
<previous-sms-uuid />
<primary-group-id>515</primary-group-id>
<resource-domain-or-workgroup>BAODV06</resource-domain-or-workgroup>
<resource-id>2097152000</resource-id>
<resource-names>
<resource-name>vw-pun-bao-dv07.baodv06.local</resource-name>
</resource-names>
<resource-type>5</resource-type>
<security-group-names />
<sid>S-1-5-21-1740867350-3125136607-4125276904-1106</sid>
<smbios-guid />
<sms-assigned-sites />
<sms-installed-sites />
<sms-Resident-sites />
<sms-unique-identifier />
<sms-uuid-change-date />
<snmp-community-name />
<suppress-auto-provision />
<system-container-names>
<name>BAODV06\COMPUTERS</name>
</system-container-names>
<system-group-names />
<system-ou-names />
<system-roles>
<role>SMS Component Server</role>
<role>SMS Distribution Point</role>
<role>SMS Management Point</role>
<role>SMS Notification Server</role>
<role>SMS Site Server</role>
<role>SMS Site System</role>
<role>SMS SQL Server</role>
</system-roles>
<unknown />
<user-account-control>4096</user-account-control>
<virtual-machine-hostName />
<wipe-status />
</output>
<output>
<active />
<ad-site-name>Default-First-Site-Name</ad-site-name>
<agents>
<agent-name>SMS_AD_SYSTEM_DISCOVERY_AGENT</agent-name>
</agents>
<agent-sites>
<agent-site>001</agent-site>
</agent-sites>
<agent-times>
<agent-time>20170616113001.000000+***</agent-time>
</agent-times>
<always-internet />
<amt-full-version />
<amt-status />
<client />
<client-type />
<client-version />
<cpu-type />
<creation-date>20170612123420.000000+***</creation-date>
<decommissioned>0</decommissioned>
<distinguished-name>CN=VW-PUN-BAO-DV06,OU=Domain Controllers,DC=baodv06,DC=local</distinguished-name>
<eas-device-id />
<hardware-id />
<internet-enabled />
<ip-addresses>
<ip-address>10.129.96.13</ip-address>
</ip-addresses>
<ip-subnets />
<ipv6-addresses />
<ipv6-prefixes />
<is-assigned-to-user />
<is-client-amt30-compatible />
<is-machine-changes-persisted />
<is-virtual-machine />
<last-logon-user-domain />
<last-logon-user-name />
<last-logon-timestamp>20170608192958.000000+***</last-logon-timestamp>
<mac-addresses />
<name>VW-PUN-BAO-DV06</name>
<netbios-name>VW-PUN-BAO-DV06</netbios-name>
<obsolete />
<operating-system-name-and-version>Microsoft Windows NT Server 6.3</operating-system-name-and-version>
<previous-sms-uuid />
<primary-group-id>516</primary-group-id>
<resource-domain-or-workgroup>BAODV06</resource-domain-or-workgroup>
<resource-id>2097152002</resource-id>
<resource-names>
<resource-name>vw-pun-bao-dv06.baodv06.local</resource-name>
</resource-names>
<resource-type>5</resource-type>
<security-group-names />
<sid>S-1-5-21-1740867350-3125136607-4125276904-1001</sid>
<smbios-guid />
<sms-assigned-sites />
<sms-installed-sites />
<sms-Resident-sites />
<sms-unique-identifier />
<sms-uuid-change-date />
<snmp-community-name />
<suppress-auto-provision />
<system-container-names />
<system-group-names />
<system-ou-names>
<name>BAODV06.LOCAL/DOMAIN CONTROLLERS</name>
</system-ou-names>
<system-roles />
<unknown />
<user-account-control>532480</user-account-control>
<virtual-machine-hostName />
<wipe-status />
</output>
</response>
</responses>
</mssccm-response>