Внедренные типы контейнеров 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.
  • Настраиваемое поведение. Тип контейнера определяет выбранное поведение для всех экземпляров контейнеров этого типа. Узнайте больше о настройке конфигурации типа контейнера.

Примечание.

  1. Необходимо указать назначение типа контейнера, создаваемого во время создания. В зависимости от цели может потребоваться указывать идентификатор подписки Azure. Тип контейнера, заданный для пробной версии, не может быть преобразован в рабочую среду; или наоборот.
  2. Для конфигураций типов контейнеров необходимо использовать последнюю версию SharePoint PowerShell.

Использование пробной версии

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

  • Используйте расширение SharePoint Embedded Visual Studio Code, чтобы создать тип контейнера всего за несколько шагов. Расширение Visual Studio Code также регистрирует тип контейнера и создает контейнеры для вас.
  • Используйте SharePoint PowerShell. Для выполнения этого командлета необходимо быть администратором SharePoint Embedded или глобальным администратором. Если вы являетесь администратором SharePoint, предоставьте себе роль администратора SharePoint Embedded, а также для выполнения этих командлетов.
New-SPOContainerType
[–TrialContainerType]
[ -ContainerTypeName <ContainerTypeName>]
[ -OwningApplicationId <OwningApplicationId>]

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

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

Стандартное или не пробное использование

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

  • Подписка Azure и группа ресурсов должны присутствовать на портале Azure.
  • Регистрация приложения должна быть создана в идентификаторе Microsoft Entra
  • Каждый клиент разработчика может создать до пяти типов контейнеров в стандартном состоянии. Чтобы создать его, используйте следующий командлет PowerShell:
New-SPOContainerType
[–ContainerTypeName <ContainerTypeName>]
[-OwningApplicationId <OwningApplicationId>]
[-AzureSubscriptionId <AzureSubscriptionId>]
[-ResourceGroup <ResourceGroup>]
[-Region <Region>]

Примечание.

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

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

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

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

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

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

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

Get-SPOContainerType

Пример выходных данных командлета 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 регистрации.

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

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

Remove-SPOContainerType
[-ContainerTypeId <ContainerTypeId>]