Share via


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

  • providerTypeId
    Type: System.Guid

    The GUID of the permission provider from the table below.

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

AddSiteSubscriptionPermission overload

Microsoft.SharePoint namespace