IM and Presence Service 設定および管理、リリース 12.5(1)

偏向のない言語

この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。

翻訳について

このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。

マニュアルのコンテンツ
このマニュアル内で検索
ご利用いただける言語
Download Options

Book Title

IM and Presence Service 設定および管理、リリース 12.5(1)

Chapter Title

連絡先リストの一括管理

検索結果

Updated:
2020年7月1日

章のタイトル： 連絡先リストの一括管理

連絡先リストの一括管理

一括管理の概要

IM and Presence サービス一括管理ツールを使用すると、多数の IM and Presence サービス ユーザに対して、以下の一括処理を実行することができます。

  • Microsoft 移行プロセスで使用するために、ユーザの連絡先 ID 名を変更します。

  • 特定のノードまたはプレゼンス冗長グループに属するユーザの連絡先リストおよび非プレゼンスの連絡先リストを CSV データ ファイルにエクスポートします。


    （注）  

    非プレゼンス連絡先は、IM アドレスを持たない連絡先であり、この手順でのみエクスポートできます。

  • エクスポートしたユーザ連絡先リストと非プレゼンス連絡先リストを別のクラスタの別のノードまたはプレゼンス冗長グループにインポートすることもできます。新規ユーザーの連絡先リストを事前入力するか、既存の連絡先リストに追加します。

  • この機能によって、クラスタ間のユーザの移行が容易になります。

一括管理の要件

ユーザ連絡先リストをインポートする前に：

  1. Cisco Unified Communications Manager でユーザをプロビジョニングします。

  2. Cisco Unified Communications Manager でユーザに IM and Presence Service のライセンスが供与されていることを確認します。


（注）  

デフォルトの連絡先リストのインポート速度は、仮想マシン展開のハードウェアのタイプに基づいています。[Cisco Unified CM IM and Presence Administration（Cisco Unified CM IM and Presence の管理）] > [System（システム）] > [Service Parameters（サービス パラメータ）] > [Cisco Bulk Provisioning Service] を選択して、連絡先リストのインポート レートを変更できます。ただし、デフォルトのインポート レートを大きくすると、IM and Presence Service で CPU 使用率とメモリ使用率が高くなります。

一括管理タスク フロー

手順

  コマンドまたはアクション 目的
ステップ 1

ユーザ連絡先 ID の一括名前変更

CSV ファイルをアップロードして、ユーザのリストの連絡先 ID 名を変更します。
ステップ 2

ユーザ連絡先リストと非プレゼンス連絡先リストの一括エクスポート

ユーザの連絡先リストを CSV ファイルにエクスポートするには、以下の手順を実行します。その後、一括管理を使用して、ユーザの連絡先リストを別のノードまたはクラスタに移動することができます。

ステップ 3

以下の手順を実行して、ユーザ連絡先リストを IM and Presence Service にインポートします。

ユーザ連絡先 ID の一括名前変更


注意    

連絡先 ID の一括名前変更は、Microsoft Server（たとえば Lync）から IM and Presence サービス サービスへのユーザの移行で使用されます。このツールのユーザ移行プロセスの一部としての使用方法についての詳しい手順については、Cisco.com の『Partitioned Intradomain Federation ガイド』を参照してください。それ以外の状況での、このツールの使用はサポートされません。

CSV ファイルをアップロードして、ユーザのリストの連絡先 ID 名を変更します。

手順

ステップ 1

すべての連絡先リスト内で名前を変更するコンタクト ID のリストを含んだ CSV ファイルをアップロードします。

  1. {1}IM and Presence Service{1} のパブリッシャ ノードに移動します。

  2. Cisco Unified CM IM and Presence 管理で、一括管理 > ファイルのアップロード/ダウンロードを選択します。。

  3. [Add New（新規追加）] をクリックします。

  4. [Browse（参照）] をクリックして CSV ライセンス ファイルを配置し、選択します。入力ファイルの詳細については、ユーザ連絡先 ID の一括変更ファイルの詳細を参照してください。

  5. ターゲットとして [Contacts（連絡先）] を選択します。

  6. トランザクション タイプとして [Rename Contacts – Custom File（連絡先の名前変更 - カスタム ファイル）] を選択します。

  7. [Save（保存）] を選択してファイルをアップロードします。

