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

Примечание

Этот модуль является частью коллекции community.windows (версия 2.3.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.windows. Вам потребуются дополнительные требования для использования этого модуля, см. Требования для получения подробной информации.

Для использования в playbook, укажите: 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. См. примечания для дополнительного контекста. Варианты: `false` ← (по умолчанию) `true`
installation_policy string	Задает `InstallationPolicy` репозитория. Будет установлено по умолчанию `trusted` при создании нового репозитория или используется с force=True. Варианты: `"trusted"` `"untrusted"`
name string / обязательно	Имя репозитория, с которым нужно работать.
password string добавлено в community.windows 1.10.0	Пароль для аутентификации в частном репозитории.
proxy string добавлено в community.windows 1.1.0	Прокси-сервер для использования с репозиторием.
publish_location string	Указывает URI для публикации модулей в этот репозиторий.
script_publish_location string	Указывает URI для публикации скриптов в этот репозиторий.
script_source_location string	Указывает URI для обнаружения и установки скриптов из этого репозитория.
source_location псевдонимы: source string	Указывает URI для обнаружения и установки модулей из этого репозитория. URI может быть каналом (feed) сервера NuGet (наиболее распространенный случай), HTTP, HTTPS, FTP или файловым расположением. Обязательно при регистрации нового репозитория или использовании force=True.
state string	Если `present` добавляется или обновляется новый репозиторий. Если `absent` репозиторий удаляется. Варианты: `"absent"` `"present"` ← (по умолчанию)
username string добавлено в community.windows 1.10.0	Имя пользователя для аутентификации в частном репозитории.

Примечания

Примечание

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

См. также

community.windows.win_psrepository_info: Сбор информации о PSRepositories.
community.windows.win_psmodule: Добавление или удаление модуля Windows PowerShell.

Примеры

---
- 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

- name: Register a PowerShell repository with credentials
  community.windows.win_psrepository:
    name: MyRepository
    source_location: https://myrepo.com
    state: present
    username: repo_username
    password: repo_password

Авторы

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

Ссылки на сборник

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