Использование командлетов PowerShell для централизованного развертывания для управления надстройками

Как глобальный администратор Microsoft 365 вы можете развертывать надстройки Office для пользователей с помощью функции централизованного развертывания (см. раздел Развертывание надстроек Office в Центре администрирования). Помимо развертывания надстроек Office с помощью Центр администрирования Microsoft 365, можно также использовать Microsoft PowerShell. Установите модуль централизованного развертывания Add-In O365 для Windows PowerShell.

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

 Import-Module -Name O365CentralizedAddInDeployment

Подключение с использованием учетных данных администратора

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

1. Запустите PowerShell.

2. Подключитесь к PowerShell с помощью учетных данных администратора организации. Выполните следующий командлет.

Connect-OrganizationAddInService

3. В открывшемся запросе на вход выберите или введите учетные данные пользователя Microsoft 365 Администратор или глобальный администратор.

Примечание.

Дополнительные сведения об использовании PowerShell см. в статье Подключение к Microsoft 365 с помощью PowerShell.

Отправка манифеста надстройки

Выполните командлет New-OrganizationAdd-In , чтобы отправить манифест надстройки по пути, который может быть расположением файла или URL-адресом. В следующем примере показано расположение файла для значения параметра ManifestPath .

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

Вы также можете запустить командлет New-OrganizationAdd-In , чтобы отправить надстройку и назначить ее пользователям или группам напрямую с помощью параметра Members , как показано в следующем примере. Разделите адреса электронной почты участников запятыми.

New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members  'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'

Отправка надстройки из Магазина Office

Выполните командлет New-OrganizationAddIn , чтобы отправить манифест из Магазина Office.

В следующем примере командлет New-OrganizationAddIn указывает AssetId для надстройки для США расположения и рынка содержимого.

New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'

Чтобы определить значение параметра AssetId , его можно скопировать из URL-адреса веб-страницы Магазина Office для надстройки. AssetIds всегда начинаются с "WA", за которым следует число. Например, в предыдущем примере источником значения AssetId WA104099688 является URL-адрес веб-страницы Магазина Office для надстройки: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Значения для параметра Locale и ContentMarket идентичны и указывают страну или регион, из которых вы пытаетесь установить надстройку. Формат en-US, fr-FR и т. д.

Примечание.

Надстройки, отправленные из Магазина Office, будут автоматически обновляться в течение нескольких дней после того, как последнее обновление будет доступно в Магазине Office.

Получение сведений о надстройке

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

Get-OrganizationAddIn

Выполните командлет Get-OrganizationAddIn со значением параметра ProductId , чтобы указать, для какой надстройки требуется получить сведения.

Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

Чтобы получить полные сведения обо всех надстройках, а также назначенных пользователях и группах, передайте выходные данные командлета Get-OrganizationAddIn в командлет Format-List, как показано в следующем примере.

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}

Включение или отключение надстройки

Чтобы отключить надстройку, чтобы пользователи и группы, назначенные ей, больше не имели доступа, выполните командлет Set-OrganizationAddIn с параметром ProductId , а параметр Enabled — $falseзначением , как показано в следующем примере.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false

Чтобы снова включить надстройку, выполните тот же командлет с параметром Enabled, для параметра Enabled задано значение $true.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true

Добавление или удаление пользователей из надстройки

Чтобы добавить пользователей и группы в определенную надстройку, выполните командлет Set-OrganizationAddInAssignments с параметрамиProductId, Add и Members . Разделите адреса электронной почты участников запятыми.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'

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

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'

Чтобы назначить надстройку всем пользователям в клиенте, выполните тот же командлет, используя параметр AssignToEveryone со значением $true.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true

Чтобы не назначать надстройку всем пользователям и отменить изменения ранее назначенным пользователям и группам, можно запустить тот же командлет и отключить параметр AssignToEveryone, задав ему значение $false.

Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false

Обновление надстройки

Чтобы обновить надстройку из манифеста, выполните командлет Set-OrganizationAddIn с параметрами ProductId, ManifestPath и Locale , как показано в следующем примере.

Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'

Примечание.

Надстройки, отправленные из Магазина Office, будут автоматически обновляться в течение нескольких дней после того, как последнее обновление будет доступно в Магазине Office.

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

Чтобы удалить надстройку, выполните командлет Remove-OrganizationAddIn с параметром ProductId , как показано в следующем примере.

Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122

Получение подробной справки по каждому командлету

Подробные справки по каждому командлету можно просмотреть с помощью командлета Get-help. Например, следующий командлет содержит подробные сведения о командлете Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full