Page tree

Use this command to move objects (such as saved searches, data collectors, collection profiles, and so on) created by one user to another user from the same user group and optionally delete the initial user. The user to which you want to move the objects must have the same (or higher) roles as compared to the initial user.

After you successfully run this command, a summary of transferred objects (including the count) is displayed.

To understand the syntax and examples, see:

Syntax

Note

Prefix this command with the following, as appropriate:

  • For Windows: itda.bat
  • For Linux: ./itda.sh

transferownership -d <hostName> -p <portNumber> -u 
<userName> -w <password> -fromUser <initialUserName> 
-toUser <targetUserName> -deleteUser <Boolean value> [-l <locale>] [-v] [-s]
  • Angle brackets (< >) indicate a variable value that needs to be user defined.

  • Square brackets ([ ]) indicate optional parameters.

The following table describes the parameters used in the syntax:

ParameterDescription
-d
Host name of the Console Server
-p
Port number of the Console Server.
-u
User name to use to connect with the Console Server.
-w
Password corresponding to the user name to use to connect with the Console Server.
-fromUser
Name of the user from which the objects need to be moved.
-toUser

Name of the user to which the objects need to be transferred from the initial user.

Note: The target user must belong to the same user group as the initial user.

-deleteUser

(Optional) Indicates whether you want to delete the user from which the objects were moved.

You can set one of the following values:

  • (Default) true: Transfer objects to the target user and then delete the initial user.
  • false: Transfer objects to the target user without deleting the initial user.

-l

(Optional) Indicates the locale in which you want to display messages when the command is run.

You can set one of the following locales:

  • English
  • Simplified Chinese
  • German
  • French

By default, the messages are displayed in the locale of the system on which the CLI is run.

The value can be set to one of the following depending on the locale you choose:

  • English: en
  • Simplified Chinese: chs
  • German: de
  • French: fr

Example: If you want to set the locale as Simplified Chinese, you need to specify, l=chs.

-v
(Optional) Version of the IT Data Analytics product.
-s
(Optional) Indicates an HTTPS connection.

Example inputs

The following example provides the input for moving the data collectors starting with the names punWin and punLin:

transferownership -u admin -w admin12345 -d localhost 
-p 9797 -fromUser userOne -toUser userTwo deleteUser false
  • No labels