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

App Broker 2020 R1

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.

Importing New Computer into System Center Configuration Manager and User Association

Endpoint Example

Response Body Example (Output)

URI Example

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

{

   "computerResourceId": "65"

}

Request Body Example

{

   "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:

Input Parameter Details of 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)

Important: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.

Important: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.

Important: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.

App Portal / App Broker 2020 R1 Administration Guide

August 2020

Communityflexera.comCopyright