Difference between revisions of "Administration API - Function Reference"

[unchecked revision][checked revision]
 
(120 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
<!-- DO NOT EDIT THIS ARTICLE-->
 
−
<!-- The content is generated from get-metadata2mediawiki.py -->
 
 
__NOTOC__
 
__NOTOC__
  
Line 11: Line 9:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>name</tt>
 
| <tt>name</tt>
Line 20: Line 14:
 
| Meaningful name of archive store.
 
| Meaningful name of archive store.
 
|-
 
|-
−
| <tt>path</tt>
+
| <tt>type</tt>
−
| string  
+
| string
−
| Path of directory containing archive store data.
+
| Type of archive store.
 +
|-
 +
| <tt>databaseName</tt>
 +
| string (optional)
 +
| Name of database on Microsoft SQL Server or PostgreSQL server.
 +
|-
 +
| <tt>databasePath</tt>
 +
| string (optional)
 +
| Path to directory in which database folder information and email meta data are stored.
 +
|-
 +
| <tt>contentPath</tt>
 +
| string (optional)
 +
| Path to directory in which email headers and contents are stored.
 +
|-
 +
| <tt>indexPath</tt>
 +
| string (optional)
 +
| Path to directory in which full text search indexes are stored.
 +
|-
 +
| <tt>serverName</tt>
 +
| string (optional)
 +
| Name of Microsoft SQL Server or PostgreSQL server.
 +
|-
 +
| <tt>userName</tt>
 +
| string (optional)
 +
| User name for accessing Microsoft SQL Server or PostgreSQL server.
 +
|-
 +
| <tt>password</tt>
 +
| string (optional)
 +
| Password for accessing Microsoft SQL Server or PostgreSQL server.
 
|-
 
|-
 
| <tt>requestedState</tt>
 
| <tt>requestedState</tt>
Line 30: Line 52:
  
 
=== Argument Values ===
 
=== Argument Values ===
 +
 +
==== type ====
 +
{| class="wikitable"
 +
! width=270px | Name
 +
! Description
 +
|-
 +
| <tt>FileSystemInternal</tt>
 +
| Advanced file system-based archive store.
 +
|-
 +
| <tt>SQLServer</tt>
 +
| Microsoft SQL Server-based archive store.
 +
|-
 +
| <tt>PostgreSQL</tt>
 +
| PostgreSQL server-based archive store.
 +
|}
  
 
==== requestedState ====
 
==== requestedState ====
Line 49: Line 86:
 
|}
 
|}
  
−
== CompactStore ==
+
== CancelJobAsync ==
−
Compact archive store.
+
Cancel a running job asynchronously.
  
 
=== Arguments ===
 
=== Arguments ===
Line 57: Line 94:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>id</tt>
 
| <tt>id</tt>
 
| number  
 
| number  
−
| Unique ID of archive store
+
| The unique identifier of the job to be canceled.
 
|}
 
|}
  
−
== CreateClientAccessServer ==
+
== ClearUserPrivilegesOnFolders ==
−
Register new client access server.
+
Removes all privileges of a user on all archive folders.
  
 
=== Arguments ===
 
=== Arguments ===
Line 76: Line 109:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>userName</tt>
−
| json
+
| string
−
| Configuration of new Client Access Server.
+
| User name of MailStore user.
 
|}
 
|}
  
−
=== Argument Values ===
+
== CompactMasterDatabase ==
 +
Compact master database.
  
−
==== config ====
+
== CompactStore ==
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
+
Compact archive store.
−
{
 
−
  "serverName" : string,
 
−
  "port" : number,
 
−
  "serverCertificate" : {
 
−
    "thumbprint" : string
 
−
  }
 
−
}
 
−
</source>
 
−
 
 
−
== CreateClientOneTimeUrlForArchiveAdmin ==
 
−
Create URL including OTP for $archiveadmin access.
 
  
 
=== Arguments ===
 
=== Arguments ===
Line 103: Line 126:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string
+
| number
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Unique ID of archive store
−
|-
 
−
| <tt>instanceUrl</tt>
 
−
| string (optional)
 
−
| Base URL for accessing instance.
 
 
|}
 
|}
  
−
== CreateDirectoryOnInstanceHost ==
+
== CreateBackup ==  
−
Create a directory on an Instance Host
+
Create a backup of the entire archive.
  
 
=== Arguments ===
 
=== Arguments ===
Line 121: Line 140:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>serverName</tt>
+
| <tt>path</tt>
−
| string  
+
| string
−
| Name of Instance Host.
+
| Path to directory into which the backup should be written.
 
|-
 
|-
−
| <tt>path</tt>
+
| <tt>excludeSearchIndexes</tt>
−
| string
+
| bool (optional)
−
| Path of directory to create.
+
| Indicates whether the search index files should be excluded from the backup.
 
|}
 
|}
  
−
== CreateInstance ==
+
== CreateJob ==
−
Create new MailStore instance.
+
Create a new job to execute Management API commands.
  
 
=== Arguments ===
 
=== Arguments ===
Line 139: Line 158:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>name</tt>
−
| json
+
| string (optional)
−
| Configuration of new instance.
+
| A meaningful name for the job. Example: ''Daily Backup''.
 +
|-
 +
| <tt>action</tt>
 +
| string (optional)
 +
| Management API command to execute.
 +
|-
 +
| <tt>owner</tt>
 +
| string (optional)
 +
| Username of the job owner; must be an administrator.
 +
|-
 +
| <tt>timeZoneId</tt>
 +
| string (optional)
 +
| The id of the time zone the date should be converted to, e.g. ''$Local'', which represents the time zone of the operating system.
 +
|-
 +
| <tt>date</tt>
 +
| string (optional)
 +
| Datetime string (YYYY-MM-DDThh:mm:ss) for running the job once.
 +
|-
 +
| <tt>interval</tt>
 +
| number (optional)
 +
| Interval for running job.
 +
|-
 +
| <tt>time</tt>
 +
| string (optional)
 +
| Time for running job. Without additional parameter, this means daily execution.
 +
|-
 +
| <tt>dayOfWeek</tt>
 +
| string (optional)
 +
| Day of week to run job. Parameter "time" also required.
 +
|-
 +
| <tt>dayOfMonth</tt>
 +
| string (optional)
 +
| Day of month to run job. Parameter "time" also required. dayOfWeek can optionally be used to define further.
 
|}
 
|}
 +
 +
Use the API command [[Administration_API_-_Function_Reference#GetTimeZones|GetTimeZones]] to retrieve a list of all available time zones and their ids.
  
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== config ====
+
==== dayOfWeek ====
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
+
{| class="wikitable"
−
{
+
! width=270px | Name
−
  "instanceID" : string,
+
! Description
−
  "alias" : string,
+
|-
−
  "displayName" : string,
+
| <tt>Sunday</tt>
−
  "instanceHost" : string,
+
| Sunday
−
  "startMode" : string,
+
|-
−
  "baseDirectory" : string,
+
| <tt>Monday</tt>
−
  "debugLogEnabled" : bool,
+
| Monday
−
  "vssWriterEnabled" : bool
+
|-
−
}
+
| <tt>Tuesday</tt>
−
</source>
+
| Tuesday
 +
|-
 +
| <tt>Wednesday</tt>
 +
| Wednesday
 +
|-
 +
| <tt>Thursday</tt>
 +
| Thursday
 +
|-
 +
| <tt>Friday</tt>
 +
| Friday
 +
|-
 +
| <tt>Saturday</tt>
 +
| Saturday
 +
|}
 +
 
 +
==== dayOfMonth ====
 +
{| class="wikitable"
 +
! width=270px | Name
 +
! Description
 +
|-
 +
| <tt>1 to 31</tt>
 +
| Numeric representation of day of month.
 +
|-
 +
| <tt>Last</tt>
 +
| Last day of month.
 +
|}
 +
 
 +
==== interval ====
 +
{| class="wikitable"
 +
! width=270px | Name
 +
! Description
 +
|-
 +
| <tt>5</tt>
 +
| Every 5 minutes.
 +
|-
 +
| <tt>10</tt>
 +
| Every 10 minutes.
 +
|-
 +
| <tt>15</tt>
 +
| Every 15 minutes.
 +
|-
 +
| <tt>20</tt>
 +
| Every 20 minutes.
 +
|-
 +
| <tt>30</tt>
 +
| Every 30 minutes.
 +
|-
 +
| <tt>60</tt>
 +
| Every hour.
 +
|-
 +
| <tt>120</tt>
 +
| Every 2 hours.
 +
|-
 +
| <tt>180</tt>
 +
| Every 3 hours.
 +
|-
 +
| <tt>240</tt>
 +
| Every 4 hours.
 +
|-
 +
| <tt>360</tt>
 +
| Every 6 hours.
 +
|-
 +
| <tt>720</tt>
 +
| Every 12 hours.
 +
|}
  
−
== CreateInstanceHost ==
+
== CreateProfile ==
−
Create a new Instance Host.
+
Create a new archiving or exporting profile.
  
 
=== Arguments ===
 
=== Arguments ===
Line 169: Line 286:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>properties</tt>
 
| json  
 
| json  
−
| Configuration of new Instance Host.
+
| Profile properties.
 +
|-
 +
| <tt>raw</tt>
 +
| bool
 +
| Currently only 'true' is supported.
 
|}
 
|}
  
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== config ====
+
==== properties ====
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
+
To receive available profile properties create a profile of the desired type via MailStore Client and then use the GetProfiles method to receive supported values. The properties ''id'' and ''version'' must be omitted, the password field must be filled properly.
−
{
 
−
  "serverName" : string,
 
−
  "port" : number,
 
−
  "serverCertificate" : {
 
−
    "thumbprint" : string
 
−
  }
 
−
}
 
−
</source>
 
−
 
 
−
== CreateLicenseRequest ==
 
−
Create and return data of a license request.
 
  
 
== CreateStore ==
 
== CreateStore ==
Line 198: Line 308:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>name</tt>
 
| <tt>name</tt>
Line 207: Line 313:
 
| Meaningful name of archive store.
 
| Meaningful name of archive store.
 
|-
 
|-
−
| <tt>path</tt>
+
| <tt>type</tt>
−
| string  
+
| string (optional)
−
| Path of directory containing archive store data.
+
| Type of archive store.
 +
|-
 +
| <tt>databaseName</tt>
 +
| string (optional)
 +
| Name of database on Microsoft SQL Server or PostgreSQL server.
 +
|-
 +
| <tt>databasePath</tt>
 +
| string (optional)
 +
| Path to directory in which database folder information and email meta data are stored.
 +
|-
 +
| <tt>contentPath</tt>
 +
| string (optional)
 +
| Path to directory in which email headers and contents are stored.
 +
|-
 +
| <tt>indexPath</tt>
 +
| string (optional)
 +
| Path to directory in which full text search indexes are stored.
 +
|-
 +
| <tt>serverName</tt>
 +
| string (optional)
 +
| Name of Microsoft SQL Server or PostgreSQL server.
 +
|-
 +
| <tt>userName</tt>
 +
| string (optional)
 +
| User name for accessing Microsoft SQL Server or PostgreSQL server.
 +
|-
 +
| <tt>password</tt>
 +
| string (optional)
 +
| Password for accessing Microsoft SQL Server or PostgreSQL server.
 
|-
 
|-
 
| <tt>requestedState</tt>
 
| <tt>requestedState</tt>
Line 217: Line 351:
  
 
=== Argument Values ===
 
=== Argument Values ===
 +
 +
==== type ====
 +
{| class="wikitable"
 +
! width=270px | Name
 +
! Description
 +
|-
 +
| <tt>FileSystemInternal</tt>
 +
| Standard archive store.
 +
|-
 +
| <tt>SQLServer</tt>
 +
| Microsoft SQL Server-based archive store.
 +
|-
 +
| <tt>PostgreSQL</tt>
 +
| PostgreSQL server-based archive store.
 +
|}
  
 
==== requestedState ====
 
==== requestedState ====
Line 236: Line 385:
 
|}
 
|}
  
