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

Примечание

Этот модуль является частью коллекции community.windows (версия 2.3.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 список / элементы=строка	Имена репозиториев для исключения. Имена интерпретируются как шаблоны. Если имя совпадает как с включением (name), так и с исключением, оно будет исключено.
exclude_profiles список / элементы=строка	Имена профилей пользователей для исключения. Если профиль совпадает как с включением (profiles), так и с exclude_profiles, он будет исключен. По умолчанию исключаются профили учетных записей служб. Чтобы явно не исключать ничего, установите exclude_profiles=[]. По умолчанию: `["systemprofile", "LocalService", "NetworkService"]`
name список / элементы=строка	Имена репозиториев для копирования. Имена интерпретируются как шаблоны. По умолчанию: `["*"]`
profiles список / элементы=строка	Имена профилей пользователей для заполнения репозиториями. Имена интерпретируются как шаблоны. Также может быть сопоставлен профиль `Default`. Профили `Public` и `All Users` не могут быть выбраны, так как PSRepositories из них не загружаются. По умолчанию: `["*"]`
source путь	Полный путь к XML-файлу исходных репозиториев. По умолчанию используется репозиторий, зарегистрированный для текущего пользователя. По умолчанию: `"%LOCALAPPDATA%\\Microsoft\\Windows\\PowerShell\\PowerShellGet\\PSRepositories.xml"`

Примечания

Примечание

Не требует модуля PowerShellGet или других внешних зависимостей.
Профили пользователей загружаются из реестра. Если указанный путь не существует (например, если каталог профиля был удален), он будет пропущен без ошибок.
При настройке профилей учетных записей служб может потребоваться become=yes. См. примеры.
Когда PowerShellGet впервые создает файл репозиториев, он всегда добавляет PSGallery. Однако, если этот модуль создает новый файл repos, и ваши выбранные репозитории не включают 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/windows/win_psrepository_copy_module.html