Модуль community.windows.win_shortcut — управление ярлыками в Windows

Примечание

Этот модуль входит в коллекцию community.windows (версия 3.1.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_shortcut.

Краткое описание
Параметры
Примечания
См. также
Примеры

Краткое описание

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

Параметры

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

Примечания

Примечание

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

См. также

ansible.windows.win_file: Создаёт, обновляет временную метку или удаляет файлы и каталоги.

Примеры

- name: Create an application shortcut on the desktop
  community.windows.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
  community.windows.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
  community.windows.win_shortcut:
    src: cmd.exe
    dest: Desktop\Command prompt.lnk

- name: Create an application shortcut for the Ansible website
  community.windows.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
  community.windows.win_shortcut:
    src: https://ansible.com/
    dest: '%Public%\Desktop\Ansible website.url'

Авторы

Dag Wieers (@dagwieers)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_shortcut_module.html