License Manager

特定のデバイスに存在する機能のみを表示するには、下の SmartDocs バーから 1 つまたは複数のフィルタを選択します。

入力フィールドには、英語のみを入力できます。

MX からのクエリは、Android 11 以降を実行している Zebra デバイスではサポートされていません。代替方法を参照してください。

StageNow - 5.10

概要

ライセンス マネージャ (LicenseMgr) CSP は、デバイス上のソフトウェア ライセンスを管理し、これにより、管理者またはデバイス上で実行されているアプリが、ライセンスを必要とするソフトウェア機能の操作性を制御できます。ソフトウェア コンポーネントは、ライセンスに基づいて、使用可能、使用不可にすること、または機能制限することができます。コンポーネントにライセンスが必要な場合、有効なライセンスがないと、その機能が制限されるか、機能が使用できなくなります。ライセンスを必要としないソフトウェア コンポーネントは、この CSP の影響を受けません。

Android 13 のライセンス処理が変更されました。下記のビデオを参照してください。

主な機能

Zebra ライセンス

  • Zebra または (レガシー) Symbol メソッドを使用して、ライセンス アクションを実行します
  • アクティベーション ID によりソフトウェア ライセンスを有効化/返却/すべて返却/更新します
  • "機能" 名やバージョンでライセンス アプリを有効化/返品/更新します
  • ライセンス ソースを選択します:
    • クラウド
    • クラウド プロキシ
    • ローカル ライセンス サーバー
    • 事前にアクティブ化されたライセンス
  • ライセンス ソースを削除します
  • オンプレミス ライセンス AID サーバーの URL とフレンドリ名を入力します
  • プロキシ経由でクラウド ベース AID サーバーの URL とフレンドリ名を入力します
  • オンプレミス機能ライセンス サーバーの URL とオプションのポート番号を入力します
  • クラウド ベースの機能ライセンス サーバーの URL とオプションのポート番号を入力します
  • Zebra ローカル ライセンス サーバー上の名前付きパーティション (グループ) からライセンス コードを取得します

Symbol ライセンス

  • デバイスにソフトウェア ライセンスを適用します
  • デバイスからソフトウェア ライセンスを取り消します
  • 標準およびカスタム機能に対してライセンス アクションを実行します
  • ライセンスを埋め込むか、参照するかを選択します
  • デバイスでライセンスを確認します

日本語サポート

ライセンス マネージャでは、日本語にローカライズされたデバイスのサポートが制限されています。

次のデバイスではサポートされていません:

  • 日本語版の Zebra ソフトウェアのライセンス (ZSL) UI (英語版 UI のみ)。
  • クライアント ライセンス アプリ機能は、日本語にローカライズされたデバイスでも英語でのみ表示されます。
  • ステージング エラー メッセージは、デバイスと StageNow クライアント アプリが日本語版にローカライズされている場合でも、英語でのみ表示されます。

以下は、StageNow ではサポートされていません。

  • プロファイル作成のための日本語入力。すべての入力は英語のみで行なう必要があります。
  • StageNow が日本語にローカライズされている場合でも、ステージング エラー メッセージは英語でのみ表示されます。

注: StageNow バーコード (およびその他の MX-XML ソース) を使用して構成された設定は、日本語にローカライズされたデバイスでサポートされています。パラメータ プロンプトは日本語で表示されますが、設定は英語で入力する必要があります。

ライセンス マネージャ アプリ

一部の Zebra デバイスは、ライセンス マネージャと呼ばれる組み込みのアプリを搭載しています。これにより、デバイス ユーザーや管理者は、デバイス上でライセンス関連のタスクを手動で実行できます。

img ライセンス マネージャ アイコン (左) と、複数の有効化されたライセンスを示すアプリのホーム画面。

ライセンス マネージャ ユーザー ガイド (PDF)

ライセンスの取得

ソフトウェア ライセンスは、Zebra ソフトウェア ライセンス サーバーから取得されます。これらはソフトウェア ライセンス ファイルとして発行され、ライセンス機能名を使用して特定のソフトウェア コンポーネントに関連付けられます。ソフトウェア ライセンス ファイルは、関連するライセンス機能名の使用を有効にするためにのみ使用できます。1 台のコンポーネントは複数の機能を持つことができ、それぞれがライセンス機能名を個別に使用して制御されます。また、1 台のコンポーネントは、単一のライセンス機能名で制御されるすべての機能を持つことができます。

Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンスは、個々のデバイス ライセンスである可能性があり、各ソフトウェア ライセンス ファイルは特定のデバイスのシリアル番号に関連付けられています。このような場合、適切なソフトウェア ライセンス ファイルを一致する各デバイスに適用する必要があります。Zebra ソフトウェア ライセンス サーバーは、エンタープライズが所有するすべてのデバイスに発行されるエンタープライズ ライセンスも提供します。このような場合、同じソフトウェア ライセンス ファイルを、そのエンタープライズが所有する各デバイスに適用できます。

ライセンスの検証

