Use the Centralized Deployment PowerShell cmdlets to manage add-ins

Som global Microsoft 365-administratör kan du distribuera Office-tillägg till användare via funktionen Centraliserad distribution (se Distribuera Office-tillägg i administrationscentret). Förutom att distribuera Office-tillägg via Administrationscenter för Microsoft 365 kan du även använda Microsoft PowerShell. Installera distributionsmodulen för O365 Centralized Add-In för Windows PowerShell.

När du har hämtat modulen öppnar du ett vanligt Windows PowerShell fönster och kör följande cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Ansluta med dina administratörsautentiseringsuppgifter

Innan du kan använda cmdletar för centraliserad distribution måste du logga in.

1. Starta PowerShell.

2. Anslut till PowerShell med dina autentiseringsuppgifter som företagsadministratör. Kör följande cmdlet.

Connect-OrganizationAddInService

3. I inloggningsprompten som öppnas väljer eller anger du dina autentiseringsuppgifter för Microsoft 365-användare Admin eller global administratör.

Obs!

Mer information om hur du använder PowerShell finns i Ansluta till Microsoft 365 med PowerShell.

Ladda upp ett tilläggsmanifest

Kör cmdleten New-OrganizationAdd-In för att ladda upp ett tilläggsmanifest från en sökväg, som kan vara antingen en filplats eller URL. I följande exempel visas en filplats för värdet för manifestpath-parametern .

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

Du kan också köra cmdleten New-OrganizationAdd-In för att ladda upp ett tillägg och tilldela det till användare eller grupper direkt med hjälp av parametern Medlemmar , som du ser i följande exempel. Avgränsa e-postadresserna för medlemmar med kommatecken.

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

Ladda upp ett tillägg från Office Store

Kör cmdleten New-OrganizationAddIn för att ladda upp ett manifest från Office Store.

I följande exempel anger cmdleten New-OrganizationAddIn AssetId för ett tillägg för en USA plats- och innehållsmarknad.

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

Om du vill fastställa värdet för parametern AssetId kan du kopiera det från URL:en för Office Store-webbsidan för tillägget. AssetIds börjar alltid med "WA" följt av ett tal. I föregående exempel är till exempel källan för AssetId-värdet för WA104099688 webbadressen till Office Store för tillägget: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Värdena för parametern Nationella inställningar och ContentMarket-parametern är identiska och anger det land/den region som du försöker installera tillägget från. Formatet är en-US, fr-FR och så vidare.

Obs!

Tillägg som laddas upp från Office Store uppdateras automatiskt inom några dagar efter att den senaste uppdateringen är tillgänglig i Office Store.

Hämta information om ett tillägg

Kör cmdleten Get-OrganizationAddIn enligt nedan för att få information om alla tillägg som laddats upp till klientorganisationen, inklusive ett tilläggs produkt-ID.

Get-OrganizationAddIn

Kör cmdleten Get-OrganizationAddIn med ett värde för parametern ProductId för att ange vilket tillägg du vill hämta information för.

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

Om du vill få fullständig information om alla tillägg plus tilldelade användare och grupper, skicka utdata från cmdleten Get-OrganizationAddIn till cmdleten Format-List, som du ser i följande exempel.

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

Aktivera eller inaktivera ett tillägg

Om du vill inaktivera ett tillägg så att användare och grupper som har tilldelats det inte längre har åtkomst kör du cmdleten Set-OrganizationAddIn med parametern ProductId och parametern Enabled inställd på $false, som du ser i följande exempel.

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

Om du vill aktivera ett tillägg igen kör du samma cmdlet med parametern Enabled inställd $truepå .

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

Lägga till eller ta bort användare från ett tillägg

Om du vill lägga till användare och grupper i ett specifikt tillägg kör du cmdleten Set-OrganizationAddInAssignments med parametrarna ProductId, Add och Members . Avgränsa e-postadresserna för medlemmar med kommatecken.

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

Om du vill ta bort användare och grupper kör du samma cmdlet med hjälp av parametern Ta bort .

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

Om du vill tilldela ett tillägg till alla användare i klientorganisationen kör du samma cmdlet med parametern AssignToEveryone med värdet inställt på $true.

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

Om du inte vill tilldela ett tillägg till alla och återgå till tidigare tilldelade användare och grupper kan du köra samma cmdlet och inaktivera parametern AssignToEveryone genom att ange dess värde till $false.

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

Uppdatera ett tillägg

Om du vill uppdatera ett tillägg från ett manifest kör du cmdleten Set-OrganizationAddIn med parametrarna ProductId, ManifestPath och Locale , enligt följande exempel.

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

Obs!

Tillägg som laddas upp från Office Store uppdateras automatiskt inom några dagar efter att den senaste uppdateringen är tillgänglig i Office Store.

Ta bort ett tillägg

Om du vill ta bort ett tillägg kör du cmdleten Remove-OrganizationAddIn med parametern ProductId , enligt följande exempel.

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

Få detaljerad hjälp för varje cmdlet

Du kan titta på detaljerad hjälp för varje cmdlet med hjälp av cmdleten Get-help. Följande cmdlet innehåller till exempel detaljerad information om Remove-OrganizationAddIn cmdlet.

Get-help Remove-OrganizationAddIn -Full