−
== CreateSystemAdministrator ==
+
== CreateUser ==
−
Create a new SPE system administrator.
+
Create new MailStore user. Use [[Administration_API_-_Function_Reference#SetUserPrivilegesOnFolder|SetUserPrivilegesOnFolder]] to grant that user privileges on the user's own archive.
  
 
=== Arguments ===
 
=== Arguments ===
Line 245: Line 394:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>userName</tt>
−
| json
+
| string
−
| Configuration of new SPE system administrator.
+
| User name of new MailStore user.
 +
|-
 +
| <tt>privileges</tt>
 +
| string
 +
| Comma separated list of privileges.
 +
|-
 +
| <tt>fullName</tt>
 +
| string (optional)
 +
| Full name of user.
 +
|-
 +
| <tt>distinguishedName</tt>
 +
| string (optional)
 +
| LDAP DN string.
 +
|-
 +
| <tt>authentication</tt>
 +
| string (optional)
 +
| Authentication setting for user: 'integrated or 'directoryServices'.
 
|-
 
|-
 
| <tt>password</tt>
 
| <tt>password</tt>
−
| string  
+
| string (optional)
−
| Password of new SPE system administrator.
+
| Password of new user.
 +
|-
 +
| <tt>loginPrivileges</tt>
 +
| string (optional)
 +
| Comma separated list of log in privileges. If not given, all login privileges are assigned.
 
|}
 
|}
  
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== config ====
+
==== privileges ====
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
+
{{Administration_API_User_Privileges}}
−
{
+
 
−
  "userName" : string,
+
 
−
  "fullName" : string
+
==== loginPrivileges ====
−
}
+
{{Administration_API_User_Login_Privileges}}
−
</source>
 
  
−
== DeleteClientAccessServer ==
+
== DeleteAppPasswords ==
−
Delete Client Access Server from management database.
+
Deletes all app passwords of a user, hence all non-interactive logins will fail and have to be reconfigured by the user.
  
 
=== Arguments ===
 
=== Arguments ===
Line 273: Line 441:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>serverName</tt>
+
| <tt>userName</tt>
−
| string  
+
| string
−
| Name of Client Access Server.
+
| The user name of the user whose app passwords shall be deleted.
 
|}
 
|}
  
−
== DeleteInstanceHost ==
+
== DeleteEmptyFolders ==
−
Delete Instance Host from management database.
+
Remove folders from folder tree that do not contain emails.
  
 
=== Arguments ===
 
=== Arguments ===
Line 287: Line 455:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>serverName</tt>
+
| <tt>folder</tt>
−
| string  
+
| string (optional)
−
| Name of Instance Host.
+
| Entry point in folder tree.
 
|}
 
|}
  
−
== DeleteInstances ==
+
== DeleteJob ==
−
Delete one or multiple MailStore Instances
+
Deletes a job.
  
 
=== Arguments ===
 
=== Arguments ===
Line 301: Line 469:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceFilter</tt>
+
| <tt>id</tt>
−
| string  
+
| string
−
| Instance filter string.
+
| The unique identifier of the job to be deleted.
 
|}
 
|}
  
−
=== Argument Values ===
+
== DeleteMessage ==
−
 
+
Delete a single message
−
==== instanceFilter ====
 
−
{| class="wikitable"
 
−
! width=270px | Name
 
−
! Description
 
−
|-
 
−
| <tt>*</tt>
 
−
| All instances
 
−
|-
 
−
| <tt>instance01 instance02 instance03</tt>
 
−
| instance01, instance02 and instance03
 
−
|-
 
−
| <tt>*instancehost01 *instancehost02</tt>
 
−
| All instances on instancehost1 and instancehost2
 
−
|-
 
−
| <tt>* .running</tt>
 
−
| All running instances
 
−
|-
 
−
| <tt>* .stopped</tt>
 
−
| All stopped instances
 
−
|}
 
−
 
 
−
== DeleteSystemAdministrator ==
 
−
Delete SPE system administrator.
 
  
 
=== Arguments ===
 
=== Arguments ===
Line 338: Line 483:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>userName</tt>
+
| <tt>id</tt>
−
| string  
+
| string
−
| User name of SPE system administrator.
+
| Unique ID of message. Format: <store_id>:<message_num>
 +
|-
 +
| <tt>reason</tt>
 +
| string
 +
| The reason why that message has to be deleted which will be written into the audit log.
 
|}
 
|}
  
−
== DetachStore ==
+
== DeleteProfile ==
−
Detach archive store
+
Delete an archiving or exporting profile.
  
 
=== Arguments ===
 
=== Arguments ===
Line 351: Line 500:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>id</tt>
 
| <tt>id</tt>
 
| number  
 
| number  
−
| Unique ID of archive store.
+
| Unique ID of profile.
 
|}
 
|}
  
−
== FreezeInstances ==
+
== DeleteUser ==
−
Freeze a MailStore Instance
+
Delete a MailStore user.
 +
Neither the user's archive nor the user's archive emails are deleted when deleting a user.
  
 
=== Arguments ===
 
=== Arguments ===
Line 370: Line 516:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceFilter</tt>
+
| <tt>userName</tt>
 
| string  
 
| string  
−
| Instance filter string.
+
| User name of MailStore user.
 
|}
 
|}
  
−
=== Argument Values ===
+
== DetachStore ==
 +
Detach an archive store.
  
−
==== instanceFilter ====
+
=== Arguments ===
 
{| class="wikitable"
 
{| class="wikitable"
−
! width=270px | Name
+
! width=150px | Name
 +
! width=120px | Type
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>*</tt>
+
| <tt>id</tt>
−
| All instances
+
| number
−
|-
+
| Unique ID of archive store.
−
| <tt>instance01 instance02 instance03</tt>
 
−
| instance01, instance02 and instance03
 
−
|-
 
−
| <tt>*instancehost01 *instancehost02</tt>
 
−
| All instances on instancehost1 and instancehost2
 
−
|-
 
−
| <tt>* .running</tt>
 
−
| All running instances
 
−
|-
 
−
| <tt>* .stopped</tt>
 
−
| All stopped instances
 
 
|}
 
|}
  
−
== GetArchiveAdminEnabled ==
+
== DisableMFA ==
−
Get currrent state of archive admin access.
+
Disables multi-factor authentication of a user.
  
 
=== Arguments ===
 
=== Arguments ===
Line 407: Line 544:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>userName</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| The user name of the user for whom MFA shall be disabled.
 
|}
 
|}
  
−
== GetClientAccessServers ==
+
[[Administration_API_-_Function_Reference#InitializeMFA|InitializeMFA]] enables multi-factor authentication of a user.
−
Get list of Client Access Servers.
+
 
 +
== GetActiveSessions ==
 +
Get list of current user sessions.
 +
 
 +
== GetChildFolders ==
 +
Get child folders.
 +
Depending on compliance settings this method may return only the first folder hierarchy level.
  
 
=== Arguments ===
 
=== Arguments ===
Line 421: Line 564:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>serverNameFilter</tt>
+
| <tt>folder</tt>
 
| string (optional)
 
| string (optional)
−
| Server name filter string.
+
| Parent folder whose child folders should be returned. If omitted, all archives and folder will be returned.
 
|-
 
|-
−
| <tt>withServiceStatus</tt>
+
| <tt>maxLevels</tt>
−
| bool
+
| number (optional)
−
| Include service status or not.
+
| Depth of child folders.
 
|}
 
|}
  
−
=== Argument Values ===
+
== GetComplianceConfiguration ==
 +
Get current compliance configuration settings.
 +
 
 +
== GetCredentials ==
 +
Get the list of credential objects and their details.
 +
 
 +
== GetDirectoryServicesConfiguration ==
 +
Get current Directory Services configuration settings.
  
−
==== serverNameFilter ====
+
== GetFolderStatistics ==
−
{| class="wikitable"
+
Get folder statistics.
−
! width=270px | Name
 
−
! Description
 
−
|-
 
−
| <tt>null</tt>
 
−
| All servers
 
−
|-
 
−
| <tt>serverName</tt>
 
−
| Only the given serverName. Must match exactly.
 
−
|}
 
  
−
== GetDirectoriesOnInstanceHost ==
+
== GetJobResults ==
−
Get file system directory structure from Instance Host.
+
Retrieves list of finished job executions.
  
 
=== Arguments ===
 
=== Arguments ===
Line 453: Line 594:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>serverName</tt>
+
| <tt>fromIncluding</tt>
 +
| string
 +
| Beginning of time range to fetch.
 +
|-
 +
| <tt>toExcluding</tt>
 +
| string
 +
| End of time range to fetch.
 +
|-
 +
| <tt>timeZoneId</tt>
 
| string  
 
| string  
−
| Name of Instance Host.
+
| The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
 
|-
 
|-
−
| <tt>path</tt>
+
| <tt>jobId</tt>
−
| string (optional)
+
| number (optional)
−
| Path of directory to obtain subdirectories from.
+
| The job id for which to retrieve results.
 
|}
 
|}
  
−
== GetEnvironmentInfo ==
+
Interactive Management Shell Example: ''GetJobResults --fromIncluding="2022-12-01T00:00:00" --toExcluding="2023-01-01T00:00:00" --timeZoneId="$Local" --jobId=1''
−
Return general information about SPE environment.
+
 
 +
Use the API command [[Administration_API_-_Function_Reference#GetTimeZones|GetTimeZones]] to retrieve a list of all available time zones and their ids.
 +
 
 +
== GetJobs ==
 +
Retrieve list of jobs.
  
−
== GetIndexConfiguration ==
+
== GetLicenseInformation ==
−
Get list of attachment file types to index.
+
Retrieve license information.
 +
 
 +
Example license information object:
 +
 
 +
{
 +
  "productKey": "YOUR-MAIL-STORE-PRODUCT-KEY",
 +
  "productVersion": "13.1.0.12345",
 +
  "maxNamedUsers": 100,
 +
  "namedUsers": 95,
 +
  "unusedNamedUsers": 5,
 +
  "supportExpiryDate": "2023-12-31",
 +
  "supportLevel": "Premium Service",
 +
  "validFrom": null,
 +
  "validTo": null,
 +
  "licensedTo": "MailStore Software GmbH",
 +
  "machineName": "MAILSTORE"
 +
}
 +
 
 +
The properties ''validFrom'' and ''validTo'' are only set when Trial or NFR product keys are used.
 +
 
 +
== GetMessages ==
 +
Get list of messages from a folder.
  
 
=== Arguments ===
 
=== Arguments ===
Line 474: Line 648:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>folder</tt>
−
| string  
+
| string (optional)
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Folder whose content to list.
 
|}
 
|}
  
−
== GetInstanceConfiguration ==
+
== GetProfiles ==
−
Get configuration of MailStore Instance.
+
Get list of archiving and exporting profiles.
  
 
=== Arguments ===
 
=== Arguments ===
Line 488: Line 662:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>raw</tt>
−
| string
+
| bool
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Currently only 'true' is supported.
 
|}
 
|}
  
−
== GetInstanceHosts ==
+
== GetRetentionPolicies ==
−
Get list of Instance Hosts.
+
Get the retention policies.
 +
 
 +
Example retention policies object:
 +
 
 +
[
 +
  {
 +
    "name": "Keep All Mails for 10 Years",
 +
    "order": 1,
 +
    "enabled": true,
 +
    "searchCriteria": {
 +
      "from": null,
 +
      "to": null,
 +
      "query": null,
 +
      "queryAttachmentContents": false,
 +
      "queryAttachments": false,
 +
      "queryMessageBody": false,
 +
      "querySubject": false,
 +
      "includedArchives": null,
 +
      "excludedArchives": [
 +
        "admin"
 +
        ]
 +
      },
 +
    "period": 10,
 +
    "periodInterval": "year",
 +
    "referenceDateType": "ArchiveDate",
 +
    "delete": false
 +
  }
 +
]
 +
 
 +
The ''referenceDateType'' can bei either ''ArchiveDate'' or ''MessageDate''.
  
−
=== Arguments ===
+
== GetServerInfo ==
−
{| class="wikitable"
+
Get MailStore Server version and machine name.
−
! width=150px | Name
+
 
−
! width=120px | Type
+
== GetServiceConfiguration ==
−
! Description
+
Get MailStore Server service configuration. This includes the path to the Master Database, the location of the audit log, whether the different debug logs are enabled and the endpoint configuration.
−
|-
 
−
| <tt>serverNameFilter</tt>
 
−
| string (optional)
 
−
| Server name filter string.
 
−
|}
 
  
−
=== Argument Values ===
+
== GetSmtpSettings ==
 +
