Location Element (XMLA)

Contains information about a remote server for the parent Backup, Restore, or Synchronize command.

Syntax

  
<Backup> <!-- or one of the elements listed below in the Element relationships table -->  
   ...  
   <Location>  
  
<File>...</File> <!-- for Backup and Restore only -->  
<DataSourceID>...</DataSourceID>  
<DataSourceType>...</DataSourceType> <!-- for Restore and Synchronize only -->  
<ConnectionString>...</ConnectionString> <!-- for Restore and Synchronize only -->  
<Folders>...</Folders> <!-- for Restore and Synchronize only -->  
  
   </Location>  
   ...  
</Backup>  

Element characteristics

Characteristic Description
Data type and length None
Default value None
Cardinality 0-n: Optional element that can occur more than once.

Element relationships

Relationship Element
Parent elements Backup, Restore, Synchronize
Child elements See the table below.
Ancestor or Parent Child Element
Backup DataSourceID, File
Restore ConnectionString, DataSourceID, DataSourceType, File, Folders
Synchronize ConnectionString, DataSourceID, DataSourceType, Folders

Remarks

For Backup commands, the Location element provides information about creating a remote backup file for a remote instance of Analysis Services.

For Restore commands, the Location element provides information about identifying and connecting to a remote Analysis Services instance, as well as the remote backup file used to restore remote partitions on that remote instance.

For Synchronize commands, the Location element describes either a data source to be used by the target instance or a remote instance defined on the source instance that must be synchronized with the target instance, depending on the value of the DataSourceType element for the parent Synchronize command.