Hinzufügen und Verwalten von App Attach- und MSIX App Attach-Anwendungen in Azure Virtual Desktop

Hier erfahren Sie, wie Sie ein MSIX- oder Appx-Image als App Attach-Paket mithilfe des Azure-Portals hinzufügen:

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus, um zur Übersicht über Azure Virtual Desktop zu navigieren.

3. Wählen Sie App Attach aus, und wählen Sie dann + Erstellen aus.

4. Geben Sie auf der Registerkarte Grundeinstellungen die folgenden Informationen an:

   Parameter	BESCHREIBUNG
   Abonnement	Wählen Sie das Abonnement aus, dem Sie ein MSIX- oder Appx-Image aus der Dropdownliste hinzufügen möchten.
   Resource group	Wählen Sie eine vorhandene Ressourcengruppe aus, oder wählen Sie die Option Neu erstellen aus, und geben Sie einen Namen ein.
   Hostpool	Wählen Sie in der Dropdownliste einen vorhandenen Hostpool aus.
   Standort	Wählen Sie die Azure-Region für Ihr App Attach-Paket aus.

   Nachdem Sie diese Registerkarte ausgefüllt haben, wählen Sie Weiter aus.

5. Füllen Sie auf der Registerkarte Imagepfad die folgenden Informationen aus:

   Parameter	Beschreibung
   Imagepfad	Wählen Sie unter Aus Speicherkonto auswählen aus, wenn Ihr Image in Azure Files oder Input UNC gespeichert ist, um einen UNC-Pfad anzugeben. Nachfolgende Felder hängen davon ab, welche Option Sie auswählen.
   Aus Speicherkonto auswählen
   Speicherkonto	Wählen Sie das Speicherkonto aus, in dem sich Ihr Image befindet.
   Dateifreigabe	Klicken Sie auf Eine Datei auswählen und navigieren Sie dann zur Dateifreigabe und zum Verzeichnis, in dem sich Ihr Image befindet. Aktivieren Sie das Kontrollkästchen neben dem Image, das Sie hinzufügen möchten, z. B. MyApp.cim, und wählen Sie dann Auswählen aus.
   MSIX-Paket	Wählen Sie das MSIX- oder Appx-Paket aus dem Image aus.
   Input UNC
   UNC	Geben Sie den UNC-Pfad zu Ihrer Imagedatei ein.
   MSIX-Paket	Wählen Sie das MSIX- oder Appx-Paket aus dem Image aus.
   Beide Optionen
   Anzeigename	Geben Sie einen Anzeigenamen für Ihre Anwendung ein.
   Version	Überprüfen Sie, ob die erwartete Versionsnummer angezeigt wird.
   Registrierungstyp	Wählen Sie den Registrierungstyp aus, den Sie verwenden möchten.
   Zustand	Wählen Sie den Anfangszustand für das Paket aus.
   Status der Integritätsprüfung bei Fehler	Wählen Sie den Status für das Paket aus, wenn es nicht auf einem Sitzungshost bereitgestellt werden kann. Dieser Status wird für AppAttachHealthCheck für den Status der Integritätsprüfung des Sitzungshosts gemeldet.

   Nachdem Sie diese Registerkarte ausgefüllt haben, wählen Sie Weiter aus.

   Tipp

   Nachdem Sie diese Registerkarte abgeschlossen haben, können Sie die Anwendung optional den Hostpools, Benutzern und Gruppen zuweisen. Wenn Sie Zuordnungen auch separat konfigurieren möchten, wählen Sie Überprüfen und erstellen aus, und wechseln Sie dann zu Zuweisen eines App Attach-Pakets.

6. Optionaler: Führen Sie auf der Registerkarte Zuordnungen die folgenden Informationen aus:

   1. Wählen Sie als Hostpool die Hostpools aus, denen Sie die Anwendung zuweisen möchten. Wenn Sie bereits MSIX App Attach mit einem Hostpool verwenden, können Sie diesen Hostpool nicht auswählen, da Sie nicht beide Versionen von App Attach mit demselben Hostpool verwenden können.

   2. Wählen Sie Benutzer oder Benutzergruppen hinzufügen aus, und suchen Sie dann nach den Benutzern oder Gruppen, die Sie der Anwendung zuweisen möchten. Wenn Sie fertig sind, wählen Sie Auswählen aus.

   3. Überprüfen Sie die hinzugefügten Aufgaben, und wählen Sie dann Weiter aus.

7. Optional: Auf der Registerkarte Tags können Sie alle erforderlichen Namen/Wert-Paare eingeben. Anschließend wählen Sie Überprüfen und erstellen aus.

8. Stellen Sie auf der Registerkarte Überprüfen und erstellen sicher, dass die Überprüfung erfolgreich ist, und überprüfen Sie die Informationen, die während der Bereitstellung verwendet werden, und wählen Sie dann Erstellen aus, um die Anwendung hinzuzufügen.

Hier erfahren Sie, wie Sie ein MSIX- oder Appx-Image als App Attach-Paket mithilfe des PowerShell-Moduls Az.DesktopVirtualization hinzufügen. Legen Sie die <placeholder>-Werte auf Ihre eigenen Werte fest.

1. Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem Terminaltyp PowerShell, oder führen Sie PowerShell auf Ihrem lokalen Gerät aus.

   • Wenn Sie Cloud Shell verwenden, stellen Sie sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

   • Wenn Sie die PowerShell lokal verwenden, müssen Sie sich zunächst mit Azure PowerShell anmelden und dann sicherstellen, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

2. Überprüfen Sie während der Vorschau, ob die PowerShell-Cmdlets verfügbar sind, indem Sie die folgenden Befehle ausführen:

   Import-Module Az.DesktopVirtualization
   Get-Command -Module Az.DesktopVirtualization -Noun "*AppAttach*"
   

   Die Ausgabe sollte in etwa wie folgt aussehen:

   CommandType     Name                                               Version    Source
   -----------     ----                                               -------    ------
   Function        Get-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Import-AzWvdAppAttachPackageInfo                   4.2.1      Az.DesktopVirtualization
   Function        New-AzWvdAppAttachPackage                          4.2.1      Az.DesktopVirtualization
   Function        Remove-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   Function        Update-AzWvdAppAttachPackage                       4.2.1      Az.DesktopVirtualization
   

3. Rufen Sie die Eigenschaften des Images ab, das Sie hinzufügen möchten, und speichern Sie sie in einer Variablen, indem Sie den folgenden Befehl ausführen. Sie müssen einen Hostpool angeben, aber es kann sich um einen beliebigen Hostpool handeln, in dem Sitzungshosts Zugriff auf die Dateifreigabe haben.

   # Get the properties of the MSIX or Appx image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

4. Überprüfen Sie, ob nur ein Objekt in den Anwendungseigenschaften vorhanden ist, indem Sie die folgenden Befehle ausführen:

   $app | FL *
   

   Optional: Wenn Sie mehrere Objekte in der Ausgabe haben, z. B. eine x64- und eine x86-Version derselben Anwendung, können Sie den Parameter PackageFullName verwenden, um anzugeben, welche Anwendung Sie hinzufügen möchten, indem Sie die folgenden Befehle ausführen:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

5. Fügen Sie das Image als App Attach-Paket hinzu, indem Sie den folgenden Befehl ausführen. In diesem Beispiel wird der Anwendungsstatus als aktiv markiert, die Anwendungsregistrierung wird auf On-Demand festgelegt, und der Status der Sitzungshost-Integritätsprüfung bei Fehlern wird auf NeedsAssistance festgelegt ist:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       FailHealthCheckOnStagingFailure = 'NeedsAssistance'
       ImageIsRegularRegistration = $false
       ImageDisplayName = '<AppDisplayName>'
       ImageIsActive = $true
   }
   
   New-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

   Es gibt keine Ausgabe, wenn das Paket erfolgreich hinzugefügt wurde.

6. Sie können überprüfen, ob das Paket hinzugefügt wird, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdAppAttachPackage @parameters | FL Name, ImagePackageApplication, ImagePackageFamilyName, ImagePath, ImageVersion, ImageIsActive, ImageIsRegularRegistration, SystemDataCreatedAt
   

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

   Name                       : My App
   ImagePackageApplication    : {MyApp}
   ImagePackageFamilyName     : MyApp_abcdef123ghij
   ImagePath                  : \\fileshare\Apps\MyApp\MyApp.cim
   ImageVersion               : 1.0.0.0
   ImageIsActive              : True
   ImageIsRegularRegistration : True
   SystemDataCreatedAt        : 7/31/2023 3:03:43 PM
   

Hier erfahren Sie, wie Sie einem Anwendungspaket Hostpools, Benutzer und Gruppen mithilfe des Azure-Portals zuweisen:

Hostpools

1. Wählen Sie in der Azure Virtual Desktop-Übersicht App Attach aus und wählen Sie dann den Namen des App Attach-Pakets aus, das Sie zuweisen möchten.

2. Wählen Sie im Abschnitt Verwalten Hostpools aus:

3. Wählen Sie + Zuweisen und dann einen oder mehrere Hostpools aus der Dropdownliste aus. Stellen Sie sicher, dass alle Sitzungshosts im Hostpool über Lesezugriff mit ihrem Computerkonto verfügen müssen, wie in den Voraussetzungen aufgeführt.

4. Wählen Sie Hinzufügen aus.

Gruppen und Benutzer

1. Wählen Sie in der Azure Virtual Desktop-Übersicht App Attach aus und wählen Sie dann den Namen des App Attach-Pakets aus, das Sie zuweisen möchten.

2. Wählen Sie im Abschnitt Verwalten Benutzer aus:

3. Wählen Sie + Hinzufügen und dann eine oder mehrere Gruppen und/oder Benutzer aus der Liste aus.

4. Wählen Sie Auswählen aus.

Hier erfahren Sie, wie Sie einem Anwendungspaket Hostpools sowie Gruppen und Benutzern mithilfe des PowerShell-Moduls Az.DesktopVirtualization zuweisen.

Hostpools

1. Rufen Sie in derselben PowerShell-Sitzung die Ressourcen-IDs der Hostpools ab, denen Sie die Anwendung zuweisen möchten, und fügen Sie sie einem Array hinzu, indem Sie die folgenden Befehle ausführen:

   # Add a comma-separated list of host pools names
   $hostPoolNames = "<HostPoolName1>","<HostPoolName2>"
   
   # Create an array and add the resource ID for each host pool
   $hostPoolIds = @()
   foreach ($hostPoolName in $HostPoolNames) {
       $hostPoolIds += (Get-AzWvdHostPool | ? Name -eq $hostPoolName).Id
   }
   

