Добавление и управление присоединением приложений MSIX и присоединением приложений в Виртуальном рабочем столе Azure

Статья
12/09/2023

Внимание

Подключение приложений в настоящее время находится в предварительной версии. Юридические условия, применимые к функциям Azure, которые находятся в состоянии бета-версии, предварительной версии или иным образом еще не выпущены в общедоступной версии, см. на странице Дополнительные условия использования предварительных версий в Microsoft Azure.

Совет

Новая версия подключения приложений для Виртуального рабочего стола Azure доступна в предварительной версии. Нажмите кнопку в верхней части этой статьи, чтобы выбрать между подключением приложений MSIX (current) и подключением приложений (предварительная версия), чтобы просмотреть соответствующую документацию.

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

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

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

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

Внимание

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

Необходимые компоненты

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

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

Существующий пул узлов с узлами сеансов, группой приложений и рабочей областью.
Узлы сеансов должны запускать поддерживаемую клиентская операционную систему Windows и по крайней мере одну из них необходимо включить. Windows Server не поддерживается.

Пул узлов должен быть настроен в качестве среды проверки.

Узлы сеансов должны быть присоединены к идентификатору Microsoft Entra или домену служб домен Active Directory (AD DS).

Узлы сеансов должны быть присоединены к домену служб домен Active Directory (AD DS). Идентификатор Microsoft Entra не поддерживается.

Учетные записи пользователей должны быть гибридными учетными записями (созданными в AD DS и синхронизированными с идентификатором Microsoft Entra). Группы могут быть гибридными или группами идентификаторов Microsoft Entra.

Общая папка S МБ в том же регионе Azure, что и узлы сеансов. Все узлы сеансов в пуле узлов должны иметь доступ на чтение с учетной записью компьютера. Этот файловый ресурс используется для хранения образов приложений. Дополнительные сведения о требованиях к общей папке см. в разделе "Файловый ресурс".

Чтобы использовать Файлы Azure при присоединении узлов сеансов к идентификатору Microsoft Entra ID, необходимо назначить роль управления доступом на основе ролей (RBAC) для виртуального рабочего стола Azure исубъекта-службы поставщика ARM виртуального рабочего стола Azure. Чтобы узнать, как назначить роль Azure RBAC субъекту-службе Виртуальных рабочих столов Azure, см. статью "Назначение ролей RBAC субъекту-службе Виртуального рабочего стола Azure". В будущем обновлении предварительной версии вам не потребуется назначить субъект-службу поставщика ARM виртуального рабочего стола Azure.

Общая папка S МБ в том же регионе Azure, что и узлы сеансов. Все узлы сеансов в пуле узлов должны иметь доступ на чтение с учетной записью компьютера. Этот файловый ресурс используется для хранения образов приложений. Дополнительные сведения о требованиях к общей папке см. в разделе "Файловый ресурс".

Образ диска MSIX или Appx, созданный из пакета приложения и хранящийся в общей папке. Дополнительные сведения см. в разделе "Создание образа", где можно также скачать предварительно созданный пакет MSIX для тестирования.

Образ MSIX, созданный из пакета приложения и хранящийся в общей папке. Дополнительные сведения см. в разделе "Создание образа", где можно также скачать предварительно созданный пакет MSIX для тестирования.

Чтобы добавить образы MSIX, вам потребуется роль "Участник виртуализации рабочего стола Azure" на основе ролей (RBAC), назначенная группе ресурсов как минимум. Чтобы назначить пользователей группе приложений, также требуются Microsoft.Authorization/roleAssignments/write разрешения для группы приложений. Встроенные роли RBAC, которые включают это разрешение, являются доступом пользователей Администратор istrator и owner.
Если вы хотите использовать Azure PowerShell локально, см. статью "Использование Azure PowerShell с виртуальным рабочим столом Azure", чтобы убедиться, что установлены модули Az.DesktopVirtualization и Microsoft Graph PowerShell. Кроме того, используйте Azure Cloud Shell.

