From 0ce941e74d63c3536d645c252995098022fcee25 Mon Sep 17 00:00:00 2001 From: Jordan Borean Date: Fri, 13 May 2022 15:22:57 +1000 Subject: [PATCH] Prepare for v1.10.0 release (#395) --- CHANGELOG.rst | 34 +++- README.md | 1 + changelogs/changelog.yaml | 45 ++++- ...ain_user-add-support-for-spns-kerberos.yml | 4 - .../win_domain_user-groups-missing.yml | 2 - .../fragments/win_hotfix-multiple-msu.yml | 5 - .../win_iis_webapplication-missing-path.yml | 2 - .../fragments/win_psmodule-credentials.yml | 3 - changelogs/fragments/win_rds-sid.yml | 3 - changelogs/fragments/win_region-output.yml | 2 - changelogs/fragments/win_scoop-install.yml | 2 - .../fragments/win_scoop_bucket-error.yml | 2 - ...windows.win_audit_policy_system_module.rst | 1 + ...ommunity.windows.win_audit_rule_module.rst | 3 + ...ows.win_domain_group_membership_module.rst | 1 + ...mmunity.windows.win_domain_user_module.rst | 158 +++++++++++++++- .../community.windows.win_eventlog_module.rst | 1 + .../community.windows.win_firewall_module.rst | 1 + ...unity.windows.win_firewall_rule_module.rst | 2 + docs/community.windows.win_hotfix_module.rst | 38 ++++ ...nity.windows.win_iis_webbinding_module.rst | 2 +- ....windows.win_listen_ports_facts_module.rst | 172 ++++++++++++++++++ docs/community.windows.win_nssm_module.rst | 1 + .../community.windows.win_psmodule_module.rst | 40 ++++ ...munity.windows.win_psrepository_module.rst | 40 ++++ docs/community.windows.win_rds_cap_module.rst | 2 + docs/community.windows.win_rds_rap_module.rst | 2 + ...nity.windows.win_scheduled_task_module.rst | 2 + ...munity.windows.win_scoop_bucket_module.rst | 47 +++++ docs/community.windows.win_snmp_module.rst | 2 + docs/community.windows.win_xml_module.rst | 1 - galaxy.yml | 2 +- 32 files changed, 588 insertions(+), 35 deletions(-) delete mode 100644 changelogs/fragments/365-win_domain_user-add-support-for-spns-kerberos.yml delete mode 100644 changelogs/fragments/win_domain_user-groups-missing.yml delete mode 100644 changelogs/fragments/win_hotfix-multiple-msu.yml delete mode 100644 changelogs/fragments/win_iis_webapplication-missing-path.yml delete mode 100644 changelogs/fragments/win_psmodule-credentials.yml delete mode 100644 changelogs/fragments/win_rds-sid.yml delete mode 100644 changelogs/fragments/win_region-output.yml delete mode 100644 changelogs/fragments/win_scoop-install.yml delete mode 100644 changelogs/fragments/win_scoop_bucket-error.yml create mode 100644 docs/community.windows.win_listen_ports_facts_module.rst diff --git a/CHANGELOG.rst b/CHANGELOG.rst index 6b0a67b9..bcbe9762 100644 --- a/CHANGELOG.rst +++ b/CHANGELOG.rst @@ -5,13 +5,41 @@ Community Windows Release Notes .. contents:: Topics -v1.9.0 -====== +v1.10.0 +======= Release Summary --------------- -- Release summary for v1.9.0 +Release summary for v1.10.0 + +Minor Changes +------------- + +- win_domain_user - Add support for managing service prinicpal names via the ``spn`` param and principals allowed to delegate via the ``delegates`` param (https://github.com/ansible-collections/community.windows/pull/365) +- win_domain_user - Added the ``groups_missing_behaviour`` option that controls the behaviour when a group specified does not exist - https://github.com/ansible-collections/community.windows/pull/375 +- win_hotfix - Added the ``identifiers`` and ``kbs`` return value that is always a list of identifiers and kbs inside a hotfix +- win_psmodule - Add credential support for through the ``username`` and ``password`` options +- win_psrepository - Add credential support for through the ``username`` and ``password`` options + +Bugfixes +-------- + +- win_hotfix - Supports hotfixes that contain multiple updates inside the supplied update msu - https://github.com/ansible-collections/community.windows/issues/284 +- win_iis_webapplication - Fix physical path check for broken configurations - https://github.com/ansible-collections/community.windows/pull/385 +- win_rds_cap - Fix SID lookup with any account ending with the ``@builtin`` UPN suffix +- win_rds_rap - Fix SID lookup with any account ending with the ``@builtin`` UPN suffix +- win_region - Fix junk output when copying settings across users +- win_scoop - Fix bootstrapping process to properly work when running as admin +- win_scoop_bucket - Fix handling of output and errors from each scoop command + +New Modules +----------- + +- win_listen_ports_facts - Recopilates the facts of the listening ports of the machine + +v1.9.0 +====== Minor Changes ------------- diff --git a/README.md b/README.md index 5cdba909..36204334 100644 --- a/README.md +++ b/README.md @@ -68,6 +68,7 @@ Name | Description [community.windows.win_inet_proxy](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_inet_proxy_module.rst)|Manages proxy settings for WinINet and Internet Explorer [community.windows.win_initialize_disk](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_initialize_disk_module.rst)|Initializes disks on Windows Server [community.windows.win_lineinfile](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_lineinfile_module.rst)|Ensure a particular line is in a file, or replace an existing line using a back-referenced regular expression +[community.windows.win_listen_ports_facts](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_listen_ports_facts_module.rst)|Recopilates the facts of the listening ports of the machine [community.windows.win_mapped_drive](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_mapped_drive_module.rst)|Map network drives for users [community.windows.win_msg](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_msg_module.rst)|Sends a message to logged in users on Windows hosts [community.windows.win_net_adapter_feature](https://github.com/ansible-collections/community.windows/blob/main/docs/community.windows.win_net_adapter_feature_module.rst)|Enable or disable certain network adapters. diff --git a/changelogs/changelog.yaml b/changelogs/changelog.yaml index ced01778..1f1f6abf 100644 --- a/changelogs/changelog.yaml +++ b/changelogs/changelog.yaml @@ -124,6 +124,49 @@ releases: - win_firewall_action.yml - win_psrepository-proxy.yml release_date: '2020-09-26' + 1.10.0: + changes: + bugfixes: + - win_hotfix - Supports hotfixes that contain multiple updates inside the supplied + update msu - https://github.com/ansible-collections/community.windows/issues/284 + - win_iis_webapplication - Fix physical path check for broken configurations + - https://github.com/ansible-collections/community.windows/pull/385 + - win_rds_cap - Fix SID lookup with any account ending with the ``@builtin`` + UPN suffix + - win_rds_rap - Fix SID lookup with any account ending with the ``@builtin`` + UPN suffix + - win_region - Fix junk output when copying settings across users + - win_scoop - Fix bootstrapping process to properly work when running as admin + - win_scoop_bucket - Fix handling of output and errors from each scoop command + minor_changes: + - win_domain_user - Add support for managing service prinicpal names via the + ``spn`` param and principals allowed to delegate via the ``delegates`` param + (https://github.com/ansible-collections/community.windows/pull/365) + - win_domain_user - Added the ``groups_missing_behaviour`` option that controls + the behaviour when a group specified does not exist - https://github.com/ansible-collections/community.windows/pull/375 + - win_hotfix - Added the ``identifiers`` and ``kbs`` return value that is always + a list of identifiers and kbs inside a hotfix + - win_psmodule - Add credential support for through the ``username`` and ``password`` + options + - win_psrepository - Add credential support for through the ``username`` and + ``password`` options + release_summary: Release summary for v1.10.0 + fragments: + - 365-win_domain_user-add-support-for-spns-kerberos.yml + - v1.10.0-release.yml + - win_domain_user-groups-missing.yml + - win_hotfix-multiple-msu.yml + - win_iis_webapplication-missing-path.yml + - win_psmodule-credentials.yml + - win_rds-sid.yml + - win_region-output.yml + - win_scoop-install.yml + - win_scoop_bucket-error.yml + modules: + - description: Recopilates the facts of the listening ports of the machine + name: win_listen_ports_facts + namespace: '' + release_date: '2022-05-13' 1.2.0: changes: bugfixes: @@ -317,8 +360,6 @@ releases: options to control the virtual directory authentication - https://github.com/ansible-collections/community.windows/issues/346 - win_power_plan - Added ``guid`` option to specify plan by a unique identifier - https://github.com/ansible-collections/community.windows/issues/310 - release_summary: - - Release summary for v1.9.0 fragments: - 310_win_disk_facts.yml - 330_win_domain_user.yml diff --git a/changelogs/fragments/365-win_domain_user-add-support-for-spns-kerberos.yml b/changelogs/fragments/365-win_domain_user-add-support-for-spns-kerberos.yml deleted file mode 100644 index cd800361..00000000 --- a/changelogs/fragments/365-win_domain_user-add-support-for-spns-kerberos.yml +++ /dev/null @@ -1,4 +0,0 @@ -minor_changes: -- win_domain_user - Add support for managing service prinicpal names via the ``spn`` param - and principals allowed to delegate via the ``delegates`` param - (https://github.com/ansible-collections/community.windows/pull/365) diff --git a/changelogs/fragments/win_domain_user-groups-missing.yml b/changelogs/fragments/win_domain_user-groups-missing.yml deleted file mode 100644 index c64fd427..00000000 --- a/changelogs/fragments/win_domain_user-groups-missing.yml +++ /dev/null @@ -1,2 +0,0 @@ -minor_changes: -- win_domain_user - Added the ``groups_missing_behaviour`` option that controls the behaviour when a group specified does not exist - https://github.com/ansible-collections/community.windows/pull/375 diff --git a/changelogs/fragments/win_hotfix-multiple-msu.yml b/changelogs/fragments/win_hotfix-multiple-msu.yml deleted file mode 100644 index aacf8b68..00000000 --- a/changelogs/fragments/win_hotfix-multiple-msu.yml +++ /dev/null @@ -1,5 +0,0 @@ -bugfixes: -- win_hotfix - Supports hotfixes that contain multiple updates inside the supplied update msu - https://github.com/ansible-collections/community.windows/issues/284 - -minor_changes: -- win_hotfix - Added the ``identifiers`` and ``kbs`` return value that is always a list of identifiers and kbs inside a hotfix diff --git a/changelogs/fragments/win_iis_webapplication-missing-path.yml b/changelogs/fragments/win_iis_webapplication-missing-path.yml deleted file mode 100644 index 018479a8..00000000 --- a/changelogs/fragments/win_iis_webapplication-missing-path.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- win_iis_webapplication - Fix physical path check for broken configurations - https://github.com/ansible-collections/community.windows/pull/385 diff --git a/changelogs/fragments/win_psmodule-credentials.yml b/changelogs/fragments/win_psmodule-credentials.yml deleted file mode 100644 index 70788d74..00000000 --- a/changelogs/fragments/win_psmodule-credentials.yml +++ /dev/null @@ -1,3 +0,0 @@ -minor_changes: -- win_psmodule - Add credential support for through the ``username`` and ``password`` options -- win_psrepository - Add credential support for through the ``username`` and ``password`` options diff --git a/changelogs/fragments/win_rds-sid.yml b/changelogs/fragments/win_rds-sid.yml deleted file mode 100644 index f942d85a..00000000 --- a/changelogs/fragments/win_rds-sid.yml +++ /dev/null @@ -1,3 +0,0 @@ -bugfixes: -- win_rds_cap - Fix SID lookup with any account ending with the ``@builtin`` UPN suffix -- win_rds_rap - Fix SID lookup with any account ending with the ``@builtin`` UPN suffix \ No newline at end of file diff --git a/changelogs/fragments/win_region-output.yml b/changelogs/fragments/win_region-output.yml deleted file mode 100644 index b0b252bb..00000000 --- a/changelogs/fragments/win_region-output.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- win_region - Fix junk output when copying settings across users diff --git a/changelogs/fragments/win_scoop-install.yml b/changelogs/fragments/win_scoop-install.yml deleted file mode 100644 index 6643c6a5..00000000 --- a/changelogs/fragments/win_scoop-install.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- win_scoop - Fix bootstrapping process to properly work when running as admin diff --git a/changelogs/fragments/win_scoop_bucket-error.yml b/changelogs/fragments/win_scoop_bucket-error.yml deleted file mode 100644 index 55b2e4ef..00000000 --- a/changelogs/fragments/win_scoop_bucket-error.yml +++ /dev/null @@ -1,2 +0,0 @@ -bugfixes: -- win_scoop_bucket - Fix handling of output and errors from each scoop command diff --git a/docs/community.windows.win_audit_policy_system_module.rst b/docs/community.windows.win_audit_policy_system_module.rst index 00617e6b..a537ea2f 100644 --- a/docs/community.windows.win_audit_policy_system_module.rst +++ b/docs/community.windows.win_audit_policy_system_module.rst @@ -39,6 +39,7 @@ Parameters
list + / elements=string / required
diff --git a/docs/community.windows.win_audit_rule_module.rst b/docs/community.windows.win_audit_rule_module.rst index 3f154791..c076e118 100644 --- a/docs/community.windows.win_audit_rule_module.rst +++ b/docs/community.windows.win_audit_rule_module.rst @@ -41,6 +41,7 @@ Parameters
list + / elements=string / required
@@ -62,6 +63,7 @@ Parameters
list + / elements=string
@@ -124,6 +126,7 @@ Parameters
list + / elements=string / required
diff --git a/docs/community.windows.win_domain_group_membership_module.rst b/docs/community.windows.win_domain_group_membership_module.rst index b9826a1f..df093f2a 100644 --- a/docs/community.windows.win_domain_group_membership_module.rst +++ b/docs/community.windows.win_domain_group_membership_module.rst @@ -87,6 +87,7 @@ Parameters
list + / elements=string / required
diff --git a/docs/community.windows.win_domain_user_module.rst b/docs/community.windows.win_domain_user_module.rst index a2777e63..fa727f7a 100644 --- a/docs/community.windows.win_domain_user_module.rst +++ b/docs/community.windows.win_domain_user_module.rst @@ -38,12 +38,13 @@ Parameters account_locked
- - + boolean
@@ -59,7 +60,7 @@ Parameters attributes
- string + dictionary
@@ -116,6 +117,25 @@ Parameters
Note that this is a two-character ISO 3166 code.
+ + +
+ delegates + +
+ list + / elements=string +
+
added in 1.10.0
+ + + + +
Specifies an array of principal objects. This parameter sets the msDS-AllowedToActOnBehalfOfOtherIdentity attribute of a computer account object.
+
Must be specified as a distinguished name CN=shenetworks,CN=Users,DC=ansible,DC=test
+

aliases: principals_allowed_to_delegate
+ +
@@ -237,6 +257,7 @@ Parameters
list + / elements=string
@@ -269,6 +290,30 @@ Parameters
If replace, the user is added as a member of each group in groups and removed from any other groups.
+ + +
+ groups_missing_behaviour + +
+ string +
+
added in 1.10.0
+ + + + + +
Controls what happens when a group specified by groups is an invalid group name.
+
fail is the default and will return an error any groups do not exist.
+
ignore will ignore any groups that does not exist.
+
warn will display a warning for any groups that do not exist but will continue without failing.
+ +
@@ -409,6 +454,47 @@ Parameters
Default to the <username> specified in upn or name if not set.
+ + +
+ spn + +
+ list + / elements=string +
+
added in 1.10.0
+ + + + +
Specifies the service principal name(s) for the account. This parameter sets the ServicePrincipalNames property of the account. The LDAP display name (ldapDisplayName) for this property is servicePrincipalName.
+

aliases: spns
+ + + + +
+ spn_action + +
+ string +
+
added in 1.10.0
+ + + + + +
If add, the SPNs are added to the user.
+
If remove, the SPNs are removed from the user.
+
If replace, the defined set of SPN's overwrite the current set of SPNs.
+ +
@@ -474,6 +560,7 @@ Parameters
Configures the user's last name (surname).
+

aliases: lastname
@@ -617,6 +704,35 @@ Examples name: bob state: absent + - name: Ensure user has spn's defined + community.windows.win_domain_user: + name: liz.kenyon + spn: + - MSSQLSvc/us99db-svr95:1433 + - MSSQLSvc/us99db-svr95.vmware.com:1433 + + - name: Ensure user has spn added + community.windows.win_domain_user: + name: liz.kenyon + spn_action: add + spn: + - MSSQLSvc/us99db-svr95:2433 + + - name: Ensure user is created with delegates and spn's defined + community.windows.win_domain_user: + name: shmemmmy + password: The3rubberducki33! + state: present + groups: + - Domain Admins + - Enterprise Admins + delegates: + - CN=shenetworks,CN=Users,DC=ansible,DC=test + - CN=mk.ai,CN=Users,DC=ansible,DC=test + - CN=jessiedotjs,CN=Users,DC=ansible,DC=test + spn: + - MSSQLSvc/us99db-svr95:2433 + Return Values @@ -729,6 +845,25 @@ Common return values are documented `here True + + +
+ delegates + +
+ list + / elements=string +
+
added in 1.10.0
+ + always + +
Principals allowed to delegate
+
+
Sample:
+
['CN=svc.tech.unicorn,CN=Users,DC=ansible,DC=test', 'CN=geoff,CN=Users,DC=ansible,DC=test']
+ +
@@ -949,6 +1084,24 @@ Common return values are documented `here S-1-5-21-2752426336-228313920-2202711348-1175 + + +
+ spn + +
+ list +
+
added in 1.10.0
+ + always + +
The service principal names
+
+
Sample:
+
['HTTPSvc/ws1intel-svc1', 'HTTPSvc/ws1intel-svc1.vmware.com']
+ +
@@ -1061,3 +1214,4 @@ Authors ~~~~~~~ - Nick Chandler (@nwchandler) +- Joe Zollo (@zollo) diff --git a/docs/community.windows.win_eventlog_module.rst b/docs/community.windows.win_eventlog_module.rst index 510c8b10..c1e36d0a 100644 --- a/docs/community.windows.win_eventlog_module.rst +++ b/docs/community.windows.win_eventlog_module.rst @@ -156,6 +156,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_firewall_module.rst b/docs/community.windows.win_firewall_module.rst index 281c2d14..b0efad14 100644 --- a/docs/community.windows.win_firewall_module.rst +++ b/docs/community.windows.win_firewall_module.rst @@ -89,6 +89,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_firewall_rule_module.rst b/docs/community.windows.win_firewall_rule_module.rst index 09e087ca..aac5c209 100644 --- a/docs/community.windows.win_firewall_rule_module.rst +++ b/docs/community.windows.win_firewall_rule_module.rst @@ -131,6 +131,7 @@ Parameters
list + / elements=string
@@ -201,6 +202,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_hotfix_module.rst b/docs/community.windows.win_hotfix_module.rst index 66c48698..4504cb56 100644 --- a/docs/community.windows.win_hotfix_module.rst +++ b/docs/community.windows.win_hotfix_module.rst @@ -220,6 +220,25 @@ Common return values are documented `here Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0 + + +
+ identifiers + +
+ list + / elements=string +
+
added in 1.10.0
+ + success + +
The DISM identifiers for each hotfix in the msu.
+
+
Sample:
+
['Package_for_KB3172729~31bf3856ad364e35~amd64~~6.3.1.0']
+ +
@@ -237,6 +256,25 @@ Common return values are documented `here KB3172729 + + +
+ kbs + +
+ list + / elements=string +
+
added in 1.10.0
+ + success + +
The KB for each hotfix in the msu,
+
+
Sample:
+
['KB3172729']
+ +
diff --git a/docs/community.windows.win_iis_webbinding_module.rst b/docs/community.windows.win_iis_webbinding_module.rst index 65d2406a..dd7a1c9e 100644 --- a/docs/community.windows.win_iis_webbinding_module.rst +++ b/docs/community.windows.win_iis_webbinding_module.rst @@ -118,7 +118,7 @@ Parameters port
- string + integer
diff --git a/docs/community.windows.win_listen_ports_facts_module.rst b/docs/community.windows.win_listen_ports_facts_module.rst new file mode 100644 index 00000000..ff26c273 --- /dev/null +++ b/docs/community.windows.win_listen_ports_facts_module.rst @@ -0,0 +1,172 @@ +.. _community.windows.win_listen_ports_facts_module: + + +**************************************** +community.windows.win_listen_ports_facts +**************************************** + +**Recopilates the facts of the listening ports of the machine** + + +Version added: 1.10.0 + +.. contents:: + :local: + :depth: 1 + + +Synopsis +-------- +- Recopilates the information of the TCP and UDP ports of the machine and the related processes. +- State of the TCP ports could be filtered, as well as the format of the date when the parent process was launched. +- The module's goal is to replicate the functionality of the linux module listen_ports_facts, mantaining the format of the said module. + + + + +Parameters +---------- + +.. raw:: html + + + + + + + + + + + + + + + + + +
ParameterChoices/DefaultsComments
+
+ date_format + +
+ string +
+ 		+ Default:
"%c"
+ 		+
The format of the date when the process that owns the port started.
+
The date specification is UFormat
+
+
+ tcp_filter + +
+ list + / elements=string +
+ 		+ Default:
["Listen"]
+ 		+
Filter for the state of the TCP ports that will be recopilated.
+
Supports multiple states (Bound, Closed, CloseWait, Closing, DeleteTCB, Established, FinWait1, FinWait2, LastAck, Listen, SynReceived, SynSent and TimeWait), that can be used alone or combined. Note that the Bound state is only available on PowerShell version 4.0 or later.
+
+
+ + +Notes +----- + +.. note:: + - The generated data (tcp_listen and udp_listen) and the fields within follows the listen_ports_facts schema to achieve compatibility with the said module output, even though this module if capable of extracting ports with a state other than Listen + + +See Also +-------- + +.. seealso:: + + :ref:`community.general.listen_ports_facts_module` + The official documentation on the **community.general.listen_ports_facts** module. + + +Examples +-------- + +.. code-block:: yaml + + - name: Recopilate ports facts + community.windows.win_listen_ports_facts: + + - name: Retrieve only ports with Closing and Established states + community.windows.win_listen_ports_facts: + tcp_filter: + - Closing + - Established + + - name: Get ports facts with only the year within the date field + community.windows.win_listen_ports_facts: + date_format: '%Y' + + + +Return Values +------------- +Common return values are documented `here `_, the following are the fields unique to this module: + +.. raw:: html + + + + + + + + + + + + + + + + + +
KeyReturnedDescription
+
+ tcp_listen + +
+ list + / elements=dictionary +
+ 		success +
List of dicts with the detected TCP ports
+
+
Sample:
+
[{'address': '127.0.0.1', 'name': 'python', 'pid': 5332, 'port': 82, 'protocol': 'tcp', 'stime': 'Thu Nov 18 15:27:42 2021', 'user': 'SERVER\\Administrator'}]
+
+
+ udp_listen + +
+ list + / elements=dictionary +
+ 		success +
List of dicts with the detected UDP ports
+
+
Sample:
+
[{'address': '127.0.0.1', 'name': 'python', 'pid': 5332, 'port': 82, 'protocol': 'udp', 'stime': 'Thu Nov 18 15:27:42 2021', 'user': 'SERVER\\Administrator'}]
+
+

+ + +Status +------ + + +Authors +~~~~~~~ + +- David Nieto (@david-ns) diff --git a/docs/community.windows.win_nssm_module.rst b/docs/community.windows.win_nssm_module.rst index f8878577..6e552b87 100644 --- a/docs/community.windows.win_nssm_module.rst +++ b/docs/community.windows.win_nssm_module.rst @@ -199,6 +199,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_psmodule_module.rst b/docs/community.windows.win_psmodule_module.rst index 789f1cd2..3d9d0935 100644 --- a/docs/community.windows.win_psmodule_module.rst +++ b/docs/community.windows.win_psmodule_module.rst @@ -118,6 +118,22 @@ Parameters
Name of the Windows PowerShell module that has to be installed.
+ + +
+ password + +
+ string +
+
added in 1.10.0
+ + + + +
Password to authenticate against private repository.
+ +
@@ -205,6 +221,22 @@ Parameters
DEPRECATED, will be removed in a major release after 2021-07-01, please use the community.windows.win_psrepository module instead.
+ + +
+ username + +
+ string +
+
added in 1.10.0
+ + + + +
Username to authenticate against private repository.
+ +
@@ -268,6 +300,14 @@ Examples repository: MyRepository state: present + - name: Add a PowerShell module from a specific repository with credentials + win_psmodule: + name: PowerShellModule + repository: MyRepository + username: repo_username + password: repo_password + state: present + - name: Remove a PowerShell module community.windows.win_psmodule: name: PowerShellModule diff --git a/docs/community.windows.win_psrepository_module.rst b/docs/community.windows.win_psrepository_module.rst index 5645085f..1ab2baaa 100644 --- a/docs/community.windows.win_psrepository_module.rst +++ b/docs/community.windows.win_psrepository_module.rst @@ -96,6 +96,22 @@ Parameters
Name of the repository to work with.
+ + +
+ password + +
+ string +
+
added in 1.10.0
+ + + + +
Password to authenticate against private repository.
+ +
@@ -195,6 +211,22 @@ Parameters
If absent a repository is removed.
+ + +
+ username + +
+ string +
+
added in 1.10.0
+ + + + +
Username to authenticate against private repository.
+ +
@@ -271,6 +303,14 @@ Examples 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 + diff --git a/docs/community.windows.win_rds_cap_module.rst b/docs/community.windows.win_rds_cap_module.rst index e7a03dd3..1fa352f1 100644 --- a/docs/community.windows.win_rds_cap_module.rst +++ b/docs/community.windows.win_rds_cap_module.rst @@ -88,6 +88,7 @@ Parameters
list + / elements=string
@@ -310,6 +311,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_rds_rap_module.rst b/docs/community.windows.win_rds_rap_module.rst index 57cdca46..18696e76 100644 --- a/docs/community.windows.win_rds_rap_module.rst +++ b/docs/community.windows.win_rds_rap_module.rst @@ -47,6 +47,7 @@ Parameters
list + / elements=string
@@ -158,6 +159,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_scheduled_task_module.rst b/docs/community.windows.win_scheduled_task_module.rst index f582c4c5..93bca898 100644 --- a/docs/community.windows.win_scheduled_task_module.rst +++ b/docs/community.windows.win_scheduled_task_module.rst @@ -39,6 +39,7 @@ Parameters
list + / elements=dictionary
@@ -630,6 +631,7 @@ Parameters
list + / elements=dictionary
diff --git a/docs/community.windows.win_scoop_bucket_module.rst b/docs/community.windows.win_scoop_bucket_module.rst index e2710e6f..e37aa1d6 100644 --- a/docs/community.windows.win_scoop_bucket_module.rst +++ b/docs/community.windows.win_scoop_bucket_module.rst @@ -130,6 +130,53 @@ Examples +Return Values +------------- +Common return values are documented `here `_, the following are the fields unique to this module: + +.. raw:: html + + + + + + + + + + + + + + + + + +
KeyReturnedDescription
+
+ rc + +
+ integer +
+ 		always +
The result code of the scoop action
+
+
+
+ stdout + +
+ string +
+ 		on failure or when verbosity is greater than 1 +
The raw output from the scoop action
+
+
Sample:
+
The test bucket was added successfully.
+
+

+ Status ------ diff --git a/docs/community.windows.win_snmp_module.rst b/docs/community.windows.win_snmp_module.rst index 1cb8fff3..55aae205 100644 --- a/docs/community.windows.win_snmp_module.rst +++ b/docs/community.windows.win_snmp_module.rst @@ -61,6 +61,7 @@ Parameters
list + / elements=string
@@ -76,6 +77,7 @@ Parameters
list + / elements=string
diff --git a/docs/community.windows.win_xml_module.rst b/docs/community.windows.win_xml_module.rst index 6e9667a1..bca98cf5 100644 --- a/docs/community.windows.win_xml_module.rst +++ b/docs/community.windows.win_xml_module.rst @@ -148,7 +148,6 @@ Parameters
string - / required
diff --git a/galaxy.yml b/galaxy.yml index 5caa9c26..04afd3f1 100644 --- a/galaxy.yml +++ b/galaxy.yml @@ -1,6 +1,6 @@ namespace: community name: windows -version: 1.9.0 +version: 1.10.0 readme: README.md authors: - Jordan Borean @jborean93