Use the Centralized Deployment PowerShell cmdlets to manage add-ins
Som Microsoft 365 global administratör kan du distribuera Office-tillägg till användare via funktionen för centraliserad distribution (se Distribuera Office-tillägg i administrationscentret. Förutom att distribuera Office tillägg via Administrationscenter för Microsoft 365 kan du också använda Microsoft PowerShell. Installera O365-distributionsmodulen för Add-In centraliserad för Windows PowerShell.
När du har laddat ned modulen öppnar du ett Windows PowerShell fönster och kör följande cmdlet:
Import-Module -Name O365CentralizedAddInDeployment
Anslut administratörsuppgifterna
Innan du kan använda cmdlets för centraliserad distribution måste du logga in.
Starta PowerShell.
Anslut till PowerShell med dina autentiseringsuppgifter som företagsadministratör. Kör följande cmdlet.
Connect-OrganizationAddInService
På sidan Ange autentiseringsuppgifter anger du autentiseringsuppgifterna Microsoft 365 Användare eller Global administratör. Alternativt kan du ange dina autentiseringsuppgifter direkt i cmdleten.
Kör följande cmdlet med dina autentiseringsuppgifter som företagsadministratör som ett PSCredential-objekt.
$secpasswd = ConvertTo-SecureString "MyPassword" -AsPlainText -Force
$mycredentials = New-Object System.Management.Automation.PSCredential ("serviceaccount@contoso.com", $secpasswd)
Connect-OrganizationAddInService -Credential $mycredentials
Anteckning
Mer information om hur du använder PowerShell finns i Anslut att Microsoft 365 med PowerShell.
Upload ett tilläggsmanifest
Kör cmdleten New-OrganizationAdd-In för att ladda upp ett tilläggsmanifest från en sökväg, som antingen kan vara en filsökväg eller en URL. I följande exempel visas en filplats för parametervärdet för ManifestPath.
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 Members, enligt exemplet nedan. Avgränsa e-postadresserna till medlemmarna med kommatecken.
New-OrganizationAddIn -ManifestPath 'C:\Users\Me\Desktop\taskpane.xml' -Locale 'en-US' -Members 'KathyBonner@contoso.com', 'MaxHargrave@contoso.com'
Upload 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 TillgångsID för ett tillägg för en plats och en innehållsmarknad i USA.
New-OrganizationAddIn -AssetId 'WA104099688' -Locale 'en-US' -ContentMarket 'en-US'
Om du vill ta reda på värdet för parametern AssetId kan du kopiera det från URL:en för Office Store-webbsidan för tillägget. Tillgångsid:er börjar alltid med "WA" följt av ett tal. I föregående exempel är källan för AssetId-värdet WA104099688 webbside-URL för Office Store för tillägget: https://store.office.com/en-001/app.aspx?assetid=WA104099688 .
Värdena för parametern Locale och parametern ContentMarket är identiska och anger landet/regionen som du försöker installera tillägget från. Formatet är en-US, fr-FR. och så vidare.
Anteckning
Tillägg som laddats upp från Office Store uppdateras automatiskt inom några dagar efter det att den senaste uppdateringen är tillgänglig på Office Store.
Få 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 tilläggets 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
För att få fullständig information om alla tillägg plus tilldelade användare och grupper ska du pipa 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ällda på , som i följande $false exempel.
Set-OrganizationAddIn -ProductId 6a75788e-1c6b-4e9b-b5db-5975a2072122 -Enabled $false
Om du vill aktivera tillägget igen kör du samma cmdlet med parametern Enabled inställd på $true .
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 till medlemmarna 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 parametern Remove.
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'
Anteckning
Tillägg som laddats upp från Office Store uppdateras automatiskt inom några dagar efter det att den senaste uppdateringen är tillgänglig på 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 se detaljerad hjälp för varje cmdlet med hjälp av cmdleten Get-help. Följande cmdlet ger till exempel detaljerad information om Remove-OrganizationAddIn cmdlet.
Get-help Remove-OrganizationAddIn -Full