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:
- Install-HaloOutlookBanner.ps1
- Invoke-HaloOutlookBannerSynchronization.ps1
- Remove-DistroGroupMember.ps1
Prasyarat
- Siapkan detail autentikasi Exchange Online Anda — baik nama pengguna/email (untuk login interaktif) atau sertifikat PFX
- Instal modul
ExchangeOnlineManagementjika 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)