UAM:Shell Appsの概要と使い方

アップロードされたインストーラーパッケージを使用している場合、これはスクリプトの一部として、組み込み変数$Context.GetAttachedBinary() を使用して呼び出すことができます。たとえば、添付されたインストーラーパッケージをインストールしたい場合、次のコマンドを使用できます：

Start-Process $Context.GetAttachedBinary() -Wait -ArgumentList "/S"

Shell Appsの「ファイル」ページで.ZIPアーカイブをインポートする際に、追加の「解凍」オプションが利用可能です。選択された場合、スクリプトは自動的に圧縮ファイルをターゲットデスクトップのC:\Windows\Tempの一時フォルダーに抽出します。

抽出後、スクリプトのコンテキストは自動的に作成された一時ディレクトリに設定されるため、すべてのインストールタスクはスクリプト内で相対パスを使用して完了できます。たとえば、Shell AppsインストールスクリプトからファイルEXAMPLE.MSIを呼び出すには、インストール処理の一部として、コマンド.\EXAMPLE.MSIではなく、コマンド.\EXAMPLE.MSI（実際は「.\EXAMPLE.MSI」）を使用してください。必要に応じて引数を追加できます。さらに、変換などの他のファイルやタスクも相対パスから呼び出すことができます。

検出スクリプト機能では、特定の問い合わせに対して正または負の値を返すルールセットを作成できます。特定のアプリケーション（Notepad ++）のための検出スクリプトの例を以下に示します。

この例では、PowerShellスクリプトが特定のプログラムの存在を確認するために、そのインストールフォルダーとそのフォルダー内のプログラム実行可能ファイルの存在を検証することで効率的にチェックします。

