Freigeben über

Verwenden der PowerShell-Cmdlets für zentrale Bereitstellung zum Verwalten von Add-Ins

  • Artikel

Als Microsoft 365-Benutzeradministrator können Sie Office-Add-Ins für Benutzer über das Feature "Zentrale Bereitstellung" bereitstellen (siehe Bereitstellen von Office-Add-Ins im Admin Center). Zusätzlich zur Bereitstellung von Office-Add-Ins über das Microsoft 365 Admin Center können Sie auch Microsoft PowerShell verwenden. Installieren Sie das O365 Centralized Add-In Deployment Module für Windows PowerShell.

Öffnen Sie nach dem Herunterladen des Moduls ein reguläres Windows PowerShell-Fenster, und führen Sie das folgende Cmdlet aus:

 Import-Module -Name O365CentralizedAddInDeployment

Herstellen einer Verbindung mit Ihren Administratoranmeldeinformationen

Bevor Sie die Cmdlets für die zentrale Bereitstellung verwenden können, müssen Sie sich anmelden.

  1. PowerShell starten.

  2. Stellen Sie eine Verbindung mit PowerShell her, indem Sie Ihre Benutzeradministratoranmeldeinformationen verwenden. Führen Sie das folgende Cmdlet aus.

Connect-OrganizationAddInService
  1. Wählen Sie in der angezeigten Anmeldeaufforderung Ihre Microsoft 365-Benutzeradministratoranmeldeinformationen aus, oder geben Sie sie ein.

Hinweis

Weitere Informationen zur Verwendung von PowerShell finden Sie unter Herstellen einer Verbindung mit Microsoft 365 mit PowerShell.

Hochladen eines Add-In-Manifests

Führen Sie das Cmdlet New-OrganizationAdd-In aus, um ein Add-In-Manifest aus einem Pfad hochzuladen, der entweder ein Dateispeicherort oder eine URL sein kann. Das folgende Beispiel zeigt einen Dateispeicherort für den Wert des ManifestPath-Parameters .

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

Sie können auch das Cmdlet New-OrganizationAdd-In ausführen, um ein Add-In hochzuladen und es Benutzern oder Gruppen direkt zuzuweisen, indem Sie den Members-Parameter verwenden, wie im folgenden Beispiel gezeigt. Trennen Sie die E-Mail-Adressen von Mitgliedern durch ein Komma.

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

Hochladen eines Add-Ins aus dem Office Store

Führen Sie das Cmdlet New-OrganizationAddIn aus, um ein Manifest aus dem Office Store hochzuladen.

Im folgenden Beispiel gibt das Cmdlet New-OrganizationAddIn die AssetId für ein Add-In für einen Standort in den USA und einen Inhaltsmarkt an.

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

Um den Wert für den AssetId-Parameter zu bestimmen, können Sie ihn aus der URL der Office Store-Webseite für das Add-In kopieren. AssetIds beginnen immer mit "WA", gefolgt von einer Zahl. Im vorherigen Beispiel ist die Quelle für den AssetId-Wert von WA104099688 die Url der Office Store-Webseite für das Add-In: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Die Werte für den Locale-Parameter und den ContentMarket-Parameter sind identisch und geben das Land/die Region an, aus dem/der Sie das Add-In installieren möchten. Das Format ist en-US, fr-FR usw.

Hinweis

Aus dem Office Store hochgeladene Add-Ins werden innerhalb weniger Tage automatisch aktualisiert, nachdem das neueste Update im Office Store verfügbar ist.

Abrufen von Details zu einem Add-In

Führen Sie das Cmdlet Get-OrganizationAddIn wie unten gezeigt aus, um Details zu allen Add-Ins abzurufen, die in den Mandanten hochgeladen wurden, einschließlich der Produkt-ID eines Add-Ins.

Get-OrganizationAddIn

Führen Sie das Cmdlet Get-OrganizationAddIn mit einem Wert für den ProductId-Parameter aus, um anzugeben, für welches Add-In Sie Details abrufen möchten.

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

Um vollständige Details zu allen Add-Ins sowie den zugewiesenen Benutzern und Gruppen zu erhalten, leiten Sie die Ausgabe des Cmdlets Get-OrganizationAddIn an das Cmdlet Format-List weiter, wie im folgenden Beispiel gezeigt.

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

Aktivieren oder Deaktivieren eines Add-Ins

Um ein Add-In so zu deaktivieren, dass Benutzer und Gruppen, die zugewiesen sind, keinen Zugriff mehr haben, führen Sie das Cmdlet Set-OrganizationAddIn aus, wobei der Parameter ProductId und der Parameter Enabled auf $falsefestgelegt sind, wie im folgenden Beispiel gezeigt.

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

Um ein Add-In wieder zu aktivieren, führen Sie dasselbe Cmdlet aus, wobei der Parameter Enabled auf festgelegt ist $true.

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

Hinzufügen oder Entfernen von Benutzern aus einem Add-In

Führen Sie zum Hinzufügen von Benutzern und Gruppen zu einem bestimmten Add-In das Cmdlet Set-OrganizationAddInAssignments mit den Parametern ProductId, Add und Members aus. Trennen Sie die E-Mail-Adressen von Mitgliedern durch ein Komma.

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

Um Benutzer und Gruppen zu entfernen, führen Sie dasselbe Cmdlet mit dem Remove-Parameter aus.

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

Um allen Benutzern im Mandanten ein Add-In zuzuweisen, führen Sie dasselbe Cmdlet mit dem AssignToEveryone-Parameter aus, wobei der Wert auf $truefestgelegt ist.

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

Wenn Sie kein Add-In für alle Benutzer zuweisen und die zuvor zugewiesenen Benutzer und Gruppen wiederherstellen möchten, können Sie dasselbe Cmdlet ausführen und den AssignToEveryone-Parameter deaktivieren, indem Sie seinen Wert auf $falsefestlegen.

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

Aktualisieren eines Add-Ins

Um ein Add-In aus einem Manifest zu aktualisieren, führen Sie das Cmdlet Set-OrganizationAddIn mit den Parametern ProductId, ManifestPath und Locale aus, wie im folgenden Beispiel gezeigt.

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

Hinweis

Aus dem Office Store hochgeladene Add-Ins werden innerhalb weniger Tage automatisch aktualisiert, nachdem das neueste Update im Office Store verfügbar ist.

Löschen eines Add-Ins

Führen Sie zum Löschen eines Add-Ins das Cmdlet Remove-OrganizationAddIn mit dem Parameter ProductId aus, wie im folgenden Beispiel gezeigt.

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

Ausführliche Hilfe zu den einzelnen Cmdlets

Mithilfe des Cmdlets Get-help finden Sie ausführliche Hilfe zu den einzelnen Cmdlets. Das folgende Cmdlet enthält beispielsweise ausführliche Informationen zum Cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full