ソフトウェア ライセンス ファイルは、Zebra ソフトウェア ライセンス サーバーから取得され、ローカルまたはオンラインで保存され、LicenseMgr を通じて参照されます。ただし、サーバーは、そのようなファイルが特定のライセンス機能に一致しているかどうかを検証しません。有効なソフトウェア ライセンス ファイルが、意図した機能以外のライセンス機能に誤って適用されている場合、その機能は有効になり、エラーは発生しません。

これを防止するため、Zebra では、検証メソッド パラメータ (以下) を使用して、ライセンス機能名がソフトウェア ライセンス ファイルに含まれているものと一致していることを確認することをお勧めしています。これにより、不一致が発生した場合に結果の XML にエラーが返されます。

事前にアクティブ化されたライセンスの制限

  • 事前にアクティブ化されたライセンスは、生成された日にのみ有効です。
  • 複数の事前にアクティブ化されたライセンスが生成された場合は、生成されたものと同じ順序で適用する必要があります。
  • 事前にアクティブ化されたライセンスは、他のすべてのライセンス アクションの前に適用する必要があります。
  • 同じ構成プロファイルでアクティベーション ID と事前にアクティブ化されたライセンスのアプリケーションを組み合わせる場合は、事前にアクティブ化されたライセンスを最初に適用する必要があります。

ライセンス デバイス タイプ

デバイスでライセンス アクションを実行する方法を入力するために使用されます。"レガシー" Symbol アクションは、デバイスに保存されているライセンス ファイルに対して実行されます。Zebra のアクションは、サーバー ベースのライセンス ストアに関連しています。

パラメータ名: LicenseChoice

オプション 名前 説明注記 ステータス 要件
0 do_nothing この値 (またはこのパラメータが XML に存在しないこと) によってデバイスの設定は変更されません。以前の設定はすべて保持されます。

MX: 7.1+
1 シンボル (レガシー) Symbol ライセンス アクションを実行します。

MX: 7.1+
2 Zebra Zebra ライセンス アクションを実行します。

MX: 7.1+

Zebra ライセンス アクション

デバイスのアクティベーション ID (AID) または機能名前とバージョンに対して実行するアクションを選択するために使用されます。Zebra ブランドのデバイスのみ。Symbol ブランドのデバイスの場合は、ライセンス アクション パラメータを使用します。オプション 6 を使用するには、アクティベーション ID 更新パラメータを使用して 39 文字のアクティベーション ID を入力します。注: オプション 4、5、8、9、10 は、デバイス上でプログラム的に使用され、人間とのやり取りを目的としたものではありません。

事前にアクティブ化されたライセンスに関する重要な制限事項:

  • 事前にアクティブ化されたライセンスは、生成された日にのみ有効です。
  • 複数の事前にアクティブ化されたライセンスが生成された場合は、生成されたものと同じ順序で適用する必要があります。
  • 事前にアクティブ化されたライセンスは、他のすべてのライセンス アクションの前に適用する必要があります。
  • 同じ構成プロファイルでアクティベーション ID と事前にアクティブ化されたライセンスのアプリケーションを組み合わせる場合は、事前にアクティブ化されたライセンスを最初に適用する必要があります。

次の場合に表示: ライセンス ソースは "Zebra クラウド"、ライセンス アクション Zebra は "AID の有効化"、ライセンス選択は "Zebra ライセンス アクションの実行" およびライセンス選択は、"ローカル ライセンス サーバー オプションの使用" です

パラメータ名: LicenseActionZebra

オプション 名前 説明注記 ステータス 要件
1 アクティブ化 Zebra デバイスの AID をアクティブにします。

MX: 7.1+
2 リターン Zebra デバイスの AID を非アクティブにして、一般的な使用に戻します。

MX: 9.2+
3 リセット Zebra デバイスのすべての AID を非アクティブにして、一般的な使用に戻します。

MX: 9.2+
4 acquirefeature デバイス上でプログラム的に使用されます。人間とのやり取りはありません。

MX: 7.1+
5 returnallfeatures 将来使用するために予約されています。デバイス上でプログラム的に使用されます。人間とのやり取りはありません。

MX: 7.1+
6 refreshAID ライセンス更新の購入後に、デバイスがライセンス サーバーに接続してデバイス ライセンスを更新するようにします。

MX: 7.2+
7 deleteLicenseSource 指定したライセンス ソースをデバイスから削除します。

MX: 8.1+
8 activatefeature デバイスでプログラム的に使用され、デバイス上の機能名とバージョンに基づいてライセンスをアクティブにします。人間とのやり取りはありません。

MX: 10.2+
9 returnfeature 指定された機能のライセンスをデバイスから再要求し、ライセンス サーバーに戻して別の場所に割り当てます。

MX: 10.2+
10 refreshfeature ライセンス更新購入後に、デバイスがライセンス サーバーに接続して、指定された機能のライセンスを更新するようにします。

MX: 10.2+

ライセンス ソース

