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.

Creación de tipos de contenedor

SharePoint Embedded tiene dos tipos de contenedor diferentes que puede crear.

1. Tipo de contenedor de prueba
2. Standard tipo de contenedor

Requisitos previos para crear un tipo de contenedor de SharePoint Embedded

Se creará un nuevo tipo de contenedor mediante Shell de administración de SharePoint Online:

1. Descargue e instale la versión más reciente de Shell de administración de SharePoint Online
2. Abra Shell de administración de SharePoint Online en la pantalla Inicio, escriba sharepoint y, a continuación, seleccione Shell de administración de SharePoint Online.
3. Conéctese al servicio SPO mediante Connect-SPOService el cmdlet proporcionando credenciales de administrador asociadas con el inquilino. Para obtener información sobre cómo usar Connect-SPOService, consulte la documentación vinculada.

Requisitos del espacio empresarial

• Se requiere una instancia activa de SharePoint en el inquilino de Microsoft 365.

• Los usuarios que se autenticarán en contenedores y tipos de contenedor incrustados de SharePoint deben estar en id. de entra (miembros e invitados)

  Nota:

  No se requiere una licencia de Office para colaborar en documentos de Microsoft Office almacenados en un contenedor.

Roles y permisos

• El administrador que configura la relación de facturación para SharePoint Embedded debe tener permisos de propietario o colaborador en la suscripción de Azure.
• Administración debe tener un rol de administrador de SharePoint Embedded o de Administración global para operar los cmdlets de facturación.

Suscripción a Azure

Para el tipo de contenedor de facturación estándar, el administrador global o el administrador de SharePoint Embedded deben configurar:

• Un inquilino de SharePoint existente
• Una suscripción de Azure en el inquilino
• Un grupo de recursos asociado a la suscripción de Azure

Tipo de contenedor 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 el siguiente 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 del tipo de contenedor. Esto incluye los contenedores activos y los de la papelera de reciclaje.
• 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.

Standard tipos de contenedor (no de prueba)

Un tipo de contenedor estándar en SharePoint Embedded define la relación, los privilegios de acceso y el perfil de facturación entre una aplicación y sus contenedores. Establece cómo interactúa la aplicación con los contenedores, incluidos los permisos de acceso, y está asociada a un perfil de facturación para fines que no son de prueba. Cada inquilino puede tener 5 tipos de contenedor a la vez.

Perfil de facturación

SharePoint Embedded es una oferta de pago por uso (PAYG) basada en el consumo, lo que significa que solo paga por lo que usa. SharePoint Embedded proporciona dos modelos de facturación que el inquilino que desarrolla la aplicación de SharePoint Embedded puede seleccionar para los tipos de contenedor respectivos, adaptándolo a sus requisitos empresariales únicos. Los dos modelos de facturación son Standard y facturación de paso a través.

tipo de contenedor Standard: con perfil de facturación

Con el perfil de facturación estándar, todos los cargos basados en el consumo se facturan directamente al inquilino que posee o desarrolla la aplicación. El administrador del inquilino para desarrolladores debe establecer un perfil de facturación válido al crear un tipo de contenedor estándar.

Cada inquilino para desarrolladores puede crear hasta cinco tipos de contenedor que constan de 1 tipo de contenedor de prueba y 4 tipos de contenedor estándar o 5 tipos de contenedor estándar. Standard tipos de contenedor se crean mediante el cmdlet New-SPOContainerType.

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

• 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.
• 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 mediante un perfil de facturación de Azure, use los siguientes cmdlets:

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

Una vez creado el tipo de contenedor, agregue el perfil de facturación de Azure.

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

tipo de contenedor Standard: facturación de paso a través

Con la facturación de paso a través, los cargos basados en consumo se facturan directamente al inquilino registrado para usar la aplicación de SharePoint Embedded (inquilino consumidor). Los administradores del inquilino para desarrolladores no necesitan configurar un perfil de facturación de Azure al crear un tipo de contenedor de SharePoint Embedded de paso a través.

Para los tipos de contenedor destinados a facturarse directamente a un cliente, use la marca -IsPassThroughBilling. Para el tipo de contenedor facturado directo al cliente, no es necesario adjuntar un perfil de facturación.

Para crear un tipo de contenedor estándar de facturación de paso a través, use el siguiente cmdlet:

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

Una vez registrado el tipo de contenedor en el inquilino de consumo, el administrador de inquilinos de consumo (Administración de SharePoint o Administración global) debe configurar el perfil de facturación en el inquilino de consumo para usar la aplicación de SharePoint Embedded.

Configuración del perfil de facturación en el inquilino de consumo

1. En Centro de administración de Microsoft 365, seleccione Configurar y vea la sección Facturación y licencias. Seleccione Activar servicios de pago por uso.

   

2. Seleccione Ir a Servicios de pago por uso.

3. Seleccione Aplicaciones en Servicios de Syntex para, seleccione Aplicaciones y SharePoint Embedded.

   

   [NOTA] La suscripción configurada en los servicios syntex reflejará los cargos de consumo en el portal de facturación de Azure.

4. Registre el tipo de contenedor mediante el token de autenticación solo de la aplicación.

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

Medidores incrustados de SharePoint

Para obtener más información sobre los medidores de pago por uso admitidos, consulte el artículo Medidores de SharePoint Embedded .