UAM: Übersicht und Verwendung von Shell-Apps

Wenn Sie ein hochgeladenes Installationspaket verwenden, kann dieses als Teil des Skripts unter Verwendung der integrierten Variable $Context.GetAttachedBinary() aufgerufen werden. Wenn Sie beispielsweise ein angehängtes Installationspaket installieren möchten, können Sie den folgenden Befehl verwenden:

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

Beim Importieren eines .ZIP-Archivs auf der Seite „Dateien“ von Shell Apps steht die zusätzliche Option „Entpacken“ zur Verfügung. Wenn diese Option ausgewählt ist, entpackt das Skript die komprimierten Dateien automatisch in einen temporären Ordner unter C:\Windows\Temp auf dem Ziel-Desktop.

Nach dem Entpacken wird der Kontext des Skripts automatisch auf das erstellte temporäre Verzeichnis gesetzt, sodass alle Installationsaufgaben mithilfe relativer Pfade im Skript abgeschlossen werden können. Um beispielsweise die Datei EXAMPLE.MSI über das Shell Apps-Installationsskript aufzurufen, verwenden Sie einfach den Befehl .\EXAMPLE.MSI als Teil Ihres Installationsprozesses. Argumente können bei Bedarf hinzugefügt werden. Zusätzlich können weitere Dateien und Aufgaben, wie z. B. Transformationen, ebenfalls über den relativen Pfad aufgerufen werden.

Die Erkennungsskript-Funktion bietet die Möglichkeit, einen Regelsatz zu erstellen, der einen positiven oder negativen Wert für eine bestimmte Abfrage zurückgibt. Nachfolgend finden Sie ein Beispiel für das Erkennungsskript für eine bestimmte Anwendung (Notepad ++).

In diesem Beispiel prüft das PowerShell-Skript effizient das Vorhandensein eines bestimmten Programms, indem es das Vorhandensein seines Installationsordners und der ausführbaren Programmdatei in diesem Ordner überprüft.

Skriptinhalt 

$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

Aufschlüsselung der Komponenten 

Das Installationsskript installiert und konfiguriert alle erforderlichen Komponenten für das erfolgreiche Deployment der Anwendung.

In diesem Beispiel automatisiert das PowerShell-Skript die Installation von Notepad++, indem es den Installer herunterlädt, ihn still ausführt (mit dem /S-Argument) und anschließend aufräumt.

Skriptinhalt 

$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('Installationsskript abgeschlossen')

Aufschlüsselung der Komponenten 

Das Deinstallationsskript bietet die Möglichkeit, eine angegebene Anwendung als Teil des Richtlinienbewertungsprozesses zu entfernen. Das Erkennungsskript wird wiederverwendet, um zu bestätigen, dass die angegebenen Erkennungselemente nicht vorhanden sind.

In diesem Beispiel automatisiert das PowerShell-Skript die Deinstallation von Notepad++, indem es das Vorhandensein sowohl des Programmordners als auch der ausführbaren Datei des Deinstallationsprogramms überprüft. Wenn beide gefunden werden, führt es das Deinstallationsprogramm still aus (/S-Argument).

Skriptinhalt 

$basePath = $env:ProgramFiles
$programFolderName = "Notepad++"
$programFolderFullPath = Join-Path $basePath $programFolderName
$programFolderExists = Test-Path $programFolderFullPath
if (!$programFolderExists)
{
    throw \"Notepad++ wurde nicht gefunden\"
}
$uninstallerFileName = 'uninstall.exe'
$uninstallerFileFullPath = Join-Path $programFolderFullPath $uninstallerFileName
$uninstallerFileExists = Test-Path $uninstallerFileFullPath
if (!$uninstallerFileExists)
{
    throw \"Notepad++-Deinstallationsprogramm wurde nicht gefunden\"
}
Start-Process "$uninstallerFileFullPath" -Wait -ArgumentList "/S" $Context.Log('Deinstallationsskript abgeschlossen')

Aufschlüsselung der Komponenten 

Die Erkennungsskriptfunktion bietet die Möglichkeit, einen Regelsatz zu erstellen, der einen positiven oder negativen Wert für eine bestimmte Abfrage zurückgibt. Nachfolgend finden Sie ein Beispiel für das Erkennungsskript für eine bestimmte Anwendung (7-Zip). Dieses PowerShell-Skript prüft auf das Vorhandensein eines bestimmten Programms, indem es das Vorhandensein seiner Deinstallationsinformationen in der Windows-Registry überprüft.

Skriptinhalt 

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

Aufschlüsselung der Komponenten 

Das Installationsskript installiert und konfiguriert alle erforderlichen Komponenten für das erfolgreiche Deployment der Anwendung. Dieses PowerShell-Skript automatisiert die Installation von 7-Zip, indem es die MSI-Installer-Datei herunterlädt, sie stumm ausführt (/qn-Argument) und anschließend aufräumt.

Skriptinhalt 

$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('Installationsskript abgeschlossen')

Aufschlüsselung der Komponenten 

Das Deinstallationsskript bietet die Möglichkeit, eine bestimmte Anwendung als Teil des Richtlinienbewertungsprozesses zu entfernen. Das Erkennungsskript kann wiederverwendet werden, um zu bestätigen, dass die angegebenen Erkennungselemente nicht vorhanden sind. Dieses PowerShell-Skriptbeispiel automatisiert die Deinstallation von 7-Zip, indem es auf das Vorhandensein seines Deinstallations-Registry-Schlüssels prüft und den Deinstallationsprozess im Hintergrund einleitet.

Skriptkörper 

$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 wurde nicht gefunden"
}
Start-Process msiexec -ArgumentList \"/x `\"$productCode`\" /qn\" -Wait $Context.Log('Deinstallationsskript abgeschlossen')

Aufschlüsselung der Komponenten 

Siehe Unified Application Management: Shell Apps Technical Reference Guide für Details zur Benutzeroberfläche der Versionskonfiguration und Ablaufbeispiele.

Das folgende Beispiel dient als vorgeschlagener Ansatz für die Verwaltung von Versionen innerhalb von Shell Apps. Dies ist eine sehr flexible Funktion, und Kunden können eine Reihe verschiedener erkannter Umgebungsbedingungen nutzen, um den Installationsstatus eines Pakets zu bestimmen. In diesem Beispiel verwenden wir die Dateiversion als Erkennungsregel, diese Funktion ist jedoch gleichermaßen auf Registry-Schlüssel, Dateien und Ordner anwendbar.

Das folgende Erkennungsskript fragt die ausführbare Datei unter dem angegebenen Pfad ab und gibt die Produktversionsinformationen zurück.

$nppDirPath = Join-Path $env:ProgramFiles "Notepad++"
$exePath = Join-Path $nppDirPath 'notepad++.exe'
if (!(Test-Path $exePath))
{
    $null zurückgeben
    # es ist nichts installiert
}
# Version aus .exe-Metadaten auswählen
return (Get-Item $exePath).VersionInfo.ProductVersion

Das untenstehende Installationsskript installiert die Zielversion der Anwendung, die in der UAM-Richtlinie definiert und im Skript als $Context.TargetVersion verfügbar ist.

$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

Das untenstehende Deinstallationsskript entfernt die Anwendung einfach unter Verwendung der definierten Routine, sofern die Bedingungen der Erkennungsregel erfüllt sind.

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