Tipos de Contentor do SharePoint Embedded

Um tipo de contentor é um recurso do SharePoint Embedded que define a relação, os privilégios de acesso e a responsabilidade de faturação entre uma aplicação Do SharePoint Embedded e um conjunto de contentores. Além disso, o tipo de contentor define comportamentos no conjunto de contentores.

Cada tipo de contentor é fortemente associado a uma aplicação Do SharePoint Embedded, que é referida como a aplicação proprietária. O programador da aplicação proprietária é responsável pela criação e gestão dos respetivos tipos de contentor. O SharePoint Embedded determina uma relação 1:1 entre a aplicação proprietária e um tipo de contentor.

O tipo de contentor é representado em cada instância de contentor como uma propriedade imutável (ContainerTypeID) e é utilizado em todo o ecossistema do SharePoint Embedded, incluindo:

• Autorização de acesso: uma aplicação Do SharePoint Embedded tem de estar associada a um tipo de contentor para obter acesso a instâncias de contentor desse tipo. Uma vez associada, a aplicação tem acesso a todas as instâncias de contentor desse tipo. O privilégio de acesso real é determinado pela definição de permissão application-ContainerTypeID. Por predefinição, a aplicação proprietária tem privilégios de acesso total a todas as instâncias de contentor do tipo de contentor com o qual está fortemente associada. Saiba mais sobre a Autorização do SharePoint Embedded.
• Exploração fácil: o tipo de contentor pode ser criado para fins de avaliação, permitindo que os programadores explorem o desenvolvimento de aplicações do SharePoint Embedded e avaliem as suas funcionalidades gratuitamente.
• Faturação: os tipos de contentor para fins de não avaliação são faturáveis e têm de ser criados com uma Subscrição do Azure. A utilização de contentores é limitada e cobrada. Saiba mais sobre a medição e a experiência de faturação do SharePoint Embedded.
• Comportamentos configuráveis: o tipo de contentor define os comportamentos selecionados para todas as instâncias de contentor desse tipo. Saiba mais sobre como definir a configuração do Tipo de contentor.

Observação

1. Tem de especificar a finalidade do tipo de contentor que está a criar no momento da criação. Consoante o objetivo, pode ou não ter de fornecer o ID da Subscrição do Azure. Não é possível converter um conjunto de tipos de contentor para fins de avaliação para produção; ou vice-versa.
2. Standard e passar pelos tipos de contentor não podem ser convertidos uma vez criados. Se quiser converter um tipo de contentor padrão para passar a faturação ou vice-versa, tem de eliminar e recriar o tipo de contentor.
3. Tem de utilizar a versão mais recente do SharePoint PowerShell para configurar um tipo de contentor. Para obter permissões e as informações mais recentes sobre Windows PowerShell para o SharePoint Embedded, veja a documentação em Introdução à Shell de Gestão incorporada do SharePoint.

Criar Tipos de Contentor

O SharePoint Embedded tem 2 Tipos de Contentor diferentes que pode criar.

1. Tipo de Contentor de Avaliação
2. Standard Tipo de Contentor

Pré-requisitos para criar o tipo de contentor do SharePoint Embedded

Será criado um novo tipo de contentor com Shell de Gerenciamento do SharePoint Online:

1. Transferir e instalar a versão mais recente do Shell de Gerenciamento do SharePoint Online
2. Abra Shell de Gerenciamento do SharePoint Online a partir do ecrã Início, escreva sharepoint e, em seguida, selecione Shell de Gerenciamento do SharePoint Online.
3. Ligue-se ao serviço SPO através Connect-SPOService do cmdlet ao fornecer credenciais de administrador associadas ao inquilino. Para obter informações sobre como utilizar o Connect-SPOService, veja a documentação ligada.

Requisitos de locatário

• É necessária uma instância ativa do SharePoint no seu inquilino do Microsoft 365.

• Os utilizadores que irão autenticar-se nos Contentores e Tipos de Contentores incorporados do SharePoint têm de estar no Entra ID (Membros e Convidados)

  Observação

  Não é necessária uma licença do Office para colaborar em documentos do Microsoft Office armazenados num contentor.

Funções e Permissões

• O administrador que configura a relação de faturação do SharePoint Embedded tem de ter permissões de proprietário ou contribuidor na subscrição do Azure.
• Administração precisa de ter uma função de Administrador Incorporado do SharePoint ou de Administração Global para operar cmdlets de faturação.

Assinatura do Azure

