community.windows.win_shortcut 模块 – 在 Windows 上管理快捷方式

注意

此模块是 community.windows 集合 (版本 2.3.0) 的一部分。

如果您正在使用 ansible 包，您可能已经安装了此集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.windows。

要在 playbook 中使用它，请指定：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.org.cn/
    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.org.cn/
    dest: '%Public%\Desktop\Ansible website.url'

作者

  • Dag Wieers (@dagwieers)