Security Element (XMLA)

Specifies how to back up or restore security definitions, such as roles and permissions, during a Backup or Restore command.

Syntax

  
<Backup> <!-- or Restore -->  
   ...  
   <Security>...</Security>  
   ...  
</Backup>  

Element characteristics

Characteristic Description
Data type and length String (enumeration)
Default value SkipMembership
Cardinality 0-1: Optional element that can occur once and only once.

Element relationships

Relationship Element
Parent elements Backup, Restore
Child elements None

Remarks

The Security element determines whether the security definitions, such as roles and permissions, defined on a Analysis Services database are backed up or restored during, respectively, a Backup or Restore command. This element also determines if the Windows user accounts and groups defined as members of the security definitions are included as part of the Backup or Restore command.

The value of this element is limited to one of the strings listed in the following table.

Value Description
SkipMembership Include security definitions, but exclude membership information, during Backup or Restore commands.
CopyAll Include security definitions and membership information during Backup or Restore commands.
IgnoreSecurity Exclude security definitions during Backup or Restore commands.