クラウド ベースまたはローカルの Zebra ライセンス サーバーを使用するか、デバイス上の事前にアクティブ化されたファイルを使用するかを制御します。Zebra クラウドを選択した場合 (オプション 1)、ライセンス クラウド URL パラメータを使用してサーバーの場所を入力します。

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra" です

パラメータ名: LicenseSource

オプション 名前 説明注記 ステータス 要件
1 Zebra Cloud Zebra ライセンス クラウド オプションのいずれかが使用されていることを示します。

MX: 7.2+
2 LLS ローカル ライセンス サーバーが使用されていることを示します。

MX: 7.2+
3 事前にアクティブ化 事前にアクティブ化されたライセンス ファイルがデバイスに存在することを示します。

MX: 8.1+

Zebra ライセンスの永続性のオン/オフ

これは、デバイス上にある Zebra ライセンスの永続性のオン/オフ スイッチです。オンにすると (オプション 1)、ライセンス コードはデバイス上の安全な場所に保存され、デバイスのエンタープライズ リセット後も保持されます。エンタープライズ リセットの詳細をご覧ください。

パラメータ名: ZebraLicensePersistence

オプション 名前 説明注記 ステータス 要件
0 変更しない この値 (またはこのパラメータが XML に存在しないこと) によってデバイスの設定は変更されません。以前の設定はすべて保持されます。

MX: 11.2+

Android API: 30+
1 オンにする ライセンス コードをデバイスに保存し、エンタープライズ リセット後も保持します。

MX: 11.2+

Android API: 30+
2 オフにする ライセンス コードをデバイスに保存し、エンタープライズ リセット後は保持しません。

MX: 11.2+

Android API: 30+

パーティション名

機能のライセンスを取得するローカルサーバー上のパーティションの名前を入力するために使用します。ライセンス パーティションは、機能名に基づいて作成され、グループ化されます。このフィールドを空白のままにした場合、または入力した名前がライセンス サーバーに存在しない場合、ライセンスは、パーティションに分割されていない (デフォルトの) ライセンス プールから有効にされます。

パラメータ値入力ルール:

  • 有効なパーティション名を含む文字列
  • 少なくとも 1 文字含める必要があります

注: この機能を使用するには、Zebra ローカル ライセンス サーバーのバージョン 4.0 以降が必要です。

次の場合に表示: ライセンス アクション Zebra は、"機能のアクティブ化" です

パラメータ名: PartitionName

要件:

  • MX: 11.1+

ライセンス クラウド URL

デバイスで Zebra クラウド ベース ライセンスのソースを入力するために使用されます。

次の場合に表示: ライセンス ソースは "Zebra クラウド"、ライセンス アクションZebra は "アクティブ化"、ライセンスの選択は "Zebra" です

パラメータ名: LicenseCloudURL

オプション 名前 説明注記 ステータス 要件
1 Zebra UAT クラウド クラウド ベースの Zebra ライセンス テスト サーバーを選択します。

MX: 8.0+
2 Zebra Production Cloud クラウド ベースの Zebra ライセンス運用サーバーを選択します。

MX: 8.0+
3 プロキシ経由の Zebra Production Cloud Zebra 本番クラウド ベースのライセンス サーバーにプロキシまたはリレー サーバー経由でアクセスする場合に使用されます。

MX: 8.1+
4 プロキシ経由の Zebra Test Cloud Zebra テスト クラウド ベース ライセンス サーバーにプロキシまたはリレー サーバー経由でアクセスする場合に使用されます。

MX: 8.1+
5 Zebra カスタム クラウド オンプレミス ライセンス サーバーまたはリレー サーバーのカスタム URL を指定できます。

MX: 8.1+

機能ベースのソース URL フレンドリ名

識別しやすいように、クラウド ベースまたはローカル ライセンス サーバーの "フレンドリ名" を入力するために使用されます。

パラメータ値入力ルール:

  • 少なくとも 1 文字を含む文字列

次の場合に表示: ライセンス アクション Zebra は、"機能のアクティブ化" または "機能の返却" または "機能の更新" です

パラメータ名: FeatureBasedLicenseSourceUrlFriendlyName

要件:

  • MX: 10.2+

機能ベースのライセンス ソース URL

Zebra の機能を含むクラウド ベースまたはローカル ライセンス サーバーの URL (およびオプションのポート番号) を入力するために使用されます。

パラメータ値入力ルール:

  • 有効な URL (およびオプションのポート番号) を含む文字列
  • 少なくとも 1 文字含める必要があります

例:

  • http://InternalLicenseServer.lan:8080
  • http://external.licenseServer.com:8081

次の場合に表示: ライセンス アクション Zebra は、"機能のアクティブ化" です

パラメータ名: FeatureBasedLicenseSourceUrl

要件:

  • MX: 10.2+

機能名

Zebra ライセンス アクション パラメータで選択したアクションを実行する機能名 (アクティベーション ID の代わりに) を入力するために使用します。

パラメータ値入力ルール:

  • 1 ～ 30 文字の文字列

