Добавление и управление приложениями app attach и приложениями MSIX app attach в виртуальном рабочем столе Azure

Вот как добавить образ MSIX, образ Appx или пакет App-V как пакет для подключения приложения с помощью портала Azure.

1. Войдите на портал Azure.

2. В строке поиска введите виртуальный рабочий стол Azure и выберите соответствующую запись службы, чтобы перейти к обзору виртуального рабочего стола Azure.

3. Выберите "Присоединить приложение", а затем нажмите кнопку "Создать".

4. На вкладке "Основы" выполните следующие сведения:

   Параметр	Описание
   Подписка	Выберите подписку, в которую нужно добавить образ MSIX, образ Appx или пакет App-V из раскрывающегося списка.
   Группа ресурсов	Выберите существующую группу ресурсов или нажмите кнопку "Создать" и введите имя.
   Пул хостов	Выберите существующий пул узлов из выпадающего списка.
   Расположение	Выберите регион Azure для пакета подключения приложения.

   После завершения этой вкладки нажмите кнопку "Далее".

5. На вкладке "Путь к изображению" заполните следующие сведения:

   Параметр	Описание
   Путь к изображению	Выберите из учетной записи хранилища, если образ хранится в Azure Files, или введите UNC, чтобы указать путь UNC. Последующие поля зависят от выбранного параметра.
   Выберите из учетной записи хранения
   учетная запись хранилища	Выберите учетную запись для хранения, в которой находится ваш образ.
   Общий доступ к файлам	Выберите файл, а затем перейдите к общей папке и каталогу образа. Установите флажок рядом с изображением, которое вы хотите добавить, например MyApp.cim, и нажмите кнопку " Выбрать".
   Пакет MSIX	Выберите пакет MSIX или Appx из образа.
   Входные данные UNC
   UNC	Введите UNC-путь к файлу изображения.
   Пакет MSIX	Выберите пакет MSIX или Appx из образа.
   Любой вариант
   Показать имя	Введите понятное имя приложения.
   Версия	Убедитесь, что отображается ожидаемый номер версии.
   Тип регистрации	Выберите тип регистрации, который вы хотите использовать.
   Штат	Выберите начальное состояние пакета.
   Статус проверки работоспособности при сбое	Выберите статус пакета, если его не удается разместить на узле сеанса. Это состояние сообщается для AppAttachHealthCheck в контексте статуса проверки работоспособности хоста сеанса.

   После завершения этой вкладки нажмите кнопку "Далее".

   Подсказка

   После завершения работы с этой вкладкой вы можете по желанию назначить приложение пулам узлов, пользователям и группам. Кроме того, если вы хотите настроить назначения отдельно, выберите Проверка + создание, а затем перейдите к Назначить пакет прикрепления приложения.

6. Необязательно. На вкладке "Назначения" заполните следующие сведения:

   1. Для пула узлов выберите, каким пулам узлов вы хотите назначить приложение. Если вы уже используете MSIX app attach с пулом узлов, вы не можете выбрать этот пул узлов, так как не можете использовать обе версии технологии подключения приложений MSIX с одним и тем же пулом узлов.

   2. Выберите " Добавить пользователей или группы пользователей", а затем найдите и выберите пользователей или группы, которым нужно назначить приложение. После завершения нажмите кнопку "Выбрать".

   3. Просмотрите добавленные назначения и нажмите кнопку "Далее".

7. Необязательно. На вкладке "Теги " можно ввести все необходимые пары "имя-значение", а затем нажмите кнопку "Просмотр и создание".

8. На вкладке "Просмотр и создание" убедитесь, что проверка проходит, и просмотрите сведения, используемые при развертывании, а затем нажмите "Создать", чтобы добавить приложение.

Вот как добавить образ MSIX, образ Appx или пакет App-V в качестве пакета подключения приложения с помощью модуля PowerShell Az.DesktopVirtualization . Обязательно измените <placeholder> значения на свои собственные.

