UAM: Shell Apps 技術リファレンスガイド

検出スクリプト

検出スクリプトは、必要なアクションと実際のインストール状態に応じて1回から2回実行されます。次のいずれかの結果で終了します:

戻り値の型

• $true: アプリはインストールされています（シングルバージョンモードのみ）。

• $false: アプリはインストールされていません（シングルバージョンモードのみ）。

• string: 検出されたバージョン名。

• $null: アプリはインストールされていません。

インストールスクリプト

これは、ターゲットアクションがインストールであり、検出スクリプトが $false、$null、またはターゲットでないバージョン名を返した場合にのみ実行されます。追加情報については、フローの例を参照してください。

戻り値の型:

• void: インストールが正常に完了しました。最終的なコンプライアンス状態は、検出スクリプトの2回目の実行によって再評価されます。

アンインストールスクリプト

これは、ターゲットアクションがアンインストールであり、検出スクリプトが$trueまたは文字列バージョン名を返す場合にのみ実行されます。追加情報については、フローの例を参照してください。

戻り値の型

• void: アンインストールが正常に完了しました。最終的なコンプライアンス状態は、検出スクリプトの2回目の実行によって再評価されます。

$Contextオブジェクトの仕様

これは、すべてのスクリプトに対して、Nerdio Managerが管理・注入するグローバル変数です。

プロパティ

• Log(message: string | string[]): 後でポリシーの詳細ページで利用可能な任意のメッセージをログに記録するための関数です。例えば、$Context.Log('Hello world')。

• GetAttachedBinary(version: string | null): 添付ファイルをダウンロードし、一時フォルダー内の絶対パスを返します。詳細については、ファイル添付を参照してください。

• TargetVersion: string | null: 展開ポリシーのインストール操作で設定されたバージョン名、アンインストール操作の場合はnullです。[Nerdio Manager v6.6+]

• DetectedVersion: string | null: 検出スクリプトによって返されたバージョン名、他の戻り値のタイプの場合はnullです。[Nerdio Manager v6.6+]

• Versions: ShellAppVersion[]: All shell app version definitions.[Nerdio Manager v6.6+]

ShellAppVersion Object Specs

プロパティ

• Name: string: バージョン名。

ファイル添付

任意のシェルアプリのバージョンには任意のバイナリデータが添付される可能性があり、任意のスクリプトは$Context.GetAttachedBinary() を使ってこのバイナリデータを取得できます。

この関数を呼び出すと、次のことが行われます：

• ファイルがまだダウンロードされていない場合は、ファイルをダウンロードします。

• ダウンロードしたファイルを内部ストレージにキャッシュします。

• ファイルを一時フォルダーにコピーします。

• 一時フォルダー内のファイルの絶対パスを返します。

この関数は、特定のバージョンに添付されたファイルを提供するためのオプションのバージョン名パラメーターを受け取ります。Nerdio Managerは、コンテキストに基づいて最も適切なファイルを見つけようとします。考えられる結果は4つです：

• シェルアプリに単一のバージョンがある場合、そのファイルを選択します。

• アクションがインストールの場合、ターゲットバージョンのファイルを選択します。

• Detectスクリプトが適切なバージョン名を返した場合、そのファイルを選択します。

• エラーが発生します。

マルチバージョンモードの重要なポイント

• Detectスクリプトは、ホスト上で検出された場合は適切なバージョン名を返す必要があり、検出されない場合はnullを返します。これは、アプリが存在するかどうかを示す単純な真/偽のブール値を許可する単一バージョンモードとは異なります。

• Detectスクリプトの返された結果は、アプリがインストールされているかどうかの最終的な真実の源です。そして、それはインストール/アンインストールのすべてのフォローアップ実行のドライバーです。

• Nerdio Managerは、アプリ検出に関してホスト上の内部状態を追跡したり、仮定を立てたりすることはありません。

• 顧客は、現在インストールされているシェルアプリのバージョンを追跡するために必要なロジックを自由に記述できます（例：レジストリキー、ファイルなど）。

統合カタログページでの可用性

統一カタログにおけるシェルアプリの可用性は、対応するシェルアプリ管理の一般ステップにある公開チェックボックスによって制御されます。

バージョン設定UI

ここでは、各シェルアプリ管理のバージョンウィザードステップで見られるバージョン管理UIの詳細をいくつか示します。

• 名前: x.x.x.x形式で保存されているバージョン名です。これは、関連するインストールポリシーに対して正の値を返すために、検出スクリプトから返されるバージョンと同一でなければなりません。

• 解凍（無効）: このオプションは新しいシェルアプリにはお勧めしません。なぜなら、このオプションは単一バージョンモードでのみサポートされており、将来的にはその動作が変更される可能性があるからです。

  注意： このオプションは、SCCM PowerShell アプリケーションのインポートサポートのために特に導入されました。選択した場合、zipファイルは一時フォルダーに抽出され、コンテキストがそのフォルダーに設定されます。したがって、アーカイブ内のファイルを直接使用できます。同じ動作は、次のチェーンを使用することで達成できます: $Context.GetAttachedBinary() -> Expand-Archive -> Set-Location。

• ファイル ：現在のバージョンに特定のファイルを添付し、インストールスクリプトから$Context.GetAttachedBinary()を介して呼び出すことができます。

• インストールをオーバーライド: これは、現在のバージョンをインストールする際にグローバル インストールスクリプトをオーバーライドする機能を提供します。これは、一部の単純なバージョン管理シナリオに便利かもしれません。

パラメータ化

Nerdio Manager v6.1から、任意のスクリプトは、設定 > Nerdio 環境 > セキュア変数タイルに設定されたセキュア変数の値を安全に注入してパラメータ化できます。詳細については、「Scripted Actions グローバル Secure Variables」を参照してください。

この機能を利用するには、スクリプトの先頭に次の定型コードを挿入し、変数の値をスクリプトパラメータとして動的に注入してください。

フローの例

シングルバージョンモード

標準のシングルバージョンインストールの場合、検出スクリプトが最初に実行され、インストールが必要かどうかを判断します。検出ルールがfalseを返す場合（アプリが存在しないことを意味します）、インストールスクリプトが実行されます。その後、検出ルールが再度実行されます。再度falseを返す場合、インストールは失敗として報告されます。trueを返す場合は、成功として報告されます。

マルチバージョンモード

マルチバージョンインストールの場合、検出スクリプトが最初に実行され、インストールが必要かどうかを判断します。バージョン検出ルールが定義されたターゲットバージョンと一致しない値を返す場合、インストールスクリプトが実行されます。その後、検出ルールが再度実行されます。それでも定義されたターゲットバージョンを返さない場合、インストールは失敗として報告されます。定義されたターゲットバージョンを返す場合は、成功として報告されます。

トラブルシューティング

発生したエラーのスタックトレースは、展開ポリシーの詳細ページで確認できます。さらに、特定のホストのホストアプリケーション管理タスクでアプリ管理ログをリクエストボタンを選択することで、すべての展開ログを抽出できます。