Importing New Computer in System Center Configuration Manager and Associating a User

This section describes the App Broker REST API endpoint to import a new computer into System Center Configuration Manager and associating a user to that computer.

Endpoint Example

URI Example: [POST] http://<SERVERNAME>/esd/api/computers

Response Body Example:

{
  "computerResourceId": "65"
}

Request Body Example (Output)

{
  "UserName": "SatheeshChandran",
  "FullName": "",
  "UserEmail": "",
  "UserDomain": "AppPortal",
  "ComputerName": "SCHAPSOMECOM44",
  "DeploymentMapping": {
    "SiteServer": "ITAAP1511CASLAX",
    "MacAddress": "01:23:45:67:89:ab",
    "SMBIOS": "00000000-0000-1001-8000-010203041561"
  }
}

Input Parameter Details

The following are the details for the parameters listed in the Request Body Example:

Parameter	Description
UserName	User name to which the new computer will be associated. (Optional) This is not a required field, but if the UserDomain parameter has a value, this parameter must also have a value; if it does not, the command will fail. Also, the provided user name must exist in the App Portal database.
FullName	Full name of the user. (Optional)
UserEmail	Email address of the user to which the new computer will be associated. (Optional)
UserDomain	Domain name to which the user belongs. (Optional) This is not a required field, but if the UserName parameter has a value, this parameter must also have a value; if it does not, the command will fail. Also, the provided domain must exist in the App Portal database.
ComputerName	Name of the computer that you want to import into System Center Configuration Manager. The computer name cannot be more than 15 characters. (Required) Note: Do not enter the name of an existing computer.
SiteServer	Server name of the System Center Configuration Manager server into which the computer will be imported. (Required)
MacAddress	MAC Address of the computer that is being imported. Hexadecimal values are accepted. Note: Specify either a MAC address or a SMBIOS GUID; only one is required. If you enter value for SMBIOS, do not also enter a value for MacAddress .
SMBIOS	SMBIOS address of the computer that is being imported. Note: Specify either a MAC address or a SMBIOS GUID; only one is required. If you enter value for MacAddress , do not also enter a value for SMBIOS .

Output Details

If the import is successful, the API responds with the resource ID of the computer that is imported.