Wat is Local App Launcher?

Met de Workspace 365 Local App Launcher start je lokale Windows-toepassingen vanuit Workspace. Gebruikers hoeven niet meer tussen verschillende omgevingen te schakelen.

De Local App Launcher werkt met een configuratiebestand (Instructions.xml). Dit bestand koppelt Workspace-apps aan toepassingen op het apparaat van de gebruiker. Je voegt ook parameters toe aan toepassingen.

Dit artikel is voor technische beheerders die Workspace 365 beheren.

Wat heb je nodig

Local App Launcher bestaat uit twee bestanden:

• Workspace 365 App Launcher.msi – het installatiebestand (te vinden op het partner portaal)

• Instructions.xml – het configuratiebestand

Vereisten:

• Windows-besturingssysteem op elke cliëntapparaat

• Het .msi-bestand verwerkt commando's van Workspace naar het apparaat

• Instructions.xml bevat de configuratie voor toepassingen

De Instructions.xml bevat al drie vooringestelde toepassingen:

• Google Chrome

• Rekenmachine

• Teams (met twee versies)

Voor Teams zijn twee instructies beschikbaar. Gebruik optie 1 in de meeste situaties. Probeer optie 2 alleen als optie 1 niet werkt.

💡 TIP: De downloadpagina's zijn alleen beschikbaar voor partners en directe klanten. Neem contact op met je Workspace 365-leverancier als je geen toegang hebt.

Installatie

Stap 1: Download Local App Launcher

Dit proces installeert Local App Launcher op je cliëntapparaten:

1. Ga naar de downloadpagina via de support widget op het partnerportaal.

2. Download Workspace 365 App Launcher.msi.

3. Rol het .msi-bestand uit naar de cliëntapparaten.

4. Rol Instructions.xml uit naar dit pad op elke cliënt:

C:\Program Files (x86)\Workspace 365 App Launcher

💡 TIP: Je kunt het .msi-bestand stil installeren. Gebruik Intune of een ander implementatiehulpmiddel om het bestand naar alle cliëntapparaten uit te rollen.

Configuratie van Instructions.xml

Stap 2: Open en bewerk Instructions.xml

Open Instructions.xml in een teksteditor, bijvoorbeeld Notepad. Elke instructie gebruikt deze parameters:


id	Ja	Koppelt de Workspace-app aan de instructie in het XML-bestand.
target	Ja	Bepaalt het pad naar de lokale toepassing.
workingdirectory	Nee	Bepaalt de map waarin de toepassing start.
args	Nee	Voegt parameters toe aan de lokale toepassing.

Waarschuwing: Let op hoofdletters en interpunctie wanneer je het XML-bestand bewerkt.

Voorbeeld van Instructions.xml

<?xml version="1.0" encoding="utf-8" ?>
<Instructions>
  <!-- Explorer -->
  <Instruction id="D0369AB1-EDBB-40DE-B74F-62EE43798C8A" target="%windir%\Explorer.exe" />

  <!-- Snipping Tool -->
  <Instruction id="j8faf5fa-d271-414c-8723-1cedd5881c27" target="SnippingTool.exe" />
  <Instruction id="d8faf5gb-g300-425c-9724-3ccd5981d198" target="C:\Windows\Sysnative\SnippingTool.exe" />

  <!-- Calculator -->
  <Instruction id="G1370AB1-ADJJ-41DC-G75G-73EE43808C9B" target="%windir%\system32\calc.exe" />

  <!-- Chrome -->
  <Instruction id="3ACA9EE8-4204-4B14-98A4-C79D8E7E7E4B" target="Chrome.exe" args="-incognito" />

  <!-- Spotify -->
  <Instruction id="6C09F2CB-099C-457A-BE09-81CEEC529716" target="%AppData%\Spotify\Spotify.exe" />

  <!-- TeamViewer -->
  <Instruction id="GC14C38E-1796-4104-BF32-1E0464574C6A" target="%ProgramW6432%\TeamViewer\TeamViewer.exe" />

  <!-- PowerShell -->
  <Instruction id="4A7F2CAC-2F72-4577-8A3C-F2DD06A39010" target="%SystemRoot%\system32\WindowsPowerShell\v1.0\powershell.exe" />
  <Instruction id="25FDD6A5-175B-4ED2-B3BB-BB76EC768650" target="%windir%\system32\WindowsPowerShell\v1.0\PowerShell_ISE.exe" />
  <Instruction id="5ad45702-c1b1-4eea-a0f4-9d035247ff2f" target="Test\powershell.lnk" workingdirectory="%userprofile%" />
  <Instruction id="351f1c63-75a1-45d0-8a31-d0133d778216" target="powershell_ise.exe" workingdirectory="C:\Windows\System32\WindowsPowerShell\v1.0" />

  <!-- Loom -->
  <Instruction id="1178D2B6-012E-4E76-A25B-B6B97243AE34" target="%LOCALAPPDATA%\Programs\Loom\Loom.exe" />
</Instructions>

Stap 3: Configureer de instructie-id

Vul de id in voor de toepassing. Deze id koppelt de Workspace-app aan de instructie in Instructions.xml.