次の場合に表示: ライセンス アクション Zebra は、"機能のアクティブ化" または "機能の返却" または "機能の更新" です

パラメータ名: FeatName

要件:

  • MX: 10.2+

ライセンス サーバーの URL

Zebra ライセンス アクティベーション ID を含むオンプレミス サーバーの URL (およびオプションのポート番号)、または外部ライセンス サーバーを指すリレー サーバーを入力するために使用されます。このパラメータは、管理対象の組織の壁の外側にあるネットワークにアクセスできないデバイスにのみ必要です。

パラメータ値入力ルール:

  • 有効な URL (およびオプションのポート番号) を含む文字列
  • 少なくとも 1 文字含める必要があります

例: http://InternalLicenseServer.lan:8080

次の場合に表示: ライセンス ソースは、"クラウド ライセンス サービスにカスタム URL を入力" で、ライセンスの選択は "Zebra" です

パラメータ名: URL

要件:

  • MX: 7.1+

サーバー フレンドリ名

識別しやすいように、ローカル ライセンス サーバーの "フレンドリ名" を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上の文字列

次の場合に表示: ライセンス アクション Zebra は "アクティブ化"、ライセンス選択は "Zebra"、ライセンス ソースは "LLS"、ライセンス ソースは "Zebra クラウド"、ライセンス選択 URL は "Zebra Production Cloud Via Proxy, Zebra Test Cloud Via Proxy or Zebra Custom Cloud" です

パラメータ名: ServerFriendlyName

要件:

  • MX: 7.2+

アクティベーション ID

デバイスでライセンスをアクティブ化するために Zebra ライセンス システムによって提供される 39 文字のコードを手動で入力するために使用されます。

パラメータ値入力ルール:

  • 39 文字のライセンス コードを含む文字列
  • 少なくとも 1 文字含める必要があります

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra" およびライセンス ソースは "Zebra Cloud または LLS" です。

パラメータ名: ActivationID

要件:

  • MX: 7.1+

アクティベーション数量

デバイスでアクティブ化するライセンス コピーの数を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上を含む文字列

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra" およびライセンス ソースは "Zebra Cloud または LLS" です。

パラメータ名: ActivationQuantity

要件:

  • MX: 7.1+

事前にアクティブ化されたライセンス ソース

デバイス上で事前にアクティブ化されたライセンス ファイルのソースを入力するために使用されます。

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra"、およびライセンス ソースは "事前アクティブ化" です

パラメータ名: PreactivatedLicenseSource

オプション 名前 説明注記 ステータス 要件
1 Zebra UAT Zebra テスト クラウドから事前にアクティブ化されたライセンスの使用を示します。

MX: 8.1+
2 Zebra Production Zebra 本番クラウドから事前にアクティブ化されたライセンスの使用を示します。

MX: 8.1+

事前にアクティブ化されたライセンス方式

デバイスで事前にアクティブ化されたライセンス ファイルの配信方法を入力するために使用されます。"参照" (オプション 2) を選択した場合、"事前にアクティブ化されたライセンス パスおよびファイル名" パラメータを使用して、デバイスでライセンス ファイルのパスとファイル名を入力します。

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra"、およびライセンス ソースは "事前アクティブ化" です

パラメータ名: PreactivatedLicenseMethod

オプション 名前 説明注記 ステータス 要件
1 組み込み 事前にアクティブ化されたライセンス ファイルをプロファイル XML に埋め込みます。

MX: 8.1+
2 参照 すでにデバイスにある事前にアクティブ化されたライセンス ファイルを参照します。

MX: 8.1+

事前にアクティブ化された「Blob」

XML に埋め込むライセンス ファイルを入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上を含む文字列

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra"、およびライセンス ソースは "事前アクティブ化"、および事前にアクティブ化されたライセンス メソッドは "参照" です

パラメータ名: PreactivatedBlob

要件:

  • MX: 8.1+

事前にアクティブ化されたファイルとパス

デバイスで事前にアクティブ化されたライセンス ファイルのパスとファイル名を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上を含む文字列

次の場合に表示: ライセンス アクション Zebra は "アクティブ化" であり、ライセンスの選択は "Zebra"、およびライセンス ソースは "事前アクティブ化"、および事前にアクティブ化されたライセンス メソッドは "埋め込み" です

パラメータ名: PreactivatedLicensePathAndFileName

要件:

  • MX: 8.1+

ライセンス ソースを返す

Zebra ライセンスを返却する方法を選択するために使用されます。

次の場合に表示: ライセンス アクション Zebra は "返却" であり、ライセンスの選択は "Zebra" です

パラメータ名: ReturnLicenseSource

オプション 名前 説明注記 ステータス 要件
1 Zebra Production Cloud ライセンスを Zebra ライセンス クラウドに返却します。

MX: 8.1+
2 Zebra UAT クラウド Zebra テスト クラウドのライセンスを返却します。

MX: 8.1+
3 サーバー フレンドリ名 サーバーのフレンドリ名を使用してライセンスを返却します。

