Introductie

Je kunt lokale Windows-applicaties starten vanuit Workspace met de Workspace 365 App Launcher.

De App Launcher gebruikt een instructiebestand om een Workspace-app te koppelen aan een lokale applicatie op het apparaat van de gebruiker. Je kunt ook parameters toevoegen aan de lokale applicatie.

Dit artikel is bedoeld voor technische beheerders en mensen die een Workspace 365-ecosysteem beheren.

Vereisten

De Workspace 365 App Launcher bestaat uit twee bestanden:

Workspace 365 App Launcher.msi
Instructions.xml

Je hebt een Windows-besturingssysteem nodig op elke doelclient.

Het bestand Workspace 365 App Launcher.msi handelt de commando’s af die Workspace naar het lokale apparaat stuurt.

Het bestand Instructions.xml bevat de configuratie voor de lokale applicaties en optionele parameters.

Het instructiebestand bevat drie vooraf geconfigureerde applicaties:

Google Chrome
Rekenmachine
Teams

Voor Teams bevat het bestand twee instructies voor de nieuwe Teams. Gebruik optie 1 in de meeste situaties. Gebruik optie 2 wanneer optie 1 niet werkt.

De downloadpagina’s zijn alleen beschikbaar voor partners en directe klanten. Neem contact op met je Workspace 365-leverancier als je geen toegang hebt tot de downloadpagina.

Instructies

Stap 1. Download de Workspace 365 Local App Launcher

Ga naar de downloadpagina via de support widget op het partner portaal.
- Neem contact op met je Workspace 365-leverancier om de bestanden te verstrekken als je geen toegang hebt tot de downloadpagina. Onze downloadpagina's zijn alleen toegankelijk voor partners.
Download de App Launcher.
Rol Workspace 365 App Launcher.msi uit naar de doelclient(s).
Rol Instructions.xml uit naar de Workspace 365 App Launcher-map.

Gebruik dit installatiepad:

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

Je kunt de .msi stil installeren. Gebruik Intune of een andere tool voor applicatie-uitrol.

Stap 2. Bewerk het instructiebestand

Open Instructions.xml in een teksteditor, zoals Notepad.

Elke instructie kan deze parameters gebruiken:

Parameter	Vereist	Beschrijving
`id`	Ja	Koppelt de Workspace-app aan de instructie in het XML-bestand.
`target`	Ja	Bepaalt het lokale applicatiepad.
`workingdirectory`	Nee	Bepaalt de map waarin de applicatie start.
`args`	Nee	Voegt parameters toe aan de lokale applicatie.

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

Voorbeeld van instructiebestand

<?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 applicatie.

De instructie-id is de waarde die de Workspace-app koppelt aan de instructie in Instructions.xml.

Je kunt een aangepaste globally unique identifier (GUID) gebruiken. Je kunt zelf een GUID genereren. Je kan deze link gebruiken

Stap 4. Configureer het doel

Vul de target in voor de applicatie.

Het doel is het lokale pad naar de applicatie die Workspace start.

Gebruik een applicatiepad dat bestaat op elke doelclient. De App Launcher kan de applicatie alleen starten wanneer het pad bestaat op de client.

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

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

Je kunt vaak hetzelfde pad gebruiken dat werkt via het Windows Uitvoeren-commando.

Soms hoef je alleen het .exe-bestand te gebruiken:

target="SnippingTool.exe"

Gebruik Sysnative wanneer een 32-bit applicatie of script toegang nodig heeft tot de 64-bit System32-map:

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

Gebruik dit formaat voor Universal Windows Platform (UWP)-apps:

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

Stap 5. Configureer de werkmap

Gebruik workingdirectory wanneer de applicatie vanuit een specifieke map moet starten.

De werkmap is de map waarin de applicatie start.

Deze optie is beschikbaar vanaf versie 1.2 van de Local App Launcher.

Voorbeeld:

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

Stap 6. Configureer argumenten

Gebruik args wanneer de lokale applicatie parameters nodig heeft.

Voorbeeld:

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

Dit start Windows Verkenner in deze map:

C:\Workspace 365 Support

Gebruik XML-gecodeerde argumenten. Gebruik bijvoorbeeld deze waarde:

&quot;C:\Workspace 365 Support&quot;

Gebruik niet deze waarde:

"C:\Workspace 365 Support"

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 doelclient(s).

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

Problemen met de Local App Launcher

Wat zie je?
De lokale applicatie start niet vanuit Workspace.

Wat betekent het?
De App Launcher kan de startactie niet voltooien.

Wat moet je doen?
Open het speciale artikel 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