2. Sobald Sie über die Ressourcen-IDs der Hostpools verfügen, können Sie ihnen das Anwendungspaket zuweisen, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = $hostPoolIds
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

3. Um die Zuweisung des Anwendungspakets von allen Hostpools aufzuheben, können Sie ein leeres Array von Hostpools übergeben, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       Name = '<AppName>'
       ResourceGroupName = '<ResourceGroupName>'
       Location = '<AzureRegion>'
       HostPoolReference = @()
   }
   
   Update-AzWvdAppAttachPackage @parameters
   

Gruppen und Benutzer

Hier erfahren Sie, wie Sie Gruppen und Benutzern mithilfe des PowerShell-Moduls Az.DesktopVirtualization eine Anwendung zuweisen.

1. Rufen Sie die Objekt-ID der Gruppen oder Benutzer ab, die Sie der Anwendung hinzufügen oder daraus entfernen möchten, und fügen Sie sie mithilfe eines der folgenden Beispiele zu einem Array hinzu. Es wird empfohlen, Gruppen Anwendungen zuzuweisen.

   1. Rufen Sie die Objekt-ID der Gruppe oder Gruppen ab, und fügen Sie sie einem Array hinzu, indem Sie die folgenden Befehle ausführen. In diesem Beispiel wird der Anzeigename der Gruppe verwendet:

      # Add a comma-separated list of group names
      $groups = "Group1","Group2"
      
      # Connect to Microsoft Graph
      Connect-MgGraph -Scopes 'Group.Read.All'
      
      # Create an array and add the ID for each group
      $Ids = @()
      
      foreach ($group in $groups) {
         $Ids += (Get-MgGroup | ? DisplayName -eq $group).Id
      }
      

   2. Rufen Sie die Objekt-ID der Benutzer ab, und fügen Sie sie einem Array hinzu, indem Sie die folgenden Befehle ausführen. In diesem Beispiel wird der Benutzerprinzipalname (UPN) verwendet:

      # Add a comma-separated list of user principal names
      $users = "user1@contoso.com","user2@contoso.com"
      
      # Connect to Azure AD
      Connect-MgGraph -Scopes 'User.Read.All'
      
      # Create an array and add the ID for each user
      $userIds = @()
      
      foreach ($user in $users) {
          $userIds += (Get-MgUser | ? UserPrincipalName -eq $user).Id
      }
      

2. Sobald Sie über die Objekt-IDs der Benutzer oder Gruppen verfügen, können Sie sie der Anwendung hinzufügen oder sie daraus entfernen, indem Sie eines der folgenden Beispiele verwenden, das die RBAC-Rolle Desktop Virtualization User zuweist.

   1. Führen Sie die folgenden Befehle aus, um die Gruppen oder Benutzer zur Anwendung hinzuzufügen:

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         New-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

   2. Führen Sie die folgenden Befehle aus, um die Gruppen oder Benutzer aus der Anwendung zu entfernen:

      $parameters = @{
         Name = '<AppName>'
         ResourceGroupName = '<ResourceGroupName>'
      }
      
      $appAttachPackage = Get-AzWvdAppAttachPackage @parameters
      
      foreach ($userId in $userIds) {
         Remove-AzRoleAssignment -ObjectId $userId -RoleDefinitionName "Desktop Virtualization User" -Scope $appAttachPackage.Id
      }
      

Hier erfahren Sie, wie Sie den Registrierungstyp und den Status eines Pakets mithilfe des Azure-Portals ändern:

1. Wählen Sie in der Übersicht über Azure Virtual Desktop App Attach aus. Es sollte eine Liste aller vorhandenen Pakete im Hostpool angezeigt werden.

2. Wählen Sie den Namen des Pakets aus, das Sie ändern möchten.

   1. Um den Registrierungstyp zu ändern, wählen Sie On-Demand oder Registrieren bei der Anmeldung und dann Speichern aus.

   2. Um den Zustand zu ändern, wählen Sie Inaktiv oder Aktiv und dann Speichern aus.

Hier erfahren Sie, wie Sie den Registrierungstyp und den Status eines Pakets mithilfe des PowerShell-Moduls Az.DesktopVirtualization ändern.

1. In derselben PowerShell-Sitzung können Sie den Registrierungstyp und den Status ändern, indem Sie die folgenden Befehle ausführen:

   1. Ändern Sie den Registrierungstyp, indem Sie den folgenden Befehl ausführen. Legen Sie IsRegularRegistration auf $true für Registrieren bei der Anmeldung oder $false für On-Demand fest.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

   2. Ändern Sie den Status, indem Sie den folgenden Befehl ausführen. Legen Sie IsActive auf $true für Aktive oder auf $false für Inaktiv fest.

      $parameters = @{
          Name = '<Name>'
          ResourceGroupName = '<ResourceGroupName>'
          Location = '<AzureRegion>'
          IsActive = $true
      }
      
      Update-AzWvdAppAttachPackage @parameters
      

