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 la propiedad de la aplicación y un 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 sencilla: 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 se pueden facturar 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: 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 configurar un tipo de contenedor. Para obtener permisos y la información más reciente sobre Windows PowerShell para SharePoint Embedded, consulte la documentación de Intro to SharePoint Embedded Management Shell (Introducción al shell de administración de SharePoint Embedded).

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 el caso de los tipos de contenedor de prueba, el inquilino para desarrolladores es el mismo que el inquilino de consumo. Cada desarrollador solo puede tener un tipo de contenedor en el estado de prueba en su inquilino a la vez. El tipo de contenedor de prueba 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 SharePoint Embedded Visual Studio Code Extension para crear el tipo de contenedor en unos pocos pasos. La extensión Visual Studio Code 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 Administración de SharePoint Embedded para ejecutar estos cmdlets.

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

Las restricciones siguientes se aplican a los tipos de contenedor 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 Standard o no de prueba

Un tipo de contenedor estándar está vinculado a un perfil de facturación, que puede ser facturación regular o directa al consumidor. Cada inquilino del desarrollador puede crear hasta cinco tipos de contenedor estándar. Standard tipos de contenedor se crean mediante el cmdlet New-SPOContainerType. Para los tipos de contenedor con facturación regular, cree un perfil de facturación mediante el cmdlet Add-SPOContainerTypeBilling . Para los tipos de contenedor con facturación directa al cliente, use la marca -IsPassThroughBilling. Para el tipo de contenedor facturado directo al cliente, no es necesario adjuntar un perfil de facturación.

Necesita lo siguiente para crear un tipo de contenedor estándar:

• Una suscripción de Azure y un grupo de recursos deben estar presentes en el Azure Portal para la facturación regular.
• Debe crearse un registro de aplicación en Microsoft Entra ID

Para crear un tipo de contenedor estándar con un perfil de facturación normal, use los siguientes cmdlets:

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

Add-SPOContainerTypeBilling –ContainerTypeId <ContainerTypeId> -AzureSubscriptionId <AzureSubscriptionId> -ResourceGroup <ResourceGroup> -Region <Region>

Nota:

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

Para crear un tipo de contenedor estándar directo al cliente facturado, use el siguiente cmdlet:

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

Configuración de tipos de contenedor

El Administración para 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 Administración para desarrolladores puede ver todos los tipos de contenedor de SharePoint Embedded que crearon en su inquilino mediante Get-SPOContainerType. Este cmdlet recupera y devuelve la lista de tipos de contenedor creados para una aplicación incrustada de SharePoint en el inquilino.

Get-SPOContainerType [<CommonParameters>]

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 pueden eliminar los tipos de contenedor estándar y de prueba. Para eliminar un tipo de contenedor, primero debe quitar todos los contenedores de ese tipo de contenedor, incluidos los de la colección de contenedores eliminada. Para quitar contenedores, consulte Consumo de Administración de inquilinos. Una vez eliminados todos los contenedores, los administradores de desarrolladores pueden eliminar el tipo de contenedor mediante Remove-SPOContainerType.

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]