Para o tipo de contentor de faturação padrão, o administrador global ou Administrador Incorporado do SharePoint tem de configurar:

• Um inquilino do SharePoint existente
• Uma subscrição do Azure no inquilino
• Um grupo de recursos anexado à subscrição do Azure

Tipo de Contentor de Avaliação

Um tipo de contentor pode ser criado para fins de avaliação/desenvolvimento e não está ligado a nenhum perfil de faturação do Azure. Isto permite que os programadores explorem o desenvolvimento de aplicações do SharePoint Embedded e avaliem as respetivas funcionalidades gratuitamente. Para tipos de contentores de avaliação, o inquilino do programador é o mesmo que o inquilino que está a consumir. Cada programador só pode ter um tipo de contentor na versão de avaliação status no respetivo inquilino de cada vez. O tipo de contentor de avaliação é válido até 30 dias, mas pode ser removido em qualquer altura dentro deste período.

Para criar um tipo de contentor para fins de avaliação, pode:

• Utilize a Extensão de Visual Studio Code do SharePoint Embedded para criar o tipo de contentor em apenas alguns passos. A extensão Visual Studio Code regista o seu tipo de contentor e cria contentores por si.

• Utilize o PowerShell do SharePoint. Tem de ser administrador do SharePoint Embedded ou Administrador Global para executar o seguinte cmdlet. Se for administrador do SharePoint, conceda a si próprio a função de Administração do SharePoint Embedded para executar estes cmdlets.

  New-SPOContainerType [–TrialContainerType] [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]
  

As seguintes restrições são aplicadas aos tipos de contentores de avaliação:

• Podem ser criados até cinco contentores do tipo de contentor. Isto inclui contentores ativos e contentores na reciclagem.
• Cada contentor tem até 1 GB de espaço de armazenamento.
• O tipo de contentor expira após 30 dias e o acesso a quaisquer contentores existentes desse tipo de contentor será removido.
• O programador tem de eliminar permanentemente todos os contentores de um tipo de contentor existente na versão de avaliação status para criar um novo tipo de contentor para avaliação. Isto inclui contentores na coleção de contentores eliminados.
• O tipo de contentor está restrito para funcionar no inquilino do programador. Não pode ser implementado noutros inquilinos que consumam.

Standard Container Types (sem versão de avaliação)

Um tipo de contentor padrão no SharePoint Embedded define a relação, os privilégios de acesso e o perfil de faturação entre uma aplicação e os respetivos contentores. Estabelece como a aplicação interage com os contentores, incluindo permissões de acesso, e está associada a um perfil de faturação para fins não experimentais. Cada inquilino pode ter 25 tipos de contentor de cada vez.

Perfil de faturação

O SharePoint Embedded é uma oferta Pay as you go (PAYG) baseada no consumo, o que significa que paga apenas pelo que utiliza. O SharePoint Embedded fornece dois modelos de faturação que o inquilino que desenvolve a aplicação SharePoint Embedded pode selecionar para os respetivos tipos de contentor, adaptando-o aos seus requisitos empresariais exclusivos. Os dois modelos de faturação são Standard e faturação pass-through.

Standard Tipo de Contentor - com perfil de faturação

Com o perfil de faturação padrão, todos os custos baseados no consumo são faturados diretamente ao inquilino que detém ou desenvolve a aplicação. O administrador no inquilino do programador tem de estabelecer um perfil de faturação válido ao criar um tipo de contentor padrão.

Cada inquilino de programador pode criar até cinco tipos de contentores que consistem em 1 tipo de contentor de avaliação e 4 tipos de contentor padrão ou 5 tipos de contentor padrão. Standard tipos de contentor são criados com o cmdlet New-SPOContainerType.

Precisa do seguinte para criar um tipo de contentor padrão:

• Utilize o PowerShell do SharePoint. Tem de ser administrador do SharePoint Embedded ou Administrador Global para executar este cmdlet. Se for administrador do SharePoint, conceda a si próprio a função de Administração do SharePoint Embedded para executar estes cmdlets.
• Uma subscrição do Azure e um grupo de recursos têm de estar presentes no portal do Azure para faturação regular.
• Tem de ser criado um Registo de aplicações no Microsoft Entra ID.

Para criar um tipo de contentor padrão com um perfil de faturação do Azure, utilize os seguintes cmdlets:

New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [<CommonParameters>]

Assim que o tipo de contentor for criado, adicione o perfil de faturação do Azure.

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

Observação

O utilizador ou administrador que configura uma relação de faturação para o SharePoint Embedded tem de ter permissões de proprietário ou contribuidor na subscrição do Azure.