Hier erfahren Sie, wie Sie eine Anwendung aus dem Paket hinzufügen, das Sie in diesem Artikel zu einer RemoteApp-Anwendungsgruppe mithilfe des Azure-Portals hinzugefügt haben:

1. Wählen Sie in der Übersicht über Azure Virtual Desktop Anwendungsgruppen aus, und wählen Sie dann die RemoteApp-Anwendungsgruppe aus, der Sie eine Anwendung hinzufügen möchten.

2. Wählen Sie Anwendungen und + Hinzufügen aus. Stellen Sie sicher, dass mindestens ein Sitzungshost im Hostpool eingeschaltet ist, dem die Anwendungsgruppe zugewiesen ist.

3. Geben Sie auf der Registerkarte Grundeinstellungen die folgenden Informationen an:

   Parameter	Wert/Beschreibung
   Anwendungsquelle	Wählen Sie App Attach aus der Dropdownliste aus. Wenn Sie Anwendungen aus dem Startmenü hinzufügen oder einen Dateipfad angeben möchten, lesen Sie Veröffentlichen von Anwendungen mit RemoteApp.
   Paket	Wählen Sie in der Dropdownliste ein für den Hostpool verfügbares Paket aus. Regionale Pakete stammen aus App Attach.
   Application	Wählen Sie eine Anwendung aus der Dropdownliste aus.
   Anwendungskennung	Geben Sie einen eindeutigen Bezeichner für die Anwendung ein.
   Anzeigename	Geben Sie einen Anzeigenamen für die Anwendung ein, die für Benutzer vorgesehen ist.
   Beschreibung	Geben Sie eine Beschreibung für die Anwendung ein.

   Nachdem Sie diese Registerkarte ausgefüllt haben, wählen Sie Weiter aus.

4. Wählen Sie auf der Registerkarte Symbol Standard aus, um das Standardsymbol für die Anwendung zu verwenden, oder wählen Sie Dateipfad aus, um ein benutzerdefiniertes Symbol zu verwenden. Wählen Sie für den Dateipfad eine der folgenden Optionen aus:

   • Durchsuchen Sie Azure Files, um ein Symbol aus einer Azure-Dateifreigabe zu verwenden. Wählen Sie ein Speicherkonto aus, und wählen Sie das Speicherkonto aus, das Ihre Symboldatei enthält, und wählen Sie dann Symboldatei auswählen aus. Navigieren Sie zur Dateifreigabe und zum Verzeichnis, in dem sich Ihr Symbol befindet, aktivieren Sie das Kontrollkästchen neben dem Symbol, das Sie hinzufügen möchten, z. B. MyApp.ico und wählen Sie dann Auswählen aus. Sie können auch eine .png-Datei verwenden. Geben Sie für Symbolindex die Indexnummer für das Symbol an, das Sie verwenden möchten. Diese Zahl ist in der Regel 0.

   • UNC-Dateipfad, um ein Symbol aus einer Dateifreigabe zu verwenden. Geben Sie als Symbolpfad den UNC-Pfad zu Ihrer Symboldatei ein, z. B. \\MyFileShare\MyApp.ico. Sie können auch eine .png-Datei verwenden. Geben Sie für Symbolindex die Indexnummer für das Symbol an, das Sie verwenden möchten. Diese Zahl ist in der Regel 0.

   Nachdem Sie diese Registerkarte abgeschlossen haben, wählen Sie Überprüfen und hinzufügen.

5. Stellen Sie auf der Registerkarte Überprüfen und hinzufügen sicher, dass die Überprüfung bestanden ist, und überprüfen Sie die Informationen, die zum Hinzufügen der Anwendung verwendet werden. Wählen Sie dann Hinzufügen aus, um die Anwendung zur RemoteApp-Anwendungsgruppe hinzuzufügen.

Hier erfahren Sie, wie Sie eine Anwendung aus dem Paket hinzufügen, das Sie in diesem Artikel zu einer RemoteApp-Anwendungsgruppe mithilfe des PowerShell-Moduls Az.DesktopVirtualization hinzugefügt haben.

1. Wenn mehrere Anwendungen im Paket vorhanden sind, müssen Sie in derselben PowerShell-Sitzung die Anwendungs-ID der Anwendung abrufen, die Sie aus dem Paket hinzufügen möchten, indem Sie die folgenden Befehle ausführen:

   Write-Host "These are the application IDs available in the package. Many packages only contain one application." -ForegroundColor Yellow
   $app.ImagePackageApplication.AppId
   

2. Notieren Sie sich die Anwendungs-ID, die Sie veröffentlichen möchten (z. B. App), und führen Sie dann die folgenden Befehle aus, um die Anwendung der RemoteApp-Anwendungsgruppe hinzuzufügen:

   $parameters = @{
       Name = '<ApplicationName>'
       ApplicationType = 'MsixApplication'
       MsixPackageFamilyName = $app.ImagePackageFamilyName
       MsixPackageApplicationId = '<ApplicationID>'
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
       CommandLineSetting = 'DoNotAllow'
   }
   
   New-AzWvdApplication @parameters
   

3. Überprüfen Sie die Liste der Anwendungen in der Anwendungsgruppe, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       GroupName = '<ApplicationGroupName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdApplication @parameters
   

Hier erfahren Sie, wie Sie ein vorhandenes Paket mithilfe des Azure-Portals aktualisieren:

