{"id":13598893,"url":"https://github.com/ansible-collections/community.windows","last_synced_at":"2025-04-08T09:06:32.568Z","repository":{"id":37803817,"uuid":"245053588","full_name":"ansible-collections/community.windows","owner":"ansible-collections","description":" Windows community collection for Ansible ","archived":false,"fork":false,"pushed_at":"2025-03-23T23:05:52.000Z","size":15307,"stargazers_count":210,"open_issues_count":147,"forks_count":165,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-04-01T07:49:43.452Z","etag":null,"topics":["ansible-collection","hacktoberfest"],"latest_commit_sha":null,"homepage":"https://galaxy.ansible.com/community/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-03-05T02:48:10.000Z","updated_at":"2025-03-23T23:05:56.000Z","dependencies_parsed_at":"2023-11-16T01:23:52.118Z","dependency_job_id":"31cfa1c1-c6e3-474c-a759-4ad615aa2d12","html_url":"https://github.com/ansible-collections/community.windows","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.windows","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.windows/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.windows/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ansible-collections%2Fcommunity.windows/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ansible-collections","download_url":"https://codeload.github.com/ansible-collections/community.windows/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247809965,"owners_count":20999816,"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:57.876Z","updated_at":"2025-04-08T09:06:32.536Z","avatar_url":"https://github.com/ansible-collections.png","language":"PowerShell","funding_links":[],"categories":["PowerShell"],"sub_categories":[],"readme":"# Ansible Collection: community.windows\n\n[![Build Status](https://dev.azure.com/ansible/community.windows/_apis/build/status/CI?branchName=main)](https://dev.azure.com/ansible/community.windows/_build/latest?definitionId=23\u0026branchName=main)\n[![codecov](https://codecov.io/gh/ansible-collections/community.windows/branch/main/graph/badge.svg)](https://codecov.io/gh/ansible-collections/community.windows)\n\n\nThe `community.windows` collection includes the community plugins supported by Ansible community 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/community.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/community/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/community/windows) shows docs for the _latest version released on Galaxy_.\n\nWe also separately publish [**latest commit** collection documentation](https://ansible-collections.github.io/community.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 community.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: community.windows\n```\n\n\n## Contributing to this collection\n\nCurrently we welcome bugfixes or feature requests to plugins in this collection but no new modules or plugins will be accepted in this collection. If you find problems, please open an issue or create a PR against the [Community Windows collection repository](https://github.com/ansible-collections/community.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 `community` namespace on Ansible Galaxy and Automation Hub to publish the build artifact.\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 Galaxy\n  * The Zuul job progress will be listed [here](https://ansible.softwarefactory-project.io/zuul/builds?project=ansible-collections%community.windows\u0026skip=0)\n\nAfter the version is published, verify it exists on the [Windows Community Collection Galaxy page](https://galaxy.ansible.com/community/windows).\n\n\n## More Information\n\nFor more information about Ansible's Windows integration, join the `#ansible-windows` channel on [libera.chat](https://libera.chat/) IRC, and browse the resources in the [Windows Working Group](https://github.com/ansible/community/wiki/Windows) Community wiki page.\n\n- [Ansible Collection overview](https://github.com/ansible-collections/overview)\n- [Ansible User guide](https://docs.ansible.com/ansible/latest/user_guide/index.html)\n- [Ansible Developer guide](https://docs.ansible.com/ansible/latest/dev_guide/index.html)\n- [Ansible Community code of conduct](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)\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%2Fcommunity.windows","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fansible-collections%2Fcommunity.windows","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fansible-collections%2Fcommunity.windows/lists"}