[SmartDocs] バーでは、特定の Zebra デバイスに存在する機能のみを表示するように、このページをカスタマイズできます。
デバイスの OSX、MX および Android のバージョン情報は、Android の設定パネルに表示されるか、ADB、EMDK、または MX CSP を使用してデバイスを照会することで確認できます。詳細情報。
Persistent Manager (PersistMgr) を使用すると、管理者はリクエスト XML ドキュメントを [永続的] として指定できます。これにより、エンタープライズ リセットまたはエンタープライズ リセットになる OS の更新の後も、これらの設定ドキュメントがデバイスに残り、オプションで設定を再適用できます。リクエスト XML ドキュメントには、1 つまたは複数の CSP 機能に従って作成されたデバイス構成設定 (キー マッピング、ネットワーク設定など) が含まれています。
PersistMgr は、名前とバージョン番号をリクエスト XML ドキュメントに割り当てて一意に識別することで機能します。オプションのオーダー番号を使用すると、他の永続的ドキュメントとの関連で再送信するタイミングを制御できます。管理者は、エラーなしでドキュメントを送信できる機能に基づいて、ドキュメントを保持するかどうかを入力することもできます。
Zebra Android デバイスでは、エンタープライズ リセットは、永続的なコンテンツが保存されている /enterprise
パーティションを保持しながら、オペレーティング システムを工場出荷時の状態に戻します (工場出荷時へのリセットでは、このパーティションが削除されます)。エンタープライズ リセットは、通常、/enterprise
パーティションのコンテンツによって決められる、エンタープライズ定義のデフォルト状態にデバイスを戻すように設計されています。MDM ツール キットを使用している場合、MDM エージェントはエンタープライズ リセット後も保持されるコンテンツを制御し、どのリクエスト XML ドキュメントを送信するかを決定することで、エンタープライズ定義の状態を制御できます。
KitKat デバイスでは、デバイスを再起動するまで、MX のアップグレード後に PersistMgr が動作しなくなります。
最も一般的なユース ケースは、処理のためにリクエスト XML ドキュメントを MXMF に送信するときに、PersistMgr を含めることです。これにより、リクエスト XML ドキュメント全体が、保護された /enterprise
フォルダに PersistMgr によって保存されます。エンタープライズ リセットの後、PersistMgr は、その時点で永続的であるすべてのリクエスト XML ドキュメントを MXMS に再送信します。
たとえば、アプリケーションをエンタープライズ定義のデフォルト状態の一部にするには、次の処理を実行します。
/enterprise/usr/myapp
) にダウンロードします。この .apk ファイルは、エンタープライズ定義のデフォルト状態の一部となり、エンタープライズ リセットのたびに自動的に再インストールされ、再起動されます。
このシナリオを使用して、以前に永続化されたリクエスト XML ドキュメントを削除します。たとえば、上記の例のアプリケーションがエンタープライズ定義のデフォルト状態の一部として不要になった場合は、アンインストールし、さらに非永続化にする必要があります。デバイスからアンインストールするだけでは、アプリが次回のエンタープライズ リセットで再インストールされるため、不十分です。このような場合は、.apk ファイルを永続的な場所から削除して、クリーンアップを完了することをお勧めします。
MDM を使用する場合は、この点に特に関心を持つ必要がある可能性があります。PersistMgr を使用して、/enterprise
保護フォルダに現在保存されているすべてのリクエスト XML ドキュメントの名前、バージョン、および実行順序をクエリできます。これは、1 つまたは複数の特定の構成パラメータがデバイスに存在するかどうかを判断するのに役立ちます。
たとえば、1 人の管理者が、四半期ごとに大規模導入を行うために、異なる WPA2 パスワードを使用して 4 セットの Wi-Fi 設定を管理することができます。これらは、「Wi-Fi 設定」という [名前として保持] および 1、2、3、4 の番号により [バージョンとして保持] して MDM システムに保存できます。PersistMgr では、いつでもデバイスに存在できるのは 1 つの [名前として保持] のみで、永続的ドキュメントのクエリにより、指定された四半期のパスワード設定がデバイスにインストールされているかどうかをすばやく判断できます。
このクエリは、複数の永続的リクエスト XML ドキュメント間のやり取りのトラブルシューティングにも役立ちます。また、必要に応じてドキュメント名を取得して非永続化することもできます。
これは、トラブルシューティングのシナリオに役立ちます。PersistMgr を使用して、永続的リクエスト XML ドキュメントを無効にするか、または無効になっている XML ドキュメントを有効にすることができます (リクエスト XML ドキュメントはデフォルトで有効になっています)。無効になっている永続的リクエスト XML ドキュメントは、エンタープライズ リセット後もデバイスに残りますが、設定は再適用されません。リクエスト XML ドキュメントとそれに対応する設定を選択的に無効化および有効化することにより、エンタープライズ リセットの後の特定のデバイスの競合を、競合の原因が検出されるまで分離できます。
エンタープライズ リセット後、 一部の Zebra デバイスでは、キーボード、タッチスクリーン、および USB ポートが一時的に無効になり、この間にメッセージが表示されます。すべての永続設定が再適用されると、デバイスはこれらの "ロックダウン" を緩和し、デバイスの保護を管理者が定義した構成とアプリケーションに戻します。
リクエスト XML ドキュメントを永続的にするか非永続的にするかを入力したり、永続的リクエスト XML ドキュメントを有効または無効にするために使用されます。リクエスト XML ドキュメントは、[名前として保持] および [バージョンとして保持] 識別子を使用して指定する必要があります。以前に指定した場合には、オプションの [オーダーとして保持] 識別子も使用する必要があります。
リクエスト XML ドキュメントはデフォルトでは非永続的であり、エンタープライズ リセット後もデバイス上に残るように永続的として指定する必要があります。永続的にされたドキュメントはデフォルトで有効になっていますリセットの後、PersistMgr サービスは、永続的および有効になっているすべてのリクエスト XML ドキュメントの設定を再適用します。無効にした永続的ドキュメントは、エンタープライズ リセット後もデバイスに残りますが、設定は再適用されません。
パラメータ名: PersistAction
オプション | 名前 | 説明 | 注記 | 要件 |
---|---|---|---|---|
1 | 現在の XML を永続的プロファイルとして追加 | 指定したリクエスト XML ドキュメントを永続的として指定します。 |
MX: 4.1+ |
|
2 | 指定した永続的プロファイルを削除 | 指定した永続的リクエスト XML ドキュメントを非永続的として指定します。 |
MX: 4.1+ |
|
3 | 指定した永続的プロファイルを有効化 | 指定した永続的リクエスト XML ドキュメントを有効にします。 |
MX: 4.2+ |
|
4 | 指定した永続的プロファイルを無効化 | 指定した永続的リクエスト XML ドキュメントを無効にします。 |
MX: 4.2+ |
永続アクションを実行する、現在存在する永続的リクエスト XML ドキュメントを識別するために、リクエスト XML ドキュメントに割り当てる名前を入力するために使用されます。既存の永続的リクエスト XML ドキュメントを識別する場合、この値は [バージョンとして保持] および [オーダーとして保持] (以前に指定した場合) の値と組み合わせて使用されます。正確な値を送信しないと、アクションが発生せず、結果の XML にエラーが返されます。
[名前として保持] で指定した値は、デバイスで一度に 1 回だけ使用できます。デバイス上にすでに存在する [名前として保持] を使用してドキュメントを指定した場合、既存のドキュメントは新しいドキュメントによって上書きされます。たとえば、[名前として保持] の使用については、上記の概要の「永続的ドキュメントをリストする」セクションを参照してください。
パラメータ値入力ルール:
パラメータ名: PersistAsName
要件:
- MX: 4.1+
永続アクションを実行する、現在存在する永続的リクエスト XML ドキュメントを識別するために、リクエスト XML ドキュメントに割り当てるバージョン番号を入力するために使用されます。正確な値を送信しないと、アクションが発生せず、結果の XML にエラーが返されます。たとえば、[バージョンとして保持] の使用については、上記の概要の「永続的ドキュメントをリストする」セクションを参照してください。
パラメータ値入力ルール:
パラメータ名: PersistAsVersion
要件:
- MX: 4.2+
エンタープライズ リセット後に他のドキュメントと比較して、リクエスト XML ドキュメントが再送信される順序を入力するために使用されます。小さい数字が先に送信されます。番号の付いていないドキュメントまたは同じ番号のドキュメントは、[名前として保持] の値に従って、アルファベット順に送信されます。正確な値を送信しないと、アクションが発生せず、結果の XML にエラーが返されます。
パラメータ値入力ルール:
パラメータ名: PersistAsOrder
要件:
- MX: 4.2+
リクエスト XML ドキュメントが、送信時に結果の XML に最上位の特性エラーを返した場合に、そのドキュメントを永続的にするかどうかを制御します。
次の場合に表示: 永続アクションが [現在の XML を永続的プロファイルとして追加] の場合
パラメータ名: PersistIfError
オプション | 名前 | 説明 | 注記 | 要件 |
---|---|---|---|---|
true | true | リクエスト XML ドキュメントが送信されたときに返された結果の XML に最上位の特性エラーが報告された場合でもこの PersistMgr 機能が含まれているリクエスト XML ドキュメントを永続化します。 |
MX: 4.2+ |
|
false | false | リクエスト XML ドキュメントが送信されたときに返された結果の XML に最上位の特性エラーが報告された場合は、この PersistMgr 機能が含まれているリクエスト XML ドキュメントを永続化できないようにします。 |
MX: 4.2+ |
次のリクエスト XML ドキュメントでは、PersistMgr を使用して自己永続化しています。
<wap-provisioningdoc>
<characteristic type="Clock" version="4.2">
<parm name="AutoTime" value="true" />
<characteristic type="AutoTimeDetails">
<parm name="NTPServer" value="http://time.test.com" />
<parm name="SyncInterval" value="00:30:00" />
</characteristic>
</characteristic>
<characteristic type="PersistMgr">
<parm name="PersistAction" value="1" />
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile" />
<parm name="PersistAsVersion" value="1" />
<parm name="PersistAsOrder" value="3"/>
<parm name="PersistIfError" value="false" />
</characteristic>
</characteristic>
</wap-provisioningdoc>
次のリクエスト XML ドキュメントでは、PersistMgr を使用して、前の例で永続化したリクエスト XML ドキュメントが永続的であることを停止します。
<wap-provisioningdoc>
<characteristic type="PersistMgr" version="4.2" >
<parm name="PersistAction" value="2"/>
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
<parm name="PersistAsVersion" value="1"/>
<parm name="PersistAsOrder" value="3"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
次のリクエスト XML ドキュメントでは、PersistMgr を使用して、前の例で永続化されたリクエスト XML ドキュメントを無効にします。
<wap-provisioningdoc>
<characteristic type="PersistMgr" version="4.2" >
<parm name="PersistAction" value="4"/>
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
<parm name="PersistAsVersion" value="1"/>
<parm name="PersistAsOrder" value="3"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
次のリクエスト XML ドキュメントでは、前の例で PersistMgr を使用して永続化したリクエスト XML ドキュメントを有効にします。
<wap-provisioningdoc>
<characteristic type="PersistMgr" version="4.2" >
<parm name="PersistAction" value="3"/>
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
<parm name="PersistAsVersion" value="1"/>
<parm name="PersistAsOrder" value="3"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
注: 次のクエリは PersistMgr でサポートされていますが、PersistMgr DSD では示されていないため、DSD ツールで生成できません。クエリが必要な場合は、手動で作成する必要があります。
入力
<wap-provisioningdoc>
<characteristic-query type="PersistMgr"/>
</wap-provisioningdoc>
出力
<wap-provisioningdoc>
<characteristic type="PersistMgr">
<parm name="PersistAction" value="1"/>
<characteristic type="persist-details">
<parm name="PersistAsName" value="App-profile"/>
<parm name="PersistAsVersion" value="02"/>
<parm name="PersistAsOrder" value="1"/>
<parm name="PersistIfError" value="true"/>
<parm name="ProfileMethod" value="3"/>
</characteristic>
</characteristic>
<characteristic type="PersistMgr">
<parm name="PersistAction" value="1"/>
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
<parm name="PersistAsVersion" value="01"/>
<parm name="PersistAsOrder" value="3"/>
<parm name="PersistIfError" value="false"/>
<parm name="ProfileMethod" value="3"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
注: 上記の結果の XML ドキュメントに含まれる [ProfileMethod] は、将来的な使用を目的としています。
入力
<wap-provisioningdoc>
<characteristic type="PersistMgr">
<characteristic-query type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
</characteristic-query>
</characteristic>
</wap-provisioningdoc>
出力
<wap-provisioningdoc>
<characteristic type="PersistMgr">
<parm name="PersistAction" value="1"/>
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
<parm name="PersistAsVersion" value="01"/>
<parm name="PersistAsOrder" value="3"/>
<parm name="PersistIfError" value="false"/>
<parm name="ProfileMethod" value="3"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
注: 上記の結果の XML ドキュメントに含まれる [ProfileMethod] は、将来的な使用を目的としています。
入力
<wap-provisioningdoc>
<characteristic type="PersistMgr">
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile" />
<parm-query name="PersistAsVersion"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>
出力
<wap-provisioningdoc>
<characteristic type="PersistMgr" version="4.4">
<characteristic type="persist-details">
<parm name="PersistAsName" value="Clock-profile"/>
<parm name="PersistAsVersion" value="01"/>
</characteristic>
</characteristic>
</wap-provisioningdoc>