Jaa

Use the Centralized Deployment PowerShell cmdlets to manage add-ins

  • Artikkeli

Microsoft 365 :n käyttäjäjärjestelmänvalvojana voit ottaa Office-apuohjelmia käyttöön käyttäjille keskitetyn käyttöönoton ominaisuuden avulla (katso Office-apuohjelmien käyttöönotto hallintakeskuksessa). Office-apuohjelmien käyttöönoton lisäksi Microsoft 365 -hallintakeskuksen kautta voit käyttää myös Microsoft PowerShelliä. Asenna O365:n keskitetty Add-In Käyttöönottomoduuli Windows PowerShellille.

Kun olet ladannut moduulin, avaa tavallinen Windows PowerShell -ikkuna ja suorita seuraava cmdlet-komento:

 Import-Module -Name O365CentralizedAddInDeployment

Yhteyden muodostaminen järjestelmänvalvojan tunnistetiedoilla

Ennen kuin voit käyttää keskitetyn käyttöönoton cmdlet-komentoja, sinun on kirjauduttava sisään.

  1. Käynnistä PowerShell.

  2. Muodosta yhteys PowerShelliin käyttämällä käyttäjän järjestelmänvalvojan tunnistetietojasi. Suorita seuraava cmdlet-komento.

Connect-OrganizationAddInService
  1. Valitse tai anna avautuvasta kirjautumiskehotteesta Microsoft 365 :n käyttäjäjärjestelmänvalvojan tunnistetietosi.

Huomautus

Lisätietoja PowerShellin käyttämisestä on artikkelissa Yhteyden muodostaminen Microsoft 365:een PowerShellin avulla.

Lataa apuohjelmaluettelo

Lataa apuohjelman luettelotiedosto polusta, joka voi olla tiedostosijainti tai URL-osoite, suorittamalla Uusi organisaatioLisää cmdlet-komento. Seuraavassa esimerkissä näytetään Tiedostosijainti ManifestPath-parametrin arvolle.

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

Voit myös ladata apuohjelman palvelimeen suorittamalla New-OrganizationAdd-In cmdlet-komennon ja määrittää sen käyttäjille tai ryhmille suoraan Käyttämällä Jäsenet-parametria seuraavassa esimerkissä esitetyllä tavalla. Erota jäsenten sähköpostiosoitteet toisistaan pilkulla.

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

Lataa apuohjelma Office-kaupasta

Lataa luettelo Office-kaupasta suorittamalla Uusi organisaatioAddIn cmdlet-komento.

Seuraavassa esimerkissä New-OrganizationAddIn cmdlet määrittää Yhdysvaltojen sijainnin ja sisältömarkkinoiden apuohjelman AssetId-tunnuksen.

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

Jos haluat määrittää AssetId-parametrin arvon, voit kopioida sen apuohjelman Office-kaupan verkkosivun URL-osoitteesta. AssetIds alkaa aina "WA":lla ja sen jälkeen numerolla. Esimerkiksi edellisessä esimerkissä WA104099688 AssetId-arvon lähde on apuohjelman Office-kaupan verkkosivun URL-osoite: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Aluekohtaiset asetukset -parametrin ja ContentMarket-parametrin arvot ovat samat. Ne ilmaisevat maan tai alueen, josta yrität asentaa apuohjelman. Muoto on en-US, fr-FR ja niin edelleen.

Huomautus

Office-kaupasta ladatut apuohjelmat päivittyvät automaattisesti muutaman päivän kuluessa siitä, kun viimeisin Päivitys on saatavilla Office-kaupassa.

Apuohjelman tietojen hakeminen

Suorita Get-OrganizationAddIn cmdlet alla kuvatulla tavalla, jotta saat lisätietoja kaikista vuokraajaan ladatuista apuohjelmia varten. Sisältää apuohjelman tuotetunnuksen.

Get-OrganizationAddIn

Suorita Get-OrganizationAddIncmdlet-komento ProductId-parametrin arvon kanssa määrittääksesi, mille apuohjelmalle haluat hakea tiedot.

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

Jos haluat nähdä täydelliset tiedot kaikista apuohjelmien sekä määritettyjen käyttäjien ja ryhmien tuloksista, siirrä Get-OrganizationAddIn cmdlet-komennon tulos Format-List cmdlet-komentoon seuraavassa esimerkissä esitetyllä tavalla.

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

Apuohjelman ottaminen käyttöön tai poistaminen käytöstä

Jos haluat poistaa apuohjelman käytöstä, jotta siihen määritetyillä käyttäjillä ja ryhmillä ei ole enää käyttöoikeutta, suorita Set-OrganizationAddIncmdlet-komento, jonka ProductId-parametrin ja Enabled-parametrin arvoksi $falseon määritetty , seuraavassa esimerkissä esitetyllä tavalla.

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

Voit ottaa apuohjelman takaisin käyttöön suorittamalla saman cmdlet-komennon, jonka Käytössä-parametrin arvo on $true.

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

Lisää käyttäjiä apuohjelmaan tai poista käyttäjiä apuohjelmasta

Jos haluat lisätä käyttäjiä ja ryhmiä tiettyyn apuohjelmaan, suorita Set-OrganizationAddInAssignmentscmdlet-komento ProductId-, Lisää- ja Jäsenet-parametreilla. Erota jäsenten sähköpostiosoitteet toisistaan pilkulla.

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

Jos haluat poistaa käyttäjiä ja ryhmiä, suorita sama cmdlet-komento Käyttämällä Poista-parametria .

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

Jos haluat määrittää apuohjelman kaikille vuokraajan käyttäjille, suorita sama cmdlet-komento Käyttämällä AssignToEveryone-parametria , jonka arvo on $true.

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

Jos et määritä apuohjelmaa kaikille ja palaa aiemmin määritettyihin käyttäjiin ja ryhmiin, voit suorittaa saman cmdlet-komennon ja poistaa AssignToEveryone-parametrin käytöstä määrittämällä sen arvoksi $false.

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

Apuohjelman päivittäminen

Päivitä apuohjelma luettelotiedostosta suorittamalla Set-OrganizationAddIncmdlet-komento ProductId-, ManifestPath- ja Locale-parametreilla seuraavassa esimerkissä esitetyllä tavalla.

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

Huomautus

Office-kaupasta ladatut apuohjelmat päivittyvät automaattisesti muutaman päivän kuluessa siitä, kun viimeisin Päivitys on saatavilla Office-kaupassa.

Poista apuohjelma

Jos haluat poistaa apuohjelman, suorita Remove-OrganizationAddIn cmdlet ProductId-parametrin kanssa seuraavassa esimerkissä esitetyllä tavalla.

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

Kunkin cmdlet-komennon yksityiskohtaisen ohjeen hankkiminen

Saat tarkat ohjeet kunkin cmdlet-komennon ohjeen ohjeen cmdlet-toiminnosta. Esimerkiksi seuraava cmdlet-komento antaa yksityiskohtaisia tietoja Remove-OrganizationAddIn cmdlet-komennosta.

Get-help Remove-OrganizationAddIn -Full