Cada tipo de contentor tem de ter uma aplicação proprietária.

Uma aplicação proprietária única só pode possuir um tipo de contentor de cada vez.

Uma subscrição do Azure pode ser anexada a qualquer número de tipos de contentor.

Se o cmdlet acima falhar com um erro SubscriptionNotRegistered, é porque Microsoft.Syntex não está registado como um fornecedor de recursos na subscrição. O cmdlet enviará um pedido de registo do fornecedor de recursos em seu nome, mas demorará alguns minutos a ser concluído. Aguarde 5 a 10 minutos e tente novamente até o cmdlet ser bem-sucedido.

Standard Container Type – faturação pass-through

Com a faturação pass-through, os custos baseados no consumo são faturados diretamente no inquilino registado para utilizar a aplicação SharePoint Embedded (inquilino de consumo). Os administradores no inquilino do programador não precisam de configurar um perfil de faturação do Azure ao criar um tipo de contentor do SharePoint Embedded pass-through.

Para os tipos de contentor que se destinam a ser faturados diretamente a um cliente, utilize o sinalizador -IsPassThroughBilling. Para o tipo de contentor faturado direto para o cliente, não é necessário anexar um perfil de faturação.

Para criar uma faturação pass-through, tipo de contentor padrão, utilize o seguinte cmdlet:

New-SPOContainerType [-ContainerTypeName] <String> [-OwningApplicationId] <String> [-ApplicationRedirectUrl] <String> [-IsPassThroughBilling] [<CommonParameters>]

Assim que o tipo de contentor estiver registado no inquilino que está a consumir, o administrador de inquilinos que consome (SharePoint Administração ou Global Administração) tem de configurar o perfil de faturação no inquilino que consome para utilizar a aplicação SharePoint Embedded.

Configurar o Perfil de Faturação no Inquilino que Está a Consumir

1. No Centro de administração do Microsoft 365, selecione Configuração e veja a secção Faturação e licenças. Selecione Ativar serviços pay as you go.

   

2. Selecione Ir para Os serviços Pay as you go.

3. Selecione Aplicações em Serviços Syntex para, selecione Aplicações e SharePoint Embedded

   

   [NOTA] A subscrição configurada nos serviços Syntex refletirá os custos de consumo no portal de faturação do Azure.

4. Registe o tipo de contentor com o token de autenticação Apenas aplicação.

Configurar Tipos de Contentor

O Administração de Programador pode definir definições selecionadas nos tipos de contentor do SharePoint Embedded criados com este cmdlet do PowerShell.

Este cmdlet permite que os administradores definam definições de deteção e partilha de conteúdos do Microsoft 365 em tipos de contentor. A definição aplica-se a todas as instâncias de contentor do tipo de contentor:

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -DiscoverabilityDisabled $False

Ver Tipos de Contentor

O Administração do Programador pode ver todos os tipos de contentor do SharePoint Embedded que criaram no inquilino com Get-SPOContainerType. Este cmdlet obtém e devolve a lista de tipos de contentor criados para uma Aplicação Do SharePoint Embedded no inquilino.

Get-SPOContainerType [<CommonParameters>]

Saída de exemplo do Get-SPOContainerType cmdlet

ContainerTypeId     : 4f0af585-8dcc-0000-223d-661eb2c604e4
ContainerTypeName   : ContosoLegal
OwningApplicationId : a735e4af-b86e-0000-93ba-1faded6c39e1
Classification      : Standard
AzureSubscriptionId : 564e9025-f7f5-xxx9-9ddd-4cdxxxx1755
ResourceGroup       : prod-resources
Region              : EastUS

Registar Tipos de Contentor

Para criar e interagir com contentores, tem de registar o tipo de contentor no Inquilino de Consumo. A aplicação proprietária define as permissões para o tipo de contentor ao invocar a API de registo.

Eliminar Tipos de Contentor

Os administradores de programadores podem eliminar os tipos de contentor padrão e de avaliação. Para eliminar um tipo de contentor, primeiro tem de remover todos os contentores desse tipo de contentor, incluindo da coleção de contentores eliminados. Para remover contentores, veja Consumir Administração de Inquilinos. Depois de todos os contentores serem eliminados, os administradores do programador podem eliminar o tipo de contentor com Remove-SPOContainerType.

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]

Medidores do SharePoint Embedded

Para saber mais sobre os medidores pay as you go suportados, veja o artigo Medidores do SharePoint Embedded .