1. Откройте Azure Cloud Shell в портал Azure с типом терминала PowerShell или запустите PowerShell на локальном устройстве.

   • Если вы используете Cloud Shell, убедитесь, что контекст Azure установлен в подписке, которую вы хотите использовать.

   • Если вы используете PowerShell локально, сначала войдите в Azure PowerShell, а затем убедитесь , что контекст Azure установлен в подписке, которую вы хотите использовать.

2. Во время предварительной версии убедитесь, что у вас есть командлеты PowerShell, доступные, выполнив следующие команды:

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

   Выходные данные должны совпадать со следующими выходными данными:

   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. Получите свойства изображения MSIX, изображения Appx или пакета App-V и сохраните их в переменной, выполнив следующую команду. Необходимо указать пул узлов, но он может быть любым пулом узлов, где узлы сеансов имеют доступ к общей папке.

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

4. Проверьте наличие только одного объекта в свойствах приложения, выполнив следующие команды:

   $app | FL *
   

   Необязательный: если в выходных данных есть несколько объектов, например x64 и x86 версии одного приложения, можно использовать параметр PackageFullName , чтобы указать, какое приложение необходимо добавить, выполнив следующие команды:

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

5. Добавьте изображение или пакет в качестве пакета подключения приложения, выполнив следующую команду. В этом примере состояние приложения помечается как активное, регистрация приложения устанавливается по запросу, а статус проверки работоспособности узла сеанса при сбое устанавливается на NeedsAssistance:

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

   Выходные данные при успешном добавлении пакета отсутствуют.

6. Чтобы убедиться, что пакет добавляется, выполните следующие команды:

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

   Выходные данные должны быть похожи на следующий пример:

   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
   

Вот как назначить пакет приложения пулам узлов, пользователям и группам с помощью портал Azure:

Пулы хостов

1. В обзоре виртуального рабочего стола Azure выберите присоединение приложения, затем выберите имя пакета подключения приложения, который вы хотите назначить.

2. В разделе Управление выберите пулы хостов:

3. Выберите + Назначить, затем выберите один или несколько пулов хостов в раскрывающемся списке. Убедитесь, что все узлы сеансов в пуле узлов должны иметь доступ на чтение с учетной записью компьютера, как указано в предварительных требованиях.

4. Выберите Добавить.

Группы и пользователи

1. В обзоре виртуального рабочего стола Azure выберите присоединение приложения, затем выберите имя пакета подключения приложения, который вы хотите назначить.

2. В разделе "Управление" выберите "Пользователи":

3. Нажмите кнопку +Добавить, а затем выберите одну или несколько групп и (или) пользователей из списка.

4. Выберите Выберите.

Вот как назначить пакет приложения пулам узлов, а также группам и пользователям с помощью модуля PowerShell Az.DesktopVirtualization .

Пулы хостов

1. В той же сессии PowerShell получите идентификаторы ресурсов пул(ов) узлов, которым нужно назначить приложение, и добавьте их в массив, выполнив следующие команды:

   # 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. После получения идентификаторов ресурсов пулов узлов можно назначить пакет приложения им, выполнив следующие команды:

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

3. Чтобы отменить назначение пакета приложения из всех пулов узлов, можно передать пустой массив пулов узлов, выполнив следующие команды:

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

Группы и пользователи

Вот как назначить приложение группам и пользователям с помощью модуля PowerShell Az.DesktopVirtualization .

1. Получите идентификатор объекта для групп или пользователей, которых вы хотите добавить в приложение или удалить из него. Затем добавьте эти идентификаторы в массив, используя один из следующих примеров. Рекомендуется назначать приложения группам.

   1. Получите идентификатор объекта группы или групп и добавьте их в массив, выполнив следующие команды. В этом примере используется отображаемое имя группы:

      # 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. Получите идентификатор объекта пользователей и добавьте их в массив, выполнив следующие команды. В этом примере используется основное имя пользователя (UPN):

      # Add a comma-separated list of user principal names
      $users = "[email protected]","[email protected]"
      
      # 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. После получения идентификаторов объектов пользователей или групп, вы можете добавить их в приложение или удалить из него, используя один из следующих примеров, который назначает роль RBAC пользователя виртуализации рабочего стола.

   1. Чтобы добавить группы или пользователей в приложение, выполните следующие команды:

      $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. Чтобы удалить группы или пользователей в приложение, выполните следующие команды:

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

