Compartilhar via

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 inquilinos pudessem delegar o acesso a outras pessoas na organização, um pacote implementado era visível em todas as coleções 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 dos catálogos de aplicações da coleção de sites, os administradores inquilinos podem ativar o catálogo de aplicações 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:

Diagrama ilustrando o conceito de catálogo de aplicativos do conjunto de sites

No seu inquilino Office 365, tem um catálogo de aplicações de inquilino. As soluções implementadas neste catálogo de aplicações podem ser instaladas em qualquer coleção de sites no inquilino. 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 aplicações da coleção de sites, tal como nos catálogos de aplicações de inquilinos, pode implementar suplementos do SharePoint e soluções de Estrutura do SharePoint (.sppkg).

Incluindo ativos em pacotes de solução

Estrutura do SharePoint pacotes de soluções que contêm recursos podem ser implementados em catálogos de aplicações de coleção 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. Outras coleções de sites na sua organização não poderão utilizar a solução. Se não marcar esta opção, terá de instalar explicitamente a solução no seu site antes de poder utilizá-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.

Observação

Antes de gerenciar catálogos de aplicativos do conjunto de sites no locatário, verifique se você instalou o Shell de Gerenciamento do SharePoint Online de novembro de 2017 ou mais recente.

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 do Microsoft 365 é uma interface de linha de comandos para várias plataformas que pode ser utilizada 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.

Observação

O PnP PowerShell é uma solução de software livre com uma comunidade ativa de suporte. Não há nenhuma SLA para o suporte da ferramenta de software livre por parte da Microsoft.

Observação

A CLI do Microsoft 365 é uma solução de software livre com uma comunidade ativa oferecendo suporte. Não há nenhuma SLA para o suporte da ferramenta de software livre por parte da Microsoft.

Criar um catálogo de aplicativos do conjunto de sites

Observação

Antes de executar o script a seguir, conecte-se ao seu locatário do SharePoint Online usando o cmdlet Connect-SPOService no PowerShell do SharePoint Online. Além disso, certifique-se de que tem um catálogo de aplicações de inquilino criado no seu inquilino (os clientes multigeográficos terão de criar um catálogo de aplicações de inquilino para cada área geográfica que pretendam utilizar um catálogo de aplicações de coleção de sites). Se não tiver, o cmdlet falhará e exibirá o seguinte erro:

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()
"

Como alternativa, se estiver usando a CLI para Microsoft 365, você deverá se conectar primeiro ao seu locatário do Microsoft 365 usando o comando m365 login. Com o PnP PowerShell, utilizaria Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -Interactive -ClientId <your-client-id> (com uma aplicação de Azure AD (Entra ID) registada) para configurar a ligação.

Cuidado

A conta utilizada para criar a Coleção de Sites do Catálogo de Aplicações tem de ser um Administrador de Coleções de Sites no Catálogo de Aplicações ao nível do inquilino e na Coleção de Sites de destino

Para criar um catálogo de aplicações de coleção de sites, utilize o Add-SPOSiteCollectionAppCatalog cmdlet ao transmitir a coleção de sites onde o catálogo de aplicações 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 este script, a biblioteca Aplicações para SharePoint será adicionada à sua coleção de sites, onde poderá implementar suplementos do SharePoint e Estrutura do SharePoint soluções.

Desabilitar o catálogo de aplicativos do conjunto de sites

Observação

Antes de executar o seguinte script, ligue-se ao seu inquilino do SharePoint Online com o Connect-SPOService cmdlet do PowerShell do SharePoint Online para Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -Interactive -ClientId <your-client-id> o PnP PowerShell (utilizando uma aplicação Azure AD (Entra ID) registada) ou o comando de início de sessão m365 para a CLI do Microsoft 365 ligar ao seu inquilino do Microsoft 365.

Para desativar o catálogo de aplicações da coleção de sites na sua coleção de sites, utilize o Remove-SPOSiteCollectionAppCatalog cmdle, não transmitindo a coleção de sites onde o catálogo de aplicações deve ser desativado como o -Site parâmetro . Como alternativa, se você tiver a ID do conjunto de sites, poderá usar o cmdlet Remove-SPOSiteCollectionAppCatalogById.

Observação

Apesar de nomenclatura, os cmdlets Remove-SPOSiteCollectionAppCatalog e Remove-SPOSiteCollectionAppCatalogById não removem o catálogo de aplicativos do conjunto de sites. Em vez disso, eles o desabilitam para que não seja possível implantar ou usar soluções implantadas nele.

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 este script, a biblioteca aplicações para SharePoint continuará visível na sua coleção de sites, mas não poderá implementar ou utilizar quaisquer soluções implementadas na mesma.

Captura de tela ilustrando como o catálogo de aplicativos impedirá a adição de novos aplicativos após a remoção

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 aplicações de coleções de sites só possam ser utilizadas nestas coleções de sites específicas, podem potencialmente aceder a recursos de outros sites no inquilino, pelo que os administradores devem garantir que as soluções que estão prestes a implementar funcionam conforme pretendido.

Confira também