Skip to content

Commit 851aaef

Browse files
KoenZomersVesaJuvonen
authored andcommitted
Added documentation on PnP PowerShell (SharePoint#4019)
* Added documentation on PnP PowerShell Added documentation on how to use PnP PowerShell to achieve the same. Also added a screenshot of what you can expect to see if you remove a site collection scoped App Catalog again. * Adding screenshot on adding a solution to a disabled app catalog
1 parent 2e315bb commit 851aaef

File tree

2 files changed

+17
-3
lines changed

2 files changed

+17
-3
lines changed

docs/general-development/site-collection-app-catalog.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ You can configure and manage site collection app catalogs using the SharePoint O
4747
> [!NOTE]
4848
> Before you can manage site collection app catalogs in your tenant, ensure that you have installed [SharePoint Online Management Shell](https://www.microsoft.com/en-us/download/details.aspx?id=35588) from November 2017 or newer.
4949
50-
Alternatively, you can use the [Office 365 CLI](https://sharepoint.github.io/office365-cli?utm_source=msft_docs&utm_medium=page&utm_campaign=Use+the+site+collection+app+catalog) to manage your SharePoint site collection app catalogs. The Office 365 CLI is a cross-platform command line interface that can be used on any platform, including Windows, MacOS and Linux.
50+
Alternatively, you can use the [Office 365 CLI](https://sharepoint.github.io/office365-cli?utm_source=msft_docs&utm_medium=page&utm_campaign=Use+the+site+collection+app+catalog) to manage your SharePoint site collection app catalogs. The Office 365 CLI is a cross-platform command line interface that can be used on any platform, including Windows, MacOS and Linux. Using [PnP PowerShell](https://docs.microsoft.com/en-us/powershell/sharepoint/sharepoint-pnp/sharepoint-pnp-cmdlets?view=sharepoint-ps) to [create the app catalog](https://docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/add-pnpsitecollectionappcatalog?view=sharepoint-ps) or [remove the app catalog](https://docs.microsoft.com/en-us/powershell/module/sharepoint-pnp/remove-pnpsitecollectionappcatalog?view=sharepoint-ps) is also an option when using Windows.
5151

5252
### Create a site collection app catalog
5353

@@ -62,7 +62,7 @@ Alternatively, you can use the [Office 365 CLI](https://sharepoint.github.io/off
6262
> "
6363
> ```
6464
>
65-
> Alternatively, if you are using the Office 365 CLI, you must first connect to your tenant using the `spo connect` command.
65+
> Alternatively, if you are using the Office 365 CLI, you must first connect to your tenant using the `spo connect` command. With PnP PowerShell you would use `Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin` to set up the connection.
6666
6767
To create a site collection app catalog, use the `Add-SPOSiteCollectionAppCatalog` cmdlet passing the site collection where the app catalog should be created as the `-Site` parameter.
6868
@@ -75,7 +75,13 @@ $site = Get-SPOSite https://contoso.sharepoint.com/sites/marketing
7575
Add-SPOSiteCollectionAppCatalog -Site $site
7676
```
7777
78-
Alternatively, use the `spo site appcatalog add` command if you are using the Office 365 CLI
78+
Alternaively, use PnP PowerShell to add the site app catalog functionality to your site after having connected to the SharePoint Online Admin site:
79+
80+
```powershell
81+
Add-PnPSiteCollectionAppCatalog -site https://<tenant>.sharepoint.com/sites/<sitename>
82+
```
83+
84+
Alternatively, use the `spo site appcatalog add` command if you are using the Office 365 CLI:
7985

8086
```shell
8187
spo site appcatalog add --url https://contoso.sharepoint.com/sites/marketing
@@ -102,6 +108,12 @@ $site = Get-SPOSite https://contoso.sharepoint.com/sites/marketing
102108
Remove-SPOSiteCollectionAppCatalog -Site $site
103109
```
104110

111+
Alternaively, use PnP PowerShell to remove the site app catalog functionality to your site after having connected to the SharePoint Online Admin site:
112+
113+
```powershell
114+
Remove-PnPSiteCollectionAppCatalog -site https://<tenant>.sharepoint.com/sites/<sitename>
115+
```
116+
105117
Alternatively, use the `spo site appcatalog remove` command if you are using the Office 365 CLI
106118

107119
```shell
@@ -110,6 +122,8 @@ spo site appcatalog remove --url https://contoso.sharepoint.com/sites/marketing
110122

111123
After executing this script, the **Apps for SharePoint** library will be still visible in your site collection, but you will not be able to deploy or use any solutions deployed in it.
112124

125+
![Screenshot illustrating how the app catalog will disallow adding new apps after it has been removed](../images/site-collection-app-catalog-disabled.png)
126+
113127
## Considerations
114128

115129
### Governance
Loading

0 commit comments

Comments
 (0)