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: um 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. Um conjunto de tipos de contentor para fins de avaliação não pode ser convertido para produção ou vice-versa.
2. Standard e os tipos de contentor pass-through 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 um 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 contentor, consistindo 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ção 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

Os administradores de programadores podem configurar as definições selecionadas para os tipos de contentor do SharePoint Embedded que foram criados. A tabela seguinte lista as definições disponíveis.

Configurações	Descrição
ApplicationRedirectUrl	Especifica o URL para o qual os ficheiros da aplicação são redirecionados.
CopilotEmbeddedChatHosts	Adiciona URLs de anfitrião que têm permissão para utilizar a experiência declarativa do agente da aplicação SharePoint Embedded.
DiscoverabilityDisabled	Determina se o conteúdo de uma aplicação Do SharePoint Embedded está visível nas experiências do Microsoft 365.
PartilhaRestricted	Configura permissões de partilha para contentores do SharePoint Embedded através do acesso baseado em funções. Suporta modelos de partilha abertos e restritivos. Quando a partilha restritiva é definida como verdadeira, apenas os gestores e proprietários podem partilhar ficheiros no contentor.

O cmdlet Set-SPOContainerType permite que os administradores atualizem o URL de Redirecionamento da Aplicação. O cmdlet Set-SPOContainerTypeConfiguration permite aos administradores adicionar URLs de anfitrião, definir 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.

Exemplo 1

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

O exemplo 1 ativa a deteção para este tipo de contentor. Todo o conteúdo criado neste tipo de contentor será detetável na experiência do Microsoft 365, incluindo em office.com, onedrive.com, ficheiros recomendados e outras experiências de deteção inteligentes.

Exemplo 2

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -SharingRestricted $false

O Exemplo 2 ativa um modelo de partilha aberto para este tipo de contentor. Todos os membros do contentor e utilizadores convidados com permissões de edição podem partilhar ficheiros criados dentro do tipo de contentor.

Exemplo 3

Set-SPOContainerTypeConfiguration -ContainerTypeId 4f0af585-8dcc-0000-223d-661eb2c604e4 -CopilotEmbeddedChatHosts "https://localhost:3000 https://contoso.sharepoint.com https://fabrikam.com"

Este exemplo define os URLs do anfitrião para o tipo de contentor com o ID 4f0af585-8dcc-0000-223d-661eb2c604e4.

Ver Tipos de Contentor

O Administração de 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

Atualizar Tipos de Contentor

Os administradores de programadores podem atualizar um tipo de contentor do SharePoint Embedded no respetivo inquilino com o Set-SPOContainerType. Este cmdlet altera um ou mais valores de propriedade para tipos de contentores faturados por versão de avaliação, padrão ou direto para cliente. Pode utilizá-la para atualizar informações básicas, como o nome do tipo de contentor ou os detalhes de faturação.

Para atualizar informações básicas, tem de ser um Administrador Incorporado do SharePoint. Para alterar as informações de faturação, precisa do proprietário ou contribuidor acesso à subscrição de faturação existente e à nova subscrição de faturação associada ao tipo de contentor.

Não é possível atualizar as seguintes propriedades: O ID do tipo de contentor e o ID da aplicação proprietário.

Exemplo 1

Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f -OwningApplicationId 12a9d93c-18d7-46a0-b43e-28d20addd56a - ContainerTypeName 'Red Container Type'

Exemplo 1 define o nome do tipo de contentor como "Tipo de Contentor Vermelho"

Exemplo 2

Set-SPOContainerType -ContainerTypeId da1d89b3-b4cf-4c0a-8e1c-0d131c57544f –Azure Subscription 12a9d93c-18d7-46a0-b43e-28d20addd56a -ResourceGroup RG200

No Exemplo 2, o perfil de faturação do tipo de contentor é atualizado.

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 os 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 .