Lewati ke konten utama

Mengaktifkan banner email Outlook melalui PowerShell

Jika Anda lebih memilih mengelola banner email Outlook secara eksternal daripada memberikan Glasswall Halo akses ke Exchange Online, skrip PowerShell disediakan untuk penggunaan mandiri:

Prasyarat

  • Siapkan detail autentikasi Exchange Online Anda — baik nama pengguna/email (untuk login interaktif) atau sertifikat PFX
  • Instal modul ExchangeOnlineManagement jika belum ada (skrip akan menginstalnya secara otomatis jika tidak ditemukan)

Langkah 1 — Instal banner Outlook

Jalankan Install-HaloOutlookBanner.ps1 untuk membuat Distribution Group dan Transport Rule.

Autentikasi dengan Exchange Online

  • Menggunakan login browser interaktif (disarankan) powershell .\Install-HaloOutlookBanner.ps1 -UserPrincipalName "[email protected]"

OR

  • Menggunakan sertifikat PFX powershell .\Install-HaloOutlookBanner.ps1 -ExchangeCertificatePath "C:\path\to\certificate.pfx" -ExchangeAppId "your-azure-app-id" -ExchangeOrganization "contoso.onmicrosoft.com"

Langkah 2 — Sinkronkan grup distribusi dengan monitor Halo

Aturan transport di-cache

catatan

Transport Rule akan menyimpan cache Distribution Group, yang kedaluwarsa setelah 4 jam. Perubahan dapat memerlukan waktu hingga 4 jam untuk berlaku.

Jalankan Invoke-HaloOutlookBannerSynchronization.ps1 setiap kali perubahan monitor dilakukan, agar Distribution Group tetap sinkron.

Autentikasi dengan Exchange Online

  • Menggunakan login browser interaktif (disarankan) powershell .\Invoke-HaloOutlookBannerSynchronization.ps1 -HaloUri "<halo-url>" -NoAuth -UserPrincipalName "<email-address>"

OR

  • Menggunakan sertifikat PFX powershell .\Invoke-HaloOutlookBannerSynchronization.ps1 -HaloUri "https://your-halo-instance.com" -NoAuth -ExchangeCertificatePath "C:\path\to\certificate.pfx" -ExchangeAppId "your-azure-app-id" -ExchangeOrganization "contoso.onmicrosoft.com"
tip

Ganti -NoAuth jika diperlukan, dengan: -HaloToken (bearer token) atau -HaloCredential (basic auth)