Вот как изменить тип регистрации пакета и состояние с помощью портал Azure:

1. На странице обзора виртуального рабочего стола Azure выберите Подключение приложения. Вы увидите список всех существующих пакетов в пуле размещения.

2. Выберите имя пакета, который нужно изменить.

   1. Чтобы изменить тип регистрации, выберите "По запросу " или "Зарегистрировать" во время входа, а затем нажмите кнопку "Сохранить".

   2. Чтобы изменить состояние, выберите "Неактивный " или "Активный", а затем нажмите кнопку "Сохранить".

Вот как изменить тип регистрации пакета и состояние с помощью модуля PowerShell Az.DesktopVirtualization .

1. В том же сеансе PowerShell можно изменить тип регистрации и состояние, выполнив следующие команды:

   1. Измените тип регистрации, выполнив следующую команду. IsRegularRegistration Установите $true для регистрации при входе или $false для регистрации по запросу.

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

   2. Измените состояние, выполнив следующую команду. Установите IsActive в $true или в $false.

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

Вот как добавить приложение из пакета, добавленного в эту статью, в группу приложений RemoteApp с помощью портал Azure:

1. В обзоре виртуального рабочего стола Azure выберите группы приложений, а затем выберите группу приложений RemoteApp, в которую нужно добавить приложение.

2. Выберите "Приложения", нажмите кнопку "+ Добавить". Убедитесь, что в пуле узлов включен как минимум один узел сеанса, к которому присоединена группа приложений.

3. На вкладке "Основы" выполните следующие сведения:

   Параметр	Значение и описание
   Источник приложения	Выберите "Присоединить приложение" из раскрывающегося списка. Если вы хотите добавить приложения из меню или указав путь к файлу, см. статью "Публикация приложений с помощью RemoteApp".
   Пакет	Выберите пакет, доступный для хост-пула из списка. Региональные пакеты происходят из подключения приложений.
   Приложение	Выберите приложение из раскрывающегося списка.
   Идентификатор приложения	Введите уникальный идентификатор приложения.
   Показать имя	Введите понятное имя приложения, которое предназначено для пользователей.
   Описание	Введите описание приложения.

   После завершения этой вкладки нажмите кнопку "Далее".

4. На вкладке "Значок" выберите "По умолчанию", чтобы использовать значок по умолчанию для приложения, или выберите путь к файлу для использования пользовательского значка. Для пути к файлу выберите один из следующих параметров:

   • Перейдите Файлы Azure, чтобы использовать значок из общей папки Azure. Выберите учетную запись хранения, содержащую файл значка, затем выберите файл значка. Перейдите к общей папке и каталогу, в которой находится значок, установите флажок рядом со значком, который вы хотите добавить, например MyApp.ico, и нажмите кнопку " Выбрать". Вы также можете использовать .png файл. Для индекса значка укажите номер индекса для значка, который требуется использовать. Обычно это число равно 0.

   • UNC-путь к общему файлу для использования значка из общей папки. Для пути значка введите UNC-путь к файлу значка, например \\MyFileShare\MyApp.ico. Вы также можете использовать .png файл. Для индекса значка укажите номер индекса для значка, который требуется использовать. Обычно это число равно 0.

   После завершения этой вкладки нажмите кнопку "Рецензирование и добавление".

5. На вкладке "Проверка и добавление" убедитесь, что проверка пройдена, и просмотрите сведения, используемые для добавления приложения, а затем нажмите кнопку "Добавить", чтобы добавить приложение в группу приложений RemoteApp.

Вот как добавить приложение из пакета, добавленного в эту статью, в группу приложений RemoteApp с помощью модуля PowerShell Az.DesktopVirtualization .

1. В одном сеансе PowerShell, если в пакете несколько приложений, необходимо получить идентификатор приложения, которое нужно добавить из пакета, выполнив следующие команды:

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

2. Запишите идентификатор приложения, который вы хотите опубликовать (например App), а затем выполните следующие команды, чтобы добавить приложение в группу приложений RemoteApp:

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