Get current SMTP configuration.
  
−
==== serverNameFilter ====
+
== GetStoreAutoCreateConfiguration ==
−
{| class="wikitable"
+
Get automatic archive store creation settings.
−
! width=270px | Name
 
−
! Description
 
−
|-
 
−
| <tt>null</tt>
 
−
| All servers
 
−
|-
 
−
| <tt>serverName</tt>
 
−
| Only the given serverName. Must match exactly.
 
−
|}
 
  
−
== GetInstanceProcessLiveStatistics ==
+
== GetStoreIndexes ==
−
Get live statistics from instance process.
+
Get list of full text indexes.
  
 
=== Arguments ===
 
=== Arguments ===
Line 530: Line 720:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string
+
| number (optional)
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Unique ID of archive store.
 
|}
 
|}
  
−
== GetInstances ==
+
== GetStores ==
−
Get list of instances.
+
Get list of archive stores.
  
 
=== Arguments ===
 
=== Arguments ===
Line 544: Line 734:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceFilter</tt>
+
| <tt>includeSize</tt>
−
| string
+
| bool (optional)
−
| Instance filter string.
+
| Includes size of archive store. Default: ''true''. May be slow when running on slow hardware.
 
|}
 
|}
  
−
=== Argument Values ===
+
== GetTimeZones ==
 +
Get the list of available time zones and their IDs.
  
−
==== instanceFilter ====
+
The ''id'' of the output can be used as ''timeZoneId'' in [[Administration_API_-_Function_Reference#CreateJob|CreateJob]], [[Administration_API_-_Function_Reference#GetJobResults|GetJobResults]], [[Administration_API_-_Function_Reference#SetJobSchedule|SetJobSchedule]] and [[Administration_API_-_Function_Reference#SendStatusReport|SendStatusReport]] and as ''timeZoneID'' (with a capital ''ID'') in [[Administration_API_-_Function_Reference#GetWorkerResults|GetWorkerResults]].
−
{| class="wikitable"
 
−
! width=270px | Name
 
−
! Description
 
−
|-
 
−
| <tt>*</tt>
 
−
| All instances
 
−
|-
 
−
| <tt>instance01 instance02 instance03</tt>
 
−
| instance01, instance02 and instance03
 
−
|-
 
−
| <tt>*instancehost01 *instancehost02</tt>
 
−
| All instances on instancehost1 and instancehost2
 
−
|-
 
−
| <tt>* .running</tt>
 
−
| All running instances
 
−
|-
 
−
| <tt>* .stopped</tt>
 
−
| All stopped instances
 
−
|}
 
  
−
== GetInstanceStatistics ==
+
== GetUserInfo ==
−
Get archive statistics from instance.
+
Get detailed information about user.
  
 
=== Arguments ===
 
=== Arguments ===
Line 581: Line 753:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>userName</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| User name of MailStore user
 
|}
 
|}
  
−
== GetServiceStatus ==
+
== GetUsers ==
−
Get current status of all SPE services.
+
Get list of users.
  
−
== GetStoreAutoCreateConfiguration ==
+
== GetWorkerResults ==
−
Get automatic archive store creation settings.
+
Get results of profile executions.
  
 
=== Arguments ===
 
=== Arguments ===
Line 598: Line 770:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>fromIncluding</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Beginning of time range to fetch.
 +
|-
 +
| <tt>toExcluding</tt>
 +
| string
 +
| End of time range to fetch.
 +
|-
 +
| <tt>timeZoneID</tt>
 +
| string
 +
| The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
 +
|-
 +
| <tt>profileID</tt>
 +
| number (optional)
 +
| Filter results by given profile ID.
 +
|-
 +
| <tt>userName</tt>
 +
| string (optional)
 +
| If given, must be equal to the current username. Filters results by current user.
 
|}
 
|}
  
−
== GetStores ==
+
Interactive Management Shell Example: ''GetWorkerResults --fromIncluding="2022-01-01T00:00:00" --toExcluding="2023-01-01T00:00:00" --timeZoneID="$Local" --profileID=1 --userName="admin"''
−
Get list of archive stores.
+
 
 +
Use the API command [[Administration_API_-_Function_Reference#GetTimeZones|GetTimeZones]] to retrieve a list of all available time zones and their ids.
 +
 
 +
Be aware that ''timeZoneID'' has to be written with a capital ''ID'' where all other commands with a ''timeZoneId'' are expecting ''Id''.
 +
 
 +
== GetWorkerResultReport ==
 +
Get the details of a profile execution result.
  
 
=== Arguments ===
 
=== Arguments ===
Line 612: Line 806:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string
+
| number
−
| Unique ID of MailStore instance in which this command is invoked.
+
| The ID of the result for which the details should be fetched.
 
|}
 
|}
  
−
== GetSystemAdministrators ==
+
Use the [[Administration_API_-_Function_Reference#GetWorkerResults|GetWorkerResults]] command to get the IDs of results.
−
Get list of system administrators.
 
  
−
== MaintainFileSystemDatabases ==
+
== InitializeMFA ==
−
Execute maintenance task on archive store databases.
+
Initializes multi-factor authentication of a user. During the next login with an MFA-capable client, the user has to scan a QR code with a TOTP compatible app and has to enter an MFA code to be able to login.
 +
When ''InitializeMFA'' is called when MFA is already active for a user, a new secret is generated and the user has to scan the QR code again. This also invalidates all trusted device tokens of a user.
  
 
=== Arguments ===
 
=== Arguments ===
Line 629: Line 823:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>userName</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| The user name of the user for whom MFA shall be initialized.
 
|}
 
|}
 +
 +
[[Administration_API_-_Function_Reference#DisableMFA|DisableMFA]] disables multi-factor authentication of a user.
 +
 +
== MaintainFileSystemDatabases ==
 +
Run database maintenance on all databases of file system based archive stores.
  
 
== MergeStore ==
 
== MergeStore ==
Line 642: Line 841:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>id</tt>
 
| <tt>id</tt>
Line 656: Line 851:
 
|}
 
|}
  
−
== PairWithManagementServer ==
+
== MoveFolder ==
−
Pair server role with Management Server.
+
Move folder.
  
 
=== Arguments ===
 
=== Arguments ===
Line 665: Line 860:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>serverType</tt>
+
| <tt>fromFolder</tt>
 
| string  
 
| string  
−
| Type of server role.
+
| Old folder name.
 
|-
 
|-
−
| <tt>serverName</tt>
+
| <tt>toFolder</tt>
 
| string  
 
| string  
−
| Name of server that hosts 'serverType' role.
+
| New folder name.
−
|-
 
−
| <tt>port</tt>
 
−
| number
 
−
| TCP port on which 'serverType' role on 'serverName' accepts connections.
 
−
|-
 
−
| <tt>thumbprint</tt>
 
−
| string
 
−
| Thumbprint of SSL certificate used by serverType' role on 'serverName'
 
 
|}
 
|}
  
−
=== Argument Values ===
+
== ProcessRetentionPolicies ==
 +
Processes the configured retention policies.
  
−
==== serverType ====
+
== RebuildSelectedStoreIndexes ==
−
{| class="wikitable"
+
Rebuild all full-text indexes selected for rebuild.
−
! width=270px | Name
 
−
! Description
 
−
|-
 
−
| <tt>instanceHost</tt>
 
−
| Pairing an Instance Host.
 
−
|-
 
−
| <tt>clientAccessServer</tt>
 
−
| Pairing a Client Access Server.
 
−
|}
 
−
 
 
−
== Ping ==
 
−
Send a keep alive packet.
 
  
−
== RebuildSelectedStoreIndexes ==
+
== RebuildStoreIndex ==
−
Rebuild search indexes of selected archive stores.
+
Rebuild search index for given archive folder.
  
 
=== Arguments ===
 
=== Arguments ===
Line 708: Line 884:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string
+
| number
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Unique ID of archive store.
−
|}
 
−
 
 
−
== RefreshAllStoreStatistics ==
 
−
Refresh archive store statistics.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>folder</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Name of folder name.
 
|}
 
|}
  
−
== RenameStore ==
+
== RecoverStore ==
−
Rename archvive store
+
Recreates a broken Firebird database from recovery records. The archive store must have been upgraded to the latest version and the recovery records must not be corrupt. The archive store must be in the ''Disabled'' or ''Error'' state.
  
 
=== Arguments ===
 
=== Arguments ===
Line 735: Line 901:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>id</tt>
 
| <tt>id</tt>
Line 744: Line 906:
 
| Unique ID of archive store.
 
| Unique ID of archive store.
 
|-
 
|-
−
| <tt>name</tt>
+
| <tt>encryptionKey</tt>
−
| string  
+
| string (optional)
−
| New name of archive store.
+
| Encryption key of the archive store. Must be given, when the encryption key cannot be read from the key file of the archive store.
 +
|-
 +
| <tt>recoverDeletedMessages</tt>
 +
| bool (optional)
 +
| Defines whether to recover deleted messages.
 
|}
 
|}
  
−
== RestartInstances ==
+
When the ''recoverDeletedMessages'' parameter is set to ''true'', only deleted messages that still have leftovers in the recovery records can be recovered. When an archive store has been compacted with [[#CompactStore|CompactStore]] or recovery record files have grown to their auto-compacting size of 32 MiB these leftovers could already be removed and deleted messages cannot be recovered.
−
Restart one or multiple instances.
+
 
 +
== RecreateRecoveryRecords ==
 +
Recreates broken Recovery Records of an archive store. Use [[#VerifyStore|VerifyStore]] or [[#VerifyStores|VerifyStores]] to verify the state of the Recovery Records. Cannot be used for external archive stores that store their content in the database.
  
 
=== Arguments ===
 
=== Arguments ===
Line 758: Line 926:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceFilter</tt>
+
| <tt>id</tt>
−
| string
+
| number
−
| Instance filter string.
+
| Unique ID of archive store.
 
|}
 
|}
  
−
=== Argument Values ===
+
== RefreshAllStoreStatistics ==
−
 
+
Refresh statistics of all archive stores.
−
==== instanceFilter ====
 
−
{| class="wikitable"
 
−
! width=270px | Name
 
−
! Description
 
−
|-
 
−
| <tt>*</tt>
 
−
| All instances
 
−
|-
 
−
| <tt>instance01 instance02 instance03</tt>
 
−
| instance01, instance02 and instance03
 
−
|-
 
−
| <tt>*instancehost01 *instancehost02</tt>
 
−
| All instances on instancehost1 and instancehost2
 
−
|-
 
−
| <tt>* .running</tt>
 
−
| All running instances
 
−
|-
 
−
| <tt>* .stopped</tt>
 
−
| All stopped instances
 
−
|}
 
  
−
== RetryOpenStores ==
+
== RenameJob ==
−
Retry opening stores that failed previously
+
Rename job.
  
 
=== Arguments ===
 
=== Arguments ===
Line 795: Line 943:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string  
+
| number (optional)
−
| Unique ID of MailStore instance in which this command is invoked.
+
| The unique identifier of the job to be renamed.
 +
|-
 +
| <tt>name</tt>
 +
| string (optional)
 +
| The new job name.
 
|}
 
|}
  
−
== SelectAllStoreIndexesForRebuild ==
+
== RenameStore ==
−
Select all archive store for rebuild.
+
Rename archive store
  
 
=== Arguments ===
 
=== Arguments ===
Line 809: Line 961:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
 +
| number
 +
| Unique ID of archive store.
 +
|-
 +
| <tt>name</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| New name of archive store.
 
|}
 
|}
  
−
== SetArchiveAdminEnabled ==
+
== RenameUser ==
−
Enable or disable archive admin access.
+
Rename a MailStore user.
  
 
=== Arguments ===
 
=== Arguments ===
Line 823: Line 979:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>oldUserName</tt>
 
| string  
 
| string  
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Old user name.
 
|-
 
|-
−
| <tt>enabled</tt>
+
| <tt>newUserName</tt>
−
| bool
+
| string
−
| Enable or disable flag.
+
| New user name.
 
