App Broker 2017
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 |
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:
|
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 2017 Administration Guide18 July 2017 |
Copyright Information | Flexera Software |