tklmMachineDeviceAdd

Use the tklmMachineDeviceAdd command to add the association of a device to an existing machine identifier in the IBM Security Key Lifecycle Manager database.

Note: The IBM Security Key Lifecycle Manager command-line interface commands will be deprecated in the later versions of IBM Security Key Lifecycle Manager. Use the REST interfaces instead.

Purpose

Use this command to add the association of a device to an existing machine identifier in the IBM Security Key Lifecycle Manager database.

Permissions

Your role must have a permission to the create action and a permission to the DS5000 device group.

Syntax

tklmMachineDeviceAdd -deviceUUID deviceuuid -machineID machineidentitystring | -machineText machineidentitytext

Parameters

-deviceUUID: Specify a value for a unique universal identifier for the device, such as DEVICE-7d588437-e725-48bf-a836-00a47df64e78. Use the tklmDeviceList command to locate the device uuid.
-machineID: Required if the value of -machineText is not specified. Specify a unique machine ID with a minimum length of 1 and a maximum length of 48 characters. For example: 3042383030303437000000000000. Use the tklmMachineIdentityList command to locate machine identities.
-machineText: Required if the value of -machineID is not specified. Specify a unique, user-supplied descriptive label greater than zero bytes and not more than 96 bytes for a machine, such as myEncryptedDS5000.

Example

This Jython-formatted command adds the association of a device to a known, existing machine ID in the IBM Security Key Lifecycle Manager database.

print AdminTask.tklmMachineDeviceAdd 
('[-deviceUUID DEVICE-7d588437-e725-48bf-a836-00a47df64e78 
-machineID 3042383030303437000000000000]')