{"id":13598528,"url":"https://github.com/ansible-collections/ansible.windows","last_synced_at":"2025-04-08T00:38:22.926Z","repository":{"id":37964111,"uuid":"241710232","full_name":"ansible-collections/ansible.windows","owner":"ansible-collections","description":"Windows core collection for Ansible","archived":false,"fork":false,"pushed_at":"2024-10-29T20:56:18.000Z","size":11153,"stargazers_count":249,"open_issues_count":65,"forks_count":169,"subscribers_count":19,"default_branch":"main","last_synced_at":"2024-10-29T22:39:33.294Z","etag":null,"topics":["ansible-collection","hacktoberfest"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/ansible/windows","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ansible-collections.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-19T19:46:44.000Z","updated_at":"2024-10-29T20:56:22.000Z","dependencies_parsed_at":"2023-10-01T14:42:25.346Z","dependency_job_id":"14a69ddb-11e6-471e-b030-19968d4ca246","html_url":"https://github.com/ansible-collections/ansible.windows","commit_stats":null,"previous_names":[],"tags_count":30,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fansible.windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fansible.windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fansible.windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fansible.windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ansible-collections","download_url":"https://codeload.github.com/ansible-collections/ansible.windows/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247755560,"owners_count":20990620,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible-collection","hacktoberfest"],"created_at":"2024-08-01T17:00:53.392Z","updated_at":"2025-04-08T00:38:22.894Z","avatar_url":"https://github.com/ansible-collections.png","language":"PowerShell","funding_links":[],"categories":["PowerShell"],"sub_categories":[],"readme":"# Ansible Collection: ansible.windows\n\n[![Build Status](https://dev.azure.com/ansible/ansible.windows/_apis/build/status/CI?branchName=main)](https://dev.azure.com/ansible/ansible.windows/_build/latest?definitionId=24\u0026branchName=main)\n[![codecov](https://codecov.io/gh/ansible-collections/ansible.windows/branch/main/graph/badge.svg)](https://codecov.io/gh/ansible-collections/ansible.windows)\n\nThe `ansible.windows` collection includes the core plugins supported by Ansible to help the management of Windows hosts.\n\n## Communication\n\n* Join the Ansible forum:\n  * [Get Help](https://forum.ansible.com/c/help/6): get help or help others.\n  * [Posts tagged with 'windows'](https://forum.ansible.com/tag/windows): subscribe to participate in collection-related conversations.\n  * [Social Spaces](https://forum.ansible.com/c/chat/4): gather and interact with fellow enthusiasts.\n  * [News \u0026 Announcements](https://forum.ansible.com/c/news/5): track project-wide announcements including social events.\n\n* The Ansible [Bullhorn newsletter](https://docs.ansible.com/ansible/devel/community/communication.html#the-bullhorn): used to announce releases and important changes.\n\nFor more information about communication, see the [Ansible communication guide](https://docs.ansible.com/ansible/devel/community/communication.html).\n\n## Ansible version compatibility\n\nThis collection has been tested against following Ansible versions: **\u003e=2.15**.\n\nPlugins and modules within a collection may be tested with only specific Ansible versions.\nA collection may contain metadata that identifies these versions.\nPEP440 is the schema used to describe the versions of Ansible.\n\n## Changelog\n\nSee [CHANGELOG.rst](https://github.com/ansible-collections/ansible.windows/blob/main/CHANGELOG.rst) for the release history and changes made to this collection.\n\n## Collection Documentation\n\nBrowsing the [**latest** collection documentation](https://docs.ansible.com/ansible/latest/collections/ansible/windows) will show docs for the _latest version released in the Ansible package_ not the latest version of the collection released on Galaxy.\n\nBrowsing the [**devel** collection documentation](https://docs.ansible.com/ansible/devel/collections/ansible/windows) shows docs for the _latest version released on Galaxy_.\n\nWe also separately publish [**latest commit** collection documentation](https://ansible-collections.github.io/ansible.windows/branch/main/) which shows docs for the _latest commit in the `main` branch_.\n\nIf you use the Ansible package and don't update collections independently, use **latest**, if you install or update this collection directly from Galaxy, use **devel**. If you are looking to contribute, use **latest commit**.\n\n## Installation and Usage\n\n### Installing the Collection from Ansible Galaxy\n\nBefore using the Windows collection, you need to install it with the `ansible-galaxy` CLI:\n\n    ansible-galaxy collection install ansible.windows\n\nYou can also include it in a `requirements.yml` file and install it via `ansible-galaxy collection install -r requirements.yml` using the format:\n\n```yaml\ncollections:\n- name: ansible.windows\n```\n\n## Contributing to this collection\n\nWe welcome community contributions to this collection. If you find problems, please open an issue or create a PR against the [Ansible Windows collection repository](https://github.com/ansible-collections/ansible.windows). See [Contributing to Ansible-maintained collections](https://docs.ansible.com/ansible/devel/community/contributing_maintained_collections.html#contributing-maintained-collections) for details.\n\nSee [Developing modules for Windows](https://docs.ansible.com/ansible/latest/dev_guide/developing_modules_general_windows.html#developing-modules-general-windows) for specifics on Windows modules.\n\nSee the [Ansible Community Guide](https://docs.ansible.com/ansible/latest/community/index.html) for details on contributing to Ansible.\n\n\n### Code of Conduct\nThis collection follows the Ansible project's\n[Code of Conduct](https://docs.ansible.com/ansible/devel/community/code_of_conduct.html).\nPlease read and familiarize yourself with this document.\n\n\n### Testing with `ansible-test`\n\nThe `tests` directory contains configuration for running sanity and integration tests using [`ansible-test`](https://docs.ansible.com/ansible/latest/dev_guide/testing_integration.html).\n\nYou can run the collection's test suites with the commands:\n\n    ansible-test sanity --docker\n    ansible-test windows-integration --docker\n\n\n## Publishing New Version\n\nThe current process for publishing new versions of the Windows Core Collection is manual, and requires a user who has access to the `ansible` namespace on Ansible Galaxy and Automation Hub to publish the build artifact.\n\n* Update `galaxy.yml` with the new version for the collection.\n* Update the `CHANGELOG`:\n  * Make sure you have [`antsibull-changelog`](https://pypi.org/project/antsibull-changelog/) installed `pip install antsibull-changelog`.\n  * Make sure there are fragments for all known changes in `changelogs/fragments`.\n  * Add a new `release_summary` fragment: `echo \"release_summary: Release summary for v...\" \u003e changelogs/fragments/release-summary.yml`\n  * Run `antsibull-changelog release`.\n* Commit the changes and wait for CI to be green\n* Create a release with the tag that matches the version number\n  * The tag is the version number itself, and should not start with anything\n  * This will trigger a build and publish the collection to AH and Galaxy\n  * The Zuul job progress will be listed [here](https://ansible.softwarefactory-project.io/zuul/builds?project=ansible-collections%2Fansible.windows\u0026skip=0)\n\nAfter the version is published, verify it exists on the [Windows Core Collection Galaxy page](https://galaxy.ansible.com/ansible/windows).\n\n\n## Support\n\nAs a Red Hat Ansible [Certified Content](https://catalog.redhat.com/software/search?target_platforms=Red%20Hat%20Ansible%20Automation%20Platform), this collection is entitled to [support](https://access.redhat.com/support/) through [Ansible Automation Platform](https://www.redhat.com/en/technologies/management/ansible) (AAP).\n\nIf a support case cannot be opened with Red Hat and the collection has been obtained either from [Galaxy](https://galaxy.ansible.com/ui/) or [GitHub](https://github.com/ansible-collections/ansible.windows), there is community support available at no charge.\n\n\n## License\n\nGNU General Public License v3.0 or later\n\nSee [COPYING](COPYING) to see the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansible-collections%2Fansible.windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fansible-collections%2Fansible.windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansible-collections%2Fansible.windows/lists"}