3. Проверьте список приложений в группе приложений, выполнив следующие команды:

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

Вот как обновить существующий пакет с помощью портал Azure:

1. В обзоре виртуального рабочего стола Azure выберите "Присоединить приложение". Вы увидите список всех существующих пакетов.

2. Выберите пакет, который нужно обновить, а затем в обзоре выберите "Обновить".

3. Введите сведения об обновленном пакете:

   1. Подписка и группа ресурсов предварительно заполнены значениями текущего пакета.

   2. Выберите пул узлов, для которого необходимо обновить пакет.

   3. Выберите путь к изображению из хранилища учетной записи или введите UNC. Последующие поля зависят от выбранного параметра.

      1. Для выбора из учетной записи хранения выберите учетную запись хранения, содержащую обновленный образ. Выберите файл, а затем перейдите к общей папке и каталогу образа. Установите флажок рядом с изображением, которое вы хотите добавить, например MyApp.cim, и нажмите кнопку " Выбрать".
      2. В поле Input UNC введите UNC-путь к файлу изображения.

   4. Для пакета MSIX выберите MSIX или Appx из образа диска.

4. После завершения полей нажмите кнопку "Обновить".

Вот как обновить существующий пакет с помощью модуля PowerShell Az.DesktopVirtualization .

1. В том же сеансе PowerShell получите свойства обновленного приложения и сохраните их в переменной, выполнив следующие команды:

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

2. Проверьте наличие только одного объекта в свойствах приложения, выполнив следующие команды:

   $app | FL *
   

   Если в выходных данных есть несколько объектов, например, версия x64 и версия x86 одного и того же приложения, можно использовать параметр PackageFullName, чтобы указать, какую из версий нужно добавить, выполнив следующие команды:

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

3. Обновите существующий пакет, выполнив следующую команду. Новый образ диска заменяет существующий, но существующие назначения сохраняются. Не удаляйте существующий образ, пока пользователи не перестали использовать его.

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

Вот как удалить пакет приложения с помощью портала Azure:

1. В обзоре виртуального рабочего стола Azure выберите "Присоединить приложение". Вы увидите список всех существующих пакетов.

2. Установите флажок рядом с именем пакета, который вы хотите удалить, а затем нажмите кнопку "Удалить". Пакет также удаляется из всех пулов хостов, которым он назначен.

Вот как удалить пакет для подключения приложений с помощью модуля PowerShell Az.DesktopVirtualization.

1. В том же сеансе PowerShell выполните следующую команду, чтобы удалить пакет, содержащий приложение:

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

Вот как добавить образ MSIX с помощью портал Azure:

1. Войдите на портал Azure.

2. В строке поиска введите виртуальный рабочий стол Azure и выберите соответствующую запись службы, чтобы перейти к обзору виртуального рабочего стола Azure.

3. Выберите пулы узлов, а затем выберите имя пула узлов, в который нужно добавить образ MSIX.

4. В обзоре пула узлов выберите пакеты MSIX, затем выберите + Добавить.

5. Для пути образа MSIX введите допустимый UNC-путь, указывающий на образ MSIX в общей папке, например, \\fileshare\Apps\MyApp\MyApp.cim, затем выберите Добавить, чтобы проверить, является ли путь допустимым.

6. После проверки пути появится больше полей. Выполните следующие сведения:

   Параметр	Описание
   Пакет MSIX	Выберите соответствующее имя пакета MSIX в раскрывающемся меню.
   Пакеты приложений	Это показывает приложение и не настраивается.
   Показать имя	Введите дружелюбное название для вашего пакета.
   Версия	Убедитесь, что отображается ожидаемый номер версии.
   Тип регистрации	Выберите тип регистрации, который вы хотите использовать.
   Штат	Выберите начальное состояние пакета.

7. После завершения полей нажмите кнопку "Добавить".

Вот как добавить пакет MSIX с помощью модуля PowerShell Az.DesktopVirtualization . Обязательно измените <placeholder> значения на свои собственные.

