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

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

Обзор
Параметры
Примечания
См. также
Примеры
Статус

Обзор

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

Параметры

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

Примечания

Примечание

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

См. также

win_file – Создание, создание или удаление файлов или каталогов: Официальная документация по модулю win_file.

Примеры

- 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'
    arguments: --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. [сообщество]

Авторы

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.8/modules/win_shortcut_module.html