ansible / ansible.builtin / v2.6.17 / module / win_shortcut Manage shortcuts on Windows | "added in version" 2.3 of ansible.builtin" Authors: Dag Wieers (@dagwieers) preview | supported by communityansible.builtin.win_shortcut (v2.6.17) — module
pip
Install with pip install ansible==2.6.17
Create, manage and delete Windows shortcuts
- 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'
src: description: - Executable or URL the shortcut points to. - The executable needs to be in your PATH, or has to be an absolute path to the executable. args: description: - Additional arguments for the executable defined in C(src). dest: description: - Destination file for the shortcuting file. - File name should have a C(.lnk) or C(.url) extension. required: true icon: description: - Icon used for the shortcut. - File name should have a C(.ico) extension. - The file name is followed by a comma and the number in the library file (.dll) or use 0 for an image file. state: choices: - absent - present default: present description: - When C(absent), removes the shortcut if it exists. - When C(present), creates or updates the shortcut. hotkey: description: - Key combination for the shortcut. - This is a combination of one or more modifiers and a key. - Possible modifiers are Alt, Ctrl, Shift, Ext. - Possible keys are [A-Z] and [0-9]. directory: description: - Working directory for executable defined in C(src). description: description: - Description for the shortcut. - This is usually shown when hoovering the icon. windowstyle: choices: - maximized - minimized - normal description: - Influences how the application is displayed when it is launched.