1. Wählen Sie in der Übersicht über Azure Virtual Desktop App Attach aus. Es sollte eine Liste aller vorhandenen Pakete angezeigt werden.

2. Wählen Sie das Paket aus, das Sie aktualisieren möchten, und wählen Sie dann in der Übersicht Aktualisieren aus.

3. Geben Sie die Informationen für das aktualisierte Paket ein:

   1. Abonnement und Ressourcengruppe werden mit den Werten für das aktuelle Paket vorab aufgefüllt.

   2. Wählen Sie den Hostpool aus, für den Sie das Paket aktualisieren möchten.

   3. Wählen Sie den Imagepfad in Aus Speicherkonto auswählen oder Input UNC aus. Nachfolgende Felder hängen davon ab, welche Option Sie auswählen.

      1. Wählen Sie in Aus Speicherkonto auswählen das Speicherkonto aus, welches das aktualisierte Image enthält. Klicken Sie auf Eine Datei auswählen und navigieren Sie dann zur Dateifreigabe und zum Verzeichnis, in dem sich Ihr Image befindet. Aktivieren Sie das Kontrollkästchen neben dem Image, das Sie hinzufügen möchten, z. B. MyApp.cim, und wählen Sie dann Auswählen aus.
      2. Geben Sie als Input UNC den UNC-Pfad zu Ihrer Imagedatei ein.

   4. Wählen Sie als MSIX-Paket das MSIX- oder Appx-Paket aus dem Image aus.

4. Nachdem Sie die Felder ausgefüllt haben, wählen Sie Aktualisieren aus.

Hier erfahren Sie, wie Sie ein vorhandenes Paket mithilfe des PowerShell-Moduls Az.DesktopVirtualization aktualisieren.

1. Rufen Sie in derselben PowerShell-Sitzung die Eigenschaften der aktualisierten Anwendung ab, und speichern Sie sie in einer Variablen, indem Sie die folgenden Befehle ausführen:

   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters
   

2. Überprüfen Sie, ob nur ein Objekt in den Anwendungseigenschaften vorhanden ist, indem Sie die folgenden Befehle ausführen:

   $app | FL *
   

   Wenn sich mehrere Objekte in Ihrer Ausgabe befinden, z. B. eine x64- und eine x86-Version derselben Anwendung, können Sie den Parameter PackageFullName verwenden, um anzugeben, welches Objekt Sie hinzufügen möchten, indem Sie die folgenden Befehle ausführen:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Path = '<UNCPathToImageFile>'
   }
   
   $app = Import-AzWvdAppAttachPackageInfo @parameters | ? ImagePackageFullName -like *$packageFullName*
   

3. Aktualisieren Sie ein vorhandenes Paket, indem Sie den folgenden Befehl ausführen. Das neue Datenträgerimage ersetzt das vorhandene, aber vorhandene Zuordnungen werden beibehalten. Löschen Sie das vorhandene Image erst, wenn Benutzer es nicht mehr verwenden.

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Update-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
   

So entfernen Sie ein App Attach-Paket mithilfe des Azure-Portals:

1. Wählen Sie in der Übersicht über Azure Virtual Desktop App Attach aus. Es sollte eine Liste aller vorhandenen Pakete angezeigt werden.

2. Aktivieren Sie das Kontrollkästchen neben dem Namen des Pakets, das Sie entfernen möchten, und wählen Sie dann Entfernen aus. Das Paket wird auch aus allen Hostpools entfernt, denen es zugewiesen ist.

Hier erfahren Sie, wie Sie ein App Attach-Paket mithilfe des PowerShell-Moduls Az.DesktopVirtualization entfernen.