MX: 8.1+

すべてのライセンス ソースを返す

デバイスから回収されたライセンスを返却するサーバーを選択するために使用されます。ローカル サーバーにライセンスを返却する場合は、AID 返却ライセンス ソース名パラメータを使用してサーバー名を入力します。

次の場合に表示: ライセンス アクション Zebra は「リセット」であり、ライセンスの選択はです " ゼブラ "

パラメータ名: ReturnAllLicenseSource

オプション 名前 説明注記 ステータス 要件
1 Zebra Production Cloud 回収されたライセンスを Zebra ライセンス クラウドに返却します。

MX: 9.2+
2 Zebra UAT クラウド 回収されたライセンスをテスト ライセンス サーバーに返却します。

MX: 9.2+
3 サーバー フレンドリ名 AID 返却ライセンス ソース名パラメータで、サーバーに回収されたライセンスを返却します。

MX: 9.2+

アクティベーション ID を返す

デバイスからライセンスを回収するために Zebra ライセンス システムによって提供される 39 文字のコードを手動で入力するために使用されます。回収されたライセンスは、他の場所に割り当てるために組織に返却されます。

パラメータ値入力ルール:

  • 39 文字のライセンス コードを含む文字列
  • 少なくとも 1 文字含める必要があります

次の場合に表示: ライセンス アクション Zebra は "返却" であり、ライセンスの選択は "Zebra" です

パラメータ名: ActivationIDReturn

要件:

  • MX: 7.1+

AID サーバー フレンドリ名を返す

回収されたライセンス アクティベーション ID を返却するローカル ライセンス サーバーの "フレンドリ名" を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上の文字列

次の場合に表示: ライセンス アクション Zebra は "返却" であり、ライセンスの選択は "Zebra"、およびライセンス ソースの返却は "サーバーのフレンドリ名" です

パラメータ名: ReturnAIDLicenseSourceName

要件:

  • MX: 9.2+

アクティベーション数量を返す

デバイスから回収するライセンス コピーの数を入力するために使用されます。

次の場合に表示: ライセンス アクション Zebra は "返却" であり、ライセンスの選択は "Zebra" です

パラメータ名: ActivationQuantityReturn

要件:

  • MX: 7.1+

ライセンス ソース名を削除

ライセンス ソースとして削除するローカル ライセンス サーバーの "フレンドリ名" を入力するために使用されます。

パラメータ値入力ルール:

  • 1 文字以上の文字列

次の場合に表示: ライセンス アクション Zebra は "ライセンス ソースの削除" であり、ライセンスの選択は "リセット" です

パラメータ名: DeleteLicenseSourceName

要件:

  • MX: 9.2+

アクティベーション ID をリフレッシュ

デバイスで更新するためのライセンス コードを入力するために使用されます。このパラメータは、RefreshID Zebra ライセンス アクションと連携して動作し、これにより、ライセンスの更新後にデバイスがライセンス サーバーに接続し、デバイス ライセンスを更新します。

パラメータ値入力ルール:

  • 有効なアクティベーション ID コードを含む 39 文字の文字列である必要があります

次の場合に表示: ライセンス アクション Zebra は "AID の更新" であり、ライセンスの選択は "Zebra" です

パラメータ名: ActivationIDRefresh

要件:

  • MX: 7.2+

取得する機能

このパラメータは、ユーザーによる操作を目的としたものではありません。

有効にする機能の名前をプログラム的に入力するために使用されます。

パラメータ値入力ルール:

  • 取得する機能と完全に一致する 1 ～ 40 文字の文字列

次の場合に表示: ライセンス アクション Zebra は "機能の取得" であり、ライセンスの選択は "Zebra ライセンス アクションの実行" です

パラメータ名: FeatureToAcquire

要件:

  • MX: 7.1+

機能バージョンを取得

このパラメータは、ユーザーによる操作を目的としたものではありません。

取得する機能パラメータを使用して、取得する機能のバージョン番号をプログラム的に入力するために使用されます。

パラメータ値入力ルール:

  • 1 ～ 10 桁の整数または 10 進数値

次の場合に表示: ライセンス アクション Zebra は "機能の取得" であり、ライセンスの選択は "Zebra ライセンス アクションの実行" です

パラメータ名: AcquireFeatureVersion

要件:

  • MX: 7.1+

機能数を取得

機能を使用できる回数を取得するためにデバイス上でライセンスがあるアプリにより使用されます。この機能はプログラム的に使用され、人間とのやり取りを目的としたものではありません。

パラメータ値入力ルール:

  • 正の整数である必要があります (デフォルト = 1)

次の場合に表示: ライセンス アクション Zebra は "機能の取得" であり、ライセンスの選択は "Zebra" です

パラメータ名: AcquireFeatureCount

要件:

  • MX: 7.2+

ライセンス動作

レガシー Symbol デバイスでソフトウェア ライセンスを適用または削除するために使用されます。Zebra 製デバイスの場合は、ライセンス アクション Zebra パラメータを使用します。

