chocolatey.chocolatey.win_chocolatey_source 模块 – 管理 Chocolatey 源

注意

此模块是 chocolatey.chocolatey 集合 (版本 1.5.3) 的一部分。

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

要安装它,请使用: ansible-galaxy collection install chocolatey.chocolatey

要在剧本中使用它,请指定: chocolatey.chocolatey.win_chocolatey_source

chocolatey.chocolatey 0.2.7 中的新增功能

概要

  • 用于管理在客户端上配置的 Chocolatey 源。

  • 需要在远程主机上已安装 Chocolatey。

参数

参数

注释

admin_only

布尔值

使源仅对管理员可见。

需要 Chocolatey >= 0.10.8。

创建新源时,默认为 false

选项

  • false

  • true

allow_self_service

布尔值

允许使用自服务功能的源

需要 Chocolatey >= 0.10.4。

创建新源时,默认为 false

选项

  • false

  • true

bypass_proxy

布尔值

使用此源时绕过代理。

需要 Chocolatey >= 0.10.4。

创建新源时,默认为 false

选项

  • false

  • true

certificate

字符串

用于 X509 身份验证源的 .pfx 文件路径。

需要 Chocolatey >= 0.9.10。

certificate_password

字符串

如果需要,则为 certificate 的密码。

需要 Chocolatey >= 0.9.10。

name

字符串 / 必需

要配置的源的名称。

priority

整数

此源与其他源相比的优先级顺序,数值越低优先级越高。

所有高于 0 的优先级将首先被评估,然后根据配置文件顺序评估基于零的值。

需要 Chocolatey >= 0.9.9.9。

创建新源时,默认为 0

source

字符串

源的文件/文件夹/URL。

statepresentdisabled 且源尚不存在时,此参数为必需。

source_password

字符串

source_username 的密码。

如果设置了 source_username,则此参数为必需。

source_username

字符串

用于访问 source 的用户名。

state

字符串

absent 时,将删除源。

disabled 时,将确保源存在但处于禁用状态。

present 时,将确保源存在并启用。

选项

  • "absent"

  • "disabled"

  • "present" ← (默认)

update_password

字符串

always 时,模块将始终设置密码,并在设置 certificate_passwordsource_password 时报告更改。

on_create 时,模块仅在创建源时设置密码。

选项

  • "always" ← (默认)

  • "on_create"

另请参阅

另请参阅

chocolatey.chocolatey.win_chocolatey

使用 chocolatey 管理包。

chocolatey.chocolatey.win_chocolatey_config

管理 Chocolatey 配置设置。

chocolatey.chocolatey.win_chocolatey_facts

创建 Chocolatey 的事实集合。

chocolatey.chocolatey.win_chocolatey_feature

管理 Chocolatey 功能。

示例

- name: Remove the default public source
  win_chocolatey_source:
    name: chocolatey
    state: absent

- name: Add new internal source
  win_chocolatey_source:
    name: internal repo
    state: present
    source: http://chocolatey-server/chocolatey

- name: Create HTTP source with credentials
  win_chocolatey_source:
    name: internal repo
    state: present
    source: https://chocolatey-server/chocolatey
    source_username: username
    source_password: password

- name: Disable Chocolatey source
  win_chocolatey_source:
    name: chocolatey
    state: disabled

作者

  • Jordan Borean (@jborean93)

  • Rain Sallow (@vexx32)

  • Josh King (@windos)