Instalar uma aplicação Do SharePoint Embedded

Aplica-se a: Consumir administrador de inquilinos — Administrador do SharePoint Embedded/Administrador global

Instale uma aplicação Do SharePoint Embedded quando um inquilino do Microsoft 365 que está a consumir tem de utilizar a aplicação.

A instalação torna a aplicação visível para a administração do inquilino, mas o inquilino ainda pode precisar do consentimento do administrador, do registo de permissões do tipo de contentor e da configuração de faturação antes de os utilizadores poderem aceder ao conteúdo.

Este artigo centra-se no caminho de administrador de inquilinos de consumo no centro de administração do SharePoint.

Utilize este artigo com Escolher um Modelo de Aplicação: Single-Tenant ou Multi-inquilino e a documentação de orientação de criação de aplicações.

O modelo de aplicação determina quem é o proprietário da aplicação, quem a instala ou integra, onde os contentores são criados, quem paga e quais os administradores que têm de consentir ou configurar a faturação.

Antes de começar

Confirme estes pré-requisitos.

• Pode iniciar sessão no inquilino que está a consumir.
• A sua conta tem a função administrador incorporado do SharePoint ou a função de Administrador Global.
• A aplicação SharePoint Embedded existe no inquilino proprietário.
• Tem a ligação de instalação ou identidade da aplicação fornecida pelo proprietário da aplicação.
• Sabe se a faturação é processada pelo proprietário da aplicação ou pela organização do utilizador.
• Sabe quais são as permissões que a aplicação pede.
• Pode concluir o consentimento do administrador se o fluxo de instalação o exigir.
• Sabe se a aplicação é uma aplicação de linha de negócio de inquilino único ou uma aplicação ISV multi-inquilino.

Para obter informações sobre a função, veja Administração descrição geral.

Compreender o caminho do inquilino que está a consumir

Um inquilino que consome é o inquilino do Microsoft 365 onde os utilizadores executam a aplicação SharePoint Embedded e onde a aplicação armazena conteúdos em contentores.

O administrador de inquilinos que consome gere a aplicação e os contentores nesse inquilino.

Para uma aplicação de linha de negócio de inquilino único, o inquilino proprietário e o inquilino que consome são normalmente os mesmos.

Para uma aplicação ISV multi-inquilino, cada inquilino do cliente é um inquilino consumidor e os ficheiros de cliente permanecem no limite de inquilino do Microsoft 365 do cliente.

Os administradores inquilinos que consomem utilizam duas superfícies de administração.

Utilize o centro de administração do SharePoint quando precisar de instalação e validação guiadas.

Utilize o PowerShell para inventário e operações repetíveis após a instalação.

Instalar a partir do centro de administração do SharePoint

Utilize a experiência do SharePoint Embedded Apps no centro de administração do SharePoint quando a aplicação estiver disponível para instalação.

O separador Aplicações instaladas lista as aplicações Do SharePoint Embedded criadas pela sua organização e por organizações externas. Atualmente, não inclui aplicações Do SharePoint Embedded criadas pela Microsoft.

1. Inicie sessão no centro de administração do SharePoint.
2. No painel de navegação esquerdo, expanda SharePoint Embedded.
3. Selecione Aplicativos.
4. Reveja Aplicações instaladas para confirmar se a aplicação já está instalada.
5. Se for o proprietário da aplicação, reveja Aplicações próprias e localize a aplicação.
6. Selecione a ação de instalação disponível para a aplicação.
7. Reveja o nome da aplicação, o publicador e as informações de faturação.
8. Continue através dos pedidos de instalação.
9. Conclua o consentimento do administrador se o fluxo lhe direcionar para o consentimento.
10. Conclua a instalação.

Os pedidos de instalação exatos podem variar consoante a propriedade da aplicação e o modelo de faturação.

Não continue se a identidade da aplicação ou o publicador forem inesperados.

Instalar uma aplicação que não foi instalada

Um fluxo de criação bem-sucedido instala a aplicação automaticamente, pelo que normalmente não instala uma aplicação própria separadamente.

Só quando o passo de instalação no fluxo de criação falha é que a aplicação SharePoint Embedded foi criada, mas não instalada.

Nesse caso, instale a aplicação a partir do separador Aplicações próprias .

1. Aceda aAplicaçõesIncorporadas> do SharePoint.
2. Abra Aplicações próprias.
3. Localize a aplicação que não está instalada.
4. Selecione a ação de instalação da aplicação.
5. Conclua os pedidos de instalação.

Após a conclusão da instalação, a aplicação é apresentada no separador Aplicações instaladas .

Validar instalação

Após a instalação, valide o inventário de aplicações.

1. Regresse àsAplicaçõesIncorporadas> do SharePoint.
2. Abra Aplicações instaladas.
3. Confirme que a aplicação está listada.
4. Confirme o nome e o publicador da aplicação.
5. Confirme o tipo de faturação e o status de faturação.
6. Se a aplicação for propriedade da sua organização, abra Aplicações próprias e confirme os metadados de propriedade.
7. Registe o ID da aplicação proprietária para o PowerShell futuro e a revisão de permissões.

Selecione uma aplicação no separador Aplicações instaladas para abrir o respetivo painel de detalhes. O painel mostra a status da aplicação, Entra ID da aplicação, o ID da aplicação SharePoint Embedded, o publicador e as informações de faturação.

Figura 1: o painel de detalhes da aplicação no separador Aplicações instaladas mostra os identificadores e as informações de faturação e permite-lhe copiar os IDs da aplicação Entra e do SharePoint Embedded.

