{"id":14965279,"url":"https://github.com/mmcelreath/pssaltstackconfig","last_synced_at":"2026-01-19T09:35:27.172Z","repository":{"id":159550426,"uuid":"633544900","full_name":"mmcelreath/PSSaltStackConfig","owner":"mmcelreath","description":"SaltStack Config API PowerShell module. Provides PowerShell function wrappers for the SaltStack API REST endpoints.","archived":false,"fork":false,"pushed_at":"2023-05-13T15:17:58.000Z","size":75,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T21:47:44.157Z","etag":null,"topics":["aria","module","powershell","salt","saltstack","saltstack-salt","saltstackconfig"],"latest_commit_sha":null,"homepage":"https://www.powershellgallery.com/packages/PSSaltStackConfig/","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mmcelreath.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2023-04-27T18:28:26.000Z","updated_at":"2024-06-11T14:13:03.000Z","dependencies_parsed_at":null,"dependency_job_id":"cbaba759-263a-441c-aa66-5feff7891905","html_url":"https://github.com/mmcelreath/PSSaltStackConfig","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcelreath%2FPSSaltStackConfig","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcelreath%2FPSSaltStackConfig/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcelreath%2FPSSaltStackConfig/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mmcelreath%2FPSSaltStackConfig/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mmcelreath","download_url":"https://codeload.github.com/mmcelreath/PSSaltStackConfig/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247970503,"owners_count":21026155,"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":["aria","module","powershell","salt","saltstack","saltstack-salt","saltstackconfig"],"created_at":"2024-09-24T13:34:31.332Z","updated_at":"2026-01-19T09:35:27.144Z","avatar_url":"https://github.com/mmcelreath.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PSSaltStackConfig\nA PowerShell module for the SaltStack Config API providing function wrappers for the SaltStack API REST endpoints.\n\nThis module started out as a project to give the ability to run some common commands against SaltStack Config using PowerShell. I started by converting a few of the most common Salt Linux commands I was running day to day and continued building on top of that. If you don't see a built in command that you're looking for, I suggest checking out the documentation for the [Invoke-SaltStackAPIMethod](#making-api-calls-with-invoke-saltstackapimethod) command below which can be used to call any API method directly.\n\nThis module utilizes the API for the SaltStack RAAS service. Documentation for the API can be found at the following VMWare Docs pages:\n\n[Working with the API (RaaS)](https://docs.vmware.com/en/VMware-vRealize-Automation-SaltStack-Config/8.4/use-manage-saltstack-config/GUID-FF1A0E3A-CA19-4139-B9DC-C32DC4F76202.html)\n\n[Aria Automation Config API Documentation](https://developer.vmware.com/apis/1179/saltstack-config-raas)\n\nA big thanks to [Ephos](https://github.com/ephos) for doing the inital dirty work to set up the the initial API connection.\n\n## Prerquisites\n- A licensed deployment of SaltStack Enterprise or VMware vRealize Automation SaltStack Config.\n- A user with API access to SaltStack Config.\n\n## Global Connection Variable\nThis module utilizes a global variable called `$global:SaltConnection` which stores the details of the connection to the SaltStack API. Running the following command will create the `$global:SaltConnection` in your current session:\n\n```powershell\nConnect-SaltStackConfig -SaltConfigServer \u003cRAAS_Server\u003e -Credential $credential\n```\n\nThis global variable is utilized automatically by the rest of the functions without the need to pass it every time.\n\n## Usage\n```powershell\n# Install Module\nInstall-Module PSSaltStackConfig\n\n$credential = Get-Credential # User with API permissions\n\n# Connect to SaltStack Config using the provided credential\n# This command will create a Global variable called $global:SaltConnection which will be used for the rest of the functions in this module\nConnect-SaltStackConfig -SaltConfigServer \u003cRAAS_Server\u003e -Credential $credential\n\nInvoke-SaltTestPing -Target 'web01'\n\n```\n\n## Making API Calls With Invoke-SaltStackAPIMethod\nWhen designing this module, we had some functionality in mind that we wanted to see initially, so those were built out into the current functions.\n\nHowever, at the core of this module is the function `Invoke-SaltStackAPIMethod` which can be used to run any of the API calls supported by the [SaltStack API](https://developer.vmware.com/apis/1179/saltstack-config-raas).\n\nThe `Invoke-SaltStackAPIMethod` takes a Resource, Method and Arguments (optional) as parameters.\n\nCheck out the examples under [Invoke-SaltStackAPIMethod](./Examples/Invoke-SaltStackAPIMethod/README.md) for more details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmcelreath%2Fpssaltstackconfig","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmmcelreath%2Fpssaltstackconfig","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmmcelreath%2Fpssaltstackconfig/lists"}