Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/techthoughts2/pwshCloudCommands
Search, discover, and identify PowerShell cloud commands across multiple cloud providers.
https://github.com/techthoughts2/pwshCloudCommands
amazon-web-services aws azure azure-powershell cloud oracle oracle-cloud powershell powershell-module
Last synced: 3 months ago
JSON representation
Search, discover, and identify PowerShell cloud commands across multiple cloud providers.
- Host: GitHub
- URL: https://github.com/techthoughts2/pwshCloudCommands
- Owner: techthoughts2
- License: mit
- Created: 2022-03-20T18:17:10.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-11T03:24:29.000Z (7 months ago)
- Last Synced: 2024-05-11T04:35:00.981Z (6 months ago)
- Topics: amazon-web-services, aws, azure, azure-powershell, cloud, oracle, oracle-cloud, powershell, powershell-module
- Language: PowerShell
- Homepage: https://pwshcloudcommands.readthedocs.io
- Size: 429 KB
- Stars: 10
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Security: .github/SECURITY.md
Awesome Lists containing this project
- jimsghstars - techthoughts2/pwshCloudCommands - Search, discover, and identify PowerShell cloud commands across multiple cloud providers. (PowerShell)
README
# pwshCloudCommands
[](https://github.com/PowerShell/PowerShell) [![PowerShell Gallery][psgallery-img]][psgallery-site]  [![License][license-badge]](LICENSE) [](https://pwshcloudcommands.readthedocs.io/en/latest/?badge=latest)
[psgallery-img]: https://img.shields.io/powershellgallery/dt/pwshCloudCommands?label=Powershell%20Gallery&logo=powershell
[psgallery-site]: https://www.powershellgallery.com/packages/pwshCloudCommands
[license-badge]: https://img.shields.io/github/license/techthoughts2/pwshCloudCommands
Branch | Windows - PowerShell | Windows - pwsh | Linux | MacOS
--- | --- | --- | --- | --- |
main | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_Windows.yml) | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_Windows_Core.yml) | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_Linux.yml) | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_MacOS.yml)
Enhancements | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_Windows.yml) | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_Windows_Core.yml) | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_Linux.yml) | [](https://github.com/techthoughts2/pwshCloudCommands/actions/workflows/wf_MacOS.yml)
## Synopsis
Search, discover, and identify PowerShell cloud commands across multiple cloud providers.
## Description
pwshCloudCommands is a PowerShell module that simplifies the search and analysis of cloud-specific PowerShell commands, without the need to install cloud modules locally. It provides a dual discovery method: querying cloud commands across AWS, Azure, and Oracle, and scanning local project files to identify which cloud commands and modules are being utilized.
### Features
- Fully cross-platform and can be run on Windows, Linux, and macOS
- Module-Free Command Search: Discover PowerShell commands without the need for local module installations.
- Exact Function Name Search: Find specific functions, like Write-S3Object.
- Wildcard Search: Use patterns, such as New\*VM\*, to locate commands.
- Free-Form Search: Enter natural language queries like 'I want to create a new compute instance' for intuitive searching.
- Complete Cache Data Dump: Access a comprehensive dump containing all known PowerShell cloud commands for detailed analysis.
- Project File Analysis: Scan files and folders in your projects to identify used cloud functions and modules, crucial for project setup, discovery, and CI/CD pipeline integration.
## Getting Started
### Documentation
Documentation for pwshCloudCommands is available at: [https://pwshCloudCommands.readthedocs.io](https://pwshCloudCommands.readthedocs.io)
### Installation
```powershell
# Install pwshCloudCommands from the PowerShell Gallery
Install-Module -Name 'pwshCloudCommands' -Scope CurrentUser
```
### Quick start
```powershell
#------------------------------------------------------------------------------------------------
# import the pwshCloudCommands module
Import-Module -Name "pwshCloudCommands"
#------------------------------------------------------------------------------------------------
# identify all PowerShell commands and modules used in the specified path
$psCloud = Get-CloudCommandFromFile -Path "$env:HOME\pathToEvaluate"
$psCloud
#------------------------------------------------------------------------------------------------
# identify all unique modules used in the specified path - useful for CI/CD bootstrapping
$psCloud = Get-CloudCommandFromFile -Path "$env:HOME\pathToEvaluate"
$psCloud.CloudCommands.ModuleName | Select-Object -Unique
#------------------------------------------------------------------------------------------------
# search for a specific cloud command on a specific cloud platform
Find-CloudCommand -Query Write-S3Object -Filter AWS
#------------------------------------------------------------------------------------------------
# search for a specific cloud command on any cloud platform
Find-CloudCommand -Query New-OCIComputeInstance
#------------------------------------------------------------------------------------------------
# wildcard search for a cloud command
Find-CloudCommand -Query New*VM* -Filter Azure
#------------------------------------------------------------------------------------------------
# free-form search for a cloud command
$commands = Find-CloudCommand -Query 'I want to create a new compute instance in Oracle Cloud'
$commands
#------------------------------------------------------------------------------------------------
# I want to get all cloud functions and modules that belong to a specific cloud platform
Get-AllCloudCommandInfo -Filter AWS
Get-AllCloudCommandInfo -Filter Azure
Get-AllCloudCommandInfo -Filter Oracle
#------------------------------------------------------------------------------------------------
```
## Notes
This PowerShell project was created with [Catesta](https://github.com/techthoughts2/Catesta).
## Contributing
If you'd like to contribute to pwshCloudCommands, please see the [contribution guidelines](.github/CONTRIBUTING.md).
## License
This project is [licensed under the MIT License](LICENSE).