共用方式為

使用集中式部署PowerShell Cmdlet來管理載入宏

  • 發行項

身為 Microsoft 365 用戶系統管理員，您可以透過集中式部署功能將 Office 載入宏部署至使用者 (請參閱在系統管理中心) 部署 Office 載入 宏。 除了透過 Microsoft 365 系統管理中心部署 Office 載入宏，您也可以使用 Microsoft PowerShell。 安裝 適用於 Windows PowerShell 的 O365 集中式 Add-In 部署模組。

下載模組之後，請開啟一般的 Windows PowerShell 視窗，然後執行下列 Cmdlet：

 Import-Module -Name O365CentralizedAddInDeployment

使用您的系統管理員認證進行連線

您必須先登入，才能使用集中式部署 Cmdlet。

  1. 啟動 PowerShell。

  2. 使用您的 用戶系統管理員 認證連線到 PowerShell。 執行下列 Cmdlet。

Connect-OrganizationAddInService
  1. 在開啟的登入提示中，選取或輸入您的Microsoft 365 用戶系統管理員 認證。

注意事項

如需使用 PowerShell 的詳細資訊，請參閱 使用 PowerShell 連線到 Microsoft 365。

上傳載入宏指令清單

執行 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 複製它。 AssetIds 一律以 「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，如下列範例所示。

foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | 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

從載入宏新增或移除使用者

若要將使用者和群組新增至特定載入宏，請使用 ProductId、Add 和 Members 參數執行 Set-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 參數執行相同的 Cmdlet，並將 值設定為 $true。

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

若要不將載入宏指派給每個人，並還原為先前指派的使用者和群組，您可以執行相同的 Cmdlet，並將其值$false設定為 來關閉 AssignToEveryone 參數。

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 參數執行 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