Tipos de contêiner incorporado do SharePoint

Um tipo de contêiner é um recurso do SharePoint Embedded que define a relação, privilégios de acesso e a responsabilidade de cobrança entre um aplicativo Do SharePoint Embedded e um conjunto de contêineres. Além disso, o tipo de contêiner define comportamentos no conjunto de contêineres.

Cada tipo de contêiner é fortemente associado a um aplicativo Do SharePoint Embedded, que é chamado de aplicativo proprietário. O desenvolvedor de aplicativos proprietário é responsável por criar e gerenciar seus tipos de contêiner. O SharePoint Embedded determina uma relação 1:1 entre possuir o aplicativo e o tipo de contêiner.

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

• Autorização de acesso. Um aplicativo Do SharePoint Embedded deve ser associado a um tipo de contêiner para obter acesso a instâncias de contêiner desse tipo. Depois de associado, o aplicativo tem acesso a todas as instâncias de contêiner desse tipo. O privilégio de acesso real é determinado pela configuração de permissão application-ContainerTypeID. O aplicativo proprietário por padrão tem privilégio de acesso total a todas as instâncias de contêiner do tipo de contêiner com o qual está fortemente associado. Saiba mais sobre a Autorização Incorporada do SharePoint.
• Exploração fácil. O tipo de contêiner pode ser criado para fins de avaliação, permitindo que os desenvolvedores explorem o desenvolvimento de aplicativos do SharePoint Embedded e avaliem seus recursos gratuitamente.
• Faturamento. Os tipos de contêiner para fins não testados podem ser cobrados e devem ser criados com uma Assinatura do Azure. O uso de contêineres é medido e cobrado. Saiba mais sobre a medição e a experiência de cobrança do SharePoint Embedded.
• Comportamentos configuráveis. O tipo de contêiner define comportamentos selecionados para todas as instâncias de contêiner desse tipo. Saiba mais sobre como definir a configuração do tipo de contêiner.

Observação

1. Você deve especificar a finalidade do tipo de contêiner que você está criando no momento da criação. Dependendo da finalidade, você pode ou não precisar fornecer sua ID de Assinatura do Azure. Um tipo de contêiner definido para fins de avaliação não pode ser convertido para produção; ou vice-versa.
2. Você deve usar a versão mais recente do SharePoint Powershell para configurações de tipo de contêiner.

Uso de avaliação

Um tipo de contêiner pode ser criado para fins de avaliação/desenvolvimento e não está vinculado a nenhum perfil de cobrança do Azure. Isso permite que os desenvolvedores explorem o desenvolvimento de aplicativos do SharePoint Embedded e avaliem seus recursos gratuitamente. Nesse cenário, o locatário do desenvolvedor é o mesmo que o locatário consumidor. Cada desenvolvedor pode ter apenas um tipo de contêiner no status de avaliação em seu locatário por vez. O tipo de contêiner é válido por até 30 dias, mas pode ser removido a qualquer momento nesse período. Para criar um tipo de contêiner para fins de avaliação, você pode:

• Use o SharePoint Embedded Visual Studio Code Extension para criar o tipo de contêiner em apenas algumas etapas. A extensão Visual Studio Code também registra seu tipo de contêiner e cria contêineres para você.
• Use SharePoint PowerShell. Você deve ser um administrador do SharePoint Embedded ou administrador global para executar esse cmdlet. Se você for administrador do SharePoint, conceda a si mesmo a função Administração do SharePoint Embedded também para executar esses cmdlets.

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

As seguintes restrições são aplicadas ao tipo de contêiner no status de avaliação:

• Até cinco contêineres ativos do tipo de contêiner podem ser criados.
• Cada contêiner tem até 1 GB de espaço de armazenamento.
• O tipo de contêiner expira após 30 dias e o acesso a todos os contêineres existentes desse tipo de contêiner será removido.
• O desenvolvedor deve excluir todos os contêineres de um tipo de contêiner existente no status de avaliação para criar um novo tipo de contêiner para avaliação.
• O tipo de contêiner é restrito ao trabalho no locatário do desenvolvedor. Ele não pode ser implantado em outros locatários consumidores.

Uso padrão/sem avaliação

O tipo de contêiner também pode ser criado com um perfil de cobrança do Azure, que inclui uma ID de Assinatura do Azure e um Grupo de Região. Esse tipo de contêiner está no status padrão e pode ser cobrado. Você precisa do seguinte para criar um tipo de contêiner no status padrão:

• Uma assinatura do Azure e o Grupo de Recursos devem estar presentes no portal do Azure
• Um registro de aplicativo deve ser criado no Microsoft Entra ID
• Cada locatário do desenvolvedor pode criar até cinco tipos de contêiner no status padrão. Para criar um, use o seguinte cmdlet do PowerShell:

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

Observação

O usuário ou administrador que configurará a relação de cobrança para o SharePoint Embedded precisará ter permissões de proprietário ou contribuidor na assinatura do Azure.

Configurando tipos de contêiner

O desenvolvedor Administração pode definir as configurações selecionadas nos tipos de contêiner do SharePoint Embedded criados usando este cmdlet do PowerShell.

Esse cmdlet permite que os administradores definam as configurações de descoberta e compartilhamento de conteúdo doMicrosoft 365 em tipos de contêiner. A configuração é aplicável a todas as instâncias de contêiner do tipo de contêiner

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

Exibindo tipos de contêiner

O desenvolvedor Administração pode exibir todos os tipos de contêiner do SharePoint Embedded criados por eles em seu locatário usando este cmdlet do PowerShell. Esse cmdlet recupera e retorna a lista de tipos de contêiner criados para um Aplicativo Incorporado do SharePoint no locatário.

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

Registrar tipos de contêiner

Para criar e interagir com contêineres, você deve registrar o tipo de contêiner dentro do Locatário Consumidor. O aplicativo proprietário define as permissões para o tipo de contêiner invocando a API de registro.

Excluindo tipos de contêiner

Os administradores do desenvolvedor só podem excluir tipos de contêiner em status de avaliação. Para excluir um tipo de contêiner no status de avaliação, você deve remover todos os contêineres do tipo de contêiner primeiro, inclusive da coleção de contêineres excluída. Para remover contêineres, consulte Consuming Tenant Administração. Depois que todos os contêineres forem excluídos, os administradores do desenvolvedor poderão excluir os tipos de contêiner usando o cmdlet abaixo do PowerShell.

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]