| title | description | ms.date | ms.service | ms.custom | ms.topic | ms.author | ms.reviewer | author | monikerRange |
|---|---|---|---|---|---|---|---|---|---|
AMO Security Classes | Microsoft Docs |
Learn about the relationships between the Analysis Management Objects (AMO) security classes that are explained in this article. |
10/31/2023 |
analysis-services |
amo |
conceptual |
kfollis |
kfollis |
kfollis |
asallproducts-allversions || sql-analysis-services-2016 || sql-analysis-services-2017 || sql-analysis-services-2019 || sql-analysis-services-2022 |
[!INCLUDEappliesto-sqlas-aas]
The following illustration shows the relationship of the classes that are explained in this topic:
A xref:Microsoft.AnalysisServices.Role object is created by adding it to the roles collection of the database, and updating the xref:Microsoft.AnalysisServices.Role object to the server by using the Update method. A xref:Microsoft.AnalysisServices.Role object has to be updated before it can be used.
To remove a xref:Microsoft.AnalysisServices.Role object, it has to be dropped by using the Drop method of the xref:Microsoft.AnalysisServices.Role object. The Remove method, from the roles collection, only prevents you from seeing the role in your application, but it does not remove the role from the server. A xref:Microsoft.AnalysisServices.Role object cannot be dropped if there are any permissions associated with it.
A xref:Microsoft.AnalysisServices.RoleMember object is created by adding a user to the members collection of the role and updating the xref:Microsoft.AnalysisServices.Role object to the server by using the Update method. Only Server Administrators or Database Administrators are permitted to create roles. A xref:Microsoft.AnalysisServices.Role object has to be updated to the server before any of its members is allowed to use any the objects to which the user has been granted permission.
To remove a xref:Microsoft.AnalysisServices.RoleMember object, it has to be removed from the collection by using the Remove method of the collection, and then updating the role by using the Update method.
For more information about methods and properties available for these objects, see xref:Microsoft.AnalysisServices.Role and xref:Microsoft.AnalysisServices.RoleMember in the xref:Microsoft.AnalysisServices.
A xref:Microsoft.AnalysisServices.Permission object is created by adding it to the permissions collection of the object and updating the xref:Microsoft.AnalysisServices.Permission object to the server by using the Update method.
To remove a xref:Microsoft.AnalysisServices.Permission object, it has to be dropped by using the Drop method of the object. The remove method, from the permissions collection, only prevents you from seeing the permission in your application, but it does not remove the xref:Microsoft.AnalysisServices.Permission object from the server. A role cannot be deleted if there is any permission associated with it.
For more information about methods and properties available, see xref:Microsoft.AnalysisServices.Permission in xref:Microsoft.AnalysisServices.