Необходимо использовать версию 4.2.1 модуля PowerShell Az.DesktopVirtualization , которая содержит командлеты, поддерживающие присоединение приложений. Вы можете скачать и установить модуль PowerShell Az.DesktopVirtualization из коллекция PowerShell.

Внимание

Все пакеты приложений MSIX и Appx включают сертификат. Вы несете ответственность за обеспечение доверия сертификатов в вашей среде. Самозаверяющий сертификат поддерживается с соответствующей цепочкой доверия.
Необходимо выбрать, следует ли использовать подключение приложения MSIX или подключение приложения с пулом узлов. Вы не можете использовать обе версии с одинаковым пакетом в одном пуле узлов.

Внимание

Все пакеты приложений MSIX включают сертификат. Вы несете ответственность за обеспечение доверия сертификатов в вашей среде. Самозаверяющий сертификат поддерживается с соответствующей цепочкой доверия.

Добавление приложения

Чтобы добавить приложение в образ MSIX или Appx в виртуальный рабочий стол Azure в качестве пакета подключения приложения, выберите соответствующую вкладку для вашего сценария и выполните действия.

Портал
Azure PowerShell

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

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

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

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

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

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

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

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

Совет

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

Необязательно. На вкладке "Назначения" заполните следующие сведения:
1. Для пула узлов выберите пулы узлов, которым нужно назначить приложение. Если вы уже используете подключение приложения MSIX с пулом узлов, вы не можете выбрать этот пул узлов, так как вы не можете использовать обе версии подключения приложений с одинаковым пулом узлов.
2. Выберите " Добавить пользователей или группы пользователей", а затем найдите и выберите пользователей или группы, которым нужно назначить приложение. После завершения нажмите кнопку "Выбрать".
3. Просмотрите добавленные назначения и нажмите кнопку "Далее".
Необязательно. На вкладке "Теги " можно ввести все необходимые пары "имя-значение", а затем нажмите кнопку "Просмотр и создание".
На вкладке "Просмотр и создание " убедитесь, что проверка проходит и просматривает сведения, используемые во время развертывания, а затем нажмите кнопку "Создать ", чтобы добавить приложение.

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

Внимание

В следующих примерах необходимо изменить <placeholder> значения для собственных.

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

Во время предварительной версии проверка доступны командлеты 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

Получите свойства изображения, который вы хотите добавить и сохранить в переменной, выполнив следующую команду. Необходимо указать пул узлов, но он может быть любым пулом узлов, где узлы сеансов имеют доступ к общей папке.
```
# Get the properties of the MSIX or Appx image
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    Path = '<UNCPathToImageFile>'
}

$app = Import-AzWvdAppAttachPackageInfo @parameters
```
Проверьте наличие только одного объекта в свойствах приложения, выполнив следующую команду:
```
$app | FL *
```
Необязательный: если в выходных данных есть несколько объектов, например x64 и x86 версии одного приложения, можно использовать параметр PackageFullName , чтобы указать, какое приложение необходимо добавить, выполнив следующую команду:
```
# 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*
```
Добавьте изображение в виде пакета подключения приложения, выполнив следующую команду. В этом примере состояние приложения помечается как активное, регистрация приложения устанавливается по запросу, а состояние работоспособности узла сеанса проверка состоянии сбоя имеет значение NeedsAssistance:
```
$parameters = @{
    Name = '<AppName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    FailHealthCheckOnStagingFailure = 'NeedsAssistance'
    ImageIsRegularRegistration = $false
    ImageDisplayName = '<AppDisplayName>'
    ImageIsActive = $true
}

New-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
```
Выходные данные при успешном добавлении пакета отсутствуют.

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

$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

Назначение пакета подключения приложения

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

Примечание.

