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

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

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 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 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/Utilização não experimental

Um tipo de contentor padrão está associado a um perfil de faturação, que pode ser uma faturação regular ou direta para o consumidor. Cada inquilino de programador pode criar até cinco tipos de contentor padrão. Standard tipos de contentor são criados com o cmdlet New-SPOContainerType. Para tipos de contentor com faturação regular, crie um perfil de faturação com o cmdlet Add-SPOContainerTypeBilling . Para tipos de contentor com faturação direta para o 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.

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 normal, utilize os seguintes cmdlets:

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

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.

Para criar um tipo de contentor padrão faturado diretamente para o cliente, utilize o seguinte cmdlet:

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

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>]