path: root/ansible_collections/community/windows/changelogs/changelog.yaml

ancestor: null
releases:
  0.2.0:
    changes:
      bugfixes:
      - '**security issue** win_unzip - normalize paths in archive to ensure extracted
        files do not escape from the target directory (CVE-2020-1737)

        '
      - psexec - Fix issue where the Kerberos package was not detected as being available.
      - psexec - Fix issue where the ``interactive`` option was not being passed down
        to the library.
      - win_credential - Fix issue that errors when trying to add a ``name`` with
        wildcards.
      - win_domain_computer - Fix idempotence checks when ``sAMAccountName`` is different
        from ``name``
      - win_domain_computer - Honour the explicit domain server and credentials when
        moving or removing a computer object - https://github.com/ansible/ansible/pull/63093
      - win_domain_user - Better handle cases when getting a new user's groups fail
        - https://github.com/ansible/ansible/issues/54331
      - win_format - Idem not working if file exist but same fs (https://github.com/ansible/ansible/issues/58302)
      - win_format - fixed issue where module would not change allocation unit size
        (https://github.com/ansible/ansible/issues/56961)
      - win_iis_webapppool - Do not try and set attributes in check mode when the
        pool did not exist
      - win_iis_website - Actually restart the site when ``state=restarted`` - https://github.com/ansible/ansible/issues/63828
      - win_partition - Fix invalid variable name causing a failure on checks - https://github.com/ansible/ansible/issues/62401
      - win_partition - don't resize partitions if size difference is < 1 MiB
      - win_timezone - Allow for _dstoff timezones
      - win_unzip - Fix support for paths with square brackets not being detected
        properly
      minor_changes:
      - win_disk_facts - Set output array order to be by disk number property - https://github.com/ansible/ansible/issues/63998
      - win_domain_computer - ``sam_account_name`` with missing ``$`` will have it
        added automatically (https://github.com/ansible-collections/community.windows/pull/93)
      - win_domain_computer - add support for offline domain join (https://github.com/ansible-collections/community.windows/pull/93)
      - win_domain_group_membership - Add multi-domain forest support - https://github.com/ansible/ansible/issues/59829
      - win_domain_user - Added the ``identity`` module option to explicitly set the
        identity of the user when searching for it - https://github.com/ansible/ansible/issues/45298
      - win_firewall- Change req check from wmf version to cmdlets presence - https://github.com/ansible/ansible/issues/63003
      - win_firewall_rule - add parameter to support ICMP Types and Codes (https://github.com/ansible/ansible/issues/46809)
      - win_iis_webapplication - add new options ``connect_as``, ``username``, ``password``.
      - win_iis_webapplication - now uses the current application pool of the website
        instead of the DefaultAppPool if none was specified.
      - win_nssm - Implement additional parameters - (https://github.com/ansible/ansible/issues/62620)
      - win_pester - Only execute ``*.tests.ps1`` in ``path`` to match the default
        behaviour in Pester - https://github.com/ansible/ansible/issues/55736
      release_summary: 'This is the first proper release of the ``community.windows``
        collection on 2020-07-18.

        The changelog describes all changes made to the modules and plugins included
        in this collection since Ansible 2.9.0.

        '
      removed_features:
      - win_disk_image - removed the deprecated return value ``mount_path`` in favour
        of ``mount_paths``.
    fragments:
    - 56033-win_iis_webapplication-add-authentication-options.yml
    - 56966-win_format-allocation-unit-size.yml
    - 58225-win_partition-maximum-partition-size.yml
    - 61227-win_iis_webapplication-apppool-change.yml
    - 65138-Windows_Multidomain_support.yml
    - 93-win_domain_computer-offline-domain-join.yml
    - psexec-kerb-and-interactive.yaml
    - summary-0.2.0.yml
    - win-unzip-check-extraction-path.yml
    - win_credential-wildcard.yaml
    - win_disk_facts-Set-output-array-order-by-disk-number.yml
    - win_disk_image_mount_path.yml
    - win_domain_computer-credential.yaml
    - win_domain_computer-idempotence.yaml
    - win_domain_user-group-missing.yaml
    - win_domain_user-identity.yaml
    - win_firewall-Change-req-check-from-wmf-version-to-cmdlets-presence.yml
    - win_firewall_rule-add-support-for-icmptypecode.yml
    - win_format-Idem-not-working-if-file-exist-but-same-fs.yml
    - win_iis_webapppool-check-mode.yaml
    - win_iis_website-restarted.yaml
    - win_nssm-Implement-additional-parameters.yml
    - win_partition-var.yaml
    - win_pester-path-behaviour.yaml
    - win_timezone-Allow-dstoff.yml
    - win_unzip-paths.yaml
    release_date: '2020-07-18'
  1.0.0:
    changes:
      breaking_changes:
      - win_pester - no longer runs all ``*.ps1`` file in the directory specified
        due to it executing potentially unknown scripts. It will follow the default
        behaviour of only running tests for files that are like ``*.tests.ps1`` which
        is built into Pester itself.
      bugfixes:
      - win_scoop - add checks for globally installed packages for better idempotency
        checks
      minor_changes:
      - win_dns_record - Added support for managing ``SRV`` records
      - win_firewall_rule - Support editing rules by the group it belongs to
      - win_firewall_rule - Support editing rules that have a duplicated name
      removed_features:
      - win_psexec - removed the deprecated ``extra_opts`` option.
    fragments:
    - 1.0.0-summary.yml
    - porting-guide.yml
    - win_dns_record_SRV.yml
    - win_firewall_rule_group_state.yml
    - win_scoop.yml
    modules:
    - description: Manage Scoop buckets
      name: win_scoop_bucket
      namespace: ''
    release_date: '2020-08-14'
  1.1.0:
    changes:
      minor_changes:
      - win_dns_record - Support NS record creation,modification and deletion
      - win_firewall - Support defining the default inbound and outbound action of
        traffic in Windows firewall.
      - win_psrepository - Added the ``proxy`` option that defines the proxy to use
        for the repository being managed
    fragments:
    - v1.1.0-summary.yml
    - win_dns_ns_record.yml
    - 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.11.0:
    changes:
      bugfixes:
      - win_domain_user - Fix broken warning call when failing to get group membership
        - https://github.com/ansible-collections/community.windows/issues/412
      - win_scheduled_task - Fix the Monthly DOW trigger value ``run_on_last_week_of_month``
        when ``weeks_of_month`` is also set - https://github.com/ansible-collections/community.windows/issues/414
      minor_changes:
      - Raise minimum Ansible version to ``2.11`` or newer
      - win_psmodule module - add ``accept_license`` option to allow for installing
        modules that require license acceptance (https://github.com/ansible-collections/community.windows/issues/340).
      release_summary: Release summary for v1.11.0
    fragments:
    - 1.11.0-release.yml
    - 340-win_psmodule-accept_license-option.yml
    - ansible-version-bump.yml
    - win_domain_user-add-warning.yml
    - win_scheduled_task_week-trigger.yml
    release_date: '2022-08-11'
  1.11.1:
    changes:
      bugfixes:
      - win_dhcp_lease - call Get-DhcpServerv4Lease once when MAC and IP are defined
        (https://github.com/ansible-collections/community.windows/pull/427)
      - win_dhcp_lease - fix mac address convert (https://github.com/ansible-collections/community.windows/issues/291)
      - win_psmodule - Fix bootstrapping PowerShellGet with ``-AcceptLicense`` - https://github.com/ansible-collections/community.windows/issues/424
      - win_psmodule - Source PowerShellGet and PackagementManagement from ``repository``
        if specified
      - win_region - did not allow regional format en-150 (= English(Europe); also
        referred as en-EU or en-Europe). This fix allows specifying en-150 as regional
        format (https://github.com/ansible-collections/community.windows/issues/438).
      - win_scoop - Fix idempotency checks with Scoop ``v0.2.3`` and newer.
      release_summary: Release summary for v1.11.1
    fragments:
    - 427-win_dhcp_lease-improvements.yml
    - 439-win_region-allow-all-cultures.yaml
    - scoop-export.yml
    - v1.11.1-release.yml
    - win_psmodule-bootstrapping.yml
    release_date: '2022-11-02'
  1.12.0:
    changes:
      bugfixes:
      - win_firewall_rule - fix problem in check mode with multiple ip addresses not
        in same order
      - win_partition - fix problem in auto assigning a drive letter should the user
        use either a, u, t or o as a drive letter
      minor_changes:
      - win_dns_record - Added support for DHCID (RFC 4701) records
      - win_domain_user - Added the ``display_name`` option to set the users display
        name attribute
      release_summary: Release summary for v1.12.0
    fragments:
    - 440-win_firewall_rule.yml
    - 463-fix_win_partition_auto_assign.yaml
    - release-summary.yml
    - win_dns_record-dhcid-support.yaml
    - win_domain_user-display_name.yml
    release_date: '2022-12-20'
  1.13.0:
    changes:
      bugfixes:
      - win_disk_facts - Fix issue when enumerating non-physical disks or disks without
        numbers - https://github.com/ansible-collections/community.windows/issues/474
      - win_firewall_rule - fix program cannot be set to any on existing rules.
      - win_psmodule - Fix missing AcceptLicense parameter that occurs when the pre-reqs
        have been installed - https://github.com/ansible-collections/community.windows/issues/487
      - 'win_pssession_configuration - Fix parser error (Invalid JSON primitive: icrosoft.WSMan.Management.WSManConfigContainerElement)'
      - win_xml - Fixes the issue when no childnode is defined and will allow adding
        a new element to an empty element.
      - win_zip - fix source appears to use backslashes as path separators issue when
        extracting Zip archve in non-Windows environment - https://github.com/ansible-collections/community.windows/issues/442
      minor_changes:
      - Raise minimum Ansible version to ``2.12`` or newer
      - win_dns_record - Add parameter ``aging`` for creating non-static DNS records.
      - win_domain_computer - Add ActiveDirectory module import
      - win_domain_object_info - Add ActiveDirectory module import
      - win_psmodule - add ``force`` option to allow overwriting/updating existing
        module dependency only if requested
      - win_pssession_configuration - Add diff mode support
      release_summary: Release summary for v1.13.0
    fragments:
    - 442-win_zip-backslash.yml
    - 472-win_firewall_rule.yml
    - 480-win_dns_record-aging.yaml
    - 482-win_xml-no-childnode.yml
    - 491-win_pssession_configuration.yml
    - 508-win_psmodule-force.yml
    - 509-import-activedirectory-module.yml
    - ansible-min.yml
    - release-1.13.0.yml
    - win_disk_facts-non-physical-disk.yml
    - win_psmodule-prereqs.yml
    release_date: '2023-05-02'
  1.2.0:
    changes:
      bugfixes:
      - win_partition - fix size comparison errors when size specified in bytes (https://github.com/ansible-collections/community.windows/pull/159)
      - win_security_policy - read config file with correct encoding to avoid breaking
        non-ASCII chars
      - win_security_policy - strip of null char added by secedit for ``LegalNoticeText``
        so the existing value is preserved
      minor_changes:
      - win_nssm - added new parameter 'app_environment' for managing service environment.
      - win_scheduled_task - validate task name against invalid characters (https://github.com/ansible-collections/community.windows/pull/168)
      - win_scheduled_task_stat - add check mode support (https://github.com/ansible-collections/community.windows/pull/167)
    fragments:
    - 158-nssm-appenv-and-custom-pathvar.yaml
    - 159-win_partition_bytes_as_number.yaml
    - 167-win_scheduled_task_stat-check_mode.yml
    - 168-win_scheduled_task-invalid-task-name.yml
    - release_summary.yml
    - win_security_policy_encoding.yml
    modules:
    - description: Enable or disable certain network adapters.
      name: win_net_adapter_feature
      namespace: ''
    release_date: '2020-12-18'
  1.3.0:
    changes:
      bugfixes:
      - 'win_firewall_rule - Ensure ``service: any`` is set to match any service instead
        of the literal service called ``any`` as per the docs'
      - win_scoop - Make sure we enable TLS 1.2 when installing scoop
      - win_xml - Fix ``PropertyNotFound`` exception when creating a new attribute
        - https://github.com/ansible-collections/community.windows/issues/166
      minor_changes:
      - Extend win_domain_computer adding managedBy parameter.
    fragments:
    - 185-add-managedBy-support.yml
    - release_summary.yml
    - win_firewall_rule-service-any.yml
    - win_scoop-tls.yml
    - win_xml-missing-attribute.yml
    modules:
    - description: Copies registered PSRepositories to other user profiles
      name: win_psrepository_copy
      namespace: ''
    release_date: '2021-02-03'
  1.4.0:
    changes:
      bugfixes:
      - win_domain_group_membership - Handle timeouts when dealing with group with
        lots of members - https://github.com/ansible-collections/community.windows/pull/204
      - win_domain_user - Make sure a password is set to change when it is marked
        as password needs to be changed before logging in - https://github.com/ansible-collections/community.windows/issues/223
      - win_domain_user - fix reporting on user when running in check mode - https://github.com/ansible-collections/community.windows/pull/248
      - win_lineinfile - Fix crash when using ``insertbefore`` and ``insertafter``
        at the same time - https://github.com/ansible-collections/community.windows/issues/220
      - win_partition - Fix gtp_type setting in win_partition - https://github.com/ansible-collections/community.windows/issues/241
      - win_psmodule - Makes sure ``-AllowClobber`` is used when updating pre-requisites
        if requested - https://github.com/ansible-collections/community.windows/issues/42
      - win_pssession_configuration - the ``async_poll`` option was not actually used
        and polling mode was always used with the default poll delay; this change
        also formally disables ``async_poll=0`` (https://github.com/ansible-collections/community.windows/pull/212).
      - win_wait_for_process - Fix bug when specifying multiple ``process_name_exact``
        values - https://github.com/ansible-collections/community.windows/issues/203
    fragments:
    - 212-win_pssession_configuration-async_poll.yml
    - release-summary.yml
    - win_domain_group_membership-large.yml
    - win_domain_user-check-reporting.yml
    - win_domain_user-pass-change.yaml
    - win_lineinfile-warning.yaml
    - win_partition-gpttype.yml
    - win_psmodule-prereq.yml
    - win_wait_for_process-exact.yml
    modules:
    - description: Gather information about Windows features
      name: win_feature_info
      namespace: ''
    release_date: '2021-05-15'
  1.5.0:
    changes:
      bugfixes:
      - win_dns_zone - Fix idempotency when using a DNS zone with forwarders - https://github.com/ansible-collections/community.windows/issues/259
      - win_domain_group_member - Fix faulty logic when comparing existing group members
        - https://github.com/ansible-collections/community.windows/issues/256
      - win_lineinfile - Avoid stripping the newline at the end of a file - https://github.com/ansible-collections/community.windows/pull/219
      - win_product_facts - fixed an issue that the module doesn't correctly convert
        a product id (https://github.com/ansible-collections/community.windows/pull/251).
    fragments:
    - 251-win_product_facts.yml
    - release-summary.yml
    - win_dns_zone-forwarder.yml
    - win_domain_group_membership-comparison.yml
    - win_lineinfile-newline.yml
    release_date: '2021-06-26'
  1.6.0:
    changes:
      minor_changes:
      - win_dns_record - Added txt Support
      - win_scheduled_task - Added support for setting a ``session_state_change``
        trigger by documenting the human friendly values for ``state_change``
      - win_scheduled_task_state - Added ``state_change_str`` to the trigger output
        to give a human readable description of the value
      security_fixes:
      - win_psexec - Ensure password is masked in ``psexec_command`` return result
        - https://github.com/ansible-collections/community.windows/issues/43
    fragments:
    - release_summary.yml
    - scheduled_task_state.yml
    - win_dns_record-txtsupport.yml
    - win_psexec-cmd-output.yml
    release_date: '2021-07-27'
  1.7.0:
    changes:
      bugfixes:
      - win_dns_record - Fix issue when trying to use the ``computer_name`` option
        - https://github.com/ansible-collections/community.windows/issues/276
      - win_domain_user - Fallback to NETBIOS username for password verification check
        if the UPN is not set - https://github.com/ansible-collections/community.windows/pull/289
      - 'win_initialize_disk - Ensure ``online: False`` doesn''t bring the disk online
        again - https://github.com/ansible-collections/community.windows/pull/268'
      - win_lineinfile - Fix up diff output with ending newlines - https://github.com/ansible-collections/community.windows/pull/283
      - win_region - Fix ``copy_settings`` on a host that has disabled ``reg.exe``
        access - https://github.com/ansible-collections/community.windows/issues/287
      minor_changes:
      - win_domain_user - Added ``sam_account_name`` to explicitly set the ``sAMAccountName``
        property of an object - https://github.com/ansible-collections/community.windows/issues/281
    fragments:
    - 1.7.0-release.yml
    - win_dns_record-comp-name.yml
    - win_domain_user-missing-upn.yml
    - win_domain_user_samaccount.yml
    - win_initialize_disk-offline.yml
    - win_lineinfile-diff.yml
    - win_region_hardened_registry.yml
    release_date: '2021-09-23'
  1.8.0:
    changes:
      bugfixes:
      - win_audit_rule - Fix exception when trying to change a rule on a hidden or
        protected system file - https://github.com/ansible-collections/community.windows/issues/17
      - win_firewall - Fix GpoBoolean/Boolean comparation(windows versions compatibility
        increase)
      - win_nssm - Perform better user comparison checks for idempotency
      - win_pssession_configuration - the associated action plugin detects check mode
        using a method that isn't always accurate (https://github.com/ansible-collections/community.windows/pull/318).
      - win_region - Fix conflicts with existing ``LIB`` environment variable
      - win_scheduled_task - Fix conflicts with existing ``LIB`` environment variable
      - win_scheduled_task_stat - Fix conflicts with existing ``LIB`` environment
        variable
      - win_scoop_bucket - Ensure no extra data is sent to the controller resulting
        in a junk output warning
      - win_xml - Do not show warnings for normal operations - https://github.com/ansible-collections/community.windows/issues/205
      - win_xml - Fix removal operation when running with higher verbosities - https://github.com/ansible-collections/community.windows/issues/275
      minor_changes:
      - win_nssm - Added ``username`` as an alias for ``user``
      - win_nssm - Remove deprecation for ``state``, ``dependencies``, ``user``, ``password``,
        ``start_mode``
      - win_nssm - Support gMSA accounts for ``user``
    fragments:
    - 205-win_xml-warning.yml
    - 275-win_xml-verbose-removed.yml
    - 318-win_pssession_configuration-action-check_mode.yml
    - add-type-env.yml
    - release.yml
    - win_audit_rule-protected-file.yml
    - win_firewall_bools_comparation_compatibility.yml
    - win_nssm-username.yml
    - win_scoop_bucket-junk.yml
    modules:
    - description: Manage Active Directory Organizational Units
      name: win_domain_ou
      namespace: ''
    release_date: '2021-11-03'
  1.9.0:
    changes:
      bugfixes:
      - win_domain_user - Module now properly captures and reports bad password -
        https://github.com/ansible-collections/community.windows/issues/316
      - win_domain_user - Module now reports user created and changed properly - https://github.com/ansible-collections/community.windows/issues/316
      - win_domain_user - The AD user's existing identity is searched using their
        sAMAccountName name preferentially and falls back to the provided name property
        instead - https://github.com/ansible-collections/community.windows/issues/344
      - win_iis_virtualdirectory - Fixed an issue where virtual directory information
        could not be obtained correctly when the parameter ``application`` was set
      minor_changes:
      - win_disk_facts - Added ``filter`` option to filter returned facts by type
        of disk information - https://github.com/ansible-collections/community.windows/issues/33
      - win_disk_facts - Converted from ``#Requires -Module Ansible.ModuleUtils.Legacy``
        to ``#AnsibleRequires -CSharpUtil Ansible.Basic``
      - win_iis_virtualdirectory - Added the ``connect_as``, ``username``, and ``password``
        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
    fragments:
    - 310_win_disk_facts.yml
    - 330_win_domain_user.yml
    - 337_win_power_plan.yml
    - 345_win_domain_user.yml
    - 347_win_iis_virtualdirectory.yml
    - release-2.9.0.yml
    release_date: '2021-12-21'