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 o 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 respetivas funcionalidades gratuitamente.
• A faturação. Os tipos de contentor para fins não experimentais 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. Tem de utilizar a versão mais recente do SharePoint Powershell para configurações de tipo de contentor.

Utilização da versão 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. Neste cenário, o inquilino do programador é o mesmo que o inquilino que consome. Cada programador só pode ter um tipo de contentor no estado de avaliação no respetivo inquilino de cada vez. O tipo de contentor é 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 do SharePoint Embedded Visual Studio Code para criar o tipo de contentor em apenas alguns passos. A extensão do Visual Studio Code também regista o seu tipo de contentor e cria contentores para si.
• 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 Administrador Incorporado do SharePoint para executar estes cmdlets.

New-SPOContainerType
[–TrialContainerType]
[ -ContainerTypeName <ContainerTypeName>]
[ -OwningApplicationId <OwningApplicationId>]

As seguintes restrições são aplicadas ao tipo de contentor no estado de avaliação:

• Podem ser criados até cinco contentores ativos do tipo de contentor.
• 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 no estado de avaliação 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.

Utilização Padrão/Não Experimental

O tipo de contentor também pode ser criado com um perfil de faturação do Azure, que inclui um ID de Subscrição do Azure e um Grupo de Regiões. Este tipo de contentor está no estado padrão e é faturável. Precisa do seguinte para criar um tipo de contentor no estado padrão:

• Uma subscrição do Azure e um Grupo de Recursos têm de estar presentes no portal do Azure
• Tem de ser criado um Registo de aplicações no Microsoft Entra ID
• Cada inquilino de programador pode criar até cinco tipos de contentor no estado padrão. Para criar um, utilize o seguinte cmdlet do PowerShell:

New-SPOContainerType
[–ContainerTypeName <ContainerTypeName>]
[-OwningApplicationId <OwningApplicationId>]
[-AzureSubscriptionId <AzureSubscriptionId>]
[-ResourceGroup <ResourceGroup>]
[-Region <Region>]

Observação

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

Configurar Tipos de Contentor

O Administrador 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 Administrador de Programador pode ver todos os tipos de contentor do SharePoint Embedded criados pelos mesmos no respetivo inquilino através deste cmdlet do PowerShell. Este cmdlet obtém e devolve a lista de tipos de contentor criados para uma Aplicação Do SharePoint Embedded no inquilino.

Get-SPOContainerType

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 do Programador só podem eliminar tipos de contentor no estado de avaliação. Para eliminar um tipo de contentor no estado de avaliação, tem de remover primeiro todos os contentores do tipo de contentor, incluindo da coleção de contentores eliminados. Para remover contentores, veja Consumir Administrador de Inquilinos. Depois de todos os contentores serem eliminados, os Administradores do Programador podem eliminar os tipos de contentor com o cmdlet do PowerShell abaixo.

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]