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

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

Обзор
Параметры
Примечания
Примеры
Статус
Техническое обслуживание
- Автор

Обзор

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
args		Дополнительные аргументы для исполняемого файла, определенного в `src`.
description		Описание ярлыка. Обычно отображается при наведении курсора на значок.
dest обязательно		Целевой файл для ярлыка. Имя файла должно иметь расширение `.lnk` или `.url`.
directory		Рабочая директория для исполняемого файла, определенного в `src`.
hotkey		Сочетание клавиш для ярлыка. Это комбинация одного или нескольких модификаторов и клавиши. Возможные модификаторы: Alt, Ctrl, Shift, Ext. Возможные клавиши: [A-Z] и [0-9].
icon		Иконка для ярлыка. Имя файла должно иметь расширение `.ico`. Имя файла следует за запятой и числом из файла библиотеки (.dll) или используйте 0 для файла изображения.
src		Исполняемый файл или URL, на которые указывает ярлык. Исполняемый файл должен быть в вашей переменной среды PATH или иметь абсолютный путь к исполняемому файлу.
state	Варианты: отсутствует присутствует ←	Когда `absent`, удаляет ярлык, если он существует. Когда `present`, создает или обновляет ярлык.
windowstyle	Варианты: развернутый свернутый обычный	Влияет на отображение приложения при запуске.

Примечания

Примечание

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

Примеры

- 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'
    hotkey: Ctrl+Alt+F

- 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'
    hotkey: Ctrl+Alt+A

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

Статус

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

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание и поддержка модулей.

Список других модулей, поддерживаемых сообществом Ansible, см. здесь.

Автор

Dag Wieers (@dagwieers)

Подсказка

Если вы обнаружите какие-либо проблемы в данной документации, вы можете отредактировать этот документ, чтобы улучшить его.

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