community.windows.win_shortcut – Manage shortcuts on Windows¶
Note
This plugin is part of the community.windows collection (version 1.3.0).
To install it use: ansible-galaxy collection install community.windows
.
To use it in a playbook, specify: community.windows.win_shortcut
.
Parameters¶
Notes¶
Note
The following options can include Windows environment variables:
dest
,args
,description
,dest
,directory
,icon
src
Windows has two types of shortcuts: Application and URL shortcuts. URL shortcuts only consists of
dest
andsrc
See Also¶
See also
- ansible.windows.win_file
The official documentation on the ansible.windows.win_file module.
Examples¶
- 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'
Authors¶
Dag Wieers (@dagwieers)