Use the Centralized Deployment PowerShell cmdlets to manage add-ins

Jako správce uživatelů Microsoftu 365 můžete nasazovat doplňky pro Office uživatelům prostřednictvím funkce Centralizované nasazení (viz Nasazení doplňků pro Office v Centru pro správu). Kromě nasazení doplňků pro Office prostřednictvím Centra pro správu Microsoftu 365 můžete použít také Microsoft PowerShell. Nainstalujte modul centralizovaného nasazení Add-In O365 pro Windows PowerShell.

Po stažení modulu otevřete běžné okno Windows PowerShellu a spusťte následující rutinu:

 Import-Module -Name O365CentralizedAddInDeployment

Připojení pomocí přihlašovacích údajů správce

Než budete moct používat rutiny Centralizované nasazení, musíte se přihlásit.

1. Spusťte PowerShell.

2. Připojte se k PowerShellu pomocí přihlašovacích údajů správce uživatele . Spusťte následující rutinu.

Connect-OrganizationAddInService

3. V výzvě k přihlášení, která se otevře, vyberte nebo zadejte přihlašovací údaje správce uživatelů Microsoftu 365.

Poznámka

Další informace o používání PowerShellu najdete v tématu Připojení k Microsoftu 365 pomocí PowerShellu.

Nahrání manifestu doplňku

Spuštěním rutiny New-OrganizationAdd-In nahrajte manifest doplňku z cesty, kterou může být umístění souboru nebo adresa URL. Následující příklad ukazuje umístění souboru pro hodnotu parametru ManifestPath .

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

Můžete také spustit rutinu New-OrganizationAdd-In , která nahraje doplněk a přiřadí ho uživatelům nebo skupinám přímo pomocí parametru Members , jak je znázorněno v následujícím příkladu. E-mailové adresy členů oddělte čárkou.

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

Nahrání doplňku z Office Storu

Spuštěním rutiny New-OrganizationAddIn nahrajte manifest z Office Storu.

V následujícím příkladu rutina New-OrganizationAddIn určuje AssetId pro doplněk pro usa umístění a trh obsahu.

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

Pokud chcete zjistit hodnotu parametru AssetId , můžete ho zkopírovat z adresy URL webové stránky Office Storu pro doplněk. AssetId vždy začínají řetězcem "WA", za kterým následuje číslo. Například v předchozím příkladu je zdrojem hodnoty AssetId WA104099688 adresa URL webové stránky office Storu pro doplněk: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Hodnoty parametru Locale a ContentMarket jsou stejné a označují zemi nebo oblast, ze které se pokoušíte doplněk nainstalovat. Formát je en-US, fr-FR atd.

Poznámka

Doplňky nahrané z Office Storu se automaticky aktualizují během několika dnů od toho, co bude nejnovější aktualizace dostupná v Office Storu.

Získání podrobností o doplňku

Spuštěním rutiny Get-OrganizationAddIn , jak je znázorněno níže, získáte podrobnosti o všech doplňcích nahraných do tenanta, včetně ID produktu doplňku.

Get-OrganizationAddIn

Spusťte rutinu Get-OrganizationAddIn s hodnotou parametru ProductId a určete, pro který doplněk chcete načíst podrobnosti.

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

Pokud chcete získat úplné podrobnosti o všech doplňcích a přiřazených uživatelích a skupinách, předávejte výstup rutiny Get-OrganizationAddIn do rutiny Format-List, jak je znázorněno v následujícím příkladu.

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

Zapnutí nebo vypnutí doplňku

Pokud chcete doplněk vypnout, aby uživatelé a skupiny, které jsou k němu přiřazené, už neměli přístup, spusťte rutinu Set-OrganizationAddIn s parametrem ProductId a parametrEm Enabled nastaveným na $falsehodnotu , jak je znázorněno v následujícím příkladu.

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

Pokud chcete doplněk znovu zapnout, spusťte stejnou rutinu s parametrem Enabled nastaveným na $true.

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

Přidání nebo odebrání uživatelů z doplňku

Pokud chcete přidat uživatele a skupiny do konkrétního doplňku, spusťte rutinu Set-OrganizationAddInAssignments s parametry ProductId, Add a Members . E-mailové adresy členů oddělte čárkou.

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

Pokud chcete odebrat uživatele a skupiny, spusťte stejnou rutinu pomocí parametru Remove .

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

Pokud chcete přiřadit doplněk všem uživatelům v tenantovi, spusťte stejnou rutinu pomocí parametru AssignToEveryone s hodnotou nastavenou na $true.

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

Pokud nechcete přiřadit doplněk všem a vrátit se k dříve přiřazeným uživatelům a skupinám, můžete spustit stejnou rutinu a vypnout parametr AssignToEveryone nastavením jeho hodnoty na $false.

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

Aktualizace doplňku

Pokud chcete aktualizovat doplněk z manifestu, spusťte rutinu Set-OrganizationAddIn s parametry ProductId, ManifestPath a Locale , jak je znázorněno v následujícím příkladu.

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

Poznámka

Doplňky nahrané z Office Storu se automaticky aktualizují během několika dnů od toho, co bude nejnovější aktualizace dostupná v Office Storu.

Odstranění doplňku

Pokud chcete doplněk odstranit, spusťte rutinu Remove-OrganizationAddIn s parametrem ProductId , jak je znázorněno v následujícím příkladu.

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

Získání podrobné nápovědy pro jednotlivé rutiny

Podrobnou nápovědu pro jednotlivé rutiny si můžete prohlédnout pomocí rutiny Get-help. Například následující rutina poskytuje podrobné informace o rutině Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full