$basePath = $env:ProgramFiles
$programFolderName = "Notepad++"
$programFolderFullPath = Join-Path $basePath $programFolderName
$programFolderExists = Test-Path $programFolderFullPath
if (!$programFolderExists) {
{
    return $false
}
$programFileName = 'notepad++.exe'
$programFileFullPath = Join-Path $programFolderFullPath $programFileName
return Test-Path $programFileFullPath

インストールスクリプトは、アプリの展開を成功させるために必要なすべてのコンポーネントをインストールし、構成します。

この例では、PowerShellスクリプトがNotepad++のインストールを自動化し、インストーラーをダウンロードし、サイレントで実行し（/S引数）、その後クリーンアップします。

$basePath = $env:TEMP
$installerFolderName = "Notepad $(New-Guid)"
$installerFolderFullPath = Join-Path $basePath $installerFolderName
$installerFolderExists = Test-Path $installerFolderFullPath
if ($installerFolderExists) {
{
    Remove-Item $installerFolderFullPath -Recurse -Force -ErrorAction Stop
}
New-Item -Path $basePath -Name $installerFolderName -ItemType Directory -Force | Out-Null
$installerName = 'installer.exe'
$installerFullPath = Join-Path $installerFolderFullPath $installerName
$installerUrl = "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v8.6/npp.8.6.Installer.x64.exe"
Invoke-WebRequest -URI $installerUrl -OutFile $installerFullPath
Start-Process "$installerFullPath" -Wait -ArgumentList "/S"
Remove-Item $installerFolderFullPath -Recurse -Force $Context.Log('Install script completed')

アンインストールスクリプトは、ポリシー評価プロセスの一環として指定されたアプリを削除する機能を提供します。検出スクリプトは再利用され、指定された検出項目が存在しないことを確認します。

この例では、PowerShellスクリプトがプログラムフォルダーとアンインストーラー実行ファイルの両方の存在を確認することでNotepad++のアンインストールを自動化します。両方が見つかった場合、アンインストーラーをサイレントモードで実行します（/S引数）。

$basePath = $env:ProgramFiles
$programFolderName = "Notepad++"
$programFolderFullPath = Join-Path $basePath $programFolderName
$programFolderExists = Test-Path $programFolderFullPath
if (!$programFolderExists) {
{
    throw "Notepad++が見つかりません"
}
$uninstallerFileName = 'uninstall.exe'
$uninstallerFileFullPath = Join-Path $programFolderFullPath $uninstallerFileName
$uninstallerFileExists = Test-Path $uninstallerFileFullPath
if (!$uninstallerFileExists) {
{
    throw "Notepad++アンインストーラーが見つかりません"
}
Start-Process \"$uninstallerFileFullPath\" -Wait -ArgumentList \"/S\" $Context.Log('Uninstall script completed')

検出スクリプト機能は、特定のクエリに対して正または負の値を返すルールセットを作成する能力を提供します。特定のアプリ（7-Zip）の検出スクリプトの例を以下に示します。このPowerShellスクリプトは、Windowsレジストリにおけるアンインストール情報の存在を確認することで、特定のプログラムが存在するかどうかをチェックします。

$basePath = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall"
$productCode = '{23170F69-40C1-2702-2201-000001000000}'
$programRegistryPath = Join-Path $basePath $productCode
return Test-Path $programRegistryPath

インストールスクリプトは、アプリの正常な展開に必要なすべてのコンポーネントをインストールおよび設定します。このPowerShellスクリプトは、インストーラーMSIファイルをダウンロードし、サイレントで実行し（/qn引数）、その後クリーンアップを行うことで7-Zipのインストールを自動化します。

$basePath = $env:TEMP
$installerFolderName = "7zip $(New-Guid)"
$installerFolderFullPath = Join-Path $basePath $installerFolderName
$installerFolderExists = Test-Path $installerFolderFullPath
if ($installerFolderExists) {
{
    Remove-Item $installerFolderFullPath -Recurse -Force -ErrorAction Stop
}
New-Item -Path $basePath -Name $installerFolderName -ItemType Directory -Force | Out-Null
$installerName = 'installer.msi'
$installerFullPath = Join-Path $installerFolderFullPath $installerName
$installerUrl = "https://7-zip.org/a/7z2201-x64.msi"
Invoke-WebRequest -URI $installerUrl -OutFile $installerFullPath
Start-Process msiexec -ArgumentList "/i `"$installerFullPath`" /qn" -Wait
Remove-Item $installerFolderFullPath -Recurse -Force $Context.Log('Install script completed')

アンインストールスクリプトは、ポリシー評価プロセスの一環として指定されたアプリケーションを削除する機能を提供します。検出スクリプトは、指定された検出項目が存在しないことを確認するために再利用できます。この例の PowerShell スクリプトは、7-Zip のアンインストールレジストリキーの存在を確認し、静かにアンインストールプロセスを開始することで、7-Zip のアンインストールを自動化します。

$basePath = "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall"
$productCode = '{23170F69-40C1-2702-2201-000001000000}'
$programRegistryPath = Join-Path $basePath $productCode
$programExists = Test-Path $programRegistryPath
if (!$programExists) {
{
    throw "7-Zipが見つかりません"
}
Start-Process msiexec -ArgumentList "/x `"$productCode`" /qn" -Wait $Context.Log('Uninstall script completed')

統合アプリケーション管理Shell Apps 技術リファレンスガイド には、バージョン設定のユーザーインターフェイスとフローの例に関する詳細が記載されています。

以下の例は、Shell Apps内でバージョンを管理するための提案されたアプローチとして提供されています。これは非常に柔軟な機能であり、顧客はパッケージのインストール状況を判断するために、さまざまな検出された環境条件を利用することができます。この例では、ファイルバージョンを検出ルールとして使用しますが、この機能はレジストリ キー、ファイル、およびフォルダーにも同様に適用されます。

以下の検出スクリプトは、指定されたパスの実行可能ファイルを検査し、製品バージョン情報を返します。

$nppDirPath = Join-Path $env:ProgramFiles "Notepad++"
$exePath = Join-Path $nppDirPath 'notepad++.exe'
if (!(Test-Path $exePath))
{
    return $null
    # 何もインストールされていません
}
# .exe メタデータからバージョンを取得しています
return (Get-Item $exePath).VersionInfo.ProductVersion

以下のインストールスクリプトは、UAMポリシーで定義され、スクリプト内で$Context.TargetVersion として利用できるアプリのターゲットバージョンをインストールします。

$installerTempDir = Join-Path $env:TEMP "Notepad $(New-Guid)" 
$installerPath = Join-Path $installerTempDir 'installer.exe' 
# creating directory in Temp folder New-Item -Path 
$installerTempDir -ItemType Directory -Force | Out-Null 
# generating url dynamically based on target version # configured in deployment policy 
$version = $Context.TargetVersion $installerUrl = "https://github.com/notepad-plus-plus/notepad-plus-plus/releases/download/v$version/npp.$version.Installer.x64.exe" 
# downloading the file and running install with silent switch 
Invoke-WebRequest -URI $installerUrl -OutFile $installerPath 
Start-Process "$installerPath" -Wait -ArgumentList "/S" 
# cleaning up after ourselves 
Remove-Item $installerTempDir -Recurse -Force

以下のアンインストールスクリプトは、検出ルールの条件が満たされている場合に、定義されたルーチンを使用してアプリを単純にアンインストールします。

$nppDirPath = Join-Path $env:ProgramFiles "Notepad++"
$uninstallerPath = Join-Path $nppDirPath 'uninstall.exe'
Start-Process "$uninstallerPath" -Wait -ArgumentList "/S"