Search Results for

    Show / Hide Table of Contents

    Interface IApp

    Represents a base interface for an app stored either in tenant or site collection app catalog.

    Inherited Members
    IDataModelWithContext.PnPContext
    Namespace: PnP.Core.Admin.Model.SharePoint
    Assembly: PnP.Core.Admin.dll
    Syntax
    public interface IApp : IDataModelWithContext

    Properties

    AadAppId

    Azure Active Directory Id of the SharePoint Online Client Extensibility Web Application Principal. It's not empty if your SPFx solution requests any AAD permissions.

    Declaration
    string AadAppId { get; set; }
    Property Value
    System.String

    AadPermissions

    The list of Azure Active Directory permissions your SPFx solution requests.

    Declaration
    string AadPermissions { get; set; }
    Property Value
    System.String

    AppCatalogVersion

    Returns version of the app in the app catalog.

    Declaration
    Version AppCatalogVersion { get; set; }
    Property Value
    Version

    CanUpgrade

    Returns whether an existing instance of the app can be upgraded. True if there's newer version available in the app catalog compared to the instance in the site.

    Declaration
    bool CanUpgrade { get; set; }
    Property Value
    System.Boolean

    CDNLocation

    Returns the url of CDN if your app is hosted on CDN. If it's hosted inside SharePoint, it returns "SharePoint Online".

    Declaration
    string CDNLocation { get; set; }
    Property Value
    System.String

    ContainsTenantWideExtension

    Indicates whether your app contains tenant wide extensions.

    Declaration
    bool ContainsTenantWideExtension { get; set; }
    Property Value
    System.Boolean

    CurrentVersionDeployed

    Indicates whether the current version of the app is deployed.

    Declaration
    bool CurrentVersionDeployed { get; set; }
    Property Value
    System.Boolean

    Deployed

    Indicates whether the app has been deployed to the context site. True if particular app has been installed to the site.

    Declaration
    bool Deployed { get; set; }
    Property Value
    System.Boolean

    ErrorMessage

    Contains an error message if the app contains any problems during deployment.

    Declaration
    string ErrorMessage { get; set; }
    Property Value
    System.String

    Id

    Unique ID of the library list item of the app.

    Declaration
    Guid Id { get; set; }
    Property Value
    Guid

    InstalledVersion

    Returns a version of the installed app in the site context.

    Declaration
    Version InstalledVersion { get; set; }
    Property Value
    Version

    IsClientSideSolution

    Indicates whether the app is SharePoint Framework client-side solution.

    Declaration
    bool IsClientSideSolution { get; set; }
    Property Value
    System.Boolean

    IsEnabled

    Whether the app is enabled.

    Declaration
    bool IsEnabled { get; set; }
    Property Value
    System.Boolean

    IsPackageDefaultSkipFeatureDeployment

    Returns true, if the app's config (./config/package-solution.json) contains "skipFeatureDeployment" setting and it's set to true.

    Declaration
    bool IsPackageDefaultSkipFeatureDeployment { get; set; }
    Property Value
    System.Boolean

    IsValidAppPackage

    Indicates whether the app package is valid.

    Declaration
    bool IsValidAppPackage { get; set; }
    Property Value
    System.Boolean

    ProductId

    The app's product id.

    Declaration
    Guid ProductId { get; set; }
    Property Value
    Guid

    ShortDescription

    The short description of the app.

    Declaration
    string ShortDescription { get; set; }
    Property Value
    System.String

    SkipDeploymentFeature

    Returns true, if the app was globally deployed.

    Declaration
    bool SkipDeploymentFeature { get; set; }
    Property Value
    System.Boolean

    ThumbnailUrl

    The thumbnail url of the app.

    Declaration
    string ThumbnailUrl { get; set; }
    Property Value
    System.String

    Title

    Title of the app.

    Declaration
    string Title { get; set; }
    Property Value
    System.String

    Methods

    ApprovePermissionRequests()

    Approves All PermissionRequests

    Declaration
    IPermissionGrant2[] ApprovePermissionRequests()
    Returns
    IPermissionGrant2[]

    true if all permissions have been approved successfully.

    ApprovePermissionRequestsAsync()

    Approves All PermissionRequests

    Declaration
    Task<IPermissionGrant2[]> ApprovePermissionRequestsAsync()
    Returns
    Task<IPermissionGrant2[]>

    Deploy(Boolean)

    Deploys / trusts an app in the app catalog.

    Declaration
    bool Deploy(bool skipFeatureDeployment = true)
    Parameters
    System.Boolean skipFeatureDeployment

    If set to true will skip the feature deployment for tenant scoped apps.

    Returns
    System.Boolean

    true if deployment was successful.

    DeployAsync(Boolean)

    Deploys / trusts an app in the app catalog.

    Declaration
    Task<bool> DeployAsync(bool skipFeatureDeployment = true)
    Parameters
    System.Boolean skipFeatureDeployment

    If set to true will skip the feature deployment for tenant scoped apps.

    Returns
    Task<System.Boolean>

    true if deployment was successful.

    Install()

    Installs the app from the app catalog in a site.

    Declaration
    bool Install()
    Returns
    System.Boolean

    true if installation was successful.

    InstallAsync()

    Installs the app from the app catalog in a site.

    Declaration
    Task<bool> InstallAsync()
    Returns
    Task<System.Boolean>

    true if installation was successful.

    Remove()

    Removes the app from the app catalog.

    Declaration
    bool Remove()
    Returns
    System.Boolean

    true if remove was successful.

    RemoveAsync()

    Removes the app from the app catalog.

    Declaration
    Task<bool> RemoveAsync()
    Returns
    Task<System.Boolean>

    true if remove was successful.

    Retract()

    Retracts the app in the app catalog. Notice that this will not remove the app from the app catalog.

    Declaration
    bool Retract()
    Returns
    System.Boolean

    true if retract was successful.

    RetractAsync()

    Retracts the app in the app catalog. Notice that this will not remove the app from the app catalog.

    Declaration
    Task<bool> RetractAsync()
    Returns
    Task<System.Boolean>

    true if retract was successful.

    Uninstall()

    Uninstalls the app from a site.

    Declaration
    bool Uninstall()
    Returns
    System.Boolean

    true if uninstall was successful.

    UninstallAsync()

    Uninstalls the app from a site.

    Declaration
    Task<bool> UninstallAsync()
    Returns
    Task<System.Boolean>

    true if uninstall was successful.

    Upgrade()

    Upgrades the app in a site.

    Declaration
    bool Upgrade()
    Returns
    System.Boolean

    true if upgrade was successful.

    UpgradeAsync()

    Upgrades the app in a site.

    Declaration
    Task<bool> UpgradeAsync()
    Returns
    Task<System.Boolean>

    true if upgrade was successful.

    Back to top PnP Core SDK
    Generated by DocFX with Material UI
    spacer