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

Примечание

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

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

Чтобы установить её, используйте: 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 логический	Если `True`, любые отличия от требуемого состояния приведут к отмене регистрации репозитория и его повторной регистрации. force не действует, если state=absent. Дополнительные сведения см. в примечаниях. Возможные значения: `false` ← (по умолчанию) `true`
installation_policy строка	Задаёт `InstallationPolicy` репозитория. При создании репозитория или использовании force=True по умолчанию будет установлено значение `trusted`. Возможные значения: `"trusted"` `"untrusted"`
name строка / обязательный	Имя репозитория, с которым нужно работать.
password строка добавлено в community.windows 1.10.0	Пароль для аутентификации в частном репозитории.
proxy строка добавлено в community.windows 1.1.0	Прокси-сервер для работы с репозиторием.
publish_location строка	Задаёт URI для публикации модулей в этом репозитории.
script_publish_location строка	Задаёт URI для публикации сценариев в этом репозитории.
script_source_location строка	Задаёт URI для поиска и установки сценариев из этого репозитория.
source_location псевдонимы: source строка	Задаёт URI для поиска и установки модулей из этого репозитория. URI может указывать на канал сервера NuGet (наиболее распространённый вариант), HTTP, HTTPS, FTP или расположение файла. Обязателен при регистрации нового репозитория или использовании force=True.
state строка	Если `present`, новый репозиторий добавляется или обновляется. Если `absent`, репозиторий удаляется. Возможные значения: `"absent"` `"present"` ← (по умолчанию)
username строка добавлено в 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 и измените плейбук в соответствии с ним.
При обновлении существующего репозитория все параметры, кроме 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/windows/win_psrepository_module.html