Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Развертывание приложений Windows (WinAppDeployCmd.exe) — это средство командной строки, которое может использовать для развертывания приложения универсальной платформы Windows (UWP) с компьютера Windows 10 на любом устройстве с Windows 10. Это средство можно использовать для развертывания пакета приложения, если устройство Windows 10 подключено через USB или доступно в той же подсети, не нуждаясь в Microsoft Visual Studio или решении для этого приложения. Кроме того, вы можете развернуть приложение без упаковки на удаленный компьютер или Xbox One. В этой статье описывается установка приложений UWP с помощью этого средства.
Для запуска средства WinAppDeployCmd из командной строки или файла скрипта необходимо установить пакет SDK для Windows 10. При установке приложения с WinAppDeployCmd.exeиспользуется файл .appx/.msix или AppxManifest(для свободных файлов) для загрузки приложения на устройство Windows 10. Эта команда не устанавливает сертификат, необходимый для приложения. Чтобы запустить приложение, устройство Windows 10 должно находиться в режиме разработчика или уже установлено сертификат.
Чтобы развернуть на мобильных устройствах, сначала необходимо создать пакет. Для получения дополнительных сведений см. здесь.
Средство WinAppDeployCmd.exe расположено здесь на вашем компьютере с Windows 10: C:\Program Files (x86)\Windows Kits\10\bin\<версия SDK>\x86\WinAppDeployCmd.exe (на основе пути установки SDK).
Замечание
В версии 15063 и более поздних версий пакет SDK устанавливается параллельно в папках для конкретной версии. Предыдущие пакеты SDK (до и включая 14393) записываются непосредственно в родительскую папку.
Сначала подключите устройство Windows 10 к той же подсети или подключите его непосредственно к компьютеру с Windows 10 с USB-подключением. Затем используйте следующий синтаксис и примеры этой команды далее в этой статье для развертывания приложения UWP:
Синтаксис и параметры WinAppDeployCmd
Это общий синтаксис, используемый для WinAppDeployCmd.exe:
WinAppDeployCmd command -option <argument>
Ниже приведены некоторые дополнительные примеры синтаксиса для использования различных команд:
WinAppDeployCmd devices
WinAppDeployCmd devices <x>
WinAppDeployCmd install -file <path> -ip <address>
WinAppDeployCmd install -file <path> -guid <address> -pin <p>
WinAppDeployCmd install -file <path> -ip <address> -dependency <a> <b>
WinAppDeployCmd install -file <path> -guid <address> -dependency <a> <b>
WinAppDeployCmd uninstall -file <path>
WinAppDeployCmd uninstall -package <name>
WinAppDeployCmd update -file <path>
WinAppDeployCmd list -ip <address>
WinAppDeployCmd list -guid <address>
WinAppDeployCmd deployfiles -file <path> -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd registerfiles -remotedeploydir <remoterelativepath> -ip <address>
WinAppDeployCmd addcreds -credserver <server> -credusername <username> -credpassword <password> -ip <address>
WinAppDeployCmd getcreds -credserver <server> -ip <address>
WinAppDeployCmd deletecreds -credserver <server> -ip <address>
Вы можете установить или удалить приложение на целевом устройстве или обновить уже установленное приложение. Чтобы сохранить данные или параметры, сохраненные приложением, которое уже установлено, используйте параметры обновления вместо параметров установки .
В следующей таблице описываются команды для WinAppDeployCmd.exe.
| Команда | Описание |
|---|---|
| приборы | Отображение списка доступных сетевых устройств. |
| Установить | Установите пакет приложения UWP на целевое устройство. |
| обновление | Обновите приложение UWP, которое уже установлено на целевом устройстве. |
| список | Отображение списка приложений UWP, установленных на указанном целевом устройстве. |
| Удалить | Удалите указанный пакет приложения с целевого устройства. |
| файлы развертывания | Скопируйте приложение без установочного пакета в указанный путь к относительному удалённому пути на устройстве. |
| регистровые файлы | Зарегистрируйте приложение с непакетированными файлами в удаленном каталоге развертывания. |
| addcreds | Добавьте учетные данные в Xbox, чтобы он мог получить доступ к сетевому ресурсу для регистрации приложения. |
| getcreds | Получите сетевые учетные данные для целевого использования при запуске приложения из сетевой папки. |
| deletecreds | Удалите учетные данные сети, которые целевой объект использует при запуске приложения из сетевого ресурса. |
В следующей таблице описаны параметры WinAppDeployCmd.exe.
| Команда | Описание |
|---|---|
| -h (-help) | Отображение команд, параметров и аргументов. |
| -протокол IP | IP-адрес целевого устройства. |
| -g (-guid) | Уникальный идентификатор целевого устройства. |
| -d (-dependency) | (Необязательно) Указывает путь зависимостей для каждого из зависимостей пакета. Если путь не указан, средство выполняет поиск зависимостей в корневом каталоге для пакета приложения и каталогов ПАКЕТА SDK. |
| -f (-file) | Путь к файлу пакета приложения для установки, обновления или удаления. |
| -p (-package) | Полное имя пакета приложения для удаления. (С помощью команды списка можно найти полные имена пакетов, уже установленных на устройстве) |
| -булавка | Пин-код, если он требуется для установления соединения с целевым устройством. (Вам будет предложено повторить попытку с параметром -pin, если требуется проверка подлинности) |
| -credserver | Имя сервера сетевых учетных данных для использования целевым объектом. |
| -credusername | Имя пользователя сетевых учетных данных для использования целевым объектом. |
| -credpassword | Пароль сетевых учетных данных для использования целевым объектом. |
| -connecttimeout | Время ожидания в секундах, используемое при подключении к устройству. |
| -remotedeploydir | Относительный путь или имя каталога для копирования файлов на удаленное устройство; Это будет предопределенная и часто используемая папка для удаленного развертывания, определяемая автоматически. |
| -deleteextrafile | Переключитесь, чтобы указать, следует ли очистить существующие файлы в удаленном каталоге, чтобы он соответствовал исходному каталогу. |
В следующей таблице описаны параметры WinAppDeployCmd.exe.
| Аргумент | Описание |
|---|---|
| <x> | Время ожидания в секундах. (Значение по умолчанию — 10) |
| <адрес> | IP-адрес или уникальный идентификатор целевого устройства. |
| <a b><> ... | Путь зависимостей для каждого из зависимостей пакета приложения. |
| <p> | Буквенно-цифровой пин-код, показанный в параметрах устройства для установления подключения. |
| <маршрут> | Путь к файловой системе. |
| < > имя | Полное название пакета приложения для его удаления. |
| <сервер> | Сервер в файловой сети. |
| <имени пользователя> | Пользователь, имеющий учетные данные для доступа к серверу в файловой сети. |
| <пароль> | Пароль для учетных данных с доступом к серверу файловой сети. |
| <remotedeploydir> | Каталог на устройстве относительно расположения развертывания |
примеры WinAppDeployCmd.exe
Ниже приведены некоторые примеры развертывания из командной строки с помощью синтаксиса для WinAppDeployCmd.exe.
Показывает устройства, доступные для развертывания. Команда завершает выполнение через 3 секунды.
WinAppDeployCmd devices 3
Устанавливает приложение из пакета MyApp.appx, который находится в каталоге загрузки компьютера на устройство с Windows 10 с IP-адресом 192.168.0.1 с ПИН-кодом A1B2C3, чтобы установить подключение к устройству
WinAppDeployCmd install -file "Downloads\MyApp.appx" -ip 192.168.0.1 -pin A1B2C3
Удаляет указанный пакет (на основе полного имени) с устройства Windows с IP-адресом 192.168.0.1. Команду списка можно использовать для просмотра полных имен всех пакетов, установленных на устройстве.
WinAppDeployCmd uninstall -package Company.MyApp_1.0.0.1_x64__qwertyuiop -ip 192.168.0.1
Обновляет приложение, которое уже установлено на устройстве с Windows 10 с IP-адресом 192.168.0.1 с помощью указанного пакета приложения.
WinAppDeployCmd update -file "Downloads\MyApp.appx" -ip 192.168.0.1
Развертывает файлы приложения на компьютере или Xbox с IP-адресом 192.168.0.1 в той же папке, что и AppxManifest, в каталог app1_F5 в пути развертывания устройства.
WinAppDeployCmd deployfiles -file "C:\apps\App1\AppxManifest.xml" -remotedeploydir app1_F5 -ip 192.168.0.1
Регистрирует приложение в каталоге app1_F5 в каталоге развертывания на ПК или Xbox с IP-адресом 192.168.0.1.
WinAppDeployCmd registerfiles -remotedeploydir app1_F5 -ip 192.168.0.1
Использование WinAppDeployCmd для настройки развертывания и запуска с ПК на Xbox One
Запуск с компьютера позволяет развернуть приложение UWP в Xbox One без копирования двоичных файлов, а двоичные файлы размещаются в сетевой папке в той же сети, что и Xbox. Для этого вам нужна консоль Xbox One с активированным режимом разработчика и UWP-приложение в виде отдельных файлов на сетевом диске, к которому может получить доступ Xbox.
Выполните следующую команду, чтобы зарегистрировать приложение:
WinAppDeployCmd registerfiles -ip <Xbox One IP> -remotedeploydir <location of app> -username <user for network> -password <password for user>
ex. WinAppDeployCmd register files -ip 192.168.0.1 -remotedeploydir \\driveA\myAppLocation -username admin -password A1B2C3