Menggunakan cmdlet PowerShell Penyebaran Terpusat untuk mengelola add-in

Sebagai admin Office 365, Anda dapat menyebarkan add-in Office kepada pengguna melalui fitur Penyebaran Terpusat (lihat Menyebarkan Add-in Office di Pusat Admin Office 365). Selain menyebarkan add-in Office melalui Pusat admin Office 365, Anda juga dapat menggunakan Microsoft PowerShell. Unduh cmdlet PowerShell Penyebaran Terpusat dari Pusat Unduhan Microsoft.

Apa yang ingin Anda lakukan?

Menyambungkan dengan kredensial admin Anda

Mengunggah manifes add-in

Mengunggah add-in dari Bursa Office

Mendapatkan detail add-in

Mengaktifkan atau menonaktifkan add-in

Menambahkan atau menghapus pengguna dari add-in

Memperbarui add-in

Menghapus add-in

Mendapatkan bantuan mendetail untuk setiap cmdlet

Menyambungkan dengan kredensial admin Anda

Sebelum dapat menggunakan cmdlet Penyebaran Terpusat, Anda perlu masuk.

  1. Mulai PowerShell.

  2. Sambungkan ke PowerShell dengan kredensial admin perusahaan Anda. Jalankan cmdlet berikut.

    Connect-OrganizationAddInService
  3. Di halaman Masukkan Kredensial, masukkan kredensial admin global Office 365 Anda. Sebagai alternatif, Anda dapat memasukkan kredensial langsung ke cmdlet.

    Jalankan cmdlet berikut yang menentukan kredensial admin perusahaan Anda sebagai objek PSCredential.

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

Catatan: Untuk informasi selengkapnya tentang menggunakan PowerShell, lihat Menyambungkan ke PowerShell Office 365.

Mengunggah manifes add-in

Jalankan cmdlet New-OrganizationAdd-In untuk mengunggah manifes add-in dari jalur, yang dapat berupa lokasi file atau URL. Contoh berikut ini memperlihatkan lokasi file untuk nilai parameter ManifestPath.

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

Anda juga dapat menjalankan cmdlet New-OrganizationAdd-In untuk mengunggah add-in dan langsung menetapkannya ke pengguna atau grup menggunakan parameter Members, seperti yang diperlihatkan dalam contoh berikut. Pisahkan alamat email anggota dengan tanda koma.

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

Mengunggah add-in dari Bursa Office

Jalankan cmdlet New-OrganizationAddIn untuk mengunggah manifes dari Bursa Office.

Dalam contoh berikut, cmdlet New-OrganizationAddIn menentukan AssetId untuk add-in bagi lokasi dan konten pasar Amerika Serikat.

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

Untuk menentukan nilai parameter AssetId, Anda dapat menyalinnya dari URL halaman web Bursa Office bagi add-in tersebut. AssetId selalu dimulai dengan "WA" yang diikuti dengan angka. Misalnya, di contoh sebelumnya, sumber untuk nilai AssetId WA104099688 adalah URL halaman web Bursa Office untuk add-in: https://store.office.com/en-001/app.aspx?assetid=WA104099688.

Nilai untuk parameter Locale dan parameter ContentMarket serupa dan mengindikasikan negara/kawasan tempat Anda mencoba menginstal add-in. Formatnya adalah en-US, fr-FR, dan sebagainya.

Catatan: Add-in yang diunggah dari Bursa Office akan diperbarui secara otomatis dalam beberapa hari dari pembaruan terbaru yang tersedia di Bursa Office.

Mendapatkan detail add-in

Jalankan cmdlet Get-OrganizationAddIn seperti yang diperlihatkan di bawah ini untuk mendapatkan detail tentang semua add-in yang diunggah ke penyewa, termasuk ID produk add-in.

Get-OrganizationAddIn

Jalankan cmdlet Get-OrganizationAddIn dengan nilai untuk parameter ProductId guna menentukan add-in mana yang ingin Anda lihat detailnya.

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

Untuk mendapatkan detail lengkap semua add-in juga grup dan pengguna yang ditetapkan, hubungkan output cmdlet Get-OrganizationAddIn ke cmdlet Format-List seperti yang diperlihatkan dalam contoh berikut.

Get-OrganizationAddIn |Format-List

Mengaktifkan atau menonaktifkan add-in

Untuk menonaktifkan add-in sehingga pengguna dan grup yang ditetapkan kepadanya tidak memiliki akses lagi, jalankan cmdlet Set-OrganizationAddIn dengan mengatur parameter ProductId dan parameter Enabled ke $false, seperti yang diperlihatkan dalam contoh berikut.

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

Untuk mengaktifkan kembali add-in, jalankan cmdlet yang sama dengan mengatur parameter Enabled ke $true.

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

Menambahkan atau menghapus pengguna dari add-in

Untuk menambahkan pengguna dan grup ke add-in tertentu, jalankan cmdlet Set-OrganizationAddInAssignments dengan parameter ProductId, Add, dan Members. Pisahkan alamat email anggota dengan tanda koma.

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

Untuk menghapus pengguna dan grup, jalankan cmdlet yang sama menggunakan parameter Remove.

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

Untuk menetapkan add-in ke semua pengguna pada penyewa, jalankan cmdlet yang sama menggunakan parameter AssignToEveryone dengan nilai yang diatur ke $true.

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

Untuk tidak menetapkan add-in ke semua orang dan kembali ke pengguna dan grup yang sebelumnya telah ditetapkan, jalankan cmdlet yang sama dan nonaktifkan parameter AssignToEveryone dengan mengatur nilainya ke $false.

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

Memperbarui add-in

Untuk memperbarui add-in dari manifes, jalankan cmdlet Set-OrganizationAddIn dengan parameter ProductId, ManifestPath, dan Locale, seperti yang diperlihatkan dalam contoh berikut.

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

Catatan: Add-in yang diunggah dari Bursa Office akan diperbarui secara otomatis dalam beberapa hari dari pembaruan terbaru yang tersedia di Bursa Office.

Menghapus add-in

Untuk menghapus add-in, jalankan cmdlet Remove-OrganizationAddIn dengan parameter ProductId, seperti yang diperlihatkan dalam contoh berikut.

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

Mendapatkan bantuan mendetail untuk setiap cmdlet

Anda dapat melihat bantuan mendetail untuk setiap cmdlet menggunakan cmdlet Get-help. Misalnya, cmdlet berikut menyediakan informasi mendetail tentang cmdlet Remove-OrganizationAddIn.

Get-help Remove-OrganizationAddIn -Full
Kembangkan keterampilan Anda
Jelajahi pelatihan
Dapatkan fitur baru terlebih dahulu
Gabung ke Office Insiders

Apakah informasi ini bermanfaat?

Terima kasih atas umpan balik Anda!

Terima kasih atas umpan balik Anda! Sepertinya menghubungkan Anda ke salah satu agen dukungan Office kami akan sangat membantu.

×