デバイスでソフトウェア ライセンスを適用すると、そのソフトウェア コンポーネントの特定の機能がそのデバイスで使用可能になります。ライセンスを削除すると、制御された機能が使用不能になるか、その機能が制限されます。注: ライセンスの削除アクションは、プライベート ライセンス ストアからのみライセンスを削除します。ライセンス ファイルはデバイス上にまだ存在しているため、別途削除する必要があります。

次の場合に表示: ライセンスの選択は "Symbol" に設定されています

パラメータ名: LicenseAction

オプション 名前 説明注記 ステータス 要件
1 適用 Symbol デバイスにソフトウェア ライセンスを適用します。

MX: 4.3+
2 削除 Symbol デバイスからソフトウェア ライセンスを失効させます。

MX: 4.3+

検証メソッド

標準またはカスタム機能名パラメータで指定されたライセンス機能名が、ソフトウェア ライセンス ファイルの内容と一致するかどうかを確認するかどうかを制御します。Zebra では、ライセンス機能の不一致を防ぐために、このパラメータを使用することをお勧めします。

ソフトウェア ライセンス ファイルは、Zebra ソフトウェア ライセンス サーバーから取得され、ローカルまたはオンラインで保存され、LicenseMgr を通じて参照されます。サーバーは、そのようなファイルが特定のライセンス機能に一致しているかどうかを検証しません。有効なソフトウェア ライセンス ファイルが、意図した機能以外のライセンス機能に誤って適用されている場合、その機能は有効にならず、エラーは発生しません。検証メソッド パラメータは、ライセンス機能名がソフトウェア ライセンス ファイルに含まれる名前と一致していることを確認し、それ以外の場合は結果の XML にエラーを生成することで、このシナリオを防止します。

次の場合に表示: ライセンス アクションは "Symbol"、ライセンス選択は "Symbol" です

パラメータ名: VerifyMethod

オプション 名前 説明注記 ステータス 要件
0 機能名は確認しない この値 (または XML からのこのパラメータがない場合) により、検証メソッドに変更は加えられません。以前に選択した設定が保持されます。

MX: 4.3+
1 標準の機能名と照合して確認 指定されたソフトウェア ライセンス ファイルに含まれるライセンス機能名が、指定された標準ライセンス機能名と一致することを確認します。

MX: 4.3+
2 カスタム機能名と照合して確認 指定されたソフトウェア ライセンス ファイルに含まれるライセンス機能名が、指定されたカスタム ライセンス機能名と一致することを確認します。

MX: 4.3+

標準機能名

ソフトウェア ライセンス ファイルを検証するための標準ライセンス機能名を入力するために使用されます。

注: 現在、SimulScan OCR/OMR 機能の定義済みの 1 つの標準ライセンス機能名が存在します。これを選択すると、ライセンス機能名の正確な (カスタム) 値を入力する必要がなくなります。その他の機能を確認するには、[カスタム名の確認] を使用し、使用されているソフトウェア ライセンス ファイルと一致するライセンス機能名を入力します。

次の場合に表示: ライセンス アクションは "Symbol"、ライセンス選択は "Symbol" です

パラメータ名: VerifyStandardFeatureName

オプション 名前 説明注記 ステータス 要件
1 SIMULDC1_0_0 ソフトウェア ライセンス ファイルに含まれる SimulScan OCR/OMR ライセンス機能名が、SimulScan ソフトウェア コンポーネントの標準ライセンス機能名と一致していることを確認します。

MX: 4.3+

カスタム機能名

カスタム ライセンス機能名の入力に使用されます。これは、Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルに含まれるライセンス機能名と正確に一致する必要があります。

注: このオプションは、標準ライセンス機能名のリストに含まれているもの以外のライセンス機能名を確認するために使用する必要があります。ライセンス機能名は、大文字と小文字も一致させ、空白文字やその他の文字は使用せずに、Zebra ソフトウェア ライセンス サーバーから取得したものとまったく同じように入力する必要があります。

パラメータ値入力ルール:

  • Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルに含まれる有効なカスタム ライセンス機能名を持つ文字列

次の場合に表示: 検証メソッドは、"カスタム機能名と照合して検証" で、ライセンス選択は "Symbol" です

パラメータ名: VerifyCustomFeatureName

要件:

  • MX: 4.3+

ライセンス方式

ソフトウェア ライセンスの提供方法を入力するために使用されます。

組み込み値 (オプション 1) は、ソフトウェア ライセンス ファイルの内容がリクエスト XML に埋め込まれていることを示します。このオプションを使用するには、Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルの Base64 エンコードされた内容が、この リクエスト XML ドキュメントに埋め込まれる前に MDM エージェントによって Base64 エンコードされている必要があります。注: データ サイズは大きくなりますが、このオプションでは自己完結型のリクエスト XML の利点が得られます。