1. Откройте Azure Cloud Shell в портал Azure с типом терминала PowerShell или запустите PowerShell на локальном устройстве.

   • Если вы используете Cloud Shell, убедитесь, что контекст Azure установлен в подписке, которую вы хотите использовать.

   • Если вы используете PowerShell локально, сначала войдите в Azure PowerShell, а затем убедитесь , что контекст Azure установлен в подписке, которую вы хотите использовать.

2. Получите свойства приложения в образе MSIX, который вы хотите добавить и сохранить в переменной, выполнив следующие команды:

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

   Выходные данные должны быть похожи на следующий пример:

   Name
   ----
   hp01/expandmsiximage
   

3. Проверьте наличие только одного объекта в свойствах приложения, выполнив следующие команды:

   $app | FL *
   

   Если в выходных данных есть несколько объектов, например, версия x64 и версия x86 одного и того же приложения, можно использовать параметр PackageFullName, чтобы указать, какую из версий нужно добавить, выполнив следующие команды:

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

4. Добавьте образ MSIX в пул узлов, выполнив следующую команду. В этом примере состояние приложения помечается как активное.

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

   При успешном добавлении пакета MSIX вывод отсутствует.

5. Вы можете проверить, добавляется пакет MSIX, выполнив следующие команды:

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

   Выходные данные должны быть похожи на следующий пример:

   DisplayName                  : My App
   Id                           : /subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/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          : [email protected]
   SystemDataCreatedByType      : User
   SystemDataLastModifiedAt     : 7/28/2023 9:04:00 AM
   SystemDataLastModifiedBy     : [email protected]
   SystemDataLastModifiedByType : User
   Type                         : Microsoft.DesktopVirtualization/hostpools/msixpackages
   Version                      : 1.0.0.0
   

Вот как изменить тип регистрации пакета и состояние с помощью портал Azure:

1. В обзоре виртуального рабочего стола Azure выберите пулы узлов, а затем выберите имя пула узлов, в который добавляется пакет MSIX.

2. В обзоре пула хостов выберите пакеты MSIX. Вы увидите список всех существующих пакетов MSIX в пуле узлов.

3. Выберите имя пакета MSIX, который нужно изменить.

   1. Чтобы изменить тип регистрации, выберите "По запросу " или "Зарегистрировать" во время входа, а затем нажмите кнопку "Сохранить".

   2. Чтобы изменить состояние, выберите "Неактивный " или "Активный", а затем нажмите кнопку "Сохранить".

Вот как изменить тип регистрации пакета и состояние с помощью модуля PowerShell Az.DesktopVirtualization .

1. В том же сеансе PowerShell получите список пакетов MSIX в пуле узлов и их текущем типе регистрации и состоянии, выполнив следующие команды:

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

   Выходные данные должны быть похожи на следующий пример:

   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. Найдите пакет, который нужно удалить, и используйте его значение для параметра Name, но удалите имя пула узлов и / в начале. Например, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij преобразуется в MyApp_1.0.0.0_neutral__abcdef123ghij. Вот несколько примеров.

   1. Измените тип регистрации, выполнив следующую команду. IsRegularRegistration Установите $true для регистрации при входе или $false для регистрации по запросу.

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

   2. Измените состояние, выполнив следующую команду. Установите IsActive в $true или в $false.

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

Вот как добавить приложение из пакета, добавленного в эту статью, в группу приложений RemoteApp с помощью портал Azure:

1. В обзоре виртуального рабочего стола Azure выберите группы приложений, а затем выберите группу приложений Desktop или RemoteApp, в которую вы хотите добавить приложение.

2. Выберите "Приложения", нажмите кнопку "+ Добавить". Убедитесь, что в пуле узлов включен как минимум один узел сеанса, к которому присоединена группа приложений.

