win_shortcut - Управление ярлыками в Windows

Новое в версии 2.3.

Описание
Параметры
Примеры
Примечания
- Статус

Описание

Создание, управление и удаление ярлыков Windows

Параметры

параметр	обязателен	по умолчанию	возможные значения	комментарии
args	нет			Дополнительные аргументы для исполняемого файла, определённого в `src`.
description	нет			Описание ярлыка. Обычно отображается при наведении на значок.
dest	да			Путь к файлу ярлыка. Имя файла должно иметь расширение `.lnk` или `.url`.
directory	нет			Рабочая директория для исполняемого файла, определённого в `src`.
hotkey	нет			Сочетание клавиш для ярлыка.
icon	нет			Значок для ярлыка. Имя файла должно иметь расширение `.ico`. Имя файла следует запятой и числом из библиотечного файла (.dll), или 0 для файла изображения.
src	нет			Исполняемый файл или URL, на который указывает ярлык. Исполняемый файл должен быть в вашей переменной PATH или иметь абсолютный путь к файлу.
state	нет	present	absent present	При значении `present`, создаёт или обновляет ярлык. При значении `absent`, удаляет ярлык, если он существует.
windowstyle	нет		maximized minimized normal	Влияет на отображение приложения при запуске.

Примеры

- name: Create an application shortcut on the desktop
  win_shortcut:
    src: C:\Program Files\Mozilla Firefox\Firefox.exe
    dest: C:\Users\Public\Desktop\Mozilla Firefox.lnk
    icon: C:\Program Files\Mozilla Firefox\Firefox.exe,0

- name: Create the same shortcut using environment variables
  win_shortcut:
    description: The Mozilla Firefox web browser
    src: '%ProgramFiles%\Mozilla Firefox\Firefox.exe'
    dest: '%Public%\Desktop\Mozilla Firefox.lnk'
    icon: '%ProgramFiles\Mozilla Firefox\Firefox.exe,0'
    directory: '%ProgramFiles%\Mozilla Firefox'

- name: Create an application shortcut for an executable in PATH to your desktop
  win_shortcut:
    src: cmd.exe
    dest: Desktop\Command prompt.lnk

- name: Create an application shortcut for the Ansible website
  win_shortcut:
    src: '%ProgramFiles%\Google\Chrome\Application\chrome.exe'
    dest: '%UserProfile%\Desktop\Ansible website.lnk'
    args: --new-window https://ansible.com/
    directory: '%ProgramFiles%\Google\Chrome\Application'
    icon: '%ProgramFiles%\Google\Chrome\Application\chrome.exe,0'

- name: Create a URL shortcut for the Ansible website
  win_shortcut:
    src: https://ansible.com/
    dest: '%Public%\Desktop\Ansible website.url'

Примечания

Примечание

Следующие параметры могут включать переменные среды Windows: dest, args, description, dest, directory, icon src
Windows имеет два типа ярлыков: ярлыки приложений и ярлыки URL. Ярлыки URL содержат только dest и src

Статус

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

Для получения помощи в разработке модулей, если вы заинтересованы, пожалуйста, ознакомьтесь со статьей Информация о сообществе и вклад, Тестирование Ansible и Разработка модулей.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/win_shortcut_module.html