PowerShell で Outlook メールバナーを有効にする
Glasswall Halo に Exchange Online へのアクセスを許可するのではなく、Outlook メール バナーを外部で管理したい場合は、スタンドアロンで使用できる PowerShell スクリプトが用意されています:
- Install-HaloOutlookBanner.ps1
- Invoke-HaloOutlookBannerSynchronization.ps1
- Remove-DistroGroupMember.ps1
前提条件
- Exchange Online の認証情報を準備してください。対話型ログイン用のユーザー名/メール アドレス、または PFX 証明書のいずれかです
ExchangeOnlineManagementモジュールがまだ存在しない場合はインストールしてください(不足している場合、スクリプトが自動的にインストールします)
手順 1 — Outlook バナーをインストールする
Install-HaloOutlookBanner.ps1 を実行して、Distribution Group と Transport Rule を作成します。
Exchange Online で認証する
- 対話型ブラウザー ログインを使用する(推奨)
powershell .\Install-HaloOutlookBanner.ps1 -UserPrincipalName "[email protected]"
OR
- PFX 証明書を使用する
powershell .\Install-HaloOutlookBanner.ps1 -ExchangeCertificatePath "C:\path\to\certificate.pfx" -ExchangeAppId "your-azure-app-id" -ExchangeOrganization "contoso.onmicrosoft.com"
ステップ 2 — 配布グループをHalo monitorsと同期する
トランスポート ルールはキャッシュされます
注
Transport Rule は Distribution Group をキャッシュし、その有効期限は 4 時間後です。変更が反映されるまで最大 4 時間かかる場合があります。
monitor に変更を加えた際は、Distribution Group の同期を維持するために Invoke-HaloOutlookBannerSynchronization.ps1 を実行してください。
Exchange Online での認証
- 対話型ブラウザーログインを使用する(推奨)
powershell .\Invoke-HaloOutlookBannerSynchronization.ps1 -HaloUri "<halo-url>" -NoAuth -UserPrincipalName "<email-address>"
OR
- 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"
ヒント
必要に応じて、-NoAuth を次のいずれかに置き換えてください: -HaloToken(bearer token)または -HaloCredential(basic auth)