|}
 
|}
  
−
== SetClientAccessServerConfiguration ==
+
== RenewMasterKey ==
−
Set the configuration of a Client Access Server.
+
Renews the master key which is used to encrypt the encryption keys.
 +
 
 +
== RepairStoreDatabase ==
 +
Tries to resolve certain issues with archive store databases (e.g. missing database indexes).
  
 
=== Arguments ===
 
=== Arguments ===
Line 841: Line 1,000:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>id</tt>
−
| json
+
| number
−
| Client Access Server configuration.
+
| Unique ID of archive store.
 
|}
 
|}
  
−
=== Argument Values ===
+
== RetryOpenStores ==
 +
Retry opening stores that failed previously.
  
−
==== config ====
+
== RunJobAsync ==
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
+
Run an existing job.
−
{
 
−
  "serverName" : string,
 
−
  "port" : number,
 
−
  "serverCertificate" : {
 
−
    "thumbprint" : string
 
−
  }
 
−
}
 
−
</source>
 
−
 
 
−
== SetIndexConfiguration ==
 
−
Set full text search index configuration.
 
  
 
=== Arguments ===
 
=== Arguments ===
Line 868: Line 1,017:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string
+
| number
−
| Unique ID of MailStore instance in which this command is invoked.
+
| The identifier of the job to be run.
−
|-
 
−
| <tt>config</tt>
 
−
| json
 
−
| Full text search index configuration.
 
 
|}
 
|}
  
−
=== Argument Values ===
+
== RunProfile ==
−
 
+
Run an existing archiving or exporting profile. Only profiles that are executed on server side can be started by this command. That are all profiles which are listed under ''E-Mail Servers'' in the MailStore Client. Client side profiles can be started by using the [[MailStore_Server_Management_Shell|MailStoreCmd]] and the commands ''import-execute'' and ''export-execute''.
−
==== config ====
 
−
Use GetIndexConfiguration to reveive supported value.
 
−
 
 
−
== SetInstanceConfiguration ==
 
−
Set configuration of MailStore Instance.
 
  
 
=== Arguments ===
 
=== Arguments ===
Line 891: Line 1,031:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>id</tt>
−
| json
+
| number
−
| Instance configuration.
+
| Unique profile ID.
 
|}
 
|}
  
−
=== Argument Values ===
+
== RunTemporaryProfile ==
−
 
+
Run a temporary/non-existent profile.  Only profiles that are executed on server side can be started by this command. That are all profiles which are listed under ''E-Mail Servers'' in the MailStore Client.
−
==== config ====
 
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
 
−
{
 
−
  "instanceID" : string,
 
−
  "alias" : string,
 
−
  "displayName" : string,
 
−
  "instanceHost" : string,
 
−
  "startMode" : string,
 
−
  "baseDirectory" : string,
 
−
  "debugLogEnabled" : bool,
 
−
  "vssWriterEnabled" : bool
 
−
}
 
−
</source>
 
−
 
 
−
== SetInstanceHostConfiguration ==
 
−
Set configuration of Instance Host.
 
  
 
=== Arguments ===
 
=== Arguments ===
Line 921: Line 1,045:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>properties</tt>
 
| json  
 
| json  
−
| Instance Host configuration.
+
| Profile properties.
−
|}
 
−
 
 
−
=== Argument Values ===
 
−
 
 
−
==== config ====
 
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
 
−
{
 
−
  "serverName" : string,
 
−
  "port" : number,
 
−
  "serverCertificate" : {
 
−
    "thumbprint" : string
 
−
  },
 
−
  "baseDirectory" : string
 
−
}
 
−
</source>
 
−
 
 
−
== SetStoreAutoCreateConfiguration ==
 
−
Set configuration for automatic archive store creation.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>raw</tt>
−
| string
+
| bool
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Currently only 'true' is supported.
−
|-
 
−
| <tt>config</tt>
 
−
| json
 
−
| Archive store automatic creation configuration.
 
 
|}
 
|}
  
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== config ====
+
==== properties ====
−
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
+
To receive available profile properties create a profile of the desired type via MailStore Client and use the GetProfiles method to receive supported value.
−
{
 
−
  "enabled" : bool,
 
−
  "interval" : string,
 
−
  "sizeThreshold" : string,
 
−
  "numberOfMessagesThreshold" : number,
 
−
  "baseDirectory" : string
 
−
}
 
−
</source>
 
  
−
== SetStorePath ==
+
== SelectAllStoreIndexesForRebuild ==
−
Set the path to archive store data.
+
Select all full-text indexes for rebuild.
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
−
|-
 
−
| <tt>id</tt>
 
−
| number
 
−
| Unique ID of archive store.
 
−
|-
 
−
| <tt>path</tt>
 
−
| string
 
−
| Path to archvie store data.
 
−
|}
 
  
−
== SetStoreRequestedState ==
+
== SendStatusReport ==
−
Set state of archive store.
+
Send a status report to the given recipients.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,002: Line 1,071:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>timespan</tt>
−
| string  
+
| string
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Timespan that is covered by the status report.
 
|-
 
|-
−
| <tt>id</tt>
+
| <tt>timeZoneId</tt>
−
| number
+
| string
−
| Unique ID of archive store.
+
| The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
 
|-
 
|-
−
| <tt>requestedState</tt>
+
| <tt>recipients</tt>
−
| string  
+
| string
−
| State of archive store.
+
| Comma separated list of recipients that will receive the status report.
 
|}
 
|}
  
 +
Use the API command [[Administration_API_-_Function_Reference#GetTimeZones|GetTimeZones]] to retrieve a list of all available time zones and their ids.
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== requestedState ====
+
==== Timespan ====
 
{| class="wikitable"
 
{| class="wikitable"
 
! width=270px | Name
 
! width=270px | Name
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>current</tt>
+
| <tt>today</tt>
−
| Same as Normal but new messages will be archived in the archive store that is set to Current.
+
| The day when the status report is sent.
 +
|-
 +
| <tt>yesterday</tt>
 +
| The day before the status report is sent.
 +
|-
 +
| <tt>thisweek</tt>
 +
| The week when the status report is sent.
 
|-
 
|-
−
| <tt>normal</tt>
+
| <tt>lastweek</tt>
−
| The content of archives store is available to users and can be modified if the user has the appropriate permission.
+
| The week before the status report is sent.
 
|-
 
|-
−
| <tt>writeProtected</tt>
+
| <tt>thismonth</tt>
−
| The content of write protected archive stores is available to users, but cannot be modified (e.g. delete or move messages, rename or move folders)
+
| The month when the status report is sent.
 
|-
 
|-
−
| <tt>disabled</tt>
+
| <tt>lastmonth</tt>
−
| Disabled archive stores are not in use but the instance still knows about their existence. Therefore the content is not available to users.
+
| The month before the status report is sent.
 
|}
 
|}
  
−
== SetSystemAdministratorConfiguration ==
+
== SetComplianceConfiguration ==
−
Set SPE system adminstrator configuration.
+
Set compliance configuration settings.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,046: Line 1,122:
 
| <tt>config</tt>
 
| <tt>config</tt>
 
| json  
 
| json  
−
| SPE system adminstrator configuration.
+
| Compliance configuration.
 
|}
 
|}
  
Line 1,052: Line 1,128:
  
 
==== config ====
 
==== config ====
 +
Use [[Administration_API_-_Function_Reference#GetComplianceConfiguration|GetComplianceConfiguration]] to receive supported values.
 +
 +
Example settings object:
 
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
 
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
 
{
 
{
−
   "fullName" : string
+
   "adminEmailPreviewEnabled": true,
 +
  "legalHoldEnabled": false,
 +
  "passwordPolicyEnabled": true,
 +
  "logSuccessfulUserActivities": [
 +
    "AdminRestored",
 +
    "ComplianceChangeSettings",
 +
    "FileGroupAttach",
 +
    "FileGroupCreate",
 +
    "FileGroupDetach",
 +
    "FileGroupRename",
 +
    "FileGroupSetProperties",
 +
    "FileGroupSetRequestedState",
 +
    "ProfileChangeUserName",
 +
    "UserAdd",
 +
    "UserDelete",
 +
    "UserRename",
 +
    "UserSetFolderAccess",
 +
    "UserSetMappings",
 +
    "UserUpdate"
 +
  ]
 
}
 
}
 
</source>
 
</source>
  
−
== SetSystemAdministratorPassword ==
+
== SetDirectoryServicesConfiguration ==
−
Set password for SPE system administrator.
+
Set directory services configuration settings.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,067: Line 1,165:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>userName</tt>
+
| <tt>config</tt>
−
| string
+
| json
−
| User name of SPE system administrator.
+
| Directory services configuration.
−
|-
 
−
| <tt>password</tt>
 
−
| string
 
−
| New password for SPE system administrator.
 
 
|}
 
|}
  
−
== StartInstances ==
+
=== Argument Values ===
−
Start one or multiple MailStore Instances.
+
 
 +
==== config ====
 +
Use GetDirectoryServicesConfiguration to receive supported value.
 +
 
 +
== SetJobEnabled ==
 +
Set enabled status of a job.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,085: Line 1,184:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceFilter</tt>
+
| <tt>id</tt>
−
| string
+
| number (optional)
−
| Instance filter string.
+
| The unique identifier of the job to be modified.
−
|}
 
−
 
 
−
=== Argument Values ===
 
−
 
 
−
==== instanceFilter ====
 
−
{| class="wikitable"
 
−
! width=270px | Name
 
−
! Description
 
 
|-
 
|-
−
| <tt>*</tt>
+
| <tt>enabled</tt>
−
| All instances
+
| bool (optional)
−
|-
+
| Boolean value of '''enabled''' attribute.
−
| <tt>instance01 instance02 instance03</tt>
 
−
| instance01, instance02 and instance03
 
−
|-
 
−
| <tt>*instancehost01 *instancehost02</tt>
 
−
| All instances on instancehost1 and instancehost2
 
−
|-
 
−
| <tt>* .running</tt>
 
−
| All running instances
 
−
|-
 
−
| <tt>* .stopped</tt>
 
−
| All stopped instances
 
 
|}
 
|}
  
−
== StopInstances ==
+
== SetJobSchedule ==
−
Stop one or multiple MailStore Instances.
+
Modify the schedule of a job.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,122: Line 1,202:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceFilter</tt>
+
| <tt>id</tt>
 +
| number
 +
| The unique identifier of the job to be modified.
 +
|-
 +
| <tt>timeZoneId</tt>
 
| string  
 
| string  
−
| Instance filter string.
+
| The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
−
|}
 
−
 
 
−
=== Argument Values ===
 
−
 
 
−
==== instanceFilter ====
 
−
{| class="wikitable"
 
−
! width=270px | Name
 
−
! Description
 
 
|-
 
|-
−
| <tt>*</tt>
+
| <tt>date</tt>
−
| All instances
+
| string (optional)
 +
| Datetime string (YYYY-MM-DDThh:mm:ss) for running the job once.
 
|-
 
|-
−
| <tt>instance01 instance02 instance03</tt>
+
| <tt>interval</tt>
−
| instance01, instance02 and instance03
+
| number (optional)
 +
| Interval for running job.
 
|-
 
|-
−
| <tt>*instancehost01 *instancehost02</tt>
+
| <tt>time</tt>
−
| All instances on instancehost1 and instancehost2
+
| string (optional)
 +
| Time for running job. Without additional parameter, this means daily execution.
 
|-
 
|-
−
| <tt>* .running</tt>
+
| <tt>dayOfWeek</tt>
−
| All running instances
+
| string (optional)
 +
| Day of week to run job. Parameter "time" also required.
 
|-
 
|-
−
| <tt>* .stopped</tt>
+
| <tt>dayOfMonth</tt>
−
| All stopped instances
+
| string (optional)
−
|}
+
| Day of month to run job. Parameter "time" also required. dayOfWeek can optionally be used to define further.
−
 
 
−
== ThawInstances ==
 
−
Thaw one or multiple MailStore Instances.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
−
|-
 
−
| <tt>instanceFilter</tt>
 
−
| string
 
−
| Instance filter string.
 
 
|}
 
|}
  
 +