1. Führen Sie in derselben PowerShell-Sitzung den folgenden Befehl aus, um das Paket zu entfernen, das eine Anwendung enthält:

   $parameters = @{
       Name = '<PackageName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdAppAttachPackage @parameters
   

Hier erfahren Sie, wie Sie ein MSIX-Image mithilfe des Azure-Portals hinzufügen:

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie in der Suchleiste Azure Virtual Desktop ein, und wählen Sie den entsprechenden Diensteintrag aus, um zur Übersicht über Azure Virtual Desktop zu navigieren.

3. Wählen Sie Hostpools und dann den Namen des Hostpools aus, dem Sie ein MSIX-Image hinzufügen möchten.

4. Wählen Sie in der Übersicht über den Hostpool MSIX-Pakete und dann + Hinzufügen aus.

5. Geben Sie für den MSIX-Imagepfad einen gültigen UNC-Pfad ein, der auf das MSIX-Image in der Dateifreigabe zeigt, z. B. \\fileshare\Apps\MyApp\MyApp.cim, und wählen Sie dann Hinzufügen aus, wodurch der Pfad überprüft wird.

6. Nachdem der Pfad überprüft wurde, werden weitere Felder angezeigt. Führen Sie die folgenden Informationen aus:

   Parameter	Beschreibung
   MSIX-Paket	Wählen Sie im Dropdownmenü den entsprechenden MSIX-Paketnamen aus.
   Paketanwendungen	Dies zeigt App und kann nicht konfiguriert werden.
   Anzeigename	Geben Sie einen Anzeigenamen für Ihr Paket ein.
   Version	Überprüfen Sie, ob die erwartete Versionsnummer angezeigt wird.
   Registrierungstyp	Wählen Sie den Registrierungstyp aus, den Sie verwenden möchten.
   Zustand	Wählen Sie den Anfangszustand für das Paket aus.

7. Nachdem Sie die Felder abgeschlossen haben, wählen Sie Hinzufügen aus.

Hier erfahren Sie, wie Sie ein MSIX-Paket mithilfe des PowerShell-Moduls Az.DesktopVirtualization hinzufügen. Legen Sie die <placeholder>-Werte auf Ihre eigenen Werte fest.

1. Öffnen Sie Azure Cloud Shell im Azure-Portal mit dem Terminaltyp PowerShell, oder führen Sie PowerShell auf Ihrem lokalen Gerät aus.

   • Wenn Sie Cloud Shell verwenden, stellen Sie sicher, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

   • Wenn Sie die PowerShell lokal verwenden, müssen Sie sich zunächst mit Azure PowerShell anmelden und dann sicherstellen, dass Ihr Azure-Kontext auf das Abonnement festgelegt ist, das Sie verwenden möchten.

2. Rufen Sie die Eigenschaften der Anwendung im MSIX-Image ab, das Sie hinzufügen möchten, und speichern Sie sie in einer Variablen, indem Sie die folgenden Befehle ausführen:

   # Get the properties of the MSIX image
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCPathToImageFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters
   

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

   Name
   ----
   hp01/expandmsiximage
   

3. Überprüfen Sie, ob nur ein Objekt in den Anwendungseigenschaften vorhanden ist, indem Sie die folgenden Befehle ausführen:

   $app | FL *
   

   Wenn sich mehrere Objekte in Ihrer Ausgabe befinden, z. B. eine x64- und eine x86-Version derselben Anwendung, können Sie den Parameter PackageFullName verwenden, um anzugeben, welches Objekt Sie hinzufügen möchten, indem Sie die folgenden Befehle ausführen:

   # Specify the package full name
   $packageFullName = '<PackageFullName>'
   
   # Get the properties of the application
   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       Uri = '<UNCPathToImageFile>'
   }
   
   $app = Expand-AzWvdMsixImage @parameters | ? PackageFullName -like *$packageFullName*
   

4. Fügen Sie das MSIX-Image zu einem Hostpool hinzu, indem Sie den folgenden Befehl ausführen. In diesem Beispiel wird der Anwendungsstatus als aktiv angezeigt.

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
       PackageAlias = $app.PackageAlias
       DisplayName = '<DisplayName>'
       ImagePath = $app.ImagePath
       IsActive = $true
   }
   
   New-AzWvdMsixPackage @parameters
   

   Es gibt keine Ausgabe, wenn das MSIX-Paket erfolgreich hinzugefügt wird.

5. Sie können überprüfen, ob das MSIX-Paket hinzugefügt wird, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | ? PackageFamilyName -eq $app.PackageFamilyName | FL *
   

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

   DisplayName                  : My App
   Id                           : /subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/avd/providers/Microsoft.DesktopVirtualization/hostpools/hp01/msixpackages/MyApp_1.0.0.0_neutral__abcdef123ghij
   ImagePath                    : \\fileshare\Apps\MyApp\MyApp.cim
   IsActive                     : True
   IsRegularRegistration        : False
   LastUpdated                  : 7/27/2023 10:02:29 AM
   Name                         : hp01/MyApp_1.0.0.0_neutral__abcdef123ghij
   PackageApplication           : {MyApp}
   PackageDependency            : {}
   PackageFamilyName            : MyApp_abcdef123ghij
   PackageName                  : MyApp
   PackageRelativePath          : apps\MyApp_1.0.0.0_neutral__abcdef123ghij
   SystemDataCreatedAt          : 7/28/2023 9:04:00 AM
   SystemDataCreatedBy          : avdadmin@contoso.com
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 7/28/2023 9:04:00 AM
   SystemDataLastModifiedBy     : avdadmin@contoso.com
   SystemDataLastModifiedByType : User
   Type                         : Microsoft.DesktopVirtualization/hostpools/msixpackages
   Version                      : 1.0.0.0
   

Hier erfahren Sie, wie Sie den Registrierungstyp und den Status eines Pakets mithilfe des Azure-Portals ändern:

1. Wählen Sie in der Übersicht über Azure Virtual Desktop Hostpools aus, und wählen Sie dann den Namen des Hostpools aus, dem das MSIX-Paket hinzugefügt wird.

2. Wählen Sie in der Übersicht über den Hostpool MSIX-Pakete aus. Es sollte eine Liste aller vorhandenen MSIX-Pakete innerhalb des Hostpools angezeigt werden.

3. Wählen Sie den Namen des MSIX-Pakets aus, das Sie ändern möchten.

   1. Um den Registrierungstyp zu ändern, wählen Sie On-Demand oder Registrieren bei der Anmeldung und dann Speichern aus.

   2. Um den Zustand zu ändern, wählen Sie Inaktiv oder Aktiv und dann Speichern aus.

Hier erfahren Sie, wie Sie den Registrierungstyp und den Status eines Pakets mithilfe des PowerShell-Moduls Az.DesktopVirtualization ändern.

