SPAppPrincipalPermissionsManager.AddSiteSubscriptionPermission method (SPAppPrincipal, Guid, SPAppPrincipalPermissionKind)
Grants the app principal access to a site subscription-scoped (also called tenant-scoped) permission for a specified workload and specified permission provider.
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
Public Sub AddSiteSubscriptionPermission ( _
appPrincipal As SPAppPrincipal, _
providerTypeId As Guid, _
permission As SPAppPrincipalPermissionKind _
)
'Usage
Dim instance As SPAppPrincipalPermissionsManager
Dim appPrincipal As SPAppPrincipal
Dim providerTypeId As Guid
Dim permission As SPAppPrincipalPermissionKind
instance.AddSiteSubscriptionPermission(appPrincipal, _
providerTypeId, permission)
public void AddSiteSubscriptionPermission(
SPAppPrincipal appPrincipal,
Guid providerTypeId,
SPAppPrincipalPermissionKind permission
)
Parameters
appPrincipal
Type: Microsoft.SharePoint.SPAppPrincipalThe app principal to be granted access.
providerTypeId
Type: System.GuidThe GUID of the permission provider from the table below.
permission
Type: Microsoft.SharePoint.SPAppPrincipalPermissionKindThe permission to be granted. See table below for options.
Remarks
Note
For Project Server permission management, use the other overload of this method: AddSiteSubscriptionPermission(SPAppPrincipal, Guid, []).
Workload |
Scope URI |
Permission Provider's GUID |
Available Permissions from SPAppPrincipalPermissionKind enum |
Remarks |
---|---|---|---|---|
BCS |
https://sharepoint/bcs/connection |
387db76f-037d-489b-b8f7-905ccf8adb9c |
Read |
|
Search |
https://sharepoint/search |
E35199BF-3211-4334-A279-A8752D370E55 |
QueryAsUserIgnoreAppPrincipal |
In SharePoint 2016 and later, your code must also call AddSiteSubscriptionQueryAsUserPermission. |
Social |
https://sharepoint/social/tenant |
fcaec196-a98c-4f8f-b60f-e1a82272a6d2 |
Read, Write, Manage, FullControl |
|
Social |
https://sharepoint/social/core |
N/A |
Read, Write, Manage, FullControl |
Do not use AddSiteSubscriptionPermission(SPAppPrincipal, Guid, SPAppPrincipalPermissionKind). Instead, call AddAppPrincipalToList(SPAppPrincipal, SPList, SPAppPrincipalPermissionKind) and specify the Social list for the site. |
Social |
https://sharepoint/social/microfeed |
N/A |
Read, Write, Manage, FullControl |
Do not use AddSiteSubscriptionPermission(SPAppPrincipal, Guid, SPAppPrincipalPermissionKind). Instead, call AddAppPrincipalToList(SPAppPrincipal, SPList, SPAppPrincipalPermissionKind) and specify the Feed list for the site. |
Social |
https://sharepoint/social/trimming |
17a6290f-30a3-49fd-8b2b-5f4da225c424 |
Read, Write, Manage, FullControl |
|
Taxonomy |
https://sharepoint/taxonomy |
0D4A59A6-7CBC-4be5-8241-4D40FD280158 |
Read, Write |
See also
Reference
SPAppPrincipalPermissionsManager class
SPAppPrincipalPermissionsManager members