Use the API command [[Administration_API_-_Function_Reference#GetTimeZones|GetTimeZones]] to retrieve a list of all available time zones and their ids.
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== instanceFilter ====
+
==== dayOfWeek ====
 
{| class="wikitable"
 
{| class="wikitable"
 
! width=270px | Name
 
! width=270px | Name
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>*</tt>
+
| <tt>Sunday</tt>
−
| All instances
+
| Sunday
 
|-
 
|-
−
| <tt>instance01 instance02 instance03</tt>
+
| <tt>Monday</tt>
−
| instance01, instance02 and instance03
+
| Monday
 
|-
 
|-
−
| <tt>*instancehost01 *instancehost02</tt>
+
| <tt>Tuesday</tt>
−
| All instances on instancehost1 and instancehost2
+
| Tuesday
 
|-
 
|-
−
| <tt>* .running</tt>
+
| <tt>Wednesday</tt>
−
| All running instances
+
| Wednesday
 
|-
 
|-
−
| <tt>* .stopped</tt>
+
| <tt>Thursday</tt>
−
| All stopped instances
+
| Thursday
−
|}
 
−
 
 
−
== UpgradeStore ==
 
−
Upgrade archive store from MailStore Server 5 or older to current format.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>Friday</tt>
−
| string
+
| Friday
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>id</tt>
+
| <tt>Saturday</tt>
−
| number
+
| Saturday
−
| Unique ID of archive store.
 
 
|}
 
|}
  
−
== VerifyStore ==
+
==== dayOfMonth ====
−
Verify archive stores consistency.
 
−
 
 
−
=== Arguments ===
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! width=150px | Name
+
! width=270px | Name
−
! width=120px | Type
 
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>1 to 31</tt>
−
| string
+
| Numeric representation of day of month.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>id</tt>
+
| <tt>Last</tt>
−
| number
+
| Last day of month.
−
| Unique ID of archive store.
 
 
|}
 
|}
  
−
== ClearUserPrivilegesOnFolders ==
+
==== interval ====
−
Removes all privileges of a user on all archive folders.
 
−
 
 
−
=== Arguments ===
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! width=150px | Name
+
! width=270px | Name
−
! width=120px | Type
 
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>5</tt>
−
| string
+
| Every 5 minutes.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>userName</tt>
+
| <tt>10</tt>
−
| string
+
| Every 10 minutes.
−
| User name of MailStore user.
 
−
|}
 
−
 
 
−
== CreateProfile ==
 
−
Create a new archiving or exporting profile.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>15</tt>
−
| string
+
| Every 15 minutes.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>properties</tt>
+
| <tt>20</tt>
−
| json
+
| Every 20 minutes.
−
| Profile properties.
 
 
|-
 
|-
−
| <tt>raw</tt>
+
| <tt>30</tt>
−
| bool
+
| Every 30 minutes.
−
| Currently only 'true' is supported.
 
−
|}
 
−
 
 
−
=== Argument Values ===
 
−
 
 
−
==== properties ====
 
−
To receive available profile properties create a profile of the desired type via MailStore Client and use the GetProfiles method to receive supported value. ''Id'' and ''Version'' attributes must not be set.
 
−
 
 
−
== CreateUser ==
 
−
Create new MailStore user.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>60</tt>
−
| string
+
| Every hour.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>userName</tt>
+
| <tt>120</tt>
−
| string
+
| Every 2 hours.
−
| User name of new MailStore user.
 
 
|-
 
|-
−
| <tt>privileges</tt>
+
| <tt>180</tt>
−
| string
+
| Every 3 hours.
−
| Comma separated list of privileges.
 
−
|-
 
−
| <tt>fullName</tt>
 
−
| string (optional)
 
−
| Full name of user.
 
−
|-
 
−
| <tt>distinguishedName</tt>
 
−
| string (optional)
 
−
| LDAP DN string.
 
−
|-
 
−
| <tt>authentication</tt>
 
−
| string (optional)
 
−
| Authentication setting for user: 'integrated' or 'directoryServices'.
 
 
|-
 
|-
−
| <tt>password</tt>
+
| <tt>260</tt>
−
| string (optional)
+
| Every 4 hours.
−
| Password of new user.
 
−
|}
 
−
 
 
−
== DeleteEmptyFolders ==
 
−
Remove folders from folder tree that do not contain emails.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>360</tt>
−
| string
+
| Every 6 hours.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>folder</tt>
+
| <tt>720</tt>
−
| string (optional)
+
| Every 12 hours.
−
| Entry point in folder tree.
 
 
|}
 
|}
  
−
== DeleteMessage ==
+
== SetProfileServerSideExecution ==
−
Delete a single message
+
Disables or enables the automatic server-sided execution with its parameters.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,332: Line 1,320:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
−
|-
 
−
| <tt>id</tt>
 
−
| string (optional)
 
−
| Unique ID of message. Format: <store_id>:<message_num>
 
−
|}
 
−
 
−
== DeleteProfile ==
 
−
Delete an archiving or exporting profile.
 
−
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>id</tt>
 
| <tt>id</tt>
 
| number  
 
| number  
−
| Unique ID of profile.
+
| The unique profile ID of the profile to be modified.
−
|}
 
−
 
 
−
== DeleteUser ==
 
−
Delete a MailStore user.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>automatic</tt>
−
| string
+
| bool
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Enables (true) or disables (false) the profile's server-side automation.
 
|-
 
|-
−
| <tt>userName</tt>
+
| <tt>automaticPauseBetweenExecutions</tt>
−
| string
+
| number (optional)
−
| User name of MailStore user.
+
| Integer value (0 - 2147483647) of seconds to pause between re-executing an automatic profile.
−
|}
 
−
 
 
−
== GetChildFolders ==
 
−
Get child folders.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>automaticMaintenanceWindows</tt>
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
−
|-
 
−
| <tt>folder</tt>
 
 
| string (optional)
 
| string (optional)
−
| Parent folder.
+
| TimeSpan string (hh:mm-hh:mm, e.g. 22:00-04:00) for the time window where the execution should not be executed, e.g. to schedule maintenance tasks.
−
|-
 
−
| <tt>maxLevels</tt>
 
−
| number (optional)
 
−
| Depth of child folders.
 
 
|}
 
|}
  
−
== GetComplianceConfiguration ==
+
Use the API command [[Administration_API_-_Function_Reference#GetProfiles|GetProfiles]] to retrieve a list of all profiles and their current "serverSideExecution" section details.
−
Get current compliance configuration settings.
 
  
−
=== Arguments ===
+
The command can be executed with either the argument ''automatic=false'' and no additional parameters to disable the automation, or with ''automatic=true'' and at least the ''automaticPauseBetweenExecutions'' value given. The ''automaticMaintenanceWindows'' parameter is optional. Setting an already automated profile to automatic again, will restart the profile.
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
−
|}
 
  
−
== GetDirectoryServicesConfiguration ==
+
== SetRetentionPolicies ==
−
Get current Directory Services configuration settings.
+
Set retention policies.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,423: Line 1,351:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>config</tt>
−
| string
+
| json
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Retention policy configuration.
 
|}
 
|}
  
−
== GetFolderStatistics ==
+
To get example policies use the client to create retention policies manually. Then use the API command [[Administration_API_-_Function_Reference#GetRetentionPolicies|GetRetentionPolicies]] to retrieve the json values. <br>
−
Get folder statistics.
+
Please be aware that the API is case-sensitive. Especially the archive inclusion/exclusion criteria must not contain upper case characters, as the user archives are always handled lower-case internally.
−
 
+
Due to a more complex distributed permission concept, retention policies can not be edited via the API for the MailStore Service Provider Edition.
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
−
|}
 
  
−
== GetMessages ==
+
== SetServiceCertificate ==
−
Get list of messages from a folder.
+
Set the X509 certificate that is used by MailStore Server for incoming connections.
 +
The certificate must already reside in the computer's local certificate store.
 +
The thumbprint of the currently used certificate can be retrieved with [[Administration_API_-_Function_Reference#GetServiceConfiguration|GetServiceConfiguration]].
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,451: Line 1,371:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>thumbprint</tt>
−
| string  
+
| string
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Thumbprint of X509 certificate.
−
|-
 
−
| <tt>folder</tt>
 
−
| string (optional)
 
−
| Folder whose content to list.
 
 
|}
 
|}
  
−
== GetProfiles ==
+
== SetSmtpSettings ==
−
Get list of archiving and exporting profiles.
+
Set SMTP configuration.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,469: Line 1,385:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>settings</tt>
−
| string
+
| json
−
| Unique ID of MailStore instance in which this command is invoked.
+
| SMTP configuration.
−
|-
 
−
| <tt>raw</tt>
 
−
| bool
 
−
| Currently only 'true' is supported.
 
 
|}
 
|}
  
−
== GetTimeZones ==
+
=== Argument Values ===
−
Get list of available time zones.
 
  
−
=== Arguments ===
+
==== settings====
−
{| class="wikitable"
+
Example settings object:
−
! width=150px | Name
+
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
−
! width=120px | Type
+
{
−
! Description
+
  "hostname": "mail.example.com",
−
|-
+
  "port": 587,
−
| <tt>instanceID</tt>
+
  "protocol": "SMTP-TLS",
−
| string
+
  "ignoreSslPolicyErrors": false,
−
| Unique ID of MailStore instance in which this command is invoked.
+
  "authenticationRequired": true,
−
|}
+
  "username": "[email protected]",
 +
  "password": "userpassword",
 +
  "fromDisplayName": "Sending User",
 +
  "fromEmailAddress": "[email protected]",
 +
  "recipientEmailAddresses": ["administrator@example.com", "[email protected]"]
 +
}
 +
</source>
  
−
== GetUserInfo ==
+
== SetStoreAutoCreateConfiguration ==
−
Get detailed information about user.
+
Set configuration for automatic archive store creation.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,501: Line 1,418:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>config</tt>
−
| string
+
| json
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Archive store automatic creation configuration.
−
|-
 
−
| <tt>userName</tt>
 
−
| string
 
−
| User name of MailStore user
 
 
|}
 
|}
  
−
== GetUsers ==
+
=== Argument Values ===
−
Get list of users.
 
  
−
=== Arguments ===
+
==== config ====
−
{| class="wikitable"
+
<source lang="js" smart-tabs="true" toolbar="false" gutter="false">
−
! width=150px | Name
+
{
−
! width=120px | Type
+
  "sizeThreshold" : int or null,
−
! Description
+
  "databaseBaseDirectory" : string,
−
|-
+
  "contentBaseDirectory" : string,
−
| <tt>instanceID</tt>
+
  "indexBaseDirectory" : string
−
| string  
+
}
−
| Unique ID of MailStore instance in which this command is invoked.
+
</source>
−
|}
 
  
−
== GetWorkerResults ==
+
== SetStoreProperties ==
−
Get results of profile executions.
+
Set properties of archive store.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,533: Line 1,444:
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>id</tt>
−
| string
+
| number
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Set properties of archive store.
 
|-
 
|-
−
| <tt>fromIncluding</tt>
+
| <tt>type</tt>
−
| string  
+
| string (optional)
−
| Beginning of time range to fetch.
+
|  
 
|-
 
|-
−
| <tt>toExcluding</tt>
+
| <tt>databaseName</tt>
−
| string  
+
| string (optional)
−
| End of time range to fetch.
+
| Name of database on Microsoft SQL Server or PostgreSQL server.
 
|-
 
|-
−
| <tt>timeZoneID</tt>
+
| <tt>databasePath</tt>
−
| string  
+
| string (optional)
−
| Time zone in which timestamp should be returned.
+
| Path to directory in which database folder information and email meta data are stored.
 
|-
 
|-
−
| <tt>profileID</tt>
+
| <tt>contentPath</tt>
−
| number (optional)
+
| string (optional)
−
| Filter results by given profile ID.
+
| Path to directory in which email headers and contents are stored.
 
|-
 
|-
−
| <tt>userName</tt>
+
| <tt>indexPath</tt>
 
| string (optional)
 
| string (optional)
−
| Filter results by given user name.
+
| Path to directory in which full text search indexes are stored.
−
|}
 
−
 
 
−
== MoveFolder ==
 
