mirror of
https://github.com/ansible-collections/community.general.git
synced 2025-04-26 12:21:26 -07:00
e4a3e73b15
* Add win_psrepository * Small corrections * Correct requiqurements - add NuGet * Extend tests * Post-review updates * Post-review - updates 2 * Add empty RETURN section in documentation * Add empty line at EOF * Post-review updates 3 * Update tests to run in check_mode too * Minor updates * Correct installing/updating NuGet * a few changes for review * Remove copyrights * Revert "Remove copyrights" This reverts commit 2d687ec6a691d8d71358ae447e0fdc828976a767.
68 lines
2.3 KiB
Python
68 lines
2.3 KiB
Python
#!/usr/bin/python
|
|
# -*- coding: utf-8 -*-
|
|
|
|
# Copyright: (c) 2018, Wojciech Sciesinski <wojciech[at]sciesinski[dot]net>
|
|
# Copyright: (c) 2017, Daniele Lazzari <lazzari@mailup.com>
|
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
|
|
|
# this is a windows documentation stub. actual code lives in the .ps1
|
|
# file of the same name
|
|
|
|
ANSIBLE_METADATA = {'metadata_version': '1.1',
|
|
'status': ['preview'],
|
|
'supported_by': 'community'}
|
|
|
|
DOCUMENTATION = r'''
|
|
---
|
|
module: win_psrepository
|
|
version_added: "2.8"
|
|
short_description: Adds, removes or updates a Windows PowerShell repository.
|
|
description:
|
|
- This module helps to add, remove and update Windows PowerShell repository on Windows-based systems.
|
|
options:
|
|
name:
|
|
description:
|
|
- Name of the repository to work with.
|
|
required: yes
|
|
source:
|
|
description:
|
|
- Specifies the URI for discovering and installing modules from this repository.
|
|
- A URI can be a NuGet server feed (most common situation), HTTP, HTTPS, FTP or file location.
|
|
state:
|
|
description:
|
|
- If C(present) a new repository is added or updated.
|
|
- If C(absent) a repository is removed.
|
|
choices: [ absent, present ]
|
|
default: present
|
|
installation_policy:
|
|
description:
|
|
- Sets the C(InstallationPolicy) of a repository.
|
|
- Will default to C(trusted) when creating a new repository.
|
|
choices: [ trusted, untrusted ]
|
|
notes:
|
|
- The PowerShellGet module (version 1.6.0 or newer) and the NuGet package provider (version 2.8.5.201 or newer) are required.
|
|
- See the examples on how to update the NuGet package provider.
|
|
- You can't use M(win_psrepository) to re-register (add) removed PSGallery, use the command C(Register-PSRepository -Default) instead.
|
|
author:
|
|
- Wojciech Sciesinski (@it-praktyk)
|
|
'''
|
|
|
|
EXAMPLES = r'''
|
|
---
|
|
- name: Ensure the required NuGet package provider version is installed
|
|
win_shell: Install-PackageProvider -Name NuGet -RequiredVersion 2.8.5.201 -Force
|
|
|
|
- name: Add a PowerShell module and register a repository
|
|
win_psrepository:
|
|
name: MyRepository
|
|
source: https://myrepo.com
|
|
state: present
|
|
|
|
- name: Remove a PowerShell repository
|
|
win_psrepository:
|
|
name: MyRepository
|
|
state: absent
|
|
'''
|
|
|
|
RETURN = r'''
|
|
'''
|