使用集中式部署 PowerShell Cmdlet 來管理增益集

如果您是 Office 365 系統管理員,您可以透過集中式部署功能將增益集部署給使用者 (請參閱在 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’

您也可以直接使用 Members 參數 (如下方範例所示) 來執行 New-OrganizationAdd-In Cmdlet,以上傳增益集以及將增益集指派給使用者或群組。以逗號分隔成員的電子郵件地址。

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」開頭,後面接著一串數字。例如,在上方範例中,WA104099688 之 AssetId 值的來源為增益集的 Office 市集網頁 URL:https://store.office.com/en-001/app.aspx?assetid=WA104099688

Locale 參數和 ContentMarket 參數的值是相同的,會指出您嘗試安裝增益集的所在國家/地區。格式為 en-US、fr-FR 等等。

附註: 從 Office 市集上傳的增益集會在 Office 市集上推出最新更新的幾天內自動更新。

取得增益集的詳細資料

執行 Get-OrganizationAddIn Cmdlet (如下所示) 以取得上傳至租用戶之所有增益集的詳細資料,包括增益集的產品識別碼。

Get-OrganizationAddIn

使用 ProductId 參數的值執行 Get-OrganizationAddIn Cmdlet 來指定您要擷取詳細資料的增益集。

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

若要取得所有增益集的完整詳細資料,以及指派的使用者和群組,請將 Get-OrganizationAddIn Cmdlet 的輸出內容傳送至 Format-List Cmdlet,如下列範例所示。

Get-OrganizationAddIn |Format-List

開啟或關閉增益集

若要關閉增益集,讓指派至該增益集的使用者和群組無法再存取,請將 ProductId 參數和 Enabled 參數設為 $false 並執行 Set-OrganizationAddIn Cmdlet,如下列範例所示。

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

若要重新開啟增益集,請將 Enabled 參數設為 $true 並執行相同的 Cmdlet。

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

從增益集新增或移除使用者

若要新增使用者和群組至特定增益集,請使用 ProductId、Add 和 Members 參數執行 OrganizationAddInAssignments Cmdlet。以逗號分隔成員的電子郵件地址。

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'

若要將增益集指派給租用戶上的所有使用者,請將 AssignToEveryone 參數的值設為 $true 並使用相同的 Cmdlet。

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

如果不想將增益集指派給所有人,並還原為之前指派的使用者和群組,請執行相同的 Cmdlet,並將 AssignToEveryone 參數的值設為 $false 來將其關閉。

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

更新增益集

若要從資訊清單更新增益集,請使用 ProductId、ManifestPath 和 Locale 參數執行 Set-OrganizationAddIn Cmdlet,如下列範例所示。

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

附註: 從 Office 市集上傳的增益集會在 Office 市集上推出最新更新的幾天內自動更新。

刪除增益集

若要刪除增益集,請使用 ProductId 參數執行 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 支援專員連絡以深入了解您的意見。

×