−
Move folder.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>serverName</tt>
−
| string  
+
| string (optional)
−
| Unique ID of MailStore instance in which this command is invoked.
+
| Name of Microsoft SQL Server or PostgreSQL server.
 
|-
 
|-
−
| <tt>fromFolder</tt>
+
| <tt>userName</tt>
−
| string  
+
| string (optional)
−
| Old folder name.
+
| User name for accessing Microsoft SQL Server or PostgreSQL server.
 
|-
 
|-
−
| <tt>toFolder</tt>
+
| <tt>password</tt>
−
| string  
+
| string (optional)
−
| New folder name.
+
| Password for accessing Microsoft SQL Server or PostgreSQL server.
 
|}
 
|}
  
−
== RenameUser ==
+
=== Argument Values ===
−
Rename a MailStore user.
 
  
−
=== Arguments ===
+
==== type ====
 
{| class="wikitable"
 
{| class="wikitable"
−
! width=150px | Name
+
! width=270px | Name
−
! width=120px | Type
 
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>FileSystemInternal</tt>
−
| string
+
| Advanced file system-based archive store.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>oldUserName</tt>
+
| <tt>SQLServer</tt>
−
| string
+
| Microsoft SQL Server-based archive store.
−
| Old user name.
 
 
|-
 
|-
−
| <tt>newUserName</tt>
+
| <tt>PostgreSQL</tt>
−
| string
+
| PostgreSQL server-based archive store.
−
| New user name.
 
 
|}
 
|}
  
−
== RunProfile ==
+
== SetStoreRequestedState ==
−
Run an existing archiving or exporting profile.
+
Set state of archive store.
  
 
=== Arguments ===
 
=== Arguments ===
Line 1,610: Line 1,506:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>id</tt>
 
| <tt>id</tt>
 
| number  
 
| number  
−
| Unique profile ID.
+
| Unique ID of archive store.
−
|}
 
−
 
 
−
== RunTemporaryProfile ==
 
−
Run a temporary/non-existent profile.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>requestedState</tt>
−
| string  
+
| string (optional)
−
| Unique ID of MailStore instance in which this command is invoked.
+
| State of archive store after attaching.
−
|-
 
−
| <tt>properties</tt>
 
−
| json
 
−
| Profile properties.
 
−
|-
 
−
| <tt>raw</tt>
 
−
| bool
 
−
| Currently only 'true' is supported.
 
 
|}
 
|}
  
 
=== Argument Values ===
 
=== Argument Values ===
  
−
==== properties ====
+
==== requestedState ====
−
To receive available profile properties create a profile of the desired type via MailStore Client and use the GetProfiles method to receive supported value. ''Id'' and ''Version'' attributes must not be set.
 
−
 
 
−
== SetComplianceConfiguration ==
 
−
Set compliance configuration settings.
 
−
 
 
−
=== Arguments ===
 
 
{| class="wikitable"
 
{| class="wikitable"
−
! width=150px | Name
+
! width=270px | Name
−
! width=120px | Type
 
 
! Description
 
! Description
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>current</tt>
−
| string
+
| Same as Normal but new messages will be archived in the archive store that is set to Current.
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>normal</tt>
−
| json
+
| The content of archives store is available to users and can be modified if the user has the appropriate permission.
−
| Compliance configuration.
 
−
|}
 
−
 
 
−
=== Argument Values ===
 
−
 
 
−
==== config ====
 
−
Use GetComplianceConfiguration to receive supported value.
 
−
 
 
−
== SetDirectoryServicesConfiguration ==
 
−
Set directory services configuration settings.
 
−
 
 
−
=== Arguments ===
 
−
{| class="wikitable"
 
−
! width=150px | Name
 
−
! width=120px | Type
 
−
! Description
 
 
|-
 
|-
−
| <tt>instanceID</tt>
+
| <tt>writeProtected</tt>
−
| string
+
| The content of write protected archive stores is available to users, but cannot be modified (e.g. delete or move messages, rename or move folders)
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
−
| <tt>config</tt>
+
| <tt>disabled</tt>
−
| json
+
| Disabled archive stores are not in use but the instance still knows about their existence. Therefore the content is not available to users.
−
| Directory services configuration.
 
 
|}
 
|}
−
 
−
=== Argument Values ===
 
−
 
−
==== config ====
 
−
Use GetDirectoryServicesConfiguration to receive supported value.
 
  
 
== SetUserAuthentication ==
 
== SetUserAuthentication ==
Line 1,701: Line 1,544:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,723: Line 1,562:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,745: Line 1,580:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,767: Line 1,598:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,780: Line 1,607:
 
| Full name of MailStore user.
 
| Full name of MailStore user.
 
|}
 
|}
 +
 +
== SetUserLoginPrivileges ==
 +
Set login privileges of a MailStore user.
 +
 +
=== Arguments ===
 +
{| class="wikitable"
 +
! width=150px | Name
 +
! width=120px | Type
 +
! Description
 +
|-
 +
| <tt>userName</tt>
 +
| string
 +
| User name of MailStore user.
 +
|-
 +
| <tt>loginPrivileges</tt>
 +
| string
 +
| Comma separated list of login privileges.
 +
|}
 +
 +
=== Argument Values ===
 +
 +
==== loginPrivileges ====
 +
{{Administration_API_User_Login_Privileges}}
  
 
== SetUserPassword ==
 
== SetUserPassword ==
Line 1,789: Line 1,639:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,811: Line 1,657:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,822: Line 1,664:
 
| <tt>pop3UserNames</tt>
 
| <tt>pop3UserNames</tt>
 
| string (optional)
 
| string (optional)
−
| Comma seperated list of POP3 user names.
+
| Comma separated list of POP3 user names.
 
|}
 
|}
  
Line 1,833: Line 1,675:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,846: Line 1,684:
 
| Comma separated list of privileges.
 
| Comma separated list of privileges.
 
|}
 
|}
 +
 +
=== Argument Values ===
 +
 +
==== privileges ====
 +
{{Administration_API_User_Privileges}}
  
 
== SetUserPrivilegesOnFolder ==
 
== SetUserPrivilegesOnFolder ==
Line 1,855: Line 1,698:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>userName</tt>
 
| <tt>userName</tt>
Line 1,871: Line 1,710:
 
| string  
 
| string  
 
| Comma separated list of folder privileges.
 
| Comma separated list of folder privileges.
 +
|}
 +
 +
=== Argument Values ===
 +
 +
==== privileges ====
 +
{| class="wikitable"
 +
! width=270px | Name
 +
! Description
 +
|-
 +
| <tt>none</tt>
 +
| The user is denied access to the specified folder. If specified, this value has to be the only value in the list. This effectively removes all privileges on the specified folder.
 +
|-
 +
| <tt>read</tt>
 +
| The user is granted read access to the specified folder.
 +
|-
 +
| <tt>write</tt>
 +
| The user is granted write access to the specified folder. Messages can be moved within an archive.
 +
|-
 +
| <tt>delete</tt>
 +
| The user is granted delete access to the specified folder.
 
|}
 
|}
  
Line 1,881: Line 1,740:
 
! width=120px | Type
 
! width=120px | Type
 
! Description
 
! Description
−
|-
 
−
| <tt>instanceID</tt>
 
−
| string
 
−
| Unique ID of MailStore instance in which this command is invoked.
 
 
|-
 
|-
 
| <tt>dryRun</tt>
 
| <tt>dryRun</tt>
Line 1,890: Line 1,745:
 
| Simulate sync only.
 
| Simulate sync only.
 
|}
 
|}
 +
 +
== TestSmtpSettings ==
 +
Test current SMTP configuration.
 +
 +
== UnlockStore ==
 +
Unlock a foreign archive store. In case an archive store from a foreign MailStore installation is attached, this method can be used to unlock that archive store.
 +
 +
=== Arguments ===
 +
{| class="wikitable"
 +
! width=150px | Name
 +
! width=120px | Type
 +
! Description
 +
|-
 +
| <tt>id</tt>
 +
| number
 +
| Unique ID of archive store to unlock.
 +
|-
 +
| <tt>passphrase</tt>
 +
| string
 +
| Product key or recovery key of the foreign MailStore installation.
 +
|}
 +
 +
== UpgradeStore ==
 +
Upgrade an archive store from an older version to the current format.
 +
 +
=== Arguments ===
 +
{| class="wikitable"
 +
! width=150px | Name
 +
! width=120px | Type
 +
! Description
 +
|-
 +
| <tt>id</tt>
 +
| number
 +
| Unique ID of archive store.
 +
|}
 +
 +
== UpgradeStores ==
 +
Upgrade all archive stores from an older version to the current format.
 +
 +
== VerifyStore ==
 +
Verify archive stores consistency.
 +
 +
=== Arguments ===
 +
{| class="wikitable"
 +
! width=150px | Name
 +
! width=120px | Type
 +
! Description
 +
|-
 +
| <tt>id</tt>
 +
| number
 +
| The unique identifier of the archive store to be verified.
 +
|-
 +
| <tt>includeIndexes</tt>
 +
| bool
 +
| Defines whether to verify the search indexes as well. Default: true. May be slow when running on slow hardware.
 +
|}
 +
 +
== VerifyStores ==
 +
Verify consistency of all archive stores.
 +
 +
=== Arguments ===
 +
{| class="wikitable"
 +
! width=150px | Name
 +
! width=120px | Type
 +
! Description
 +
|-
 +
| <tt>includeIndexes</tt>
 +
| bool
 +
| Defines whether to verify the search indexes as well. Default: true. May be slow when running on slow hardware.
 +
|}
 +
 +
[[de:Administration API - Function Reference]]
 +
[[en:Administration API - Function Reference]]

Latest revision as of 10:36, 28 March 2024


AttachStore

Attach existing archive store.

Arguments

Name Type Description
name string Meaningful name of archive store.
type string Type of archive store.
databaseName string (optional) Name of database on Microsoft SQL Server or PostgreSQL server.
databasePath string (optional) Path to directory in which database folder information and email meta data are stored.
contentPath string (optional) Path to directory in which email headers and contents are stored.
indexPath string (optional) Path to directory in which full text search indexes are stored.
serverName string (optional) Name of Microsoft SQL Server or PostgreSQL server.
userName string (optional) User name for accessing Microsoft SQL Server or PostgreSQL server.
password string (optional) Password for accessing Microsoft SQL Server or PostgreSQL server.
requestedState string (optional) State of archive store after attaching.

Argument Values

type

Name Description
FileSystemInternal Advanced file system-based archive store.
SQLServer Microsoft SQL Server-based archive store.
PostgreSQL PostgreSQL server-based archive store.

requestedState

Name Description
current Same as Normal but new messages will be archived in the archive store that is set to Current.
normal The content of archives store is available to users and can be modified if the user has the appropriate permission.
writeProtected The content of write protected archive stores is available to users, but cannot be modified (e.g. delete or move messages, rename or move folders)
disabled Disabled archive stores are not in use but the instance still knows about their existence. Therefore the content is not available to users.

CancelJobAsync

Cancel a running job asynchronously.

Arguments

Name Type Description
id number The unique identifier of the job to be canceled.

ClearUserPrivilegesOnFolders

Removes all privileges of a user on all archive folders.

Arguments

Name Type Description
userName string User name of MailStore user.

CompactMasterDatabase

Compact master database.

CompactStore

Compact archive store.

Arguments

Name Type Description
id number Unique ID of archive store

CreateBackup

Create a backup of the entire archive.

Arguments

Name Type Description
path string Path to directory into which the backup should be written.
excludeSearchIndexes bool (optional) Indicates whether the search index files should be excluded from the backup.

CreateJob

Create a new job to execute Management API commands.

Arguments

Name Type Description
name string (optional) A meaningful name for the job. Example: Daily Backup.
action string (optional) Management API command to execute.
owner string (optional) Username of the job owner; must be an administrator.
timeZoneId string (optional) The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
date string (optional) Datetime string (YYYY-MM-DDThh:mm:ss) for running the job once.
interval number (optional) Interval for running job.
time string (optional) Time for running job. Without additional parameter, this means daily execution.
dayOfWeek string (optional) Day of week to run job. Parameter "time" also required.
dayOfMonth string (optional) Day of month to run job. Parameter "time" also required. dayOfWeek can optionally be used to define further.

