synchronizesecurity-element-xmla.md

title	description	ms.date	ms.service	ms.custom	ms.topic	ms.author	ms.reviewer	author
SynchronizeSecurity Element (XMLA) | Microsoft Docs	Learn how the SynchronizeSecurity element specifies how to synchronize security definitions, such as roles and permissions, during a Synchronize command.	01/05/2020	analysis-services	xmla	reference	kfollis	kfollis	kfollis

SynchronizeSecurity Element (XMLA)

Specifies how to synchronize security definitions, such as roles and permissions, during a Synchronize command.

Syntax

  
<Synchronize>  
   ...  
   <SynchronizeSecurity>...</SynchronizeSecurity>  
   ...  
</Synchronize>  

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	Synchronize
Child elements	None

Remarks

The Security element determines whether the security definitions, such as roles and permissions, defined on an Analysis Services database are synchronized during a Synchronize 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 Synchronize 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 a Synchronize command.
CopyAll	Include security definitions and membership information during a Synchronize command.
IgnoreSecurity	Exclude security definitions during a Synchronize command.