Использование каталога приложений в семействе веб-сайтов
Область применения: Office 365
С помощью каталогов приложений в семействах веб-сайтов администраторы клиентов SharePoint могут рассредоточить управление и ограничить развертывание надстроек SharePoint и решений SharePoint Framework определенными сайтами.
Зачем нужны каталоги приложений в семействах веб-сайтов
Ранее всеми надстройками и решениями SharePoint Framework необходимо было централизованно управлять в каталоге приложений клиента. Администраторы клиентов могли делегировать доступ другим пользователям в организации, но развернутый пакет был виден во всех семействах веб-сайтов. В SharePoint нет поддерживаемого способа развертывания надстроек и решений SharePoint Framework только на определенных сайтах.
С появлением каталогов приложений для семейств веб-сайтов у администраторов клиентов появилась возможность включать каталог на определенных сайтах. После этого администраторы семейств веб-сайтов могут развертывать надстройки SharePoint и решения SharePoint Framework, которые будут доступны только в соответствующем семействе веб-сайтов.
На приведенной ниже схеме показано использование каталогов приложений в семействе веб-сайтов.
В клиенте Office 365 есть клиентский каталог приложений. Решения, развернутые в этом каталоге, можно установить в любом семействе веб-сайтов в клиенте. Администраторы клиентов могут включать каталоги приложений в определенных семействах веб-сайтов. Решения, развернутые в таких каталогах, можно устанавливать только в соответствующем семействе веб-сайтов.
Поддерживаемые возможности
Поддержка надстроек SharePoint и пакетов SharePoint Framework
В каталогах приложений для семейств веб-сайтов, как и в каталоге приложений для клиента, можно развертывать не только надстройки SharePoint, но и решения SharePoint Framework (SPPKG-файлы).
Включение ресурсов в пакеты решений
Пакеты решений SharePoint Framework, содержащие ресурсы, можно развертывать в каталогах приложений для семейств веб-сайтов. Включенные в них ресурсы развертываются в заранее настроенной библиотеке документов в том же семействе веб-сайтов, где находится каталог приложений. Если настроена общедоступная сеть доставки содержимого Office 365, ресурсы будут предоставляться из нее. В противном случае они будут поступать непосредственно из библиотеки документов.
Развертывание на уровне клиента
При развертывании решений SharePoint Framework, поддерживающих развертывание на уровне клиента, в каталоге приложений для семейства веб-сайтов вам будет предложено сделать решение доступным на всех сайтах в организации. Несмотря на такую формулировку, при установке этого флажка решение сразу станет доступным только в том семействе веб-сайтов, где находится каталог приложений. Другие семейства веб-сайтов в организациях не смогут использовать решение. Если не включить этот параметр, потребуется явно установить решение на сайте, прежде чем использовать его.
Текущие ограничения
Настройка каталогов приложений для семейств веб-сайтов и управление ими
Вы можете настраивать каталоги приложений для семейств веб-сайтов и управлять ими с помощью командной консоли SharePoint Online.
Примечание.
Чтобы управлять каталогами приложений в семействе веб-сайтов в клиенте, установите командную консоль SharePoint Online, выпущенную в ноябре 2017 г., или более поздней версии.
Кроме того, для управления каталогами приложений в семействе веб-сайтов в SharePoint можно использовать CLI для Microsoft 365. CLI для Microsoft 365 — это кроссплатформенный интерфейс командной строки, который можно использовать на любой платформе, в том числе Windows, MacOS и Linux. В качестве варианта при работе в Windows можно использовать PnP PowerShell для создания каталога приложений или удаления каталога приложений.
Примечание.
PnP PowerShell — это решение с открытым исходным кодом, поддержка которого предоставляется активным сообществом. Для инструментов с открытым исходным кодом не существует соглашения об уровне обслуживания в отношении поддержки корпорацией Майкрософт.
Примечание.
CLI для Microsoft 365 — это решение с открытым исходным кодом, поддерживаемое активным сообществом. SLA для поддержки инструмента с открытым исходным кодом со стороны Майкрософт отсутствует.
Создание каталога приложений в семействе веб-сайтов
Примечание.
Прежде чем запускать приведенный ниже скрипт, подключитесь к клиенту SharePoint Online, используя командлет Connect-SPOService в оболочке PowerShell. Кроме того, у вас должен быть каталог приложений клиента, созданный в вашем клиенте (пользователям функции Multi-geo необходимо создать каталог приложений клиента для каждого региона, в котором они желают использовать каталог приложений в семействе веб-сайтов). В противном случае командлет вернет следующую ошибку:
Cannot invoke method or retrieve property from null object. Object returned by the
following call stack is null. "TenantAppCatalog
RootWeb
GetSiteByUrl
new Microsoft.Online.SharePoint.TenantAdministration.Tenant()
"
В том случае, если вы используете CLI для Microsoft 365, сначала необходимо подключиться к клиенту Microsoft 365 с помощью команды m365 login. В PnP PowerShell для настройки подключения применяется параметр Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin.
Осторожностью
Учетная запись, которая использовалась для создания семейства веб-сайтов каталога приложений, должна принадлежать администраторам семейства веб-сайтов как на уровне клиента каталога приложений, так и целевого семейства веб-сайтов.
Чтобы создать каталог приложений в семействе веб-сайтов, используйте командлет Add-SPOSiteCollectionAppCatalog, передав имя нужного семейства веб-сайтов в параметре -Site.
Add-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing
Либо используйте PnP PowerShell, чтобы добавить функции каталога приложений для своего сайта после подключения к сайту администратора SharePoint Online:
Add-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing
Кроме того, при работе с CLI для Microsoft 365 можно использовать команду spo site appcatalog add.
m365 spo site appcatalog add --siteUrl https://contoso.sharepoint.com/sites/marketing
После выполнения скрипта в семейство веб-сайтов будет добавлена библиотека Приложения для SharePoint, где можно будет развертывать надстройки SharePoint и решения SharePoint Framework.
Отключение каталога приложений в семействе веб-сайтов
Примечание.
Прежде чем запускать приведенный ниже сценарий, подключитесь к клиенту SharePoint Online, используя командлет Connect-SPOService PowerShell в SharePoint Online, Connect-PnPOnline -Url https://<tenant>-admin.sharepoint.com -UseWebLogin для PnP PowerShell или команду m365 login в CLI для Microsoft 365, чтобы подключиться к клиенту Microsoft 365.
Чтобы отключить каталог приложений в семействе веб-сайтов, используйте командлет Remove-SPOSiteCollectionAppCatalog, передав имя нужного семейства веб-сайтов в параметре -Site. Кроме того, если вы знаете ИД семейства веб-сайтов, можно использовать командлет Remove-SPOSiteCollectionAppCatalogById.
Примечание.
Несмотря на их названия, командлеты Remove-SPOSiteCollectionAppCatalog и Remove-SPOSiteCollectionAppCatalogById не удаляют каталог приложений из семейства веб-сайтов. Они просто отключают его, чтобы в нем нельзя было развертывать решения и использовать их.
Remove-SPOSiteCollectionAppCatalog -Site https://contoso.sharepoint.com/sites/marketing
Либо используйте PnP PowerShell, чтобы удалить функции каталога приложений из своего сайта после подключения к сайту администратора SharePoint Online:
Remove-PnPSiteCollectionAppCatalog -site https://contoso.sharepoint.com/sites/marketing
Кроме того, при работе с CLI для Microsoft 365 можно использовать команду spo site appcatalog remove
m365 spo site appcatalog remove --url https://contoso.sharepoint.com/sites/marketing
После выполнения этого скрипта библиотека Приложения для SharePoint по-прежнему будет видна в семействе веб-сайтов, но в ней будет невозможно развертывать решения и использовать их.
Рекомендации
Система управления
Используйте URL-адрес https://<tenant-app-catalog-URL>/Lists/SiteCollectionAppCatalogs/AllItems.aspx для получения списка всех семейств веб-сайтов в клиенте, для которых включен каталог приложений.
Безопасность
Перед развертыванием решений в каталогах приложений для семейств веб-сайтов администраторы этих семейств должны проверять соответствие решений политикам организации. Решения, установленные в каталогах приложений для семейств веб-сайтов, можно использовать только в соответствующих семействах, но они могут получать доступ к ресурсам с других сайтов клиента, поэтому администраторам следует убедиться, что развертываемые решения работают надлежащим образом.