Внедренные типы контейнеров SharePoint

Тип контейнера — это ресурс SharePoint Embedded, который определяет связь, привилегии доступа и отчетность по выставлению счетов между приложением SharePoint Embedded и набором контейнеров. Кроме того, тип контейнера определяет поведение в наборе контейнеров.

Каждый тип контейнера тесно связан с одним приложением SharePoint Embedded, которое называется собственным приложением. Разработчик собственных приложений отвечает за создание типов контейнеров и управление ими. SharePoint Embedded требует отношения 1:1 между владельцем приложения и типом контейнера.

Тип контейнера представлен на каждом экземпляре контейнера как неизменяемое свойство (ContainerTypeID) и используется во всей экосистеме SharePoint Embedded, включая:

• Авторизация доступа. Приложение SharePoint Embedded должно быть связано с типом контейнера, чтобы получить доступ к экземплярам контейнеров этого типа. После связывания приложение имеет доступ ко всем экземплярам контейнеров этого типа. Фактические права доступа определяются параметром разрешения application-ContainerTypeID. Владеющее приложение по умолчанию имеет полный доступ ко всем экземплярам контейнеров типа, с которым он тесно связан. Узнайте больше об авторизации SharePoint Embedded.
• Простой просмотр. Тип контейнера можно создать в пробных целях, что позволяет разработчикам бесплатно изучать разработку приложений SharePoint Embedded и оценивать его функции.
• Выставление счетов. Типы контейнеров для целей, отличных от пробной версии, оплачиваются и должны создаваться с подпиской Azure. Использование контейнеров измеряется и взимается плата. Узнайте больше о отслеживании использования и интерфейсе выставления счетов SharePoint Embedded.
• Настраиваемое поведение. Тип контейнера определяет выбранное поведение для всех экземпляров контейнеров этого типа. Узнайте больше о настройке конфигурации типа контейнера.

Создание типов контейнеров

SharePoint Embedded имеет 2 различных типа контейнеров, которые можно создать.

1. Тип контейнера пробной версии
2. Тип контейнера Standard

Предварительные требования для создания типа контейнера SharePoint Embedded

Новый тип контейнера будет создан с помощью командная консоль SharePoint Online:

1. Скачайте и установите последнюю версию командная консоль SharePoint Online
2. Откройте командная консоль SharePoint Online на начальном экране, введите sharepoint и выберите командная консоль SharePoint Online.
3. Подключитесь к службе SPO с помощью Connect-SPOService командлета, предоставив учетные данные администратора, связанные с клиентом. Сведения об использовании Connect-SPOService см. в связанной документации.

Требования к клиенту

• В клиенте Microsoft 365 требуется активный экземпляр SharePoint.

• Пользователи, которые будут выполнять проверку подлинности в внедренных типах контейнеров и контейнерах SharePoint, должны иметь идентификатор Entra (участники и гости)

  Примечание.

  Лицензия Office не требуется для совместной работы с документами Microsoft Office, хранящимися в контейнере.

Роли и разрешения

• Администратор, который настраивает отношение выставления счетов для SharePoint Embedded, должен иметь разрешения владельца или участник в подписке Azure.
• Администратор для выполнения командлетов выставления счетов требуется роль администратора SharePoint Embedded или глобального Администратор.

Подписка на Azure

Для стандартного типа контейнера выставления счетов глобальный администратор или администратор SharePoint Embedded должен настроить следующее:

• Существующий клиент SharePoint
• Подписка Azure в клиенте
• Группа ресурсов, присоединенная к подписке Azure

Тип контейнера пробной версии

Тип контейнера можно создать для пробной версии или разработки и не связан ни с каким профилем выставления счетов Azure. Это позволяет разработчикам бесплатно изучать разработку приложений SharePoint Embedded и оценивать его функции. Для пробных типов контейнеров клиент разработчика является таким же, как и используемый клиент. Каждый разработчик может одновременно иметь только один тип контейнера в состоянии пробной версии в клиенте. Тип пробного контейнера действителен в течение 30 дней, но его можно удалить в любое время в течение этого периода.

Чтобы создать тип контейнера для пробной версии, можно:

• Используйте расширение Visual Studio Code SharePoint Embedded, чтобы создать тип контейнера всего за несколько шагов. Расширение Visual Studio Code регистрирует тип контейнера и создает контейнеры для вас.

• Используйте SharePoint PowerShell. Для выполнения следующего командлета необходимо быть администратором SharePoint Embedded или глобальным администратором. Если вы являетесь администратором SharePoint, предоставьте себе роль SharePoint Embedded Администратор также для выполнения этих командлетов.

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

К пробным типам контейнеров применяются следующие ограничения:

• Можно создать до пяти контейнеров типа контейнера. Сюда входят активные контейнеры и контейнеры в корзине.
• Каждый контейнер имеет до 1 ГБ дискового пространства.
• Срок действия типа контейнера истекает через 30 дней, и доступ к существующим контейнерам этого типа будет удален.
• Разработчик должен окончательно удалить все контейнеры существующего типа контейнера в состоянии пробной версии, чтобы создать новый тип контейнера для пробной версии. Сюда входят контейнеры в удаленной коллекции контейнеров.
• Тип контейнера ограничен работой в клиенте разработчика. Его нельзя развернуть в других потребляющих клиентах.

Типы контейнеров Standard (не пробная версия)