Учетные записи пользователей должны быть гибридными учетными записями (созданными в AD DS и синхронизированными с Azure AD), но группы не выполняются.

Портал
Azure PowerShell

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

Пулы узлов

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

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

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

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

Пулы узлов

Внимание

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

В том же сеансе 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
}

После получения идентификаторов ресурсов пулов узлов можно назначить пакет приложения им, выполнив следующую команду:
```
$parameters = @{
    Name = '<AppName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    HostPoolReference = $hostPoolIds
}

Update-AzWvdAppAttachPackage @parameters
```
Чтобы отменить назначение пакета приложения из всех пулов узлов, можно передать пустой массив пулов узлов, выполнив следующую команду:
```
$parameters = @{
    Name = '<AppName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    HostPoolReference = @()
}

Update-AzWvdAppAttachPackage @parameters
```

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

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

Получите идентификатор объекта групп или пользователей, к которым нужно добавить или удалить из приложения, и добавьте их в массив с помощью одного из следующих примеров. Рекомендуется назначать приложения группам.
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 = "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
$Ids = @()

foreach ($user in $users) {
    $Ids += (Get-MgUser | ? UserPrincipalName -eq $user).Id
}
```
После получения идентификаторов объектов пользователей или групп их можно добавить в приложение или удалить их с помощью одного из следующих примеров, который назначает роль RBAC пользователя виртуализации рабочего стола. Вы также можете назначить роль пользователя RBAC для виртуального рабочего стола группам или пользователям с помощью командлета New-AzRoleAssignment .
1. Чтобы добавить группы или пользователей в приложение, выполните следующую команду:
```
$parameters = @{
    Name = '<AppName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    PermissionsToAdd = $Ids
}

Update-AzWvdAppAttachPackage @parameters
```
2. Чтобы удалить группы или пользователей в приложение, выполните следующую команду:
```
$parameters = @{
    Name = '<AppName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    PermissionsToRemove = $objectIds
}

Update-AzWvdAppAttachPackage @parameters
```

Примечание.

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

Изменение типа регистрации и состояния

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

Портал
Azure PowerShell

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

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

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

В том же сеансе PowerShell можно изменить тип регистрации и состояние, выполнив следующие команды:
1. Измените тип регистрации, выполнив следующую команду. Установите значение IsRegularRegistration для входа по блокировке или $false по запросу.$true
```
$parameters = @{
    FullName = '<FullName>'
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    IsRegularRegistration = $true
}

Update-AzWvdAppAttachPackage @parameters
```
2. Измените состояние, выполнив следующую команду. Установите значение IsActive "Активный" или $false "Неактивный".$true
```
$parameters = @{
    Name = '<Name>'
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    Location = '<AzureRegion>'
    IsActive = $true
}

Update-AzWvdAppAttachPackage @parameters
```

Публикация приложения MSIX или Appx с помощью группы приложений RemoteApp

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

Портал
Azure PowerShell

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

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

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

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

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

На вкладке "Значок" выберите "По умолчанию", чтобы использовать значок по умолчанию для приложения, или выберите путь к файлу для использования пользовательского значка. Для пути к файлу выберите один из следующих параметров:
- Перейдите Файлы Azure, чтобы использовать значок из общей папки Azure. Выберите учетную запись хранения и выберите учетную запись хранения, содержащую файл значка, а затем выберите файл значка. Перейдите к общей папке и каталогу, в который находится значок, проверка поле рядом с значком, который вы хотите добавить, напримерMyApp.ico, и нажмите кнопку "Выбрать". Вы также можете использовать .png файл. Для индекса значка укажите номер индекса для значка, который требуется использовать. Обычно это число равно 0.
- UNC-путь к файлу для использования значка из общей папки. Для пути значка введите UNC-путь к файлу значка, например \\MyFileShare\MyApp.ico. Вы также можете использовать .png файл. Для индекса значка укажите номер индекса для значка, который требуется использовать. Обычно это число равно 0.
После завершения этой вкладки нажмите кнопку "Рецензирование и добавление".
На вкладке "Просмотр и добавление" убедитесь, что проверка проходит и просматривает сведения, используемые для добавления приложения, а затем нажмите кнопку "Добавить " для добавления приложения в группу приложений RemoteApp.

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

В одном сеансе PowerShell, если в пакете несколько приложений, необходимо получить идентификатор приложения, которое нужно добавить из пакета, выполнив следующую команду:
```
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.ImagePackageFamilyName
    MsixPackageApplicationId = '<ApplicationID>'
    GroupName = '<ApplicationGroupName>'
    ResourceGroupName = '<ResourceGroupName>'
    CommandLineSetting = 'DoNotAllow'
}