1. Rufen Sie in derselben PowerShell-Sitzung eine Liste der MSIX-Pakete in einem Hostpool und deren aktuellen Registrierungstyp und -status ab, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, Name, Version, IsRegularRegistration, IsActive
   

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

   DisplayName ImagePath                        Name                                      Version IsRegularRegistration IsActive
   ----------- ---------                        -----------------                         ------- --------------------- --------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0                 False     True
   

2. Suchen Sie das Paket, das Sie entfernen möchten, und verwenden Sie den Wert für den Name-Parameter, entfernen Sie jedoch den Hostpoolnamen und / aus dem Start. Beispielsweise wird hp01/MyApp_1.0.0.0_neutral__abcdef123ghij zu MyApp_1.0.0.0_neutral__abcdef123ghij. Nachstehend sind einige Beispiele angegeben.

   1. Ändern Sie den Registrierungstyp, indem Sie den folgenden Befehl ausführen. Legen Sie IsRegularRegistration auf $true für Registrieren bei der Anmeldung oder $false für On-Demand fest.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsRegularRegistration = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

   2. Ändern Sie den Status, indem Sie den folgenden Befehl ausführen. Legen Sie IsActive auf $true für Aktive oder auf $false für Inaktiv fest.

      $parameters = @{
          FullName = '<FullName>'
          HostPoolName = '<HostPoolName>'
          ResourceGroupName = '<ResourceGroupName>'
          IsActive = $true
      }
      
      Update-AzWvdMsixPackage @parameters
      

Hier erfahren Sie, wie Sie eine Anwendung aus dem Paket hinzufügen, das Sie in diesem Artikel zu einer RemoteApp-Anwendungsgruppe mithilfe des Azure-Portals hinzugefügt haben:

1. Wählen Sie in der Azure Virtual Desktop-Übersicht Anwendungsgruppen und dann die Desktop- oder RemoteApp-Anwendungsgruppe aus, der Sie eine Anwendung hinzufügen möchten.

2. Wählen Sie Anwendungen und + Hinzufügen aus. Stellen Sie sicher, dass mindestens ein Sitzungshost im Hostpool eingeschaltet ist, dem die Anwendungsgruppe zugewiesen ist.

3. Auf der Registerkarte Grundlagen hängen die angezeigten Optionen davon ab, ob Ihre Anwendungsgruppe für einen Desktop oder eine RemoteApp ist:

   1. Füllen Sie für eine Desktopanwendungsgruppe die folgenden Informationen aus:

      Parameter	Wert/Beschreibung
      Anwendungsquelle	MSIX-Paket wird automatisch ausgewählt und ausgegraut.
      Paket	Wählen Sie in der Dropdownliste ein für den Hostpool verfügbares Paket aus.
      Anwendungskennung	Geben Sie einen eindeutigen Bezeichner für die Anwendung ein.
      Anzeigename	Geben Sie einen Anzeigenamen für die Anwendung ein, die für Benutzer vorgesehen ist.
      Beschreibung	Geben Sie eine Beschreibung für die Anwendung ein.

      Nachdem Sie diese Registerkarte abgeschlossen haben, wählen Sie Überprüfen und hinzufügen.

   2. Füllen Sie für eine RemoteApp-Anwendungsgruppe die folgenden Informationen aus:

      Parameter	Wert/Beschreibung
      Anwendungsquelle	Wählen Sie App Attach aus der Dropdownliste aus. Wenn Sie Anwendungen aus dem Startmenü hinzufügen oder einen Dateipfad angeben möchten, lesen Sie Veröffentlichen von Anwendungen mit RemoteApp.
      Paket	Wählen Sie in der Dropdownliste ein für den Hostpool verfügbares Paket aus. Hostpoolpakete stammen aus MSIX App Attach.
      Application	Wählen Sie eine Anwendung aus der Dropdownliste aus.
      Anwendungskennung	Geben Sie einen eindeutigen Bezeichner für die Anwendung ein.
      Anzeigename	Geben Sie einen Anzeigenamen für die Anwendung ein, die für Benutzer vorgesehen ist.
      Beschreibung	Geben Sie eine Beschreibung für die Anwendung ein.

      Nachdem Sie diese Registerkarte ausgefüllt haben, wählen Sie Weiter aus.

      Wählen Sie auf der Registerkarte Symbol Standard aus, um das Standardsymbol für die Anwendung zu verwenden, oder wählen Sie Dateipfad aus, um ein benutzerdefiniertes Symbol zu verwenden. Wählen Sie für den Dateipfad eine der folgenden Optionen aus:

      • Durchsuchen Sie Azure Files, um ein Symbol aus einer Azure-Dateifreigabe zu verwenden. Wählen Sie ein Speicherkonto aus, und wählen Sie das Speicherkonto aus, das Ihre Symboldatei enthält, und wählen Sie dann Symboldatei auswählen aus. Navigieren Sie zur Dateifreigabe und zum Verzeichnis, in dem sich Ihr Symbol befindet, aktivieren Sie das Kontrollkästchen neben dem Symbol, das Sie hinzufügen möchten, z. B. MyApp.ico und wählen Sie dann Auswählen aus. Sie können auch eine .png-Datei verwenden. Geben Sie für Symbolindex die Indexnummer für das Symbol an, das Sie verwenden möchten. Diese Zahl ist in der Regel 0.

      • UNC-Dateipfad, um ein Symbol aus einer Dateifreigabe zu verwenden. Geben Sie als Symbolpfad den UNC-Pfad zu Ihrer Symboldatei ein, z. B. \\MyFileShare\MyApp.ico. Sie können auch eine .png-Datei verwenden. Geben Sie für Symbolindex die Indexnummer für das Symbol an, das Sie verwenden möchten. Diese Zahl ist in der Regel 0.

      Nachdem Sie diese Registerkarte abgeschlossen haben, wählen Sie Überprüfen und hinzufügen.

