Usar o catálogo de aplicativos do conjunto de sites

Aplica-se a: Office 365

Usando catálogos de aplicativos do conjunto de sites, os administradores de locatários do SharePoint podem descentralizar o gerenciamento e definir o escopo da implantação de suplementos do SharePoint e de soluções da Estrutura do SharePoint para sites específicos.

Por que catálogos de aplicativos do conjunto de sites

Anteriormente, todos os suplementos e as soluções da Estrutura do SharePoint tinham que sejam gerenciados centralmente no catálogo de aplicativos de locatários. Embora os administradores de locatários pudessem delegar acesso a outras pessoas na organização, um pacote implantado estava visível em todos os conjuntos de sites. O SharePoint não oferecia um modo compatível de implantar suplementos e soluções da Estrutura do SharePoint apenas para sites específicos.

Com a introdução de catálogos de aplicativos de conjuntos de sites, os administradores de locatários podem habilitar o catálogo de aplicativos em sites específicos. Quando habilitado, os administradores de conjunto de sites podem implantar Suplementos do SharePoint e soluções da Estrutura do SharePoint que estarão disponíveis somente nesse conjunto de sites específico.

O esquema a seguir ilustra o uso de catálogos de aplicativos do conjunto de sites:

Em seu locatário do Office 365, você tem um catálogo de aplicativos de locatário. As soluções implantadas neste catálogo de aplicativos podem ser instaladas em qualquer conjunto de sites no locatário. Os administradores de locatários podem optar por habilitar catálogos de aplicativos em conjuntos de sites específicos. As soluções implantadas nos catálogos de aplicativos do conjunto de sites podem ser instaladas apenas nesse conjunto de sites específico.

Recursos compatíveis

Suporte para suplementos do SharePoint e pacotes da Estrutura do SharePoint

Nos catálogos de aplicativos do conjunto de sites, assim como nos catálogos de aplicativos de locatário, você pode implantar suplementos do SharePoint e soluções da Estrutura do SharePoint (.sppkg).

Incluindo ativos em pacotes de solução

Os pacotes de solução da Estrutura do SharePoint que contêm ativos podem ser implantados em catálogos de aplicativos de conjuntos de sites. Os ativos incluídos serão implantados em uma biblioteca de documentos pré-configurada no mesmo conjunto de sites onde se encontra o catálogo de aplicativos do conjunto de sites. Se a CDN pública do Office 365 estiver configurada, os ativos serão disponibilizados pela CDN. Caso contrário, os ativos serão disponibilizados diretamente pela biblioteca de documentos.

Implantação definida pelo locatário

Ao implantar soluções da Estrutura do SharePoint que oferecem suporte a implantação em locatários em um catálogo de aplicativos do conjunto de sites, você deverá responder se deseja disponibilizar essa solução para todos os sites da organização. Apesar do texto, se você marcar essa caixa, a solução ficará disponível imediatamente somente no mesmo conjunto de sites onde está o catálogo de aplicativos. Outros conjuntos de sites em sua organização não poderão usar a solução. Se você não marcar esta opção, terá que instalar explicitamente a solução em seu site antes de poder usá-la.

Limitações atuais

Configurar e gerenciar catálogos de aplicativos do conjunto de sites

Você pode configurar e gerenciar catálogos de aplicativo de conjunto de sites usando o Shell de Gerenciamento do SharePoint Online.

Como alternativa, use a CLI para Microsoft 365 para gerenciar os catálogos de aplicativos do conjunto de sites do Microsoft Office SharePoint Online. A CLI para Microsoft 365 é uma interface de linha de comando multiplataforma que pode ser usada em qualquer plataforma, incluindo Windows, macOS e Linux. Usar o PowerShell PnP para criar o catálogo de aplicativos ou remover o catálogo de aplicativos também é uma opção ao usar o Windows.

Criar um catálogo de aplicativos do conjunto de sites

Cannot invoke method or retrieve property from null object. Object returned by the
following call stack is null. "TenantAppCatalog
RootWeb
GetSiteByUrl
new Microsoft.Online.SharePoint.TenantAdministration.Tenant()
"

Para criar um catálogo de aplicativos de conjunto de sites, use o Add-SPOSiteCollectionAppCatalog cmdlet, passando o conjunto de sites em que o catálogo de aplicativos deve ser criado como o -Site parâmetro.

Add-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing

Como alternativa, use o PowerShell PnP para adicionar a funcionalidade de catálogo de aplicativos do site ao seu site depois de ter se conectado ao site de administração do SharePoint Online:

Add-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing

Como alternativa, use o comando spo site appcatalog add se estiver usando a CLI para Microsoft 365:

m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/marketing

Depois de executar esse script, a biblioteca Aplicativos para SharePoint será adicionada ao seu conjunto de sites, onde você poderá implantar suplementos do SharePoint e soluções de Estrutura do SharePoint.

Desabilitar o catálogo de aplicativos do conjunto de sites

Para desabilitar o catálogo de aplicativos do conjunto de sites em seu conjunto de sites, use o Remove-SPOSiteCollectionAppCatalog cmdle,t passando o conjunto de sites em que o catálogo de aplicativos deve ser desabilitado como o -Site parâmetro. Como alternativa, se você tiver a ID do conjunto de sites, poderá usar o cmdlet Remove-SPOSiteCollectionAppCatalogById.

Remove-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing

Como alternativa, use o PowerShell PnP para remover a funcionalidade catálogo de aplicativos do site do seu site depois de ter se conectado ao site de administração do SharePoint Online:

Remove-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing

Como alternativa, use o comando spo site appcatalog remove se estiver usando a CLI do Microsoft 365

m365 spo site appcatalog remove --url https://contoso.sharepoint.com/sites/marketing

Depois de executar esse script, a biblioteca do Apps for SharePoint ainda estará visível em seu conjunto de sites, mas você não poderá implantar ou usar nenhuma solução implantada nele.

Considerações

Gestão

Para listar todos os conjuntos de sites no locatário que tenha o catálogo de aplicativos do conjunto de sites habilitado, use a URLhttps://<tenant-app-catalog-URL>/Lists/SiteCollectionAppCatalogs/AllItems.aspx.

Segurança

Antes de implantar soluções nos catálogos de aplicativos do conjunto de sites, os administradores de conjunto de sites devem verificar se essas soluções cumprem os requisitos organizacionais. Embora as soluções instaladas em catálogos de aplicativos de conjuntos de sites só possam ser usadas nesses conjuntos de sites específicos, elas podem acessar recursos de outros sites no locatário, portanto, os administradores devem garantir que as soluções que estão prestes a implantar funcionem conforme o esperado.

Confira também

• Gerenciar o catálogo de aplicativos organizacionais
• CLI para Microsoft 365