New-AzWvdApplication @parameters

Проверьте список приложений в группе приложений, выполнив следующую команду:
```
$parameters = @{
    GroupName = '<ApplicationGroupName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdApplication @parameters
```

Обновление существующего пакета

Существующий пакет можно обновить, указав новый образ, содержащий обновленное приложение. Дополнительные сведения см. в статье "Новые версии приложений".

Чтобы обновить существующий пакет на месте, выберите соответствующую вкладку для вашего сценария и выполните действия.

Портал
Azure PowerShell

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

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

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

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

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

$app = Import-AzWvdAppAttachPackageInfo @parameters

Проверьте наличие только одного объекта в свойствах приложения, выполнив следующую команду:
```
$app | FL *
```
Если в выходных данных имеется несколько объектов, например x64 и x86 версии одного приложения, можно использовать параметр PackageFullName , чтобы указать, какой из них необходимо добавить, выполнив следующую команду:
```
# 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*
```
Обновите существующий пакет, выполнив следующую команду. Новый образ диска заменяет существующий, но существующие назначения сохраняются. Не удаляйте существующий образ, пока пользователи не перестали использовать его.
```
$parameters = @{
    Name = '<PackageName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Update-AzWvdAppAttachPackage -AppAttachPackage $app @parameters
```

Удаление пакета подключения приложения

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

Совет

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

Портал
Azure PowerShell

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

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

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

В том же сеансе PowerShell выполните следующую команду, чтобы удалить пакет, содержащий приложение:
```
$parameters = @{
    Name = '<PackageName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Remove-AzWvdAppAttachPackage @parameters
```

Добавление образа MSIX в пул узлов

Чтобы добавить образ MSIX в пул узлов, выберите соответствующую вкладку для вашего сценария и выполните действия.

Портал
Azure PowerShell

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

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

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

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

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

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

Внимание

В следующих примерах необходимо изменить <placeholder> значения для собственных.

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

Получите свойства приложения в образе MSIX, который вы хотите добавить и сохранить в переменной, выполнив следующую команду:
```
# Get the properties of the MSIX image
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    Uri = '<UNCPathToImageFile>'
}

$app = Expand-AzWvdMsixImage @parameters
```
Выходные данные должны совпадать со следующими выходными данными:
```
Name
----
hp01/expandmsiximage
```
Проверьте наличие только одного объекта в свойствах приложения, выполнив следующую команду:
```
$app | FL *
```
Если в выходных данных имеется несколько объектов, например x64 и x86 версии одного приложения, можно использовать параметр PackageFullName , чтобы указать, какой из них необходимо добавить, выполнив следующую команду:
```
# 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*
```
Добавьте образ MSIX в пул узлов, выполнив следующую команду. В этом примере состояние приложения помечается как активное.
```
$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    PackageAlias = $app.PackageAlias
    DisplayName = '<DisplayName>'
    ImagePath = $app.ImagePath
    IsActive = $true
}

New-AzWvdMsixPackage @parameters
```
Выходные данные при успешном добавлении пакета MSIX отсутствуют.

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

$parameters = @{
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
}

