Apuohjelmien hallinta keskitetyn käyttöönoton PowerShell-cmdlet-komentojen avulla

Office 365 -järjestelmänvalvoja voi ottaa Officen apuohjelmat käyttöön käyttäjille keskitetyn käyttöönottotoiminnon avulla (katso Officen apuohjelmien käyttöönotto Office 365 -hallintakeskuksen avulla). Voit käyttää Office 365 -hallintakeskusta tai Microsoft PowerShelliä Officen apuohjelmien käyttöönottoon. Lataa keskitetyn käyttöönoton PowerShell-cmdlet-komennot Microsoft Download Centeristä.

Sisältö

Yhteyden muodostaminen järjestelmänvalvojan tunnistetiedoilla

Apuohjelman luettelon lataaminen

Apuohjelman lataaminen Office-kaupasta

Apuohjelman tietojen hakeminen

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

Apuohjelman käyttäjien lisääminen tai poistaminen

Apuohjelman päivittäminen

Apuohjelman poistaminen

Cmdlet-komentokohtaiset ohjeet

Yhteyden muodostaminen järjestelmänvalvojan tunnistetiedoilla

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

  1. Käynnistä PowerShell.

  2. Muodosta PowerShell -yhteys käyttämällä yrityksesi järjestelmänvalvojan tunnistetietoja. Suorita seuraava cmdlet-komento:

    Connect-OrganizationAddInService
  3. Kirjoita Anna tunnistetiedot -sivulla yleisen Office 365 -järjestelmänvalvojan tunnistetietosi. Voit antaa tunnistetiedot myös suoraan cmdlet-komentoon.

    Suorita seuraava cmdlet-komento, jolla yrityksesi järjestelmänvalvojan tunnistetiedot määritetään PSCredential-objektiksi.

    $secpasswd = ConvertTo-SecureString “MyPassword” -AsPlainText -Force
    $mycredentials = New-Object System.Management.Automation.PSCredential (“serviceaccount@contoso.com”, $secpasswd)
    Connect-OrganizationAddInService -Credential $mycredentials

Huomautus: Lisätietoja PowerShellin käyttämisestä on kohdassa Yhteyden muodostaminen Office 365:n PowerShelliin.

Apuohjelman luettelon lataaminen

Lataa apuohjelman luettelo polusta, joka voi olla joko tiedostosijainti tai URL-osoite, suorittamalla New-OrganizationAdd-In-cmdlet-komento. Seuraavassa esimerkissä näytetään ManifestPath-parametrin arvon tiedostosijainti.

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

Voit myös suorittaa New-OrganizationAdd-In-cmdlet-komennon ja ladata apuohjelman ja määrittää sen suoraan käyttäjille tai ryhmille Members-parametrin avulla, kuten seuraavassa esimerkissä. 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'

Apuohjelman lataaminen Office-kaupasta

Lataa luettelo kohteesta Office-kauppa suorittamalla New-OrganizationAddIn-cmdlet-komento.

Seuraavassa esimerkissä New-OrganizationAddIn-cmdlet-komento määrittää apuohjelman AssetId:n, kun sijainti ja sisältöalue on Yhdysvallat.

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

Voit määrittää AssetId-parametrin arvon kopioimalla sen apuohjelman Office-kauppa-verkkosivun URL-osoitteesta. AssetId-parametri alkaa aina kirjaimilla ”WA”, joiden perässä on numero. Esimerkiksi edellisen esimerkin AssetId-arvon WA104099688 lähde on apuohjelman Office-kauppa-verkkosivun URL-osoite: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Locale-parametrin ja ContentMarket-parametrin arvot ovat samat ja ne ilmoittavat sen maan/alueen, josta yrität asentaa apuohjelman. Muoto on en-US, fr-FR ja niin edelleen.

Huomautus: Office-kauppa-kohteesta ladatut apuohjelmat päivittyvät automaattisesti muutaman päivän sisällä siitä, kun uusin päivitys on saatavilla Office-kauppa-kohteessa.

Apuohjelman tietojen hakeminen

Suorita Get-OrganizationAddIn-cmdlet-komento alla kuvatulla tavalla, niin saat tietoa kaikista vuokraajaan ladatuista apuohjelmista, mukaan lukien apuohjelman tuotetunnus.

Get-OrganizationAddIn

Suorita Get-OrganizationAddIn-cmdlet-komento ja lisää ProductId-parametrin arvo, niin voit määrittää, mistä apuohjelmasta haluat hakea tietoja.

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

Saat kaikkien apuohjelmien sekä määritettyjen käyttäjien ja ryhmien kaikki tiedot ohjaamalla Get-OrganizationAddIn-cmdlet-komennon tuloksen Format-List-cmdlet-komentoon seuraavan esimerkin mukaisesti.

Get-OrganizationAddIn |Format-List

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

Poista apuohjelma käytöstä, jotta siihen määritetyillä käyttäjillä ja ryhmillä ei enää ole käyttöoikeutta, suorittamalla Set-OrganizationAddIn-cmdlet-komento siten, että ProductId-parametrin ja Enabled-parametrin arvona on $false seuraavan esimerkin mukaisesti.

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

Ota apuohjelma takaisin käyttöön suorittamalla sama cmdlet-komento siten, että Enabled-parametrin arvona on $true.

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

Apuohjelman käyttäjien lisääminen tai poistaminen

Voit lisätä käyttäjiä ja ryhmiä tiettyyn apuohjelmaan suorittamalla Set-OrganizationAddInAssignments-cmdlet-komennon ProductId-, Add- ja Members-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'

Voit poistaa käyttäjiä ja ryhmiä suorittamalla saman cmdlet-komennon ja käyttämällä Remove-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 ja arvoa $true.

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

Jos et halua määrittää apuohjelmaa kaikille ja haluat palauttaa aiemmin määritetyt käyttäjät ja ryhmät, voit suorittaa saman cmdlet-komennon ja poistaa AssignToEveryone-parametrin käytöstä asettamalla sen arvoksi $false.

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

Apuohjelman päivittäminen

Päivitä apuohjelman luettelo suorittamalla Set-OrganizationAddIn-cmdlet-komento ProductId-, ManifestPath- ja Locale-parametreilla seuraavan esimerkin mukaisesti.

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

Huomautus: Office-kauppa-kohteesta ladatut apuohjelmat päivittyvät automaattisesti muutaman päivän sisällä siitä, kun uusin päivitys on saatavilla Office-kauppa-kohteessa.

Apuohjelman poistaminen

Poista apuohjelma suorittamalla Remove-OrganizationAddIn-cmdlet-komento käyttämällä ProductId-parametria seuraavan esimerkin mukaisesti.

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

Cmdlet-komentokohtaiset ohjeet

Saat cmdlet-komentokohtaisia ohjeita käyttämällä Get-help-cmdlet-komentoa. Esimerkiksi seuraavan cmdlet-komennon avulla saat yksityiskohtaisia tietoja Remove-OrganizationAddIn-cmdlet-komennosta.

Get-help Remove-OrganizationAddIn -Full
Kehitä Office-taitojasi
Tutustu koulutusmateriaaliin
Saat uudet ominaisuudet ensimmäisten joukossa
Liity Office Insider -käyttäjiin

Oliko näistä tiedoista hyötyä?

Kiitos palautteesta!

Kiitos palautteestasi! Näyttää siltä, että Office-tukiedustajamme avusta voi olla sinulle hyötyä.

×