Delen via

Use the Centralized Deployment PowerShell cmdlets to manage add-ins

  • Artikel

Als Microsoft 365-gebruikersbeheerder 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 het Microsoft 365-beheercentrum, kunt u ook Microsoft PowerShell gebruiken. Installeer de O365 Centralized Add-In Deployment Module 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.

  1. Start PowerShell.

  2. Maak verbinding met PowerShell met behulp van uw gebruikersbeheerderreferenties . Voer de volgende cmdlet uit.

Connect-OrganizationAddInService
  1. Selecteer of voer in de aanmeldingsprompt die wordt geopend uw referenties voor Microsoft 365-gebruikersbeheerder 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 locatie en inhoudsmarkt in de Verenigde Staten.

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