Get-AzWvdMsixPackage @parameters | ? PackageFamilyName -eq $app.PackageFamilyName | FL *

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

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

Изменение типа регистрации и состояния

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

Портал
Azure PowerShell

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

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

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

В том же сеансе 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

Найдите пакет, который нужно удалить и использовать для Name параметра, но удалите имя пула узлов и / с самого начала. Например, hp01/MyApp_1.0.0.0_neutral__abcdef123ghij преобразуется в MyApp_1.0.0.0_neutral__abcdef123ghij. Вот несколько примеров.
1. Измените тип регистрации, выполнив следующую команду. Установите значение IsRegularRegistration для входа по блокировке или $false по запросу.$true
```
$parameters = @{
    FullName = '<FullName>'
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    IsRegularRegistration = $true
}

Update-AzWvdMsixPackage @parameters
```
2. Измените состояние, выполнив следующую команду. Установите значение IsActive "Активный" или $false "Неактивный".$true
```
$parameters = @{
    FullName = '<FullName>'
    HostPoolName = '<HostPoolName>'
    ResourceGroupName = '<ResourceGroupName>'
    IsActive = $true
}

Update-AzWvdMsixPackage @parameters
```

Публикация приложения MSIX

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

Портал
Azure PowerShell

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

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

Для группы классических приложений выполните следующие сведения:

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

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

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

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

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

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

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

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

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

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

В том же сеансе 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

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

Совет

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

Портал
Azure PowerShell

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

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

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

В том же сеансе 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

Найдите пакет, который нужно удалить и использовать для 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
```

Отключение автоматических обновлений

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

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

Ключ: HKLM\Software\Policies\Microsoft\WindowsStore
- Тип: DWORD
- Имя: Автозагрузка
- Значение: 2
- Описание. Отключает автоматическое обновление в Microsoft Store.
Ключ: HKCU\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager
- Тип: DWORD
- Имя: PreInstalledAppsEnabled
- Значение: 0
- Описание. Отключает автоматическую загрузку содержимого.
Ключ: HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug
- Тип: DWORD
- Имя: ContentDeliveryAllowedOverride
- Значение: 2
- Описание. Отключает автоматическую загрузку содержимого.

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

# Disable Microsoft Store automatic update
If (!(Test-Path "HKLM:\Software\Policies\Microsoft\WindowsStore")) {
    New-Item -Path "HKLM:\Software\Policies\Microsoft\WindowsStore" -Force
}
New-ItemProperty -Path "HKLM:\Software\Policies\Microsoft\WindowsStore" -Name AutoDownload -PropertyType DWORD -Value 2 -Force

# Disable content delivery automatic download
If (!(Test-Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager")) {
    New-Item -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager" -Force
}
New-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\ContentDeliveryManager" -Name PreInstalledAppsEnabled -PropertyType DWORD -Value 0 -Force

# Disables content delivery automatic download
If (!(Test-Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug")) {
    New-Item -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug" -Force
}
New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\ContentDeliveryManager\Debug" -Name ContentDeliveryAllowedOverride -PropertyType DWORD -Value 2 -Force

Следующие шаги

Узнайте, как публиковать приложения из меню "Пуск" или пути к файлу с помощью RemoteApp. Дополнительные сведения см. в разделе "Публикация приложений".

Добавление и управление присоединением приложений MSIX и присоединением приложений в Виртуальном рабочем столе Azure

Необходимые компоненты

Добавление приложения

Назначение пакета подключения приложения

Пулы узлов

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

Изменение типа регистрации и состояния

Публикация приложения MSIX или Appx с помощью группы приложений RemoteApp

Обновление существующего пакета

Удаление пакета подключения приложения

Добавление образа MSIX в пул узлов

Изменение типа регистрации и состояния

Публикация приложения MSIX

Удаление пакета MSIX

Отключение автоматических обновлений

Следующие шаги

Дополнительные ресурсы