ステップ 2

パブリッシャ ノードで、Cisco Unified CM IM and Presence 管理 > 一括管理 > 連絡先リスト > 連絡先の名前の変更を選択します。

ステップ 3

[File Name（ファイル名）] フィールドで、ユーザがアップロードしたファイルを選択します。

ステップ 4

次のいずれかのアクションを選択します。

  • 一括管理ジョブをただちに実行するには、[Run Immediately（すぐに実行）] を選択します。
  • 一括管理ジョブを実行する時間をスケジュールするには、[Run Later（後で実行）] をクリックします。一括管理ツールのスケジューリング ジョブの詳細については、Cisco Unified CM IM and Presence Administration のオンライン ヘルプを参照してください。
ステップ 5

[Submit（送信）] をクリックします。

ジョブをただちに実行するように選択した場合は、[Submit（送信）] をクリックするとジョブが実行されます。

次のタスク

ユーザ連絡先リストと非プレゼンス連絡先リストの一括エクスポート

ユーザ連絡先 ID の一括変更ファイルの詳細

このジョブを実行する前にアップロードするファイルは、以下の形式の CSV ファイルである必要があります。

<Contact ID>, <New Contact ID>

<Contact ID> が、既存の連絡先 ID であり、<New Contact ID> が連絡先 ID の新しい形式です。

プレゼンス トポロジのユーザ割り当てウィンドウで表示される <Contact ID> がユーザの IM アドレスです。

次に、1 つのエントリを持つ CSV ファイルのサンプルを示します。

Contact ID, New Contact ID
john.smith@example.com, jsmith@example.com

ユーザ連絡先リストと非プレゼンス連絡先リストの一括エクスポート

ユーザの連絡先リストを CSV ファイルにエクスポートするには、以下の手順を実行します。その後、一括管理を使用して、ユーザの連絡先リストを別のノードまたはクラスタに移動することができます。

  • 連絡先リスト：このリストは、IM and Presence 連絡先で構成されます。IM アドレスがない連絡先は、エクスポートされません（非プレゼンス連絡先リストをエクスポートする必要があります）。

  • 非プレゼンス連絡先リスト：このリストは、IM アドレスを持っていない連絡先で構成されます。

手順

ステップ 1

Cisco Unified CM IM and Presence 管理で、以下のいずれかを実行します。

  • 連絡先リストをエクスポートするには、一括管理 > 連絡先リスト > 連絡先リストのエクスポートを選択します。
  • 非プレゼンス連絡先リストをエクスポートするには、一括管理 > 非プレゼンス連絡先リスト > 非プレゼンス連絡先リストのエクスポート を選択し、次のステップはスキップします。
ステップ 2

連絡先リストのみ。連絡先リストをエクスポートするユーザを選択します。

  1. 連絡先リストのオプションのエクスポートの下で、連絡先リストのエクスポート先となるユーザのカテゴリを選択します。デフォルトでは、すべてのユーザの連絡先リストがエクスポートされます。

  2. 検索 をクリックして、ユーザ リストを表示して、次へ をクリックします。

ステップ 3

[File Name（ファイル名）] フィールドに、CSV ファイルの名前を入力します。

ステップ 4

ジョブ情報 の下で、このジョブをいつ実行するかを設定します。

  • すぐに実行：連絡先のリストを即座にエクスポートするには、このボタンをオンにします。
  • 後で実行：ジョブを実行する時間をスケジュールする場合は、このボタンをオンにします。このオプションでは、バルク管理 > ジョブスケジューラの [ジョブスケジューラ] ページを使用して、このジョブが実行される時間をスケジュールする必要があります。
ステップ 5

[送信（Submit）] をクリックします。

すぐに実行する を選択した場合は、エクスポート ジョブは即座に実行されます。
ステップ 6

