メイン コンテンツにスキップ

PowerShell で Outlook メールバナーを有効にする

Glasswall Halo に Exchange Online へのアクセスを許可するのではなく、Outlook メール バナーを外部で管理したい場合は、スタンドアロンで使用できる PowerShell スクリプトが用意されています:

前提条件

  • 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)