Стандартный тип контейнера в SharePoint Embedded определяет связь, привилегии доступа и профиль выставления счетов между приложением и его контейнерами. Он определяет, как приложение взаимодействует с контейнерами, включая разрешения на доступ, и связывается с профилем выставления счетов для целей, не связанных с пробной версией. Каждый клиент может иметь 5 типов контейнеров одновременно.

Профиль выставления счетов

SharePoint Embedded — это система с оплатой по мере использования (PAYG) на основе потребления, означающая, что вы платите только за то, что используете. SharePoint Embedded предоставляет две модели выставления счетов, которые клиент, разрабатывающий приложение SharePoint Embedded, может выбрать для соответствующих типов контейнеров, адаптируя его к уникальным бизнес-требованиям. Две модели выставления счетов — это Standard и сквозное выставление счетов.

тип контейнера Standard — с профилем выставления счетов

В стандартном профиле выставления счетов все расходы на основе потребления выставляются непосредственно клиенту, который владеет или разрабатывает приложение. Администратор в клиенте разработчика должен установить допустимый профиль выставления счетов при создании стандартного типа контейнера.

Каждый клиент разработчика может создать до пяти типов контейнеров, состоящих из 1 пробного типа контейнера и 4 стандартных типов контейнеров или 5 стандартных типов контейнеров. Standard типы контейнеров создаются с помощью командлета New-SPOContainerType.

Чтобы создать стандартный тип контейнера, вам потребуется следующее:

• Используйте SharePoint PowerShell. Для выполнения этого командлета необходимо быть администратором SharePoint Embedded или глобальным администратором. Если вы являетесь администратором SharePoint, предоставьте себе роль SharePoint Embedded Администратор также для выполнения этих командлетов.
• Подписка Azure и группа ресурсов должны присутствовать в портал Azure для регулярного выставления счетов.
• Регистрация приложения должна быть создана в Microsoft Entra ID.

Чтобы создать стандартный тип контейнера с помощью профиля выставления счетов Azure, используйте следующие командлеты:

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

После создания типа контейнера добавьте профиль выставления счетов Azure.

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

Тип контейнера Standard — сквозное выставление счетов

При сквозном выставлении счетов плата на основе потребления выставляется непосредственно клиенту, зарегистрированным для использования приложения SharePoint Embedded (потребляющего клиента). Администраторам в клиенте разработчика не нужно настраивать профиль выставления счетов Azure при создании сквозного типа контейнера SharePoint Embedded.

Для типов контейнеров, предназначенных для выставления счетов напрямую клиенту, используйте флаг -IsPassThroughBilling. Для типа контейнера, выставленного непосредственно клиенту, нет необходимости присоединять профиль выставления счетов.

Чтобы создать сквозное выставление счетов стандартного типа контейнера, используйте следующий командлет:

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

После регистрации типа контейнера в используемом клиенте администратору потребляющего клиента (SharePoint Администратор или глобальной Администратор) необходимо настроить профиль выставления счетов в используемом клиенте для использования приложения SharePoint Embedded.

Настройка профиля выставления счетов в потребляемом клиенте

1. В Центр администрирования Microsoft 365 выберите Настройка и просмотрите раздел Выставление счетов и лицензии. Выберите Активировать службы с оплатой по мере использования.

   

2. Выберите Перейти к разделу Оплата по мере использования служб.

3. Выберите Приложения в разделе Службы Syntex для и выберите Приложения и SharePoint Embedded

   

   [ПРИМЕЧАНИЕ] Подписка, настроенная в службах Syntex, будет отражать расходы на портале выставления счетов Azure.

4. Зарегистрируйте тип контейнера с помощью маркера проверки подлинности только для приложений.

Настройка типов контейнеров

Администратор разработчика может задать выбранные параметры для типов контейнеров SharePoint Embedded, созданных с помощью этого командлета PowerShell.

Этот командлет позволяет администраторам задавать параметры обнаружения содержимого Microsoft 365 и общего доступа к ним для типов контейнеров. Этот параметр применяется ко всем экземплярам контейнеров типа контейнера:

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

Просмотр типов контейнеров

Администратор разработчика может просматривать все типы контейнеров SharePoint Embedded, созданные в клиенте, с помощью Get-SPOContainerType. Этот командлет извлекает и возвращает список типов контейнеров, созданных для внедренного приложения SharePoint в клиенте.

Get-SPOContainerType [<CommonParameters>]

Пример выходных данных командлета Get-SPOContainerType

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

Регистрация типов контейнеров

Чтобы создать контейнеры и взаимодействовать с ними, необходимо зарегистрировать тип контейнера в потребляющих клиентах. Владеющее приложение определяет разрешения для типа контейнера, вызывая API регистрации.

Удаление типов контейнеров

Администраторы разработчиков могут удалять как пробные, так и стандартные типы контейнеров. Чтобы удалить тип контейнера, сначала необходимо удалить все контейнеры этого типа, в том числе из коллекции удаленных контейнеров. Сведения об удалении контейнеров см. в статье Использование Администратор клиента. После удаления всех контейнеров администраторы разработчиков могут удалить тип контейнера с помощью Remove-SPOContainerType.

Remove-SPOContainerType [-ContainerTypeId <ContainerTypeId>]

Счетчики внедрения SharePoint

Дополнительные сведения о поддерживаемых счетчиках с оплатой по мере использования см. в статье Счетчики SharePoint Embedded .