Use the API command GetTimeZones to retrieve a list of all available time zones and their ids.

Argument Values

dayOfWeek

Name Description
Sunday Sunday
Monday Monday
Tuesday Tuesday
Wednesday Wednesday
Thursday Thursday
Friday Friday
Saturday Saturday

dayOfMonth

Name Description
1 to 31 Numeric representation of day of month.
Last Last day of month.

interval

Name Description
5 Every 5 minutes.
10 Every 10 minutes.
15 Every 15 minutes.
20 Every 20 minutes.
30 Every 30 minutes.
60 Every hour.
120 Every 2 hours.
180 Every 3 hours.
240 Every 4 hours.
360 Every 6 hours.
720 Every 12 hours.

CreateProfile

Create a new archiving or exporting profile.

Arguments

Name Type Description
properties json Profile properties.
raw bool Currently only 'true' is supported.

Argument Values

properties

To receive available profile properties create a profile of the desired type via MailStore Client and then use the GetProfiles method to receive supported values. The properties id and version must be omitted, the password field must be filled properly.

CreateStore

Create and attach a new archive store.

Arguments

Name Type Description
name string Meaningful name of archive store.
type string (optional) Type of archive store.
databaseName string (optional) Name of database on Microsoft SQL Server or PostgreSQL server.
databasePath string (optional) Path to directory in which database folder information and email meta data are stored.
contentPath string (optional) Path to directory in which email headers and contents are stored.
indexPath string (optional) Path to directory in which full text search indexes are stored.
serverName string (optional) Name of Microsoft SQL Server or PostgreSQL server.
userName string (optional) User name for accessing Microsoft SQL Server or PostgreSQL server.
password string (optional) Password for accessing Microsoft SQL Server or PostgreSQL server.
requestedState string (optional) State of archive store after attaching.

Argument Values

type

Name Description
FileSystemInternal Standard archive store.
SQLServer Microsoft SQL Server-based archive store.
PostgreSQL PostgreSQL server-based archive store.

requestedState

Name Description
current Same as Normal but new messages will be archived in the archive store that is set to Current.
normal The content of archives store is available to users and can be modified if the user has the appropriate permission.
writeProtected The content of write protected archive stores is available to users, but cannot be modified (e.g. delete or move messages, rename or move folders)
disabled Disabled archive stores are not in use but the instance still knows about their existence. Therefore the content is not available to users.

CreateUser

Create new MailStore user. Use SetUserPrivilegesOnFolder to grant that user privileges on the user's own archive.

Arguments

Name Type Description
userName string User name of new MailStore user.
privileges string Comma separated list of privileges.
fullName string (optional) Full name of user.
distinguishedName string (optional) LDAP DN string.
authentication string (optional) Authentication setting for user: 'integrated or 'directoryServices'.
password string (optional) Password of new user.
loginPrivileges string (optional) Comma separated list of log in privileges. If not given, all login privileges are assigned.

Argument Values

privileges

Name Description
none The user is granted no global privileges. If specified, this value has to be the only value in the list.
admin The user is granted administrator privileges. If specified, this value has to be the only value in the list.
login The user can log on to MailStore Server.
changePassword The user can change his own MailStore Server password. This only makes sense if the authentication is set to integrated.
archive The user can run archiving profiles.
modifyArchiveProfiles The user can create, modify and delete archiving profiles.
export The user can run export profiles.
modifyExportProfiles The user can create, modify and delete export profiles.
delete The user can delete messages. Please note that a non-admin user can only delete messages in folders where he has been granted delete access. In addition, compliance settings may be in effect, keeping administrators and users from deleting messages even if they have been granted the privilege to do so.


loginPrivileges

Name Description
none The user is granted no login privileges. If specified, this value has to be the only value in the list.
windows The user is allowed to use the Windows Client.
web The user is allowed to use the Web Access.
outlook The user is allowed to use the Outlook Add-in.
windowsCmd The user is allowed to use scheduled tasks and the command line client of MailStore Client.
imap The user is allowed to access the archive using IMAP.
api The user is allowed to use the Management API. This option is only available for administrators. This option is unavailable in the SPE.

DeleteAppPasswords

Deletes all app passwords of a user, hence all non-interactive logins will fail and have to be reconfigured by the user.

Arguments

Name Type Description
userName string The user name of the user whose app passwords shall be deleted.

DeleteEmptyFolders

Remove folders from folder tree that do not contain emails.

Arguments

Name Type Description
folder string (optional) Entry point in folder tree.

DeleteJob

Deletes a job.

Arguments

Name Type Description
id string The unique identifier of the job to be deleted.

DeleteMessage

Delete a single message

Arguments

Name Type Description
id string Unique ID of message. Format: <store_id>:<message_num>
reason string The reason why that message has to be deleted which will be written into the audit log.

DeleteProfile

Delete an archiving or exporting profile.

Arguments

Name Type Description
id number Unique ID of profile.

DeleteUser

Delete a MailStore user. Neither the user's archive nor the user's archive emails are deleted when deleting a user.

Arguments

Name Type Description
userName string User name of MailStore user.

DetachStore

Detach an archive store.

Arguments

Name Type Description
id number Unique ID of archive store.

DisableMFA

Disables multi-factor authentication of a user.

Arguments

Name Type Description
userName string The user name of the user for whom MFA shall be disabled.

InitializeMFA enables multi-factor authentication of a user.

GetActiveSessions

Get list of current user sessions.

GetChildFolders

Get child folders. Depending on compliance settings this method may return only the first folder hierarchy level.

Arguments

Name Type Description
folder string (optional) Parent folder whose child folders should be returned. If omitted, all archives and folder will be returned.
maxLevels number (optional) Depth of child folders.

GetComplianceConfiguration

Get current compliance configuration settings.

GetCredentials

Get the list of credential objects and their details.

GetDirectoryServicesConfiguration

Get current Directory Services configuration settings.

GetFolderStatistics

Get folder statistics.

GetJobResults

Retrieves list of finished job executions.

Arguments

Name Type Description
fromIncluding string Beginning of time range to fetch.
toExcluding string End of time range to fetch.
timeZoneId string The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
jobId number (optional) The job id for which to retrieve results.

Interactive Management Shell Example: GetJobResults --fromIncluding="2022-12-01T00:00:00" --toExcluding="2023-01-01T00:00:00" --timeZoneId="$Local" --jobId=1

Use the API command GetTimeZones to retrieve a list of all available time zones and their ids.

GetJobs

Retrieve list of jobs.

GetLicenseInformation

Retrieve license information.

Example license information object: 

{
 "productKey": "YOUR-MAIL-STORE-PRODUCT-KEY",
 "productVersion": "13.1.0.12345",
 "maxNamedUsers": 100,
 "namedUsers": 95,
 "unusedNamedUsers": 5,
 "supportExpiryDate": "2023-12-31",
 "supportLevel": "Premium Service",
 "validFrom": null,
 "validTo": null,
 "licensedTo": "MailStore Software GmbH",
 "machineName": "MAILSTORE"
}

The properties validFrom and validTo are only set when Trial or NFR product keys are used.

GetMessages

Get list of messages from a folder.

Arguments

Name Type Description
folder string (optional) Folder whose content to list.

GetProfiles

Get list of archiving and exporting profiles.

Arguments

Name Type Description
raw bool Currently only 'true' is supported.

GetRetentionPolicies

Get the retention policies.

Example retention policies object: 

[
  {
    "name": "Keep All Mails for 10 Years",
    "order": 1,
    "enabled": true,
    "searchCriteria": {
     "from": null,
     "to": null,
     "query": null,
     "queryAttachmentContents": false,
     "queryAttachments": false,
     "queryMessageBody": false,
     "querySubject": false,
     "includedArchives": null,
     "excludedArchives": [
       "admin"
       ]
     },
    "period": 10,
    "periodInterval": "year",
    "referenceDateType": "ArchiveDate",
    "delete": false
  }
]

The referenceDateType can bei either ArchiveDate or MessageDate.

GetServerInfo

Get MailStore Server version and machine name.

GetServiceConfiguration

Get MailStore Server service configuration. This includes the path to the Master Database, the location of the audit log, whether the different debug logs are enabled and the endpoint configuration.

GetSmtpSettings

Get current SMTP configuration.

GetStoreAutoCreateConfiguration

Get automatic archive store creation settings.

GetStoreIndexes

Get list of full text indexes.

Arguments

Name Type Description
id number (optional) Unique ID of archive store.

GetStores

Get list of archive stores.

Arguments

Name Type Description
includeSize bool (optional) Includes size of archive store. Default: true. May be slow when running on slow hardware.

GetTimeZones

Get the list of available time zones and their IDs.

The id of the output can be used as timeZoneId in CreateJob, GetJobResults, SetJobSchedule and SendStatusReport and as timeZoneID (with a capital ID) in GetWorkerResults.

GetUserInfo

Get detailed information about user.

Arguments

Name Type Description
userName string User name of MailStore user

GetUsers

Get list of users.

GetWorkerResults

Get results of profile executions.

Arguments

Name Type Description
fromIncluding string Beginning of time range to fetch.
toExcluding string End of time range to fetch.
timeZoneID string The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
profileID number (optional) Filter results by given profile ID.
userName string (optional) If given, must be equal to the current username. Filters results by current user.

Interactive Management Shell Example: GetWorkerResults --fromIncluding="2022-01-01T00:00:00" --toExcluding="2023-01-01T00:00:00" --timeZoneID="$Local" --profileID=1 --userName="admin"

Use the API command GetTimeZones to retrieve a list of all available time zones and their ids.

Be aware that timeZoneID has to be written with a capital ID where all other commands with a timeZoneId are expecting Id.

GetWorkerResultReport

Get the details of a profile execution result.

Arguments

Name Type Description
id number The ID of the result for which the details should be fetched.

Use the GetWorkerResults command to get the IDs of results.

InitializeMFA

Initializes multi-factor authentication of a user. During the next login with an MFA-capable client, the user has to scan a QR code with a TOTP compatible app and has to enter an MFA code to be able to login. When InitializeMFA is called when MFA is already active for a user, a new secret is generated and the user has to scan the QR code again. This also invalidates all trusted device tokens of a user.

Arguments

Name Type Description
userName string The user name of the user for whom MFA shall be initialized.

DisableMFA disables multi-factor authentication of a user.

MaintainFileSystemDatabases

Run database maintenance on all databases of file system based archive stores.

MergeStore

Merge two archive stores.

Arguments

Name Type Description
id number Unique ID of destination archive store.
sourceId number Unique ID of source archive store.

MoveFolder

Move folder.

Arguments

Name Type Description
fromFolder string Old folder name.
toFolder string New folder name.

ProcessRetentionPolicies

Processes the configured retention policies.

RebuildSelectedStoreIndexes

Rebuild all full-text indexes selected for rebuild.

RebuildStoreIndex

Rebuild search index for given archive folder.

Arguments

Name Type Description
id number Unique ID of archive store.
folder string Name of folder name.

RecoverStore

Recreates a broken Firebird database from recovery records. The archive store must have been upgraded to the latest version and the recovery records must not be corrupt. The archive store must be in the Disabled or Error state.

Arguments

Name Type Description
id number Unique ID of archive store.
encryptionKey string (optional) Encryption key of the archive store. Must be given, when the encryption key cannot be read from the key file of the archive store.
recoverDeletedMessages bool (optional) Defines whether to recover deleted messages.

When the recoverDeletedMessages parameter is set to true, only deleted messages that still have leftovers in the recovery records can be recovered. When an archive store has been compacted with CompactStore or recovery record files have grown to their auto-compacting size of 32 MiB these leftovers could already be removed and deleted messages cannot be recovered.

RecreateRecoveryRecords

Recreates broken Recovery Records of an archive store. Use VerifyStore or VerifyStores to verify the state of the Recovery Records. Cannot be used for external archive stores that store their content in the database.

Arguments

Name Type Description
id number Unique ID of archive store.

RefreshAllStoreStatistics

Refresh statistics of all archive stores.

RenameJob

Rename job.

Arguments

Name Type Description
id number (optional) The unique identifier of the job to be renamed.
name string (optional) The new job name.

RenameStore

Rename archive store

Arguments

