README.md

Jagabata.psm 🥔🧈

PowerShell module to operate AWX/AnsibleTower using Rest API.

• Required: PowerShell 7
• Supports Windows, GNU/Linux, macOS
• Much number of commands are available (nearly 200). See: Command list by verb or by noun.
  • Retrieve various information (Get-*, Find-*)
  • Launch, wait or stop jobs such as JobTemplate, WorkflowJobTemplate, etc (Start-*, Invoke-*, Wait-, Stop-*)
  • Creating new resources such as Users, JobTemplates, Credential, etc. (New-*)
  • Update existing resources (Update-*)
  • Associate or Unassociate a resource with another resource (Register-*, Unregister-*)
  • Delete resources (Remove-*)

🎥 Demo

See: All demo movies

🚀 Get Started

1. Install Jagabata.psm from PowerShell Gallery.

Install-Module -Name Jagabata.psm -Scope CurrentUser

2. Import module

Import-Module Jagabata.psm

All commands of Jagabata.psm are added "Ansible" prefix by default, like Get-Host -> Get-AnsibleHost

Tip

Please use the -Prefix parameter to change the prefix. For example:

Import-Module Jagabata.psm -Prefix Awx

All commands of Jagabata.psm will be added "Awx" prefix instead of "Ansible", like Get-Host -> Get-AwxHost.

3. Get Poersonal Access Token

Login to AWX/AnsibleTower to obtain a Personal Access Token (PAT) and create a configuration file with the New-AnsibleApiConfig command.

See Settings for more details.

4. Completed

Now you are ready. Now execute your favorite command!

🚧 Build

See Build document.