Use the Centralized Deployment PowerShell cmdlets to manage add-ins
Als globale beheerder van Microsoft 365 kunt u Office-invoegtoepassingen implementeren voor gebruikers via de functie Gecentraliseerde implementatie (zie Office-invoegtoepassingen implementeren in het beheercentrum). Naast het implementeren van Office-invoegtoepassingen via de Microsoft 365-beheercentrum, kunt u ook Microsoft PowerShell gebruiken. Installeer de O365 Gecentraliseerde Add-In-implementatiemodule voor Windows PowerShell.
Nadat u de module hebt gedownload, opent u een normaal Windows PowerShell venster en voert u de volgende cmdlet uit:
Import-Module -Name O365CentralizedAddInDeployment
Verbinding maken met uw beheerdersreferenties
Voordat u de cmdlets voor gecentraliseerde implementatie kunt gebruiken, moet u zich aanmelden.
Start PowerShell.
Maak verbinding met PowerShell met behulp van de referenties van uw bedrijfsbeheerder. Voer de volgende cmdlet uit.
Connect-OrganizationAddInService
- Selecteer of voer in de aanmeldingsprompt die wordt geopend uw microsoft 365-gebruikersreferenties Beheer of globale beheerder in.
Opmerking
Zie Verbinding maken met Microsoft 365 met PowerShell voor meer informatie over het gebruik van PowerShell.
Een invoegtoepassingsmanifest uploaden
Voer de cmdlet New-OrganizationAdd-In uit om een invoegtoepassingsmanifest te uploaden vanaf een pad, dat een bestandslocatie of URL kan zijn. In het volgende voorbeeld ziet u een bestandslocatie voor de waarde van de manifestpath-parameter .
New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'
U kunt ook de cmdlet New-OrganizationAdd-In uitvoeren om een invoegtoepassing te uploaden en deze rechtstreeks aan gebruikers of groepen toe te wijzen met behulp van de parameter Leden , zoals wordt weergegeven in het volgende voorbeeld. Scheid de e-mailadressen van leden door een komma.
New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members 'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'
Een invoegtoepassing uploaden vanuit de Office Store
Voer de cmdlet New-OrganizationAddIn uit om een manifest uit de Office Store te uploaden.
In het volgende voorbeeld geeft de cmdlet New-OrganizationAddIn de AssetId op voor een invoegtoepassing voor een Verenigde Staten locatie en inhoudsmarkt.
New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'
Als u de waarde voor de AssetId-parameter wilt bepalen, kunt u deze kopiëren van de URL van de Office Store-webpagina voor de invoegtoepassing. AssetIds beginnen altijd met 'WA' gevolgd door een getal. In het vorige voorbeeld is de bron voor de AssetId-waarde van WA104099688 bijvoorbeeld de URL van de Office Store-webpagina voor de invoegtoepassing: https://store.office.com/en-001/app.aspx?assetid=WA104099688.
De waarden voor de parameter Landinstelling en de parameter ContentMarket zijn identiek en geven het land/de regio aan van waaruit u de invoegtoepassing probeert te installeren. De indeling is en-US, fr-FR enzovoort.
Opmerking
Invoegtoepassingen die zijn geüpload vanuit de Office Store, worden binnen een paar dagen nadat de meest recente update beschikbaar is in de Office Store automatisch bijgewerkt.
Details van een invoegtoepassing ophalen
Voer de cmdlet Get-OrganizationAddIn uit zoals hieronder wordt weergegeven om details op te halen van alle invoegtoepassingen die zijn geüpload naar de tenant, inclusief de product-id van een invoegtoepassing.
Get-OrganizationAddIn
Voer de cmdlet Get-OrganizationAddIn uit met een waarde voor de parameter ProductId om op te geven voor welke invoegtoepassing u details wilt ophalen.
Get-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122
Voor volledige details van alle invoegtoepassingen plus de toegewezen gebruikers en groepen, sluist u de uitvoer van de cmdlet Get-OrganizationAddIn door naar de cmdlet Format-List, zoals in het volgende voorbeeld wordt weergegeven.
foreach($G in (Get-organizationAddIn)){Get-OrganizationAddIn -ProductId $G.ProductId | Format-List}
Een invoegtoepassing in- of uitschakelen
Als u een invoegtoepassing wilt uitschakelen zodat gebruikers en groepen die eraan zijn toegewezen, geen toegang meer hebben, voert u de cmdlet Set-OrganizationAddIn uit met de parameter ProductId en de parameter Enabled ingesteld op $false, zoals wordt weergegeven in het volgende voorbeeld.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false
Als u een invoegtoepassing weer wilt inschakelen, voert u dezelfde cmdlet uit met de parameter Ingeschakeld ingesteld op $true.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $true
Gebruikers toevoegen aan of verwijderen uit een invoegtoepassing
Als u gebruikers en groepen wilt toevoegen aan een specifieke invoegtoepassing, voert u de cmdlet Set-OrganizationAddInAssignments uit met de parameters ProductId, Toevoegen en Leden . Scheid de e-mailadressen van leden door een komma.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Add -Members 'KathyBonner@contoso.com','sales@contoso.com'
Als u gebruikers en groepen wilt verwijderen, voert u dezelfde cmdlet uit met de parameter Remove .
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Remove -Members 'KathyBonner@contoso.com','sales@contoso.com'
Als u een invoegtoepassing wilt toewijzen aan alle gebruikers in de tenant, voert u dezelfde cmdlet uit met de parameter AssignToEveryone , waarbij de waarde is ingesteld op $true.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $true
Als u geen invoegtoepassing aan iedereen wilt toewijzen en wilt terugkeren naar de eerder toegewezen gebruikers en groepen, kunt u dezelfde cmdlet uitvoeren en de parameter AssignToEveryone uitschakelen door de waarde ervan in te stellen op $false.
Set-OrganizationAddInAssignments -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -AssignToEveryone $false
Een invoegtoepassing bijwerken
Als u een invoegtoepassing vanuit een manifest wilt bijwerken, voert u de cmdlet Set-OrganizationAddIn uit met de parameters ProductId, ManifestPath en Locale , zoals wordt weergegeven in het volgende voorbeeld.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US'
Opmerking
Invoegtoepassingen die zijn geüpload vanuit de Office Store, worden binnen een paar dagen nadat de meest recente update beschikbaar is in de Office Store automatisch bijgewerkt.
Een invoegtoepassing verwijderen
Als u een invoegtoepassing wilt verwijderen, voert u de cmdlet Remove-OrganizationAddIn uit met de parameter ProductId , zoals wordt weergegeven in het volgende voorbeeld.
Remove-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122
Gedetailleerde hulp voor elke cmdlet
U kunt gedetailleerde help voor elke cmdlet bekijken met behulp van de get-help-cmdlet. De volgende cmdlet bevat bijvoorbeeld gedetailleerde informatie over de cmdlet Remove-OrganizationAddIn.
Get-help Remove-OrganizationAddIn -Full
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor