コンテンツにスキップ
Look Service Manual

HABエクスポートツール

HABエクスポートツールは、階層型アドレス帳(HAB)のデータをエクスポートする際に利用するツールです。
エクスポートしたデータをAddressLookにインポートする手順については「出力したCSVファイルのインポート手順について」をご確認ください。

準備

Section titled “準備”

システム条件

Section titled “システム条件”

HABエクスポートツールのシステム条件につきましては、以下のリンクからご参照ください。
システム条件


ダウンロード

Section titled “ダウンロード”

HABエクスポートツールは、AddressLook WebサイトまたはAddresLook 管理サイトからダウンロードすることができます。


・AddressLook Webサイトからダウンロード

  1. 管理者アカウントで、AddressLook Webサイトにサインインします。
    https://www.addresslook.net/
  2. 「管理」タブをクリックします。
  3. 項目「HABエクスポートツール」内の「HABエクスポートツール」と「証明書」をクリックし、ダウンロードします。


・AddresLook 管理サイトからダウンロード

  1. 管理者アカウントで、AddresLook 管理サイトにサインインします。
    https://v2.addresslook.net/admin
  2. 左メニューの「管理者用」をクリックします。
  3. 項目「HABエクスポートツール」内の「HABエクスポートツール」ボタンと「証明書」ボタンをクリックし、ダウンロードします。


初期設定

Section titled “初期設定”

HABエクスポートツール初回利用時のみ実施する作業です。
2回目以降は「HABエクスポートツールの利用方法」をご参照ください。

Microsoft Entraアプリケーションの登録

Section titled “Microsoft Entraアプリケーションの登録”

Microsoft Entra管理センターにてMicrosoft Entraアプリケーションの登録を実施します。

・アプリの新規登録

  1. Microsoft Entra 管理センターに管理者アカウントでサインインし、Microsoft Entra 管理センターを開きます。
    https://entra.microsoft.com/
  2. 「アプリケーション」メニューから、「アプリの登録」をクリックします。
  3. 「新規登録」をクリックします。


  4. 「アプリケーションの登録」画面で以下の設定を行い、「登録」ボタンをクリックします。
    • 名前：アプリケーションの名称を入力します。(例：AddressLook_HABExport)
    • サポートされているアカウントの種類：「この組織ディレクトリのみに含まれるアカウント」を選択します。


・証明書の配置

  1. Microsoft Entra 管理センターに管理者アカウントでサインインします。
    https://entra.microsoft.com/
  2. 「アプリケーション」メニューから、「アプリの登録」をクリックします。
  3. 「すべてのアプリケーション」をクリックし、「アプリの新規登録」作業で作成したアプリケーションをクリックします。　　
  4. サイドメニューの「証明書とシークレット」をクリックします。
  5. 「証明書」タブを開き、「証明書のアップロード」をクリックします。

  6. 「証明書のアップロード」画面で、ダウンロードしたHABエクスポートツールの証明書フォルダに含まれる「AddressLookConsoleCert.cer」ファイルを選択し、アップロードします。
    ※アップロードする証明書ファイルは、cerファイルを使用します。
  7. 「追加」ボタンをクリックします。
  8. ダウンロードしたHABエクスポートツールの証明書フォルダに含まれる「AddressLookConsoleCert.pfx」ファイルを、アプリを使用する環境の任意の場所に配置します。
    例：C:\work\AddressLook\AddressLookConsoleCert.pfx
    ※アプリを使用する環境に配置する証明書ファイルは、pfxファイルを使用します。

・マニフェストの編集

  1. Microsoft Entra 管理センターに管理者アカウントでサインインします。

    https://entra.microsoft.com/

  2. 「アプリケーション」メニューから、「アプリの登録」をクリックします。

  3. 「すべてのアプリケーション」をクリックし、「アプリの新規登録」作業で作成したアプリケーションをクリックします。

  4. サイドメニューの「マニフェスト」をクリックします。



  5. 「マニフェスト」画面から「requiredResourceAccess」セクションまで下にスクロールし、以下の設定に置き換えます。

    {
                "resourceAppId": "00000002-0000-0ff1-ce00-000000000000",
                "resourceAccess": [
                    {
                        "id": "dc50a0fb-09a3-484d-be87-e023b12c6440",
                        "type": "Role"
                    }
                ]
            }

6. 「マニフェスト」画面で「保存」をクリックします。


・APIアクセス許可の設定

  1. Microsoft Entra 管理センターに管理者アカウントでサインインします。

    https://entra.microsoft.com/

  2. 「アプリケーション」メニューから、「アプリの登録」をクリックします。

  3. 「すべてのアプリケーション」をクリックし、「アプリの新規登録」作業で作成したアプリケーションをクリックします。　　

  4. サイドメニューの「APIのアクセス許可」をクリックします。

  5. 「アクセス許可の追加」をクリックします。



  6. 「APIアクセス許可の要求」画面で「Microsoft Graph」をクリックし、「委任されたアクセス許可」を選択します。



  7. 以下のアクセス許可を選択します。

    アクセス許可用途
    User：User.Read認証時に使用します。

  8. 「アクセス許可の追加」ボタンをクリックします。

  9. 「APIアクセス許可の要求」画面で「Microsoft Graph」をクリックし、「アプリケーションの許可」を選択します。



  10. 以下のアクセス許可を選択します。

    アクセス許可用途
    Domain：Domain.Read.All認証時に使用します。
    Group：Group.Read.Allグループ情報取得時に使用します。
    GroupMember：GroupMember.Read.Allグループメンバー取得時に使用します。
    Organization：Organization.Read.All組織および関連するリソースの取得時に使用します。
    User：User.Read.All認証時に使用します。
    User：User.ReadBasic.All認証時に使用します。

  11. 「アクセス許可の追加」ボタンをクリックします。

  12. 左メニューの「表示数を増やす」をクリックします。



  13. 「役割と管理者」メニューの「役割と管理者」をクリックします。

  14. ロールで「Exchangeの管理者」をクリックします。



  15. 「Exchangeの管理者」画面で「割り当ての追加」をクリックします。



  16. 「検索」で「アプリの新規登録」作業で作成したアプリケーションの名前を入力し、表示されたアプリを選択した後に「追加」ボタンをクリックします。

  17. アクセス許可の追加後、「APIのアクセス許可」画面で「管理者の同意を与えます」をクリックします。



  18. 確認メッセージが表示されるので、「はい」をクリックします。

アプリの設定

Section titled “アプリの設定”

ダウンロードしたHABエクスポートツールのフォルダに含まれる「HABGroupExportTool.exe.config」ファイルをテキストエディタで開き、以下の項目の値を設定します。
※No.5については値の変更は不要です。

No.項目概要設定例
1FileName出力されるCSVファイル名を入力します。
※ファイル名には拡張子を含めないでください。		Address
2ida:TenantMicrosoft Entra テナントIDを入力します。
値の確認方法につきましては、Microsoft社の公式情報をご参照ください。
テナント ID とプライマリ ドメイン名を確認する		11111111-1111-1111-1111-111111111111
3ida:TenantNameMicrosoft Entra プライマリドメイン名を入力します。
値の確認方法につきましては、Microsoft社の公式情報をご参照ください。
テナント ID とプライマリ ドメイン名を確認する		○○.onmicrosoft.com
4ida:ClientId登録したアプリのアプリケーション(クライアント)IDを入力します。
値の確認方法につきましては、Microsoft社の公式情報をご参照ください。
アプリケーション ID (クライアント ID)		11111111-1111-1111-1111-111111111111
5ida:AADInstanceAzure クラウド インスタンス を入力します。https://login.microsoftonline.com/{0}
※上記の値は固定値のため、値の変更は不要です。
6ida:CertPath「証明書の配置」で配置した証明書の、拡張子までを含めた絶対パスを入力してください。C:\work\AddressLook\AddressLookConsoleCert.pfx
7GroupIdCSVファイルに出力する最上位グループ(部署)のオブジェクトIDを入力してください。
値の確認方法につきましては、「最上位グループ(部署)のオブジェクトID」をご参照ください。		11111111-1111-1111-1111-111111111111
8~22UserItem01~UserItem15CSVファイルのUserItem01～15項目に出力するユーザーのEntra IDプロパティ名を入力します。CreatedDateTime

最上位グループ(部署)のオブジェクトID
HABエクスポートツールの初期設定で入力する、最上位グループ(部署)のオブジェクトIDの確認方法について説明します。

  1. Microsoft Entra 管理センターに管理者アカウントでサインインします。
    https://entra.microsoft.com/
  2. 「グループ」メニューから、「すべてのグループ」をクリックします。
  3. 「検索」で情報を出力したい最上位グループ(部署)の名前を入力し、クリックします。
  4. 「基本情報」の中にある「オブジェクトID」が「アプリの設定」のNo.7で入力する値となります。


Exchange Online PowerShell モジュールのインストール

Section titled “Exchange Online PowerShell モジュールのインストール”

・Exchange Online PowerShell モジュールを読み込む

  1. PowerShellを管理者権限で起動します。
  2. 以下のコマンドを入力し、実行します。
    Terminal window
    Import-Module ExchangeOnlineManagement

・Exchange Online PowerShell モジュールの確認方法

  1. PowerShellを管理者権限で起動します。
  2. 以下のコマンドを入力し、実行します。
    Terminal window
    Get-Module
  3. 「Name」に「ExchangeOnlineManagement」が存在することを確認します。

HABエクスポートツールの利用方法

Section titled “HABエクスポートツールの利用方法”

HABエクスポートツールの利用方法について説明します。

HABエクスポートツールの実行

Section titled “HABエクスポートツールの実行”
  1. 「HABGroupExportTool.exe」を右クリックし、「管理者として実行」をクリックします。
  2. アプリが実行され、アプリと同一階層にCSVファイルが作成されます。

出力されるCSVファイルについて

Section titled “出力されるCSVファイルについて”

出力されるCSVファイルについて説明します。

出力先

Section titled “出力先”

HABエクスポートツールアプリの存在する階層と同一階層にCSVファイルが出力されます。

出力対象

Section titled “出力対象”

出力対象は「部署情報」と「アドレス情報」になります。

部署情報

Section titled “部署情報”
  • AddressLookに表示する部署情報を指します。
  • 「アプリの設定」のNo.7「GroupId」に設定されたグループを、最上位の部署として出力します。
  • グループのメンバーとして登録されているグループを、配下の部署として出力します。
  • グループの情報はMicrosoft Entra IDから取得し、出力します。

アドレス情報

Section titled “アドレス情報”
  • AddressLookに表示するユーザー、リソース(会議室・備品)、連絡先情報を指します。
  • 「アプリの設定」のNo.7「GroupId」に設定されたグループのメンバー(グループ以外)を、アドレス情報として出力します。
  • メンバーが所属するグループを、メンバーの所属部署として出力します。
  • Microsoft Entra IDにて、ユーザーが無効なアカウント(AccountEnable属性)の場合は、出力対象外とします。
  • 表示名、メールアドレスが未設定のアカウントは出力対象外とします。


出力形式

Section titled “出力形式”

  • CSVファイルは「アプリの設定」で入力したファイル名にて出力されます。

  • 出力されるCSVファイルの拡張子は「.csv」となります。

  • 出力されるCSVファイルは上書き保存となります。

  • CSVファイルには以下の項目が出力されます。

    No.項目名出力種別内容
    1Operatorグループ/ユーザーadd
    2ClassObjectグループ/ユーザーグループの場合：Hierarchy
    ユーザーの場合：Address
    3DisplayNameグループ/ユーザー表示名(最大255文字)
    設定必須項目です。
    4DisplayNameKana表示名(フリガナ)(最大255文字)
    5Priorityグループ/ユーザー表示順(0~999999)
    ※値の大きいものほど上位に表示します。
    6ParentHierarchyPathグループ/ユーザー所属する親グループ階層
    7Addressユーザーメールアドレス(最大300文字)
    設定必須項目です。
    8Snユーザー姓(最大255文字)
    9GivenNameユーザー名(最大255文字)
    10SnKana姓(フリガナ)(最大255文字)
    11GivenNameKana名(フリガナ)(最大255文字)
    12MainNicknameユーザーエイリアス(最大300文字)
    13Titleユーザー役職(最大255文字)
    14Departmentユーザー部署(最大255文字)
    15Companyユーザー会社名(最大255文字)
    16PhysicalDeliveryOfficeNameユーザー事業所(最大255文字)
    17LユーザーMicrosoft Entra IDの市区町村＋番地(最大255文字)
    18TelephoneNumberユーザー電話番号(最大255文字)
    19AddressTypeユーザーアドレス種別
    • 2:ユーザー
    • 3:連絡先
    • 4:リソース(会議室・備品)
    20Descriptionグループグループの説明(最大255文字)
    21UpdateDisplayName更新後の表示名
    22UpdateAddress更新後のメールアドレス
    23UpdateParentHierarchyPath更新後の親グループ階層
    24~38UserItem01~UserItem15ユーザー「アプリの設定」で設定したNo.8~No.22の項目名のプロパティを取得します。

    ※出力するデータの文字数が最大文字数を超過する場合は、超過した分を切り捨てて出力されます。

ログについて

Section titled “ログについて”

HABエクスポートツール利用時に出力されるログファイルについて説明します。

出力先

Section titled “出力先”

HABエクスポートツールアプリの存在する階層と同一階層にログファイルが出力されます。

出力形式

Section titled “出力形式”
  • ログファイルは「HABGroupExportTool_log」というファイル名で出力されます。
  • 出力されるログファイルの拡張子は「.log」となります。
  • 出力されるログファイルは上書き保存となります。

出力したCSVファイルのインポート手順について

Section titled “出力したCSVファイルのインポート手順について”

HABエクスポートツールを使用して出力したCSVファイルをインポートする手順については、以下をご参照ください。

  • GUIで実施する手順
    「組織階層情報メンテナンスツール」の「CSVに関する機能」をご参照ください。
  • コマンドで実施する手順
    「組織階層情報メンテナンスツール(コマンド)」の「CSVに関する機能」をご参照ください。