3. На вкладке "Основные сведения" доступные параметры зависят от того, является ли группа приложений для рабочего стола или удаленного приложения.

   1. Для группы настольных приложений заполните следующую информацию:

      Параметр	Значение и описание
      Источник приложения	Пакет MSIX автоматически выбирается и оттеняется.
      Пакет	Выберите пакет, доступный для хост-пула из списка.
      Идентификатор приложения	Введите уникальный идентификатор приложения.
      Показать имя	Введите понятное имя приложения, которое предназначено для пользователей.
      Описание	Введите описание приложения.

      После завершения этой вкладки нажмите кнопку "Рецензирование и добавление".

   2. Для группы приложений RemoteApp выполните следующие сведения:

      Параметр	Значение и описание
      Источник приложения	Выберите "Присоединить приложение" из раскрывающегося списка. Если вы хотите добавить приложения из меню или указав путь к файлу, см. статью "Публикация приложений с помощью RemoteApp".
      Пакет	Выберите пакет, доступный для хост-пула из списка. Пакеты пула хостов из MSIX app attach.
      Приложение	Выберите приложение из раскрывающегося списка.
      Идентификатор приложения	Введите уникальный идентификатор приложения.
      Показать имя	Введите понятное имя приложения, которое предназначено для пользователей.
      Описание	Введите описание приложения.

      После завершения этой вкладки нажмите кнопку "Далее".

      На вкладке "Значок" выберите "По умолчанию", чтобы использовать значок по умолчанию для приложения, или выберите путь к файлу для использования пользовательского значка. Для пути к файлу выберите один из следующих параметров:

      • Просмотрите Файлы Azure, чтобы использовать значок из файлового хранилища Azure. Выберите учетную запись хранения, содержащую файл значка, затем выберите файл значка. Перейдите к общей папке и каталогу, в которой находится значок, установите флажок рядом со значком, который вы хотите добавить, например MyApp.ico, и нажмите кнопку " Выбрать". Вы также можете использовать .png файл. Для индекса значка укажите номер индекса для значка, который требуется использовать. Обычно это число равно 0.

      • UNC-путь к общему файлу для использования значка из общей папки. Для пути значка введите UNC-путь к файлу значка, например \\MyFileShare\MyApp.ico. Вы также можете использовать .png файл. Для индекса значка укажите номер индекса для значка, который требуется использовать. Обычно это число равно 0.

      После завершения этой вкладки нажмите кнопку "Рецензирование и добавление".

4. На вкладке "Просмотр и добавление" убедитесь, что проверка проходит и просмотрите сведения, используемые для добавления приложения, а затем нажмите кнопку "Добавить ", чтобы добавить приложение в группу приложений.

Вот как добавить приложения MSIX в группу приложений с помощью модуля PowerShell Az.DesktopVirtualization .

1. В том же сеансе PowerShell добавьте приложение MSIX в группу приложений, выполнив команды в одном из следующих примеров.

   1. Чтобы добавить приложение MSIX в группу классических приложений, выполните следующие команды:

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

   2. Чтобы добавить приложение MSIX в группу приложений RemoteApp, если в пакете несколько приложений, необходимо получить идентификатор приложения, которое нужно добавить из пакета, выполнив следующие команды:

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

      Запишите идентификатор приложения, который вы хотите опубликовать (например App), а затем выполните следующие команды, чтобы добавить приложение в группу приложений RemoteApp:

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

      Проверьте список приложений в группе приложений, выполнив следующие команды:

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

Вот как удалить пакет MSIX из пула узлов с помощью портал Azure:

1. В обзоре виртуального рабочего стола Azure выберите пулы узлов, а затем выберите имя пула узлов, в который добавляется пакет MSIX.

2. В обзоре пула хостов выберите пакеты MSIX. Вы увидите список всех существующих пакетов MSIX в пуле узлов.

3. Установите флажок рядом с именем пакета MSIX, который вы хотите удалить, а затем нажмите кнопку "Удалить".

Вот как удалить приложения с помощью модуля PowerShell Az.DesktopVirtualization .

1. В том же сеансе PowerShell получите список пакетов MSIX в пуле узлов, выполнив следующие команды:

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

   Выходные данные должны быть похожи на следующий пример:

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

2. Найдите пакет, который нужно удалить, и используйте его значение для параметра Name, но удалите имя пула узлов и / в начале. Например, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij преобразуется в MyApp_1.0.0.0_neutral__abcdef123ghij. Затем удалите пакет, выполнив следующие команды:

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