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

Администратор Office 365 может развертывать надстройки Office для пользователей с помощью функции централизованного развертывания (см. статью Развертывание надстроек Office в Центре администрирования Office 365). Кроме того, для развертывания надстроек можно использовать Microsoft PowerShell. Скачайте командлеты PowerShell для централизованного развертывания с сайта Центра загрузки Майкрософт.

Выберите нужное действие

Подключение с учетными данными администратора

Добавление манифеста надстройки

Добавление надстройки из Магазина Office

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

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

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

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

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

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

Подключение с учетными данными администратора

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

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

  2. Подключитесь к PowerShell, используя учетные данные администратора своей компании. Выполните следующий командлет:

    Connect-OrganizationAddInService
  3. На странице Ввод учетных данных введите учетные данные глобального администратора Office 365. Кроме того, вы можете указать свои учетные данные непосредственно в командлете.

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

    $secpasswd = ConvertTo-SecureString “MyPassword” -AsPlainText -Force
    $mycredentials = New-Object System.Management.Automation.PSCredential (“serviceaccount@contoso.com”, $secpasswd)
    Connect-OrganizationAddInService -Credential $mycredentials

Примечание : Дополнительные сведения об использовании PowerShell см. в статье Подключение к Office 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, как показано в приведенном ниже примере.

Get-OrganizationAddIn |Format-List

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

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

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

Чтобы снова включить надстройку, выполните тот же командлет, задав для параметра 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
Совершенствование навыков
Перейти к обучению
Первоочередный доступ к новым возможностям
Присоединиться к программе предварительной оценки Office

Были ли сведения полезными?

Спасибо за ваш отзыв!

Благодарим за отзыв! Возможно, будет полезно связать вас с одним из наших специалистов службы поддержки Office.

×