Les på engelsk

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 Administrasjonssenter for Microsoft 365, kan du også bruke Microsoft PowerShell. Installer den sentraliserte Add-In distribusjonsmodulen for O365 for Windows PowerShell.

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

PowerShell 
 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 legitimasjonen for global Admin. Kjør følgende cmdlet.

PowerShell 
Connect-OrganizationAddInService
  1. I ledeteksten for pålogging som åpnes, velger eller skriver du inn legitimasjonen for Microsoft 365 Global Admin.

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.

PowerShell 
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.

PowerShell 
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 USA plasserings- og innholdsmarked.

PowerShell 
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.

PowerShell 
Get-OrganizationAddIn

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

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
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.

PowerShell 
Get-help Remove-OrganizationAddIn -Full