参照値 (オプション 2) は、デバイス ファイル システムに存在する必要があるソフトウェア ライセンス ファイルが、パスとファイル名で参照されていることを示します。注: このオプションでは、リクエスト XML が送信される前にソフトウェア ライセンス ファイルをデバイス ファイル システムに転送する必要があり、デバイスでのソフトウェア ライセンス ファイルの正確なパスとファイル名を指定する必要があります。エンタープライズ リセットの後にライセンスを適用する必要がある場合は、ライセンス ファイルを /enterprise ディレクトリなどの永続的な場所に保存する必要があります。

注: ソフトウェア ライセンス ファイル (埋め込みまたは参照) の提供方法にかかわらず、提供されたソフトウェア ライセンス ファイルには、Zebra ソフトウェア ライセンス サーバーから取得した有効なコンテンツが含まれている必要があります。無効なコンテンツを含むソフトウェア ライセンス ファイルを適用しようとすると、結果の XML にエラーが発生します。また、ソフトウェア ライセンス ファイルが個々のデバイス ライセンスである場合、ソフトウェア ライセンス ファイルに埋め込まれているデバイスのシリアル番号は、そのソフトウェア ライセンス ファイルが適用されるデバイスのシリアル番号と一致する必要があります。一致しないライセンスを適用しようとすると、結果の XML にエラーが生成されます。

次の場合に表示: ライセンス アクションは "Symbol"、ライセンス選択は "Symbol" です

パラメータ名: LicenseMethod

オプション 名前 説明注記 ステータス 要件
1 組み込み ライセンス ファイルからライセンス BLOB を XML に埋め込みます。

MX: 4.3+
2 参照 すでにデバイスにあるライセンス ファイルを参照します。

MX: 4.3+

ライセンス ファイル「Blob」

コンテンツが XML に埋め込まれている、ソフトウェア ライセンス ファイルを入力するために使用されます。コンテンツは Base64 でエンコードされ、これにより、コンテンツ サイズが約 33% 増加します。リクエスト XML 内でエンコードされたソフトウェア ライセンスが抽出され、デバイスに適用されます。

パラメータ値入力ルール:

  • 2 文字以上の文字列 (1 バイトのコンテンツを保持するために必要な最小値)
  • データは Base64 エンコードされている必要があります (4 文字で 3 バイトのコンテンツを保持)

次の場合に表示: ライセンス アクションは "適用" で、ライセンスメソッドは "埋め込み"、ライセンス選択は "Symbol" です

パラメータ名: LicenseBlob

要件:

  • MX: 4.3+

ライセンス ファイルとパス

デバイス ファイル システムに存在し、Zebra ソフトウェア ライセンス サーバーから取得した正確なコンテンツが含まれている必要がある、ソフトウェア ライセンス ファイルのパスとファイル名を入力するために使用されます。このパラメータは、ソフトウェア ライセンス ファイルで指定されたソフトウェア ライセンスをデバイスに適用します。

パラメータ値入力ルール:

  • 最小サイズが 1 文字の文字列
  • デバイス ファイル システム内の有効なソフトウェア ライセンス ファイルの有効なパスおよびファイル名である必要があります

次の場合に表示: ライセンス アクションは "適用" で、ライセンスメソッドは "参照"、ライセンス選択は "Symbol" です

パラメータ名: LicensePathAndFileName

要件:

  • MX: 4.3+

削除方式の選択

デバイスから削除するソフトウェア ライセンスを識別する、ライセンス機能名を選択する方法を制御します。

次の場合に表示: ライセンス アクションは "削除" でライセンス選択は "Symbol" です

パラメータ名: SelectMethod

オプション 名前 説明注記 ステータス 要件
1 標準 標準ライセンス機能名によりデバイスから削除されるソフトウェア ライセンスを識別することを示します。

MX: 4.3+
2 カスタム カスタム ライセンス機能名によりデバイスから削除されるソフトウェア ライセンスを識別することを示します。

MX: 4.3+

標準機能の削除

デバイスから削除するソフトウェア ライセンスを識別する目的の標準ライセンス機能名を入力するために使用されます。

次の場合に表示: 選択メソッドは "標準"、ライセンス選択は "Symbol" です

パラメータ名: SelectStandardFeatureName

オプション 名前 説明注記 ステータス 要件
SIMULDC1_0_0 SimulScan OCR/OMR SimulScan ソフトウェア コンポーネントのソフトウェア ライセンスをデバイスから削除します。

MX: +

カスタム機能の削除

デバイスから削除するソフトウェア ライセンスを識別するために、カスタム ライセンス機能名を入力するために使用されます。適切に削除するには、大文字と小文字の違い、空白文字などを含め、デバイスに適用されている元のソフトウェア ライセンス ファイルに含まれている正確なライセンス機能名を入力します。

パラメータ値入力ルール:

  • Zebra ソフトウェア ライセンス サーバーから取得したソフトウェア ライセンス ファイルに含まれる有効なカスタム ライセンス機能名を持つ文字列

次の場合に表示: 選択メソッドは "カスタム"、ライセンス選択は "Symbol" です

