使用集中式部署 PowerShell cmdlet 管理加载项

Office 365 管理员可以通过集中式部署功能为用户部署 Office 加载项(请参阅在 Office 365 管理中心部署 Office 加载项)。除了通过 Office 365 管理中心 部署 Office 加载项,还可以使用 Microsoft PowerShell。从 Microsoft 下载中心下载集中式部署 PowerShell cmdlet。

您要做什么?

使用管理员凭据连接

上传加载项清单

从 Office 应用商店上传加载项

获取加载项的详细信息

打开或关闭加载项

从加载项添加或删除用户

更新加载项

删除加载项

获取每个 cmdlet 的详细帮助信息

使用管理员凭据连接

需要先登录,才能使用集中式部署 cmdlet。

  1. 启动 PowerShell。

  2. 使用你的公司管理员凭据连接到 PowerShell。运行以下 cmdlet。

    Connect-OrganizationAddInService
  3. 在“输入凭据”页面上,输入 Office 365 全局管理员凭据。或者,直接在 cmdlet 中输入凭据。

    运行以下 cmdlet,将贵公司管理员凭据指定为 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 cmdlet,从路径(文件位置或 URL)上传加载项清单。下面的示例显示 ManifestPath 参数值的文件位置。

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

也可以运行 New-OrganizationAdd-In cmdlet 上传加载项,并使用 Members 参数将其直接分配给用户或组,如下例所示。用逗号分隔成员的电子邮件地址。

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

从 Office 应用商店上传加载项

运行 New-OrganizationAddIn cmdlet,从 Office 应用商店 上传清单。

在以下示例中,New-OrganizationAddIn cmdlet 为美国位置和内容市场的加载项指定了 AssetId。

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

若要确定 AssetId 参数的值,可以从加载项的 Office 应用商店 网页 URL 中复制该值。AssetId 始终以“WA”开头,后跟一串数字。例如,在上一示例中,AssetId 值 WA104099688 的源是加载项的 Office 应用商店 网页 URL:https://store.office.com/en-001/app.aspx?assetid=WA104099688

Locale 参数和 ContentMarket 参数的值是相同的,指示你正在尝试从哪个国家/地区安装加载项。格式是 en-US、fr-FR 等。

注意: Office 应用商店 上提供最新更新后的几天内,从 Office 应用商店 上传的加载项会自动更新。

获取加载项的详细信息

运行如下所示的 Get-OrganizationAddIn cmdlet 可获取已上传到租户的所有加载项的详细信息,包括加载项的产品 ID。

Get-OrganizationAddIn

运行带有 ProductId 参数值的 Get-OrganizationAddIn cmdlet 可指定要检索其详细信息的加载项。

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

若要获取所有加载项以及已分配的用户和组的完整详细信息,请将 Get-OrganizationAddIn cmdlet 的输出传递到 Format-List cmdlet,如以下示例所示。

Get-OrganizationAddIn |Format-List

打开或关闭加载项

若要关闭加载项,使分配到该加载项的用户和组无法对其进行访问,请运行 Set-OrganizationAddIn cmdlet,其中 ProductId 参数和 Enabled 参数设置为 $false,如下例所示。

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

若要重新打开加载项,请运行相同的 cmdlet,其中 Enabled 参数设置为 $true

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

从加载项添加或删除用户

若要将用户和组添加到特定的加载项,请运行 Set-OrganizationAddInAssignments cmdlet(包含 ProductId、Add 和 Members 参数)。用逗号分隔成员的电子邮件地址。

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

若要删除用户和组,请使用 Remove 参数运行相同的 cmdlet。

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

若要向租户上的所有用户分配加载项,请运行相同的 cmdlet,并将 AssignToEveryone 参数的值设置为 $true

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

如果不希望将加载项分配给所有人,且要还原为以前分配的用户和组,可运行相同的 cmdlet,并通过将 AssignToEveryone 参数的值设置为 $false 将其关闭。

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

更新加载项

若要从清单更新加载项,请运行 Set-OrganizationAddIn cmdlet(包含 ProductId、ManifestPath 和 Locale 参数,如下例所示。)

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

注意: Office 应用商店 上提供最新更新后的几天内,从 Office 应用商店 上传的加载项会自动更新。

删除加载项

若要删除加载项,请使用 ProductId 参数运行 Remove-OrganizationAddIn cmdlet,如下例所示。

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

获取每个 cmdlet 的详细帮助信息

可以通过使用 Get-help cmdlet 查看每个 cmdlet 的详细帮助信息。例如,以下 cmdlet 会提供有关 Remove-OrganizationAddIn cmdlet 的详细信息。

Get-help Remove-OrganizationAddIn -Full
扩展你的技能
了解培训
抢先获得新功能
加入 Office 预览体验计划

此信息是否有帮助?

谢谢您的反馈!

谢谢你的反馈! 可能需要转接到 Office 支持专员。

×