community.windows.win_psrepository – Добавляет, удаляет или обновляет репозиторий Windows PowerShell.

Примечание

Этот плагин входит в коллекцию community.windows (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.windows.

Для использования в плейбуке укажите: community.windows.win_psrepository.

Обзор
Требования
Параметры
Примечания
См. также
Примеры

Обзор

Этот модуль помогает добавить, удалить и обновить репозиторий Windows PowerShell на системах с Windows.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

Модуль PowerShell PowerShellGet >= 1.6.0
Модуль PowerShell PackageManagement >= 1.1.7
Поставщик пакетов PowerShell NuGet >= 2.8.5.201

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
force boolean	Варианты: нет ← да	Если `True`, любые различия от желаемого состояния приведут к тому, что репозиторий будет деинсталлирован, а затем повторно зарегистрирован. force не влияет, когда state=absent. См. примечания для дополнительного контекста.
installation_policy строка	Варианты: trusted untrusted	Устанавливает `InstallationPolicy` репозитория. Будет по умолчанию `trusted`, при создании нового репозитория или использовании force=True.
name строка / обязательный		Имя репозитория для работы.
proxy строка добавлен в 1.1.0 community.windows		Прокси-сервер для использования с репозиторием.
publish_location строка		Указывает URI для публикации модулей в этот репозиторий.
script_publish_location строка		Указывает URI для публикации скриптов в этот репозиторий.
script_source_location строка		Указывает URI для поиска и установки скриптов из этого репозитория.
source_location строка		Указывает URI для поиска и установки модулей из этого репозитория. URI может быть каналом NuGet (чаще всего), HTTP, HTTPS, FTP или расположением файла. Требуется при регистрации нового репозитория или использовании force=True. псевдонимы: source
state строка	Варианты: absent present ←	Если `present`, добавляется или обновляется новый репозиторий. Если `absent`, репозиторий удаляется.

Примечания

Примечание

См. примеры по обновлению поставщика пакетов NuGet.
Вы не можете использовать win_psrepository для повторной регистрации (добавления) удаленного PSGallery, используйте команду Register-PSRepository -Default вместо этого.
При регистрации или установке source_location, PowerShellGet преобразует расположение в соответствии с внутренними правилами, например, следуя перенаправлениям HTTP/S.
Это может привести к статусу CHANGED при каждом запуске, так как значения никогда не будут совпадать и будут «сброшены» каждый раз.
Чтобы обойти это, найдите истинное конечное значение с помощью community.windows.win_psrepository_info или Get-PSRepository и обновите плейбук для соответствия.
При обновлении существующего репозитория все параметры, кроме name, являются необязательными. Будут обновлены только предоставленные параметры. Используйте force=True для точного соответствия.
script_location, publish_location и script_publish_location являются необязательными, но после установки их можно очистить только с помощью force=True.
Использование force=True приведет к деинсталляции и повторной регистрации репозитория, если есть какие-либо изменения, чтобы точно соответствовать указанным параметрам.

См. также

community.windows.win_psrepository_info: Официальная документация модуля community.windows.win_psrepository_info.
community.windows.win_psmodule: Официальная документация модуля community.windows.win_psmodule.

Примеры

---
- name: Ensure the required NuGet package provider version is installed
  ansible.windows.win_shell: Find-PackageProvider -Name Nuget -ForceBootstrap -IncludeDependencies -Force

- name: Register a PowerShell repository
  community.windows.win_psrepository:
    name: MyRepository
    source_location: https://myrepo.com
    state: present

- name: Remove a PowerShell repository
  community.windows.win_psrepository:
    name: MyRepository
    state: absent

- name: Add an untrusted repository
  community.windows.win_psrepository:
    name: MyRepository
    installation_policy: untrusted

- name: Add a repository with different locations
  community.windows.win_psrepository:
    name: NewRepo
    source_location: https://myrepo.example/module/feed
    script_source_location: https://myrepo.example/script/feed
    publish_location: https://myrepo.example/api/module/publish
    script_publish_location: https://myrepo.example/api/script/publish

- name: Update only two properties on the above repository
  community.windows.win_psrepository:
    name: NewRepo
    installation_policy: untrusted
    script_publish_location: https://scriptprocessor.example/publish

- name: Clear script locations from the above repository by re-registering it
  community.windows.win_psrepository:
    name: NewRepo
    installation_policy: untrusted
    source_location: https://myrepo.example/module/feed
    publish_location: https://myrepo.example/api/module/publish
    force: True

Авторы

Wojciech Sciesinski (@it-praktyk)
Brian Scholer (@briantist)

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