Модуль community.windows.win_psrepository_copy — копирует зарегистрированные PSRepositories в профили других пользователей

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.windows.

Чтобы использовать её в плейбуке, укажите: community.windows.win_psrepository_copy.

Добавлено в community.windows 1.3.0

Краткое описание
Параметры
Примечания
См. также
Примеры

Краткое описание

Копирует указанные зарегистрированные PSRepositories в профили других пользователей системы.
Можно включить профиль Default, чтобы новые пользователи начинали работу с выбранными репозиториями.
Можно включить специальные учётные записи служб, например локального пользователя SYSTEM, LocalService, NetworkService.

Параметры

Параметр	Комментарии
exclude list / elements=string	Имена репозиториев, которые нужно исключить. Имена интерпретируются как шаблоны подстановки. Если имя соответствует как включаемому (name), так и исключаемому (exclude) шаблону, оно будет исключено.
exclude_profiles list / elements=string	Имена профилей пользователей, которые нужно исключить. Если профиль соответствует как включаемому (profiles), так и исключаемому (exclude_profiles) шаблону, он будет исключён. По умолчанию профили учётных записей служб исключаются. Чтобы явно не исключать ничего, задайте exclude_profiles=[]. По умолчанию: `["systemprofile", "LocalService", "NetworkService"]`
force boolean добавлено в community.windows 2.4.0	Если задано `True`, удаляет репозитории, отсутствующие в источнике. Варианты: `false` ← (по умолчанию) `true`
name list / elements=string	Имена репозиториев, которые нужно скопировать. Имена интерпретируются как шаблоны подстановки. По умолчанию: `["*"]`
profiles list / elements=string	Имена профилей пользователей, в которые нужно добавить репозитории. Имена интерпретируются как шаблоны подстановки. Также можно выбрать профиль `Default`. Профили `Public` и `All Users` нельзя выбрать, поскольку PSRepositories из них не загружаются. По умолчанию: `["*"]`
source path	Полный путь к XML-файлу исходных репозиториев. По умолчанию используются репозитории, зарегистрированные для текущего пользователя. По умолчанию: `"%LOCALAPPDATA%\\Microsoft\\Windows\\PowerShell\\PowerShellGet\\PSRepositories.xml"`

Примечания

Примечание

Не требует модуля PowerShellGet или каких-либо других внешних зависимостей.
Профили пользователей загружаются из реестра. Если указанный путь не существует (например, если каталог профиля был удалён), он пропускается без уведомления.
При настройке профилей учётных записей служб может потребоваться become=yes. См. примеры.
При первоначальной настройке файла репозиториев PowerShellGet всегда добавляет PSGallery. Однако если этот модуль создаёт новый файл репозиториев, а среди выбранных вами репозиториев нет PSGallery, в целевом расположении его не будет.
В profiles (и exclude_profiles) выполняется поиск по именам профилей, которые не обязательно совпадают с именами пользователей. Такое может произойти, если путь к профилю был намеренно изменён или если имена доменных пользователей совпадают с именами пользователей локального компьютера или другого домена. В этом случае к имени профиля второго и последующих пользователей может добавляться имя домена или локального компьютера, например JoeUser.Contoso и JoeUser. Если вы хотите фильтровать профили пользователей, убедитесь, что фильтры соответствуют нужным именам.
Для учётных записей служб используются следующие профили: systemprofile (для пользователя SYSTEM), а также LocalService или NetworkService для соответствующих учётных записей.
Репозитории с учётными данными (требующие аутентификации) или сведениями о прокси-сервере будут скопированы, однако учётные данные и сведения о прокси-сервере скопированы не будут, поскольку эта информация не хранится вместе с репозиторием.

См. также

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

Примеры

- name: Copy the current user's PSRepositories to all non-service account profiles and Default profile
  community.windows.win_psrepository_copy:

- name: Copy the current user's PSRepositories to all profiles and Default profile
  community.windows.win_psrepository_copy:
    exclude_profiles: []

- name: Copy the current user's PSRepositories to all profiles beginning with A, B, or C
  community.windows.win_psrepository_copy:
    profiles:
      - 'A*'
      - 'B*'
      - 'C*'

- name: Copy the current user's PSRepositories to all profiles beginning B except Brian and Brianna
  community.windows.win_psrepository_copy:
    profiles: 'B*'
    exclude_profiles:
      - Brian
      - Brianna

- name: Copy a specific set of repositories to profiles beginning with 'svc' with exceptions
  community.windows.win_psrepository_copy:
    name:
      - CompanyRepo1
      - CompanyRepo2
      - PSGallery
    profiles: 'svc*'
    exclude_profiles: 'svc-restricted'

- name: Copy repos matching a pattern with exceptions
  community.windows.win_psrepository_copy:
    name: 'CompanyRepo*'
    exclude: 'CompanyRepo*-Beta'

- name: Copy repositories from a custom XML file on the target host
  community.windows.win_psrepository_copy:
    source: 'C:\data\CustomRepostories.xml'

### A sample workflow of seeding a system with a custom repository

# A playbook that does initial host setup or builds system images

- name: Register custom respository
  community.windows.win_psrepository:
    name: PrivateRepo
    source_location: https://example.com/nuget/feed/etc
    installation_policy: trusted

- name: Ensure all current and new users have this repository registered
  community.windows.win_psrepository_copy:
    name: PrivateRepo

# In another playbook, run by other users (who may have been created later)

- name: Install a module
  community.windows.win_psmodule:
    name: CompanyModule
    repository: PrivateRepo
    state: present

Авторы

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_copy_module.html