Je kunt een aangepaste Globally Unique Identifier (GUID) gebruiken. Genereer een GUID via online generator.

Stap 4: Configureer het doelpad

Vul de target in voor de toepassing. Dit is het pad naar de lokale toepassing die Workspace start.

Zorg dat het pad op elke cliëntapparaat bestaat. Local App Launcher start de toepassing alleen als het pad beschikbaar is.

Het App Launcher-proces draait als x86-proces. Wanneer je een systeemvariabele gebruikt zoals %ProgramFiles%, verwijst Windows naar de map Program Files (x86).

Veelgebruikte padindelingen:

1. Alleen de .exe-naam:

target="SnippingTool.exe"

2. Met volledig pad:

target="C:\Windows\Sysnative\SnippingTool.exe"

3. Sysnative (voor 32-bit toepassingen die 64-bit System32 nodig hebben):

target="C:\Windows\Sysnative\SnippingTool.exe"

4. %ProgramW6432% (voor 64-bit Program Files-map):

target="%ProgramW6432%\TeamViewer\TeamViewer.exe"

5. Universal Windows Platform (UWP)-apps:

target="shell:appsFolder\Microsoft.MSPaint_8wekyb3d8bbwe!Microsoft.MSPaint"

💡 TIP: Test het doelpad met het Windows Uitvoeren-commando (Win+R). Gebruik hetzelfde pad in Instructions.xml wanneer het commando werkt.

Stap 5: Configureer de werkmap (optioneel)

Gebruik workingdirectory wanneer de toepassing vanuit een bepaalde map moet starten. Deze optie is beschikbaar vanaf versie 1.2 van Local App Launcher.

Voorbeeld:

<Instruction id="75f51d21-11b2-4cdc-83a7-b5c911f5d69a" target="D:\Deleteme\ShowCurrentFolder.bat" workingdirectory="%userprofile%"/>

Stap 6: Voeg parameters toe (optioneel)

Gebruik args wanneer de lokale toepassing parameters nodig heeft.

Voorbeeld:

args="/root,&quot;C:\Workspace 365 Support&quot;"

Dit start Windows Verkenner in deze map:

C:\Workspace 365 Support

Waarschuwing: Gebruik XML-gecodeerde argumenten. Gebruik " voor aanhalingstekens, niet rechte aanhalingstekens.

Stap 7. Voeg de lokale app toe aan Workspace

Ga naar de App store.
Selecteer Beheer apps.

Inhoud van de afbeelding: de App store met Beheer apps geselecteerd en Nieuwe app toevoegen zichtbaar.
Selecteer Nieuwe app toevoegen.
Voeg de Lokale app toe.
Selecteer Toevoegen.

Inhoud van de afbeelding: het scherm Nieuwe app toevoegen met de tegel Lokale app.
Vul de app-naam in.
Vul de instructie-id in.
Inhoud van de afbeelding: het scherm met de instellingen voor de Lokale app, met de velden App-naam en Instructie-id.

Je kunt ook deze optionele instellingen configureren:
- App-kleur
- Pictogram
- Toegang tot de app
Selecteer Opslaan.

Je kunt de app nu toevoegen aan Workspace vanuit de App store.

Best practices

• Gebruik hetzelfde lokale applicatiepad op elke doelclient.

• Test het doelpad met het Windows Uitvoeren-commando. Gebruik hetzelfde pad in Instructions.xml wanneer het commando werkt.

• Gebruik %ProgramW6432% wanneer de applicatie niet start met het geconfigureerde pad en de applicatie is geïnstalleerd in de 64-bit Program Files-map.

• Gebruik XML-gecodeerde argumenten wanneer het pad spaties bevat.

• Gebruik een deploymenttool, zoals Intune, om de .msi en Instructions.xml uit te rollen naar alle doelclients.

Beperkingen

De Workspace 365 App Launcher werkt op Windows-apparaten.
Het doelpad moet bestaan op elke doelclient.
De App Launcher ondersteunt alleen XML-gecodeerde argumenten.
De downloadpagina’s zijn alleen beschikbaar voor partners en directe klanten.

Troubleshoot

Voor problemen kan je het volgende artikel raadplegen:

Troubleshooting van de Local App Launcher.

Woordenlijst

Workspace 365 App Launcher: Een component waarmee je lokale Windows-applicaties start vanuit Workspace.
MSI: Een Windows-installatiebestand waarmee je de Workspace 365 App Launcher installeert op een client.
Instructions.xml: Het XML-bestand met de instructies voor lokale applicaties.
Instructie-id: De ID die de Workspace-app koppelt aan de instructie in Instructions.xml.
GUID: Een unieke waarde die je kunt gebruiken als instructie-id.
Doel: Het lokale pad naar de applicatie die Workspace start.
Werkmap: De map waarin de applicatie start.
Args: Parameters die de App Launcher meegeeft aan de lokale applicatie.
Sysnative: Een Windows-alias waarmee 32-bit applicaties toegang krijgen tot de 64-bit System32-map.
UWP-app: Een Universal Windows Platform-app, zoals een Microsoft Store-app.

Start lokale apps met de App Launcher