この記事では、Microsoft Edgeブラウザ用のWindows Active Directory（AD）ネットワークでのPendo Launcherのインストール手順を説明します。
前提条件
この記事は、Active DirectoryにMicrosoft Edgeの管理用テンプレートをインストール済みであることを前提としています。Microsoft Edgeの管理用テンプレートは、ウェブサイト上（ビジネス向けMicrosoft Edgeのダウンロードおよび設定）で確認できます。
管理用テンプレートのインストール方法については、Windowsでグループポリシー管理用テンプレートのセントラルストアを作成および管理する方法を参照してください。Edgeの導入に関するインタラクティブなウォークスルーについては、Microsoft社の記事Microsoft Edgeの導入および設定を参照してください。
ドメイン管理者のインストールプロセス
1. 使用しているPendo LauncherのバージョンのMicrosoft Edge拡張機能IDを特定します。
2. Active Directory（AD）グループポリシーオブジェクト（GPO）を使用して、Pendo拡張機能を展開します。
3. 拡張機能APIキーのレジストリキーを作成します。
4. PowerShellログインスクリプトを使用して、訪問者IDを設定します。
5. Edgeでポリシーが正しく設定されていることを確認します。
Microsoft Edge拡張機能IDを特定する
この記事では、Microsoft Edge拡張機能IDを「拡張機能ID」と表記します。
Pendo Launcherの拡張機能IDはすべてのお客様に共通で、lgpofjmgggolmabddgdmbgipcnblpnbmです。拡張機能IDはPendo LauncherのMicrosoft Edgeアドオンのリストでも確認できます：https://microsoftedge.microsoft.com/addons/detail/pendo-launcher/lgpofjmgggolmabddgdmbgipcnblpnbm
この拡張機能IDはメジャーバージョンアップやマイナーバージョンアップを経ても変更されませんが、Microsoft Edgeアドオンリストには他の組織で使用することを目的とした別のバージョンのPendo Launcherが配布されている場合があります。この値は、Edgeでedge://extensionsと入力することで確認できます。
グループポリシーを使用してPendo拡張機能をActive Directory環境に展開する
ADの「グループポリシーの管理」を通じてPendo拡張機能を展開します。
1. run.exeアプリケーションを開きます。
画面左下のWindowsアイコンを右クリックし、メニューから［実行（Run）］を選択します。
2. グループポリシーの管理コンソールを開きます。
「GPMC.msc」を［開く（Open）］フィールドに入力し、［OK］を選択します。
3. 新しいグループポリシーオブジェクト（GPO）を作成します。
左側のナビゲーションから［グループポリシーオブジェクト（Group Policy Object）］を右クリックし、メニューから［新規（New）］を選択します。
4. 新しいGPOにわかりやすい名前を付けて、後でもう一度見つけられるようにします（「PendoAdoptInstall」など）。
5. 新しい空のポリシーを右クリックして、［編集（Edit）］を選択します。
6. 自動インストールされたアプリと拡張機能のリストを開きます。
［ポリシー（Policies）］>［セントラルストアから取得した管理用テンプレートポリシー定義（ADMXファイル）（Administrative Templates Policy Definitions (ADMX files) retrieved from the central store）］>［Microsoft Edge］>［拡張機能（Extensions）］に移動します。
次に、［サイレントインストールされる拡張機能の制御（Control which extensions are installed silently）］の設定を開きます。
7. ポリシーを有効にします。
［サイレントインストールされる拡張機能/アプリのIDと更新URL（Extension/App IDs and update URLs to be silently installed）］で［表示…（Show…）］を選択します。次に、セミコロンで連結された拡張機能IDと、拡張機能を更新するためのURLを入力します。URLは通常、明示的に別のURLが指定されていない限り、lgpofjmgggolmabddgdmbgipcnblpnbm;https://edge.microsoft.com/extensionwebstorebase/v1/crxです。
8. ［OK］ を選択してから［適用（Apply）］を選択します。
これで、ドメイン内のすべてのマシンにPendo拡張機能を自動的にインストールするポリシーが作成されました。
拡張機能APIキーのレジストリキーを作成する
レジストリキーを作成して、ネットワーク内のすべてのマシンのレジストリにAPIキーを自動的に適用します。
まず、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］>［拡張アプリ（Extension Apps）］の下にあるPendoサブスクリプションで、Pendo拡張機能APIキーを見つけます。
次に、上記のグループポリシーを使用してPendo拡張機能をActive Directory環境に展開するの手順の一部として作成されたGPOで、以下を実行します。
1. ［コンピューターの構成（Computer Configuration）］>［基本設定（Preferences）］>［Windowsの設定（Windows Settings）］>［レジストリ（Registry）］に移動します。
2. メニューから［新規（New）］>［レジストリ項目（Registry Item）］を選択します。
3. ［新しいレジストリのプロパティ］ウィンドウに、以下を入力します。
-
- ［ハイブ］を「HKEY_LOCAL_MACHINE」に設定します。
- ［キーパス（Key Path）］を「SOFTWARE\Policies\Microsoft\Edge\3rdparty\extensions\lgpofjmgggolmabddgdmbgipcnblpnbm\policy」に設定します。
- ［値の名前］を「APIKey」に設定します。
- ［値のデータ］をPendo拡張機能（サブスクリプション）APIキーに設定します。
PowerShellを使用して訪問者IDを設定する
PowerShellログオンスクリプトを使用して、ユーザーの訪問者IDとメタデータを設定します。
1. 以下の内容で「PendoUserInstall.ps1」という名前の新しいPowerShellスクリプトを作成します。
$visitorId = $env:username + "@yourdomain.com"
$visitorJson= "{ `"id`": `"$($visitorId)`" }"
if(!(Test-Path "C:\temp")) {
New-Item "C:\" -Name "temp" -ItemType "directory" -ErrorAction SilentlyContinue
}
New-Item "C:\temp\PendoMetadata.txt"
Set-Content -Path "C:\temp\PendoMetadata.txt" -Value $visitorJson
2. PowerShellスクリプトをドメインの共有ネットワークフォルダーのNETLOGONフォルダーに保存し、認証ユーザー（Authentication Users）に読み取り（Read）および読み取りと実行（Read & Execute）のアクセス許可を設定します。
3. 「PendoAdminInstall.ps1」という名前の別のPowerShellスクリプトを以下の内容で作成し、ドメインの共有ネットワークフォルダ内のNETLOGONフォルダに、同じ読み取りおよび読み取りと実行のアクセス許可で保存します。
このスクリプトは、ユーザーアカウントが作成したファイルに基づいてレジストリ値を追加します。管理者として実行する際、そのデータにアクセスすることはできません。
# メタデータファイルを待つ
while (!(Test-Path"C:\temp\PendoMetadata.txt")) { Start-Sleep10 }
# メタデータをレジストリに追加
$visitorJson = Get-Content -Path "C:\temp\PendoMetadata.txt"
$registryPath = "HKLM:\Software\Policies\Microsoft\Edge\3rdparty\extensions\lgpofjmgggolmabddgdmbgipcnblpnbm\policy"
New-ItemProperty -Path $registryPath -Name "visitor" -Value $visitorJson -Type ExpandString
# クリーンアップ
Remove-Item -Path "C:\temp\PendoMetadata.txt"
Remove-Item -Path "C:\temp"
4. 作成したGPOに戻ります。
5. ［ユーザーの構成］>［ポリシー］>［Windows の設定］>［スクリプト(ログオン/ログオフ)］に移動し、［ログオン］を選択します。
6.「powershell.exe」という名前の新しいスクリプトを追加します。-nonInteractive -executionPolicy Bypass -file \\YOURSHARE\NETLOGON\PendoUserInstall.ps1”のパラメーターを使用します。
7.［OK］を選択してから［適用（Apply）］を選択します。
8. ログオンのプロパティのウィンドウを閉じます。
9. 管理者スクリプトを追加して実行します。
このスクリプトはシステム管理者によって実行されるため、起動時に実行されます。これを行うには、 ［コンピューターの構成］>［ポリシー］>［Windows の設定］ > ［スクリプト (スタートアップ/シャットダウン)］に移動し、 ［スタートアップ］を選択します。
10.「PendoAdminInstall.ps1」について、手順4～9を繰り返します。
新しいGPOをネットワークに追加する
新しく作成したポリシーをネットワークに適用します。
1. ［グループ ポリシーの管理］コンソールに戻ります。
2. ドメインを右クリックします。
3. ［既存の GPO のリンク…］を選択します。
4. 開いたダイアログボックスで、グループポリシーオブジェクトの下で変更したGPOを見つけて選択し、［OK］を選択します。
GPOは10分以内にドメインに反映されます。または、ネットワークでポリシーの更新を強制することもできます。
ポリシーが正しく設定されていることを確認する
ポリシーが適用されたマシンにログインし、PowerShellで次のコマンドを実行します：
gpresult /r
このコマンドは、以下のような内容を返します。以下の例では、ポリシーの名前はPendoAdoptInstallで、インストールは成功しています。
Pendo拡張機能がデータを収集していることを確認する
ブラウザのヘッダーのPendo Launcherアイコンの色は、拡張機能のデータ収集がアクティブかどうかを示します。
Pendo Launcherアイコンがピンクの場合はアクティブで、データを収集しています。Pendo Launcherアイコンがグレーの場合は非アクティブで、データを収集していません。
メタデータが正しくエージェントに送信されていることを確認するには、Pendo Launcherの拡張アイコンを右クリックし、［デバッグ情報の表示（Show Debug Info）］をクリックします。
Pendo Launcherが適切に情報を収集している場合は、「Pendo Launcherはこのページのデータを収集しています（The Pendo Launcher is collecting data on this page）」というメッセージが表示されます。これは、Pendo Launcherが現在のウェブページの情報を収集するように設定されていることを意味します。
Pendo Launcher がページの情報を収集していない場合、「Pendo Launcherはこのページのデータを収集していません（The Pendo Launcher is NOT collecting information on this page.）」というメッセージが表示されます。
IDとメタデータが正しく設定されていることを確認するには、以下の操作を行います。
1. visitorStringが全体を通して一意であり、コンピューターの現在のユーザーを正しく識別していることを確認します。
2. ［構成情報の表示（Show Configuration Info）］を選択して、拡張機能内で構成されている設定を展開します。
3. ［拡張機能の設定を再取得（Re-fetch extension settings）］を選択し、拡張機能に最新の設定が適用されていることを確認します。
4. ［IT管理の構成（IT-Managed Config）］セクションで、データが予想される展開構成と一致していることを確認します。
よくある質問
なぜ共通のIDが重要なのですか？
これらのIDは、各訪問者とアカウントを識別します。訪問者IDとアカウントIDのいずれかが重複している場合、複数のユーザーのデータが1つのIDに集約されてしまう可能性があります。
なぜメタデータが重要なのですか？
メタデータを利用することで、豊富なインサイトをもたらす強力なセグメントを作成し、ガイドをパーソナライズすることができます。Pendoに渡されたあらゆるメタデータに基づいて、訪問者をセグメント化することができます。
拡張機能はどのくらいの頻度で更新されますか？
ChromeとEdgeは、拡張機能の更新を自動的にチェックします。たとえば、Chromeは12時間ごとにチェックします。ChromeとEdgeは、新しいバージョンが利用可能になったときに拡張機能を自動的に更新するように構成することもできます。
Pendoは、定期的なエージェントの更新や機能拡張など、Pendoブラウザ拡張機能の更新と保守を行っています。拡張機能の更新は、対応するブラウザの所有者（Chromeウェブストアなど）に送信され、公開される前にセキュリティ監査を受けます。
詳しくは、訪問者とアカウントのメタデータをご覧ください。