4. Stellen Sie auf der Registerkarte Überprüfen und Hinzufügen sicher, dass die Überprüfung bestanden ist, und überprüfen Sie die Informationen, die zum Hinzufügen der Anwendung verwendet werden. Wählen Sie dann Hinzufügen aus, um die Anwendung zur Anwendungsgruppe hinzuzufügen.

Hier erfahren Sie, wie Sie MSIX-Anwendungen mithilfe des PowerShell-Moduls Az.DesktopVirtualization zu einer Anwendungsgruppe hinzufügen.

1. Fügen Sie in derselben PowerShell-Sitzung eine MSIX-Anwendung zu einer Anwendungsgruppe hinzu, indem Sie die Befehle in einem der folgenden Beispiele ausführen.

   1. Führen Sie die folgenden Befehle aus, um einer Desktopanwendungsgruppe eine MSIX-Anwendung hinzuzufügen:

      $parameters = {
          Name = '<ApplicationName>'
          ApplicationType = 'MsixApplication'
          MsixPackageFamilyName = $app.PackageFamilyName
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
          CommandLineSetting = 'DoNotAllow'
      }
      
      New-AzWvdApplication @parameters
      

   2. Wenn Sie einer RemoteApp-Anwendungsgruppe eine MSIX-Anwendung hinzufügen möchten, müssen Sie, wenn mehrere Anwendungen im Paket vorhanden sind, die Anwendungs-ID der Anwendung abrufen, die Sie aus dem Paket hinzufügen möchten, indem Sie die folgenden Befehle ausführen:

      Write-Host "These are the application IDs available in the package. Many packages only contain one application." -ForegroundColor Yellow
      $app.ImagePackageApplication.AppId
      

      Notieren Sie sich die Anwendungs-ID, die Sie veröffentlichen möchten (z. B. App), und führen Sie dann die folgenden Befehle aus, um die Anwendung der RemoteApp-Anwendungsgruppe hinzuzufügen:

      $parameters = @{
          Name = '<ApplicationName>'
          ApplicationType = 'MsixApplication'
          MsixPackageFamilyName = $app.PackageFamilyName
          MsixPackageApplicationId = '<ApplicationID>'
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
          CommandLineSetting = 'DoNotAllow'
      }
      
      New-AzWvdApplication @parameters
      

      Überprüfen Sie die Liste der Anwendungen in der Anwendungsgruppe, indem Sie die folgenden Befehle ausführen:

      $parameters = @{
          GroupName = '<ApplicationGroupName>'
          ResourceGroupName = '<ResourceGroupName>'
      }
      
      Get-AzWvdApplication @parameters
      

So entfernen Sie ein MSIX-Paket aus Ihrem Hostpool mithilfe des Azure-Portals:

1. Wählen Sie in der Übersicht über Azure Virtual Desktop Hostpools aus, und wählen Sie dann den Namen des Hostpools aus, dem das MSIX-Paket hinzugefügt wird.

2. Wählen Sie in der Übersicht über den Hostpool MSIX-Pakete aus. Es sollte eine Liste aller vorhandenen MSIX-Pakete innerhalb des Hostpools angezeigt werden.

3. Aktivieren Sie das Kontrollkästchen neben dem Namen des MSIX-Pakets, das Sie entfernen möchten, und wählen Sie dann Entfernen aus.

Hier erfahren Sie, wie Sie Anwendungen mithilfe des PowerShell-Moduls Az.DesktopVirtualization entfernen.

1. Rufen Sie in derselben PowerShell-Sitzung eine Liste von MSIX-Paketen in einem Hostpool ab, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Get-AzWvdMsixPackage @parameters | Select-Object DisplayName, ImagePath, PackageFamilyName, Version
   

   Die Ausgabe sollte ungefähr wie das folgende Beispiel aussehen:

   DisplayName ImagePath                        Name                                      Version
   ----------- ---------                        -----------------                         -------
   My App      \\fileshare\Apps\MyApp\MyApp.cim hp01/MyApp_1.0.0.0_neutral__abcdef123ghij 1.0.0.0
   

2. Suchen Sie das Paket, das Sie entfernen möchten, und verwenden Sie den Wert für den Name-Parameter, entfernen Sie jedoch den Hostpoolnamen und / aus dem Start. Beispielsweise wird hp01/MyApp_1.0.0.0_neutral__abcdef123ghij zu MyApp_1.0.0.0_neutral__abcdef123ghij. Entfernen Sie dann das Paket, indem Sie die folgenden Befehle ausführen:

   $parameters = @{
       FullName = '<FullName>'
       HostPoolName = '<HostPoolName>'
       ResourceGroupName = '<ResourceGroupName>'
   }
   
   Remove-AzWvdMsixPackage @parameters