Zarządzanie dodatkami za pomocą poleceń cmdlet programu PowerShell scentralizowanego wdrażania

Jako administrator użytkowników platformy Microsoft 365 możesz wdrażać dodatki pakietu Office dla użytkowników za pośrednictwem funkcji Scentralizowane wdrażanie (zobacz Wdrażanie dodatków pakietu Office w centrum administracyjnym). Oprócz wdrażania dodatków pakietu Office za pośrednictwem centrum administracyjnego platformy Microsoft 365 można również użyć programu Microsoft PowerShell. Zainstaluj moduł wdrażania scentralizowanego Add-In usługi O365 dla programu Windows PowerShell.

Po pobraniu modułu otwórz zwykłe okno programu Windows PowerShell i uruchom następujące polecenie cmdlet:

 Import-Module -Name O365CentralizedAddInDeployment

Nawiązywanie połączenia przy użyciu poświadczeń administratora

Aby można było używać poleceń cmdlet scentralizowanego wdrażania, musisz się zalogować.

1. Uruchom program PowerShell.

2. Połącz się z programem PowerShell przy użyciu poświadczeń administratora użytkownika . Uruchom następujące polecenie cmdlet.

Connect-OrganizationAddInService

3. W wyświetlonym wierszu polecenia logowania wybierz lub wprowadź poświadczenia administratora użytkownika platformy Microsoft 365.

Uwaga

Aby uzyskać więcej informacji na temat korzystania z programu PowerShell, zobacz Connect to Microsoft 365 with PowerShell (Łączenie z platformą Microsoft 365 przy użyciu programu PowerShell).

Przekazywanie manifestu dodatku

Uruchom polecenie cmdlet New-OrganizationAdd-In , aby przekazać manifest dodatku ze ścieżki, która może być lokalizacją pliku lub adresem URL. W poniższym przykładzie przedstawiono lokalizację pliku dla wartości parametru ManifestPath .

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

Możesz również uruchomić polecenie cmdlet New-OrganizationAdd-In , aby przekazać dodatek i przypisać go do użytkowników lub grup bezpośrednio przy użyciu parametru Członkowie , jak pokazano w poniższym przykładzie. Rozdziel adresy e-mail członków przecinkiem.

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

Przekazywanie dodatku ze Sklepu Office

Uruchom polecenie cmdlet New-OrganizationAddIn , aby przekazać manifest ze Sklepu Office.

W poniższym przykładzie polecenie cmdlet New-OrganizationAddIn określa identyfikator assetid dla dodatku dla lokalizacji i rynku zawartości w Stanach Zjednoczonych.

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

Aby określić wartość parametru AssetId , możesz skopiować ją z adresu URL strony internetowej Sklepu Office dla dodatku. Identyfikatory assetId zawsze zaczynają się od "WA", po których następuje liczba. Na przykład w poprzednim przykładzie źródłem wartości AssetId WA104099688 jest adres URL strony internetowej sklepu Office dla dodatku: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Wartości parametru Ustawienia regionalne i parametru ContentMarket są identyczne i wskazują kraj/region, z których próbujesz zainstalować dodatek. Format to en-US, fr-FR i tak dalej.

Uwaga

Dodatki przekazane ze Sklepu Office zostaną automatycznie zaktualizowane w ciągu kilku dni od udostępnienia najnowszej aktualizacji w Sklepie Office.

Uzyskiwanie szczegółów dodatku

Uruchom polecenie cmdlet Get-OrganizationAddIn , jak pokazano poniżej, aby uzyskać szczegółowe informacje o wszystkich dodatkach przekazanych do dzierżawy, które zawierają identyfikator produktu dodatku.

Get-OrganizationAddIn

Uruchom polecenie cmdlet Get-OrganizationAddIn z wartością parametru ProductId , aby określić dodatek, dla którego chcesz pobrać szczegóły.

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

Aby uzyskać pełne szczegóły wszystkich dodatków oraz przypisanych użytkowników i grup, przekaż dane wyjściowe polecenia cmdlet Get-OrganizationAddIn do polecenia cmdlet Format-List, jak pokazano w poniższym przykładzie.

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

Włączanie lub wyłączanie dodatku

Aby wyłączyć dodatek, aby przypisani do niego użytkownicy i grupy nie mieli już dostępu, uruchom polecenie cmdlet Set-OrganizationAddIn z parametrem ProductId i parametrem Enabled ustawionym na $false, jak pokazano w poniższym przykładzie.

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

Aby ponownie włączyć dodatek, uruchom to samo polecenie cmdlet z parametrem Enabled ustawionym na $truewartość .

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

Dodawanie lub usuwanie użytkowników z dodatku

Aby dodać użytkowników i grupy do określonego dodatku, uruchom polecenie cmdlet Set-OrganizationAddInAssignments z parametrami ProductId, Add i Members . Rozdziel adresy e-mail członków przecinkiem.

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

Aby usunąć użytkowników i grupy, uruchom to samo polecenie cmdlet przy użyciu parametru Usuń .

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

Aby przypisać dodatek do wszystkich użytkowników w dzierżawie, uruchom to samo polecenie cmdlet przy użyciu parametru AssignToEveryone z wartością ustawioną na $true.

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

Aby nie przypisywać dodatku do wszystkich użytkowników i wrócić do poprzednio przypisanych użytkowników i grup, można uruchomić to samo polecenie cmdlet i wyłączyć parametr AssignToEveryone , ustawiając jego wartość na $false.

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

Aktualizowanie dodatku

Aby zaktualizować dodatek z manifestu, uruchom polecenie cmdlet Set-OrganizationAddIn z parametrami ProductId, ManifestPath i Locale , jak pokazano w poniższym przykładzie.

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

Uwaga

Dodatki przekazane ze Sklepu Office zostaną automatycznie zaktualizowane w ciągu kilku dni od udostępnienia najnowszej aktualizacji w Sklepie Office.

Usuwanie dodatku

Aby usunąć dodatek, uruchom polecenie cmdlet Remove-OrganizationAddIn z parametrem ProductId , jak pokazano w poniższym przykładzie.

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

Uzyskaj szczegółową pomoc dotyczącą każdego polecenia cmdlet

Aby zapoznać się ze szczegółową pomocą dla każdego polecenia cmdlet, użyj polecenia cmdlet Get-help. Na przykład następujące polecenie cmdlet zawiera szczegółowe informacje o poleceniu cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full