パラメータ名: SelectCustomFeatureName

要件:

  • MX: 4.3+

例

適用されたすべてのソフトウェア ライセンスを表示します

クエリは、Android 11 以降を実行している Zebra デバイスではサポートされていません。

リクエスト XML

以下のクエリでは、デバイスに適用されているすべてのソフトウェア ライセンスに関する情報を要求します。

    
    <wap-provisioningdoc>
        <characteristic-query type="LicenseMgr"/>
    </wap-provisioningdoc>

成功 (1 つの SimulScan ライセンス)

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic type="ExistingLicense">
                <parm name="SelectCustomFeatureName" value="SIMULDC1_0_0"/>
                <parm name="CompanyName" value="CompanyName1"/>
                <parm name="LicenseType" value="serial"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

追加のソフトウェア ライセンスが適用された場合は、追加情報が成功の結果 XML に返されます。ソフトウェア ライセンスが適用されていないデバイスに送信された同じリクエスト XML は、次のようなエラー結果の XML を返します。

エラー結果の XML

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic-error type="ExistingLicense" desc="Feature is not licensed" />
        </characteristic>
    </wap-provisioningdoc>

特定のソフトウェア ライセンス情報を表示します

以下のクエリは、SimulScan ソフトウェア コンポーネントのソフトウェア ライセンスにのみ適用されます。

リクエスト XML

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" >
            <characteristic-query type="ExistingLicense">
                 <parm name="SelectStandardFeatureName" value="SIMULDC1_0_0"/>
            </characteristic-query>
        </characteristic>
    </wap-provisioningdoc>

成功 (1 つの SimulScan ライセンス)

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic type="ExistingLicense">
                <parm name="SelectCustomFeatureName" value="SIMULDC1_0_0"/>
                <parm name="CompanyName" value="CompanyName1"/>
                <parm name="LicenseType" value="serial"/>
            </characteristic>
        </characteristic>
    </wap-provisioningdoc>

失敗

    
    <wap-provisioningdoc>
        <characteristic type="LicenseMgr" version="4.3" >
            <characteristic-error type="ExistingLicense" desc="Feature is not licensed" />
        </characteristic>
    </wap-provisioningdoc>

ローカル サーバーからライセンスをアクティブ化します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="activate"/>
    <characteristic type="NewLicenseZebra">
    <characteristic type="LicenseSourceURL">
        <parm name="LicenseSource" value="LLS"/>
        <parm name="URL" value="http://10.61.206.102:7070/request"/>
        <parm name="ServerFriendlyName" value="Local Server Name"/>
    </characteristic>
        <parm name="ActivationID" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantity" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

ライセンスをローカル サーバーに返却します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="return"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnLicenseSource" value="3"/>
        <parm name="ReturnAIDLicenseSourceName" value="Local Server Name"/>
        <parm name="ActivationIDReturn" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantityReturn" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

すべてのライセンスをローカル サーバーに返却します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="reset"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnAllLicenseSource" value="3"/>
        <parm name="ReturnAllAIDLicenseSourceName" value="Local Server Name"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

クラウド ベースのサーバーからライセンスをアクティブ化します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="activate"/>
    <characteristic type="NewLicenseZebra">
    <characteristic type="LicenseSourceURL">
        <parm name="LicenseSource" value="Zebra Cloud"/>
        <parm name="LicenseCloudURL" value="2"/>
    </characteristic>
        <parm name="ActivationID" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantity" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

クラウド ベースのサーバーにライセンスを返却します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="return"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ReturnLicenseSource" value="1"/>
        <parm name="ActivationIDReturn" value="0e62-2e66-53ec-4619-86bb-5246-ce58-24d5"/>
        <parm name="ActivationQuantityReturn" value="1"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

クラウド ベースのサーバーにすべてのライセンスを返却します


<wap-provisioningdoc>
<characteristic type="LicenseMgr" version="7.3" >
    <parm name="LicenseChoice" value="zebra"/>
<characteristic type="LicenseZebra">
    <parm name="LicenseActionZebra" value="reset"/>
<characteristic type="ExistingLicenseZebra">
    <parm name="ReturnAllLicenseSource" value="1"/>
</characteristic>
</characteristic>
</characteristic>
</wap-provisioningdoc>

クラウド ソース リストからローカル サーバーを削除します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="7.3" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="deleteLicenseSource"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="DeleteLicenseSourceName" value="local server name"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>

ライセンスを更新します


<wap-provisioningdoc>
    <characteristic type="LicenseMgr" version="8.1" >
        <parm name="LicenseChoice" value="zebra"/>
    <characteristic type="LicenseZebra">
        <parm name="LicenseActionZebra" value="refreshAID"/>
    <characteristic type="ExistingLicenseZebra">
        <parm name="ActivationIDRefresh" value="c3fe-2bd5-e8c0-4058-a93a-dc82-bab6-0939"/>
    </characteristic>
    </characteristic>
    </characteristic>
</wap-provisioningdoc>