audit [-<option> . . .]

Extracts audit trail information and objects old versions.

Options

[-ids] <comma-separated database ids>

List of object id(s).

-userids <comma-separated database ids>

List of user id(s).

-actions <comma-separated actions>

List of actions to extract. If not present the list is not filtered by action.

-logins <comma-separated GUIDs>

List of login GUIDs to consider. If not present the list is not filtered by login GUIDs.

-codes <comma-separated list of version codes>

List of codes of the versions to retrieve - used only when retrieving versions and not generic audit trail information. If not specified retrieve versions with any code.

-out <string>

Name of the output file for export.

-versions <integer>

Extract version information; specify the number of versions to get: 0 = all versions, positive number = last (most recent) versions, negative number = first versions.

-versionobj

When extracting version information extract also the old object version.

-excludechild

When extracting version information do not consider versions of child objects as versions of their parents.

-from <date/time>

Consider only information after the specified date time.

-to <date/time>

Consider only information before the specified date time.

-max <integer>

Maximum number of records to be retrieved.

-username <string>

The optional user name to use to login into the system. If not specified the Web service login is used. Ignored in interactive mode.

-password <string>

The user password to use to login into the system. Ignored if no system user name is specified. Ignored in interactive mode.

-lang <string>

User-interface language, e.g. 'en-US' for English, US version. Ignored in interactive mode.

-srvname <string>

The name of the Web service connection parameters to use, as defined in the user configuration file (USERCONFIG.XML file, typically stored in C:\Users\<yourWindowsname>\AppData\Roaming\TeraDP\GN4\ on Windows 10 / 8 / 7 / Vista and in c:\Documents and Settings\<user name>\Application Data on Windows XP / Server 2003). If not specified the first connection in the configuration file is used. Ignored in interactive mode.

Notes:

•When using this parameter, have in mind that there is no way to ensure that the same name in the USERCONFIG.XML file gets used coherently on all network computers. Therefore, this is not a safe method unless you are using it only on well known computers.

•Use either -srvname or -srvurl, but not both.

-srvurl <string>

The URL of Web service to connect to, e.g. http://myhost.com/GN4/Adminsrv.asmx. Ignored in interactive mode.

Notes:

•When using this parameter, have in mind that it is independent of the USERCONFIG.XML settings, therefore, much safer.

•Use either -srvname or -srvurl, but not both.

-srvusername <string>

The Windows user name to use to login to the Web service. If not specified the current Windows login is used, and the password and domain options are ignored. Ignored in interactive mode.

-srvpassword <string>

The Windows user password to use to login to the Web service. Ignored ininteractive mode.

-srvdomain <string>

The domain of the user to use to login to the Web service. Ignored in interactive mode.

-srvpassphrase <string>

Pass-phrase used to encrypt/decrypt data transferred to and from the server. Ignored in interactive mode.

See also other exports commands