Tipos de contenedor incrustados de SharePoint

Un tipo de contenedor es un recurso de SharePoint Embedded que define la relación, los privilegios de acceso y la responsabilidad de facturación entre una aplicación de SharePoint Embedded y un conjunto de contenedores. Además, el tipo de contenedor define comportamientos en el conjunto de contenedores.

Cada tipo de contenedor está fuertemente acoplado con una aplicación de SharePoint Embedded, a la que se hace referencia como la aplicación propietaria. El desarrollador de aplicaciones propietario es responsable de crear y administrar sus tipos de contenedor. SharePoint Embedded exige una relación 1:1 entre el propietario de la aplicación y el tipo de contenedor.

El tipo de contenedor se representa en cada instancia de contenedor como una propiedad inmutable (ContainerTypeID) y se usa en todo el ecosistema de SharePoint Embedded, incluidos:

• Autorización de acceso. Una aplicación de SharePoint Embedded debe estar asociada a un tipo de contenedor para obtener acceso a las instancias de contenedor de ese tipo. Una vez asociada, la aplicación tiene acceso a todas las instancias de contenedor de ese tipo. El privilegio de acceso real viene determinado por la configuración del permiso application-ContainerTypeID. De forma predeterminada, la aplicación propietaria tiene privilegios de acceso total a todas las instancias de contenedor del tipo de contenedor con el que está fuertemente acoplada. Obtenga más información sobre la autorización incrustada de SharePoint.
• Exploración fácil. El tipo de contenedor se puede crear con fines de prueba, lo que permite a los desarrolladores explorar el desarrollo de aplicaciones de SharePoint Embedded y evaluar sus características de forma gratuita.
• Facturación. Los tipos de contenedor para fines que no son de prueba son facturables y deben crearse con una suscripción de Azure. El uso de contenedores se mide y se cobra. Obtenga más información sobre la medición y la experiencia de facturación de SharePoint Embedded.
• Comportamientos configurables. El tipo de contenedor define los comportamientos seleccionados para todas las instancias de contenedor de ese tipo. Obtenga más información sobre cómo establecer la configuración del tipo de contenedor.

Nota:

1. Debe especificar el propósito del tipo de contenedor que va a crear en el momento de la creación. En función del propósito, puede que tenga que proporcionar o no el identificador de suscripción de Azure. Un conjunto de tipos de contenedor con fines de prueba no se puede convertir para producción; o viceversa.
2. Debe usar la versión más reciente de SharePoint PowerShell para las configuraciones de tipo de contenedor.

Uso de prueba

Se puede crear un tipo de contenedor con fines de prueba o desarrollo y no está vinculado a ningún perfil de facturación de Azure. Esto permite a los desarrolladores explorar el desarrollo de aplicaciones de SharePoint Embedded y evaluar sus características de forma gratuita. En este escenario, el inquilino para desarrolladores es el mismo que el inquilino que consume. Cada desarrollador solo puede tener un tipo de contenedor en el estado de prueba en su inquilino a la vez. El tipo de contenedor es válido hasta 30 días, pero se puede quitar en cualquier momento dentro de este período. Para crear un tipo de contenedor con fines de prueba, puede:

• Use la extensión de Visual Studio Code de SharePoint Embedded para crear el tipo de contenedor en unos pocos pasos. La extensión de Visual Studio Code también registra el tipo de contenedor y crea contenedores automáticamente.
• Use PowerShell de SharePoint. Debe ser administrador de SharePoint Embedded o administrador global para ejecutar este cmdlet. Si es administrador de SharePoint, concédale también el rol de administrador de SharePoint Embedded para ejecutar estos cmdlets.

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

Las restricciones siguientes se aplican al tipo de contenedor en el estado de prueba:

• Se pueden crear hasta cinco contenedores activos del tipo de contenedor.
• Cada contenedor tiene hasta 1 GB de espacio de almacenamiento.
• El tipo de contenedor expira después de 30 días y se quitará el acceso a los contenedores existentes de ese tipo de contenedor.
• El desarrollador debe eliminar permanentemente todos los contenedores de un tipo de contenedor existente en estado de prueba para crear un nuevo tipo de contenedor para la prueba. Esto incluye los contenedores de la colección de contenedores eliminada.
• El tipo de contenedor está restringido para trabajar en el inquilino para desarrolladores. No se puede implementar en otros inquilinos de consumo.

Uso estándar o no de prueba

El tipo de contenedor también se puede crear con un perfil de facturación de Azure, que incluye un identificador de suscripción de Azure y un grupo de regiones. Este tipo de contenedor está en el estado estándar y se puede facturar. Necesita lo siguiente para crear un tipo de contenedor en el estado estándar:

• Una suscripción de Azure y un grupo de recursos deben estar presentes en Azure Portal
• Debe crearse un registro de aplicación en microsoft entra id.
• Cada inquilino del desarrollador puede crear hasta cinco tipos de contenedor en el estado estándar. Para crear uno, use el siguiente cmdlet de PowerShell:

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

Nota:

El usuario o administrador que configurará una relación de facturación para SharePoint Embedded deberá tener permisos de propietario o colaborador en la suscripción de Azure.

Configuración de tipos de contenedor

El administrador de desarrolladores puede establecer la configuración seleccionada en los tipos de contenedor de SharePoint Embedded creados mediante este cmdlet de PowerShell.

Este cmdlet permite a los administradores establecer la configuración de detección y uso compartido de contenido de Microsoft 365 en los tipos de contenedor. La configuración se aplica a todas las instancias de contenedor del tipo de contenedor.

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

Visualización de tipos de contenedor

El administrador de desarrolladores puede ver todos los tipos de contenedor de SharePoint Embedded creados por ellos en su inquilino mediante este cmdlet de PowerShell. Este cmdlet recupera y devuelve la lista de tipos de contenedor creados para una aplicación incrustada de SharePoint en el inquilino.

Get-SPOContainerType

Salida de ejemplo del 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

Registro de tipos de contenedor

Para crear e interactuar con contenedores, debe registrar el tipo de contenedor en el inquilino de consumo. La aplicación propietaria define los permisos para el tipo de contenedor invocando la API de registro.

Eliminación de tipos de contenedor

Los administradores de desarrolladores solo pueden eliminar tipos de contenedor en estado de prueba. Para eliminar un tipo de contenedor en estado de prueba, primero debe quitar todos los contenedores del tipo de contenedor, incluidos los de la colección de contenedores eliminada. Para quitar contenedores, consulte Consumo del administrador de inquilinos. Una vez eliminados todos los contenedores, los administradores de desarrolladores pueden eliminar los tipos de contenedor mediante el siguiente cmdlet de PowerShell.

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]