Del via

Bruk PowerShell-cmdleter for sentralisert distribusjon til å administrere tillegg

  • Artikkel

Som brukeradministrator for Microsoft 365 kan du distribuere Office-tillegg til brukere via funksjonen Sentralisert distribusjon (se Distribuere Office-tillegg i administrasjonssenteret). I tillegg til å distribuere Office-tillegg via administrasjonssenteret for Microsoft 365, kan du også bruke Microsoft PowerShell. Installer O365 Centralized Add-In Deployment Module for Windows PowerShell.

Når du har lastet ned modulen, åpner du et vanlig Windows PowerShell-vindu og kjører følgende cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Koble til ved hjelp av administratorlegitimasjonen

Før du kan bruke cmdleter for sentralisert distribusjon, må du logge på.

  1. Start PowerShell.

  2. Koble til PowerShell ved hjelp av brukeradministratorlegitimasjonen . Kjør følgende cmdlet.

Connect-OrganizationAddInService
  1. Velg eller angi legitimasjonen for brukeradministratoren for Microsoft 365 i ledeteksten for pålogging som åpnes.

Obs!

Hvis du vil ha mer informasjon om hvordan du bruker PowerShell, kan du se Koble til Microsoft 365 med PowerShell.

Laste opp et tilleggsmanifest

Kjør cmdleten New-OrganizationAdd-In for å laste opp et tilleggsmanifest fra en bane, som enten kan være en filplassering eller nettadresse. Følgende eksempel viser en filplassering for verdien til ManifestPath-parameteren.

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

Du kan også kjøre cmdleten New-OrganizationAdd-In for å laste opp et tillegg og tilordne det til brukere eller grupper direkte ved hjelp av Medlemmer-parameteren, som vist i eksemplet nedenfor. Skill e-postadressene til medlemmene med et komma.

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

Laste opp et tillegg fra Office Store

Kjør cmdleten New-OrganizationAddIn for å laste opp et manifest fra Office Store.

I eksemplet nedenfor angir cmdleten New-OrganizationAddIn AssetId for et tillegg for et steds- og innholdsmarked i USA.

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

Hvis du vil finne ut verdien for AssetId-parameteren, kan du kopiere den fra nettadressen til Office Store-nettsiden for tillegget. AssetIds begynner alltid med «WA» etterfulgt av et tall. I det forrige eksemplet er for eksempel kilden for AssetId-verdien for WA104099688 nettadressen for Office Store-nettsiden for tillegget: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Verdiene for parameteren Nasjonal innstilling og contentmarket-parameteren er identiske og angir landet/området du prøver å installere tillegget fra. Formatet er en-US, fr-FR og så videre.

Obs!

Tillegg som lastes opp fra Office Store, oppdateres automatisk innen noen få dager etter at den nyeste oppdateringen er tilgjengelig i Office Store.

Få detaljer om et tillegg

Kjør Get-OrganizationAddIn-cmdleten som vist nedenfor for å få detaljer om alle tillegg som er lastet opp til leieren, inkludert produkt-ID-en for et tillegg.

Get-OrganizationAddIn

Kjør Get-OrganizationAddIn-cmdleten med en verdi for ProductId-parameteren for å angi hvilket tillegg du vil hente detaljer for.

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

Hvis du vil ha fullstendig informasjon om alle tilleggene pluss tilordnede brukere og grupper, kan du pipe utdataene fra Get-OrganizationAddIn-cmdleten til Format-List cmdlet, som vist i eksemplet nedenfor.

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

Aktivere eller deaktivere et tillegg

Hvis du vil deaktivere et tillegg slik at brukere og grupper som er tilordnet til det, ikke lenger har tilgang, kjører du cmdleten Set-OrganizationAddIn med ProductId-parameteren og den aktiverte parameteren satt til $false, som vist i eksemplet nedenfor.

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

Hvis du vil aktivere et tillegg igjen, kjører du samme cmdlet med aktivert parameter satt til $true.

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

Legge til eller fjerne brukere fra et tillegg

Hvis du vil legge til brukere og grupper i et bestemt tillegg, kjører du cmdleten Set-OrganizationAddInAssignments med parameterne ProductId, Add og Members . Skill e-postadressene til medlemmene med et komma.

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

Hvis du vil fjerne brukere og grupper, kjører du samme cmdlet ved hjelp av Fjern-parameteren.

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

Hvis du vil tilordne et tillegg til alle brukere på leieren, kjører du samme cmdlet ved hjelp av Parameteren AssignToEveryone med verdien satt til $true.

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

Hvis du ikke vil tilordne et tillegg til alle og gå tilbake til tidligere tilordnede brukere og grupper, kan du kjøre samme cmdlet og deaktivere parameteren AssignToEveryone ved å angi verdien til $false.

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

Oppdatere et tillegg

Hvis du vil oppdatere et tillegg fra et manifest, kjører du cmdleten Set-OrganizationAddIn med parameterne ProductId, ManifestPath og Locale , som vist i eksemplet nedenfor.

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

Obs!

Tillegg som lastes opp fra Office Store, oppdateres automatisk innen noen få dager etter at den nyeste oppdateringen er tilgjengelig i Office Store.

Slette et tillegg

Hvis du vil slette et tillegg, kjører du cmdleten Remove-OrganizationAddIn med ProductId-parameteren, som vist i eksemplet nedenfor.

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

Få detaljert hjelp for hver cmdlet

Du kan se på detaljert hjelp for hver cmdlet ved hjelp av Get-help cmdlet. Følgende cmdlet gir for eksempel detaljert informasjon om Remove-OrganizationAddIn cmdlet.

Get-help Remove-OrganizationAddIn -Full