Name Type Description
id number Unique ID of archive store.
name string New name of archive store.

RenameUser

Rename a MailStore user.

Arguments

Name Type Description
oldUserName string Old user name.
newUserName string New user name.

RenewMasterKey

Renews the master key which is used to encrypt the encryption keys.

RepairStoreDatabase

Tries to resolve certain issues with archive store databases (e.g. missing database indexes).

Arguments

Name Type Description
id number Unique ID of archive store.

RetryOpenStores

Retry opening stores that failed previously.

RunJobAsync

Run an existing job.

Arguments

Name Type Description
id number The identifier of the job to be run.

RunProfile

Run an existing archiving or exporting profile. Only profiles that are executed on server side can be started by this command. That are all profiles which are listed under E-Mail Servers in the MailStore Client. Client side profiles can be started by using the MailStoreCmd and the commands import-execute and export-execute.

Arguments

Name Type Description
id number Unique profile ID.

RunTemporaryProfile

Run a temporary/non-existent profile. Only profiles that are executed on server side can be started by this command. That are all profiles which are listed under E-Mail Servers in the MailStore Client.

Arguments

Name Type Description
properties json Profile properties.
raw bool Currently only 'true' is supported.

Argument Values

properties

To receive available profile properties create a profile of the desired type via MailStore Client and use the GetProfiles method to receive supported value.

SelectAllStoreIndexesForRebuild

Select all full-text indexes for rebuild.

SendStatusReport

Send a status report to the given recipients.

Arguments

Name Type Description
timespan string Timespan that is covered by the status report.
timeZoneId string The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
recipients string Comma separated list of recipients that will receive the status report.

Use the API command GetTimeZones to retrieve a list of all available time zones and their ids.

Argument Values

Timespan

Name Description
today The day when the status report is sent.
yesterday The day before the status report is sent.
thisweek The week when the status report is sent.
lastweek The week before the status report is sent.
thismonth The month when the status report is sent.
lastmonth The month before the status report is sent.

SetComplianceConfiguration

Set compliance configuration settings.

Arguments

Name Type Description
config json Compliance configuration.

Argument Values

config

Use GetComplianceConfiguration to receive supported values.

Example settings object: 

{
  "adminEmailPreviewEnabled": true,
  "legalHoldEnabled": false,
  "passwordPolicyEnabled": true,
  "logSuccessfulUserActivities": [
    "AdminRestored",
    "ComplianceChangeSettings",
    "FileGroupAttach",
    "FileGroupCreate",
    "FileGroupDetach",
    "FileGroupRename",
    "FileGroupSetProperties",
    "FileGroupSetRequestedState",
    "ProfileChangeUserName",
    "UserAdd",
    "UserDelete",
    "UserRename",
    "UserSetFolderAccess",
    "UserSetMappings",
    "UserUpdate"
  ]
}

SetDirectoryServicesConfiguration

Set directory services configuration settings.

Arguments

Name Type Description
config json Directory services configuration.

Argument Values

config

Use GetDirectoryServicesConfiguration to receive supported value.

SetJobEnabled

Set enabled status of a job.

Arguments

Name Type Description
id number (optional) The unique identifier of the job to be modified.
enabled bool (optional) Boolean value of enabled attribute.

SetJobSchedule

Modify the schedule of a job.

Arguments

Name Type Description
id number The unique identifier of the job to be modified.
timeZoneId string The id of the time zone the date should be converted to, e.g. $Local, which represents the time zone of the operating system.
date string (optional) Datetime string (YYYY-MM-DDThh:mm:ss) for running the job once.
interval number (optional) Interval for running job.
time string (optional) Time for running job. Without additional parameter, this means daily execution.
dayOfWeek string (optional) Day of week to run job. Parameter "time" also required.
dayOfMonth string (optional) Day of month to run job. Parameter "time" also required. dayOfWeek can optionally be used to define further.

Use the API command GetTimeZones to retrieve a list of all available time zones and their ids.

Argument Values

dayOfWeek

Name Description
Sunday Sunday
Monday Monday
Tuesday Tuesday
Wednesday Wednesday
Thursday Thursday
Friday Friday
Saturday Saturday

dayOfMonth

Name Description
1 to 31 Numeric representation of day of month.
Last Last day of month.

interval

Name Description
5 Every 5 minutes.
10 Every 10 minutes.
15 Every 15 minutes.
20 Every 20 minutes.
30 Every 30 minutes.
60 Every hour.
120 Every 2 hours.
180 Every 3 hours.
260 Every 4 hours.
360 Every 6 hours.
720 Every 12 hours.

SetProfileServerSideExecution

Disables or enables the automatic server-sided execution with its parameters.

Arguments

Name Type Description
id number The unique profile ID of the profile to be modified.
automatic bool Enables (true) or disables (false) the profile's server-side automation.
automaticPauseBetweenExecutions number (optional) Integer value (0 - 2147483647) of seconds to pause between re-executing an automatic profile.
automaticMaintenanceWindows string (optional) TimeSpan string (hh:mm-hh:mm, e.g. 22:00-04:00) for the time window where the execution should not be executed, e.g. to schedule maintenance tasks.

Use the API command GetProfiles to retrieve a list of all profiles and their current "serverSideExecution" section details.

The command can be executed with either the argument automatic=false and no additional parameters to disable the automation, or with automatic=true and at least the automaticPauseBetweenExecutions value given. The automaticMaintenanceWindows parameter is optional. Setting an already automated profile to automatic again, will restart the profile.

SetRetentionPolicies

Set retention policies.

Arguments

Name Type Description
config json Retention policy configuration.

To get example policies use the client to create retention policies manually. Then use the API command GetRetentionPolicies to retrieve the json values.
Please be aware that the API is case-sensitive. Especially the archive inclusion/exclusion criteria must not contain upper case characters, as the user archives are always handled lower-case internally. Due to a more complex distributed permission concept, retention policies can not be edited via the API for the MailStore Service Provider Edition.

SetServiceCertificate

Set the X509 certificate that is used by MailStore Server for incoming connections. The certificate must already reside in the computer's local certificate store. The thumbprint of the currently used certificate can be retrieved with GetServiceConfiguration.

Arguments

Name Type Description
thumbprint string Thumbprint of X509 certificate.

SetSmtpSettings

Set SMTP configuration.

Arguments

Name Type Description
settings json SMTP configuration.

Argument Values

settings

Example settings object: 

{
  "hostname": "mail.example.com",
  "port": 587,
  "protocol": "SMTP-TLS",
  "ignoreSslPolicyErrors": false,
  "authenticationRequired": true,
  "username": "[email protected]",
  "password": "userpassword",
  "fromDisplayName": "Sending User",
  "fromEmailAddress": "[email protected]",
  "recipientEmailAddresses": ["[email protected]", "[email protected]"]
}

SetStoreAutoCreateConfiguration

Set configuration for automatic archive store creation.

Arguments

Name Type Description
config json Archive store automatic creation configuration.

Argument Values

config

{
  "sizeThreshold" : int or null,
  "databaseBaseDirectory" : string,
  "contentBaseDirectory" : string,
  "indexBaseDirectory" : string
}

SetStoreProperties

Set properties of archive store.

Arguments

Name Type Description
id number Set properties of archive store.
type string (optional)
databaseName string (optional) Name of database on Microsoft SQL Server or PostgreSQL server.
databasePath string (optional) Path to directory in which database folder information and email meta data are stored.
contentPath string (optional) Path to directory in which email headers and contents are stored.
indexPath string (optional) Path to directory in which full text search indexes are stored.
serverName string (optional) Name of Microsoft SQL Server or PostgreSQL server.
userName string (optional) User name for accessing Microsoft SQL Server or PostgreSQL server.
password string (optional) Password for accessing Microsoft SQL Server or PostgreSQL server.

Argument Values

type

Name Description
FileSystemInternal Advanced file system-based archive store.
SQLServer Microsoft SQL Server-based archive store.
PostgreSQL PostgreSQL server-based archive store.

SetStoreRequestedState

Set state of archive store.

Arguments

Name Type Description
id number Unique ID of archive store.
requestedState string (optional) State of archive store after attaching.

Argument Values

requestedState

Name Description
current Same as Normal but new messages will be archived in the archive store that is set to Current.
normal The content of archives store is available to users and can be modified if the user has the appropriate permission.
writeProtected The content of write protected archive stores is available to users, but cannot be modified (e.g. delete or move messages, rename or move folders)
disabled Disabled archive stores are not in use but the instance still knows about their existence. Therefore the content is not available to users.

SetUserAuthentication

Set authentication settings of a MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
authentication string Authentication method. Either 'integrated' or 'directoryServices'.

SetUserDistinguishedName

Set the LDAP distinguished name of a MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
distinguishedName string (optional) LDAP DN string.

SetUserEmailAddresses

Set email addresses of MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
emailAddresses string (optional) List of email addresses.

SetUserFullName

Set full name of MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
fullName string (optional) Full name of MailStore user.

SetUserLoginPrivileges

Set login privileges of a MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
loginPrivileges string Comma separated list of login privileges.

Argument Values

loginPrivileges

Name Description
none The user is granted no login privileges. If specified, this value has to be the only value in the list.
windows The user is allowed to use the Windows Client.
web The user is allowed to use the Web Access.
outlook The user is allowed to use the Outlook Add-in.
windowsCmd The user is allowed to use scheduled tasks and the command line client of MailStore Client.
imap The user is allowed to access the archive using IMAP.
api The user is allowed to use the Management API. This option is only available for administrators. This option is unavailable in the SPE.

SetUserPassword

Set password of MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
password string Password of MailStore user.

SetUserPop3UserNames

Set POP3 user name of MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
pop3UserNames string (optional) Comma separated list of POP3 user names.

SetUserPrivileges

Set privileges of MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
privileges string Comma separated list of privileges.

Argument Values

privileges

Name Description
none The user is granted no global privileges. If specified, this value has to be the only value in the list.
admin The user is granted administrator privileges. If specified, this value has to be the only value in the list.
login The user can log on to MailStore Server.
changePassword The user can change his own MailStore Server password. This only makes sense if the authentication is set to integrated.
archive The user can run archiving profiles.
modifyArchiveProfiles The user can create, modify and delete archiving profiles.
export The user can run export profiles.
modifyExportProfiles The user can create, modify and delete export profiles.
delete The user can delete messages. Please note that a non-admin user can only delete messages in folders where he has been granted delete access. In addition, compliance settings may be in effect, keeping administrators and users from deleting messages even if they have been granted the privilege to do so.

SetUserPrivilegesOnFolder

Set privileges on folder for MailStore user.

Arguments

Name Type Description
userName string User name of MailStore user.
folder string Folder name.
privileges string Comma separated list of folder privileges.

Argument Values

privileges

Name Description
none The user is denied access to the specified folder. If specified, this value has to be the only value in the list. This effectively removes all privileges on the specified folder.
read The user is granted read access to the specified folder.
write The user is granted write access to the specified folder. Messages can be moved within an archive.
delete The user is granted delete access to the specified folder.

SyncUsersWithDirectoryServices

Sync users of MailStore instance with directory services.

Arguments

Name Type Description
dryRun bool (optional) Simulate sync only.

TestSmtpSettings

Test current SMTP configuration.

UnlockStore

Unlock a foreign archive store. In case an archive store from a foreign MailStore installation is attached, this method can be used to unlock that archive store.

Arguments

Name Type Description
id number Unique ID of archive store to unlock.
passphrase string Product key or recovery key of the foreign MailStore installation.

UpgradeStore

Upgrade an archive store from an older version to the current format.

Arguments

Name Type Description
id number Unique ID of archive store.

UpgradeStores

Upgrade all archive stores from an older version to the current format.

VerifyStore

Verify archive stores consistency.

Arguments

Name Type Description
id number The unique identifier of the archive store to be verified.
includeIndexes bool Defines whether to verify the search indexes as well. Default: true. May be slow when running on slow hardware.

VerifyStores

Verify consistency of all archive stores.

Arguments

Name Type Description
includeIndexes bool Defines whether to verify the search indexes as well. Default: true. May be slow when running on slow hardware.
Retrieved from "https://help.mailstore.com/en/server/index.php?title=Administration_API_-_Function_Reference&oldid=7622"