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 string	Варианты: trusted untrusted	Устанавливает `InstallationPolicy` хранилища. Будет по умолчанию `trusted` при создании нового хранилища или использовании с force=True.
name string / обязательно		Имя хранилища, с которым нужно работать.
proxy string добавлен в 1.1.0 community.windows		Прокси-сервер для использования с хранилищем.
publish_location string		Указывает URI для публикации модулей в это хранилище.
script_publish_location string		Указывает URI для публикации скриптов в это хранилище.
script_source_location string		Указывает URI для обнаружения и установки скриптов из этого хранилища.
source_location string		Указывает URI для обнаружения и установки модулей из этого хранилища. URI может быть NuGet серверной лентой (наиболее распространенный случай), HTTP, HTTPS, FTP или файловым местоположением. Требуется при регистрации нового хранилища или использовании force=True. псевдонимы: source
state string	Варианты: 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/windows/win_psrepository_module.html