Se a aplicação não estiver visível, atualize a página e confirme se a instalação foi concluída com êxito.

Se a aplicação permanecer em falta, contacte o proprietário da aplicação e verifique a identidade da aplicação.

Conclua o consentimento do administrador

A instalação e o consentimento estão relacionados, mas nem sempre a mesma tarefa.

A aplicação proprietária tem de ter um principal de serviço instalado no inquilino que está a consumir e o consentimento do administrador para poder registar permissões de aplicação do tipo de contentor.

Utilize Conceder consentimento e permissões ao administrador para rever as permissões pedidas e concluir o consentimento.

Administração consentimento pode ser pedido através do ponto final de consentimento do administrador do plataforma de identidade da Microsoft, por exemplo:

https://login.microsoftonline.com/{your-tenant-id}/v2.0/adminconsent?client_id={owning-app-clientid}&scope=https://graph.microsoft.com/.default&redirect_uri={spe-app-redirect-uri}

Utilize o ID de cliente exato fornecido pelo proprietário da aplicação. Não substitua um ID de aplicação diferente.

Confirmar os requisitos de faturação

O SharePoint Embedded suporta modelos de faturação padrão e pass-through.

Para a faturação pass-through, um Administrador Global no inquilino que consome tem de configurar a faturação no Centro de administração do Microsoft 365 antes de os utilizadores poderem aceder à aplicação. Apenas um Administrador Global pode configurar a faturação; a função Administrador Incorporado do SharePoint não consegue.

Se a faturação for inválida ou o SharePoint Embedded estiver desativado, os utilizadores deixarão de poder criar novos contentores, embora os contentores existentes e os respetivos conteúdos permaneçam acessíveis.

Anexar ou alterar a faturação a partir do painel de detalhes

Se a faturação tiver sido ignorada durante a criação da aplicação, pode anexá-la mais tarde a partir do painel de detalhes da aplicação no separador Aplicações instaladas . Para uma aplicação organizacional Proprietário da qual a sua organização é proprietária, também pode alterar a subscrição de faturação que já está anexada a partir do mesmo painel.

1. Abraaplicações instaladas do SharePoint Embedded>Apps>.
2. Selecione a aplicação para abrir o respetivo painel de detalhes.
3. Em Informações de faturação, anexe uma subscrição de faturação ou atualize a existente.

Para uma aplicação de organização do Utilizador , a faturação não está anexada a partir deste painel. Um Administrador Global no inquilino que está a consumir configura a faturação no Centro de administração do Microsoft 365. Consulte Configurar a faturação no Centro de administração do Microsoft 365.

Utilize Configurar a faturação no Centro de administração do Microsoft 365 para configurar a faturação para cenários de consumo-inquilino.

Utilize Monitorizar a utilização, a faturação e o custo para rever os custos contínuos.

Verificar contentores após a utilização da aplicação

A aplicação não pode criar contentores até que os utilizadores ou os processos da aplicação comecem a utilizá-lo. Depois de existirem contentores, valide-os.

1. No centro de administração do SharePoint, aceda aContentores Ativos incorporados> do SharePoint.
2. Procurar ou filtrar por nome da aplicação.
3. Abra um painel de detalhes do contentor.
4. Reveja os metadados gerais.
5. Reveja a associação.
6. Confirme o estado da etiqueta de confidencialidade se forem necessárias etiquetas.
7. Reveja a utilização do armazenamento.

Para obter os passos detalhados, veja Gerir contentores no centro de administração do SharePoint.

Validar com o PowerShell

Utilize Shell de Gerenciamento do SharePoint Online quando precisar de um marcar com script.

Instale o Shell de Gerenciamento do SharePoint Online mais recente e ligue-se ao SharePoint Online.

Em seguida, utilize os cmdlets de inventário de aplicações suportados.

Get-SPOApplication

Para ver os detalhes de uma aplicação específica, utilize o ID da aplicação proprietária.

Get-SPOApplication -OwningApplicationId <OwningApplicationId>

Para obter detalhes do comando, veja Gerir contentores com o PowerShell e Get-SPOApplication.

Gerir registos de tipo de contentor com o Microsoft Graph

Consumir administradores de inquilinos também pode gerir registos de tipo de contentor através de programação. O recurso fileStorageContainerTypeRegistration representa o registo de um tipo de contentor num inquilino consumidor. A gestão de todos os registos no inquilino requer a FileStorageContainerTypeReg.Manage.All permissão delegada.

Resolver problemas de instalação

Utilize estas verificações quando a instalação não for concluída.

• Confirme que o administrador tem a função administrador do SharePoint Embedded.
• Confirme a identidade e o publicador da aplicação.
• Confirme que a aplicação está disponível para o seu inquilino.
• Confirme que o consentimento do administrador foi concedido para a aplicação correta.
• Confirme que a aplicação tem um principal de serviço no inquilino que está a consumir após o consentimento.
• Confirme que a faturação está ativa para aplicações pass-through.
• Confirme se o proprietário da aplicação registou as permissões da aplicação do tipo de contentor quando necessário.
• Confirme que são atribuídas aos utilizadores as funções ou associações de aplicações necessárias.

Conteúdo relacionado

• Visão Geral do Administrador
• Criar aplicações no centro de administração do SharePoint
• Conceder consentimento e permissões de administrador
• Configurar a faturação no Centro de administração do Microsoft 365
• Gerir contentores no centro de administração do SharePoint

Próximas etapas

Conceda consentimento e verifique as permissões em Conceder consentimento e permissões de administrador.