エクスポート ファイルが作成された後のCSV ファイルのダウンロード：

  1. Cisco Unified CM IM and Presence 管理で、一括管理 > ァイルのアップロード/ダウンロードを選択します。

  2. [ 検索 をクリックしてエクスポート ファイルを選択します。

  3. 選択したものをダウンロードする をクリックして、アクセス可能なロケーションにファイルをダウンロードします。

エクスポート連絡先リストのファイルの詳細

次に、CSV ファイル エントリのサンプルを示します。

userA,example.com,userB,example.com,buddyB,General

BAT を使用すると、エクスポートする連絡先リストのユーザを検索して選択できます。ユーザ連絡先リストは次の形式の CSV ファイルにエクスポートされます。

<User ID>,<User Domain>,<Contact ID>,<Contact Domain>,<Nickname>,<Group Name>

次の表に、エクスポート ファイルのパラメータについて説明します。

パラメータ

説明

ユーザ ID（User ID）

IM and Presence サービス ユーザのユーザ ID。

（注）   

この値は、ユーザの IM アドレスのユーザ部分です。

User Domain（ユーザ ドメイン）

IM and Presence サービス ユーザのプレゼンス ドメイン。

（注）   

この値は、ユーザの IM アドレスのドメイン部分です。

例 1：bjones@example.com （bjones はユーザ ID、example.com はユーザ ドメインです。）

例 2 ： bjones @ usa @ example.com ： bjones @ usa はユーザ ID であり、example.com は、ユーザのドメインです。

Contact ID（連絡先 ID）

連絡先リスト エントリのユーザ ID。

Contact Domain（連絡先ドメイン）

連絡先リスト エントリのプレゼンス ドメイン。

Nickname（ニックネーム）

連絡先リスト エントリのニックネーム。

ユーザが連絡先のニックネームを指定しない場合、[Nickname（ニックネーム）] パラメータは空白です。

Group Name（グループ名）

連絡先リスト エントリが追加されるグループの名前。

ユーザの連絡先がグループに分けられていない場合、デフォルト グループ名が、[Group Name（グループ名）] フィールドに指定されます。

非プレゼンス連絡先リストのエクスポート ファイルの詳細

非プレゼンス ユーザ連絡先リストは次の形式の CSV ファイルにエクスポートされます。

<User JID>,<Contact JID>,<Group Name>,<Content Type>,<Version>,<Info>

次の表で、エクスポート ファイルのパラメータについて説明します。

パラメータ

説明

ユーザ JID（User JID）

ユーザ JID。これはユーザの IM アドレスです。

連絡先 JID（Contact JID）

連絡先リスト エントリのユーザ JID（利用できる場合）。それ以外の場合は UUID。

グループ名（Group Name）

連絡先リスト エントリが追加されるグループの名前。

コンテンツ タイプ（Content Type）

情報フィールドで使用される textmime タイプおよびサブタイプ。

バージョン（Version）

情報フィールドで使用されるコンテンツ タイプ。

情報（Info）

vCard 形式の連絡先リスト エントリの連絡先情報。

次に、CSV ファイル エントリのサンプルを示します。

user2@cisco.com,ce463d44-02c3-4975-a37f-d4553e3f17e1,group01,text/directory,3,BEGIN:VCARD
ADR;TYPE=WORK:ADR\;WORK:\;\;123 Dublin rd\,\;Oranmore\;Galway\;\;Ireland
EMAIL;TYPE=X-CUSTOM1;X LABEL=Custom:testuser01@test.com N:test;user;;; NICKNAME:pizzaguy01
ORG:ABC TEL;TYPE=WORK,VOICE:5323534535 TITLE:QA VERSION:3.0 END:VCARD

ユーザ連絡先リストの一括インポート

連絡先リストの最大サイズの確認

IM and Presence Service での連絡先リストの最大サイズとウォッチャの最大設定を確認します。[Maximum Contact List Size（連絡先リストの最大サイズ）] のシステム デフォルト値は 200、[Maximum Watchers（ウォッチャの最大数）] のシステム デフォルト値は 200 です。

ユーザ連絡先リストのインポート中に連絡先リストの最大サイズと最大のウォッチャの設定を無制限に設定することを推奨します。BAT を使用して連絡先リストをインポートする際に最大連絡先リストサイズを超える場合でも、この手順により、移行された各ユーザー連絡先リストがデータを損失せずに完全にインポートされます。すべてのユーザを移行した後は、[Maximum Contact List Size（連絡先リストの最大サイズ）] と [Maximum Watchers（ウォッチャの最大数）] の設定値を必要な値にリセットできます。

連絡先をインポートするユーザを含むクラスタについてのみ、連絡先リストの最大サイズを確認する必要があります。プレゼンス設定を変更する場合、変更はクラスタ内のすべてのノードに適用されます。したがって、クラスタ内の IM and Presence データベース パブリッシャ ノードでのみこれらの設定を変更する必要があります。

次のタスク

入力ファイルのアップロード

入力ファイルのアップロード

次の手順では、連絡先リストおよび非プレゼンス連絡先リストに BAT を使用して CSV 入力ファイルをアップロードする方法について説明します。

始める前に

連絡先リストの最大サイズの確認

手順
ステップ 1

Cisco Unified CM IM and Presence 管理で、一括管理 > ファイルのアップロード/ダウンロードを選択します。

ステップ 2

[Add New（新規追加）] をクリックします。

ステップ 3

[Browse（参照）] をクリックして CSV ライセンス ファイルを配置し、選択します。

ステップ 4

対象設定：
ステップ 5

トランザクション タイプ：トランザクション タイプを選択します。

  • 連絡先リストの入力ファイルをアップロードする場合は、ユーザの連絡先 - カスタムファイルのインポートを選択します。
  • 非プレゼンス連絡先リストの入力ファイルをアップロードする場合は、ユーザの非プレゼンス連絡先を選択する
ステップ 6

[保存（Save）] をクリックし、ファイルをアップロードします。

次のタスク

新しい一括管理ジョブの作成

連絡先リストのファイル インポートの詳細

入力ファイルは次の形式の CSV ファイルである必要があります。

<User ID>,<User Domain>,<Contact ID>,<Contact Domain>,<Nickname>,<Group Name>

次に、CSV ファイル エントリのサンプルを示します。

userA,example.com,userB,example.com,buddyB,General

次の表に、入力ファイルのパラメータについて説明します。

パラメータ

説明

User ID（ユーザ ID）

これは必須パラメータです。

IM and Presence Service ユーザのユーザ ID。これには、最大 132 文字を使用できます。

（注）   

この値は、ユーザの IM アドレスのユーザ部分です。

User Domain（ユーザ ドメイン）

これは必須パラメータです。

IM and Presence Service ユーザのプレゼンス ドメイン。これには、最大 128 文字を使用できます。

（注）   

この値は、ユーザの IM アドレスのドメイン部分です。

例 1：bjones@example.com （bjones はユーザ ID、example.com はユーザ ドメインです。）

例 2：bjones@usa@example.com （bjones@usa はユーザ ID、example.com はユーザ ドメインです。）

Contact ID（連絡先 ID）

これは必須パラメータです。

連絡先リスト エントリのユーザ ID。これには、最大 132 文字を使用できます。

Contact Domain（連絡先ドメイン）

これは必須パラメータです。

連絡先リスト エントリのプレゼンス ドメイン。次の制限は、ドメイン名の形式に適用されます。

  • 長さは 128 文字以下である必要があります

  • 数字、大文字と小文字、およびハイフン（-）だけ含めます

  • ハイフン（-）で開始または終了してはいけません

  • ラベルの長さは 63 文字以下である必要があります

  • トップ レベル ドメインは文字だけで、少なくとも 2 文字にする必要があります

Nickname（ニックネーム）

連絡先リスト エントリのニックネーム。これには、最大 255 文字を使用できます。

Group Name（グループ名）

これは必須パラメータです。

連絡先リスト エントリが追加されるグループの名前。これには、最大 255 文字を使用できます。
非プレゼンス連絡先リストのファイル インポートの詳細

入力ファイルは次の形式の CSV ファイルである必要があります。

<User JID>,<Contact JID>,<Group Name>,<Content Type>,<Version>,<Info>

次に、CSV ファイル エントリのサンプルを示します。

user2@cisco.com,ce463d44-02c3-4975-a37f-d4553e3f17e1,group01,text/directory,3,BEGIN:VCARD
ADR;TYPE=WORK:ADR\;WORK:\;\;123 Dublin rd\,\;Oranmore\;Galway\;\;Ireland
EMAIL;TYPE=X-CUSTOM1;X LABEL=Custom:testuser01@test.com N:test;user;;; NICKNAME:pizzaguy01
ORG:ABC TEL;TYPE=WORK,VOICE:5323534535 TITLE:QA VERSION:3.0 END:VCARD

注意    

ファイル自体のサイズに関する問題が発生したり vCard 情報が破損するリスクがあることから、CSV ファイルは手動で変更しないことを推奨します。

次の表で、非プレゼンス連絡先の入力ファイルのパラメータについて説明します。

パラメータ

説明

ユーザ JID（User JID）

ユーザ JID。これはユーザの IM アドレスです。

連絡先 JID（Contact JID）

連絡先リスト エントリのユーザ JID（利用できる場合）。それ以外の場合は UUID。

グループ名（Group Name）

連絡先リスト エントリが追加されるグループの名前。

コンテンツ タイプ（Content Type）

情報フィールドで使用される textmime タイプおよびサブタイプ。

バージョン（Version）

情報フィールドで使用されるコンテンツ タイプ。

情報（Info）

vCard 形式の連絡先リスト エントリの連絡先情報。

新しい一括管理ジョブの作成

連絡先リストおよび非プレゼンス連絡先リストの新しい一括管理ジョブを作成します。

始める前に

入力ファイルのアップロード

手順
ステップ 1

Cisco Unified CM IM and Presence の管理：

  • 連絡先リストの新しい一括管理ジョブを作成する場合は、一括管理 > 連絡先リスト > 更新を選択します
  • 連絡先リストの新しいバルク管理ジョブを作成する場合は、一括管理 > 非プレゼンス連絡先リスト > 非プレゼンス連絡先リストを選択します。
ステップ 2

[File Name（ファイル名）] ドロップダウン リストから、インポートするファイルを選択します。
ステップ 3

[Job Description（ジョブの説明）] フィールドに、この一括管理コミッションの説明を入力します。
ステップ 4

次のいずれかを実行します。

  • 一括管理ジョブをただちに実行するには、[Run Immediately（すぐに実行）] を選択します。
  • 一括管理ジョブを実行する時間をスケジュールするには、[Run Later（後で実行）] を選択します。BAT でジョブをスケジュールする方法の詳細については、Cisco Unified CM IM and Presence の管理のオンライン ヘルプを参照してください。
ステップ 5

[Submit（送信）] をクリックします。ジョブをただちに実行するように選択した場合は、[Submit（送信）] をクリックするとジョブが実行されます。

次のタスク

一括管理ジョブの結果の確認

一括管理ジョブの結果の確認

一括管理ジョブが完了すると、IM and Presence サービス BAT ツールは、連絡先リストのインポート ジョブの結果をログ ファイルに書き込みます。ログ ファイルには、次の情報が含まれています。

  • 正常にインポートされた連絡先の数。

  • 連絡先をインポートしようとした際に発生した内部サーバ エラーの数。

  • インポートされなかった（無視された）連絡先の数。ログ ファイルには、無視されたそれぞれの連絡先の理由がログ ファイルの末尾に記載されます。次に、連絡先がインポートされない理由を示します。

    • 無効な形式：無効な行形式。たとえば、必須フィールドが見つからないか、または空になっています

    • 無効なアクセス ドメイン：連絡先ドメインの形式が無効です。連絡先ドメインの有効な形式については、ユーザの連絡先リストの一括インポートに関するトピックを参照してください

    • 連絡先として自身を追加できない：連絡先がユーザの場合、そのユーザの連絡先はインポートできません

    • ユーザの連絡先リストが制限を超えている：ユーザが連絡先リストの最大サイズに達したため、これ以上の連絡先をそのユーザに対してインポートできません

    • ユーザはローカル ノードに割り当てられない：ユーザはローカル ノードに割り当てられません

  • BAT ジョブを早期に終了させたエラーが原因で処理されなかった ​​CSV ファイル内の連絡先の数。このエラーは滅多に起こりません。

このログ ファイルにアクセスするには、次の手順を実行します。

始める前に

新しい一括管理ジョブの作成

手順
ステップ 1

Cisco Unified CM IM and Presence 管理で、一括管理 > ジョブ スケジューラを選択します。

ステップ 2

[Find（検索）] をクリックして、連絡先リストのインポート ジョブのジョブ ID を選択します。

ステップ 3

[Log File Name（ログ ファイル名）] リンクをクリックし、ログを開きます。

このドキュメントは役に